home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD1.bin / gnu / man / cat1 / jove.0 < prev    next >
Text File  |  1995-01-12  |  15KB  |  397 lines
  1.  
  2.  
  3.  
  4. JOVE(1)                                                   JOVE(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        jove - an interactive display-oriented text editor
  9.  
  10. SSYYNNOOPPSSIISS
  11.        jove [-d directory] [-w] [-t tag] [+[n] file] [-p file] [files]
  12.        jove -r
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.        JOVE  is  Jonathan's Own Version of Emacs.  It is based on
  16.        the original EMACS editor written at MIT by Richard Stall-
  17.        man.   Although JOVE is meant to be compatible with EMACS,
  18.        there are some major differences between the  two  editors
  19.        and you shouldn't rely on their behaving identically.
  20.  
  21.        JOVE  works  on  any  reasonable  display terminal that is
  22.        described in the _t_e_r_m_c_a_p file  (see  TERMCAP(5)  for  more
  23.        details).   When  you  start  up  JOVE,  it  checks to see
  24.        whether you have your _T_E_R_M environment variable  set.   On
  25.        most  systems  that  will automatically be set up for you,
  26.        but if it's not JOVE will ask you what  kind  of  terminal
  27.        you  are  using.   To avoid having to type this every time
  28.        you run JOVE you can set your  _T_E_R_M  environment  variable
  29.        yourself.   How you do this depends on which shell you are
  30.        running.  If you are running the C Shell, as most  of  you
  31.        are, you type
  32.  
  33.             % setenv TERM _t_y_p_e
  34.  
  35.        and with the Bourne Shell, you type
  36.  
  37.             $ TERM= _t_y_p_e ; export TERM
  38.  
  39.        where  _t_y_p_e  is  the  name of the kind of terminal you are
  40.        using (e.g., vt100).  If neither of these works get  some-
  41.        body to help you.
  42.  
  43. IINNVVOOKKIINNGG JJOOVVEE
  44.        If you run JOVE with no arguments you will be placed in an
  45.        empty buffer, called _M_a_i_n_.  Otherwise, any  arguments  you
  46.        supply  are  considered file names and each is "given" its
  47.        own  buffer.   Only  the  first  file  is  actually   read
  48.        in--reading other files is deferred until you actually try
  49.        to use the buffers they are  attached  to.   This  is  for
  50.        efficiency's  sake: most of the time, when you run JOVE on
  51.        a big list of files, you end up  editing  only  a  few  of
  52.        them.
  53.  
  54.        The  names  of  all  of the files specified on the command
  55.        line are saved in a buffer, called _*_m_i_n_i_b_u_f_*_.   The  mini-
  56.        buffer  is a special JOVE buffer that is used when JOVE is
  57.        prompting for some input to many  commands  (for  example,
  58.        when  JOVE  is  prompting  for a file name).  When you are
  59.        being prompted for a file name, you can type  C-N  (that's
  60.        Control-N) and C-P to cycle through the list of files that
  61.  
  62.  
  63.  
  64.                          12 February 1986                       1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. JOVE(1)                                                   JOVE(1)
  71.  
  72.  
  73.        were specified on the command line.  The file name will be
  74.        inserted  where you are typing and then you can edit it as
  75.        if you typed it in yourself.
  76.  
  77.        JOVE recognizes the following switches:
  78.  
  79.        _-_d     The following argument is taken to be the  name  of
  80.               the  current  directory.   This is for systems that
  81.               don't have a version of C shell that  automatically
  82.               maintains  the  _C_W_D environment variable.  If _-_d is
  83.               not specified on a  system  without  a  modified  C
  84.               shell,  JOVE  will  have  to figure out the current
  85.               directory itself, and that can be VERY  slow.   You
  86.               can  simulate  the  modified C shell by putting the
  87.               following lines in your C shell initialization file
  88.               (.cshrc):
  89.  
  90.                    alias cd        'cd \!*; setenv CWD $cwd'
  91.                    alias popd      'popd \!*; setenv CWD $cwd'
  92.                    alias pushd     'pushd \!*; setenv CWD $cwd'
  93.  
  94.        _+_n     Reads  the  file, designated by the following argu-
  95.               ment, and positions point at the _n_'_t_h line  instead
  96.               of  the (default) 1'st line.  This can be specified
  97.               more than once but it doesn't make sense to use  it
  98.               twice on the same file; in that case the second one
  99.               wins. If no numeric argument is given after the  +,
  100.               the point is positioned at the end of the file.
  101.  
  102.        _-_p     Parses the error messages in the file designated by
  103.               the following argument.   The  error  messages  are
  104.               assumed  to  be  in  a format similar to the C com-
  105.               piler, LINT, or GREP output.
  106.  
  107.        _-_t     Runs the _f_i_n_d_-_t_a_g command on the string of  charac-
  108.               ters  immediately  following the -t if there is one
  109.               (as in -tTagname), or on the following argument (as
  110.               in -t Tagname) otherwise (see ctags(1)).
  111.  
  112.        _-_w     Divides  the  window  in  two.   When this happens,
  113.               either the same file is displayed in both  windows,
  114.               or  the second file in the list is read in and dis-
  115.               played in its window.
  116.  
  117. RREECCOOVVEERRIINNGG BBUUFFFFEERRSS AAFFTTEERR AA CCRRAASSHH
  118.        The _-_r option of jove runs the JOVE recover program.   Use
  119.        this  when  the  system  crashes,  or JOVE crashes, or you
  120.        accidently get logged out while in JOVE.  If there are any
  121.        buffers to be recovered, this will find them.
  122.  
  123.        Recover  looks  for  JOVE buffers that are left around and
  124.        are owned by you.   (You  cannot  recover  other  peoples'
  125.        buffers,  obviously.)   If there were no buffers that were
  126.        modified at the time  of  the  crash  or  there  were  but
  127.  
  128.  
  129.  
  130.                          12 February 1986                       2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. JOVE(1)                                                   JOVE(1)
  137.  
  138.  
  139.        recover  can't get its hands on them, you will be informed
  140.        with the message, "There is nothing to  recover."   Other-
  141.        wise,  recover  prints the date and time of the version of
  142.        the buffers it has, and then waits for you type a command.
  143.  
  144.        To  get a list of the buffers recover knows about, use the
  145.        _l_i_s_t command.  This will list  all  the  buffers  and  the
  146.        files  and the number of lines associated with them.  Next
  147.        to each buffer is a number.  When you want  to  recover  a
  148.        buffer,  use  the  _g_e_t  command.  The syntax is _g_e_t _b_u_f_f_e_r
  149.        _f_i_l_e_n_a_m_e where _b_u_f_f_e_r is either the buffer's name  or  the
  150.        number  at  the  beginning of the line.  If you don't type
  151.        the buffer name or the filename, recover will  prompt  you
  152.        for them.
  153.  
  154.        If  there are a lot of buffers and you want to recover all
  155.        of them, use the _r_e_c_o_v_e_r command.  This will recover  each
  156.        buffer  to  the  name of the buffer with ".#" prepended to
  157.        the name (so that the original  isn't  over-written).   It
  158.        asks  for each file and if you want to restore that buffer
  159.        to that name you type "yes".  If you want to  recover  the
  160.        file  but  to a different name, just type the new name in.
  161.        If you type "no" recover will skip that file and go on  to
  162.        the next one.
  163.  
  164.        If you want to look at a buffer before deciding to recover
  165.        it, use the _p_r_i_n_t command.  The syntax for this  is  _p_r_i_n_t
  166.        _b_u_f_f_e_r  where  _b_u_f_f_e_r again is either its name or the num-
  167.        ber.  You can type ^C if you want to  abort  printing  the
  168.        file  to  the  terminal,  and recover will respond with an
  169.        appropriate message.
  170.  
  171.        When you're done and have all the buffers you  want,  type
  172.        the _q_u_i_t command to leave.  You will then be asked whether
  173.        it's okay to delete the  tmp  files.   Most  of  the  time
  174.        that's okay and you should type "yes".  When you say that,
  175.        JOVE removes all traces of those buffers and you won't  be
  176.        able  to  look  at  them  again.   (If  you recovered some
  177.        buffers they will still be around, so don't  worry.)   So,
  178.        if  you're not sur