home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / util / vim-2.0.lha / Vim-2.0 / doc / vim.man < prev    next >
Encoding:
Text File  |  1993-12-15  |  6.7 KB  |  196 lines
  1.  
  2.  
  3. VIM(1)                          USER COMMANDS                           VIM(1)
  4.  
  5.  
  6. NNNAAAMMMEEE
  7.      vim - Vi IMproved, a programmers text editor
  8.  
  9. SSSYYYNNNOOOPPPSSSIIISSS
  10.      vvviiimmm [options] [file ..]
  11.      vvviiimmm [options] -t tag
  12.      vvviiimmm [options] +[command] file ..
  13.      vvviiimmm [options] -c {command} file ..
  14.      vvviiimmm [options] -e [errorfile]
  15.  
  16. DDDEEESSSCCCRRRIIIPPPTTTIIIOOONNN
  17.      VVViiimmm is a text editor that is upwards compatible to vi. It can be used  to
  18.      edit any ASCII text. It is especially useful for editing programs.
  19.  
  20.      There are a lot of enhancements above vi: multi level undo, command  line
  21.      editing,   filename   completion,  on  line  help,  quoting,  etc..  Read
  22.      difference.doc for a summary of the differences between vi and Vim.
  23.  
  24.      Most often VVViiimmm is started to edit a single file with the command
  25.  
  26.           vim file
  27.  
  28.      More generally VIM is started with:
  29.  
  30.           vim [options] [filelist]
  31.  
  32.      If the filelist is missing, the editor will start with an  empty  buffer.
  33.      Otherwise exactly one out of the following four may be used to choose one
  34.      or more files to be edited.
  35.  
  36.      file ..     A list of file names. The first one (alphabetically) will  be
  37.                  the current file and read into the buffer. The cursor will be
  38.                  positioned on the first line of the buffer. You  can  get  to
  39.                  the other files with the ":next" command.
  40.  
  41.      +[num] file ..
  42.                  Same as the above, but the cursor will be positioned on  line
  43.                  "num".  If "num" is missing, the cursor will be positioned on
  44.                  the last line.
  45.  
  46.      +/pat file ..
  47.                  Same as the above, but the cursor will be positioned  on  the
  48.                  first   occurrence   of   "pat"  in  the  current  file  (see
  49.                  reference.doc, section "pattern searches" for  the  available
  50.                  search patterns).
  51.  
  52.      +{command} file ..
  53.  
  54.      -c {command} file ..
  55.                  Same as the above, but {command} will be executed  after  the
  56.                  file  has  been  read.  {command}  is  interpreted  as  an Ex
  57.                  command. If the {command} contains spaces it must be enclosed
  58.                  in  double  quotes  (this depends on the shell that is used).
  59.                  Example: Vim "+set si" main.c
  60.  
  61.  
  62.  
  63.  
  64.                                 28 March 1992                                1
  65.  
  66.  
  67.  
  68. VIM(1)                          USER COMMANDS                           VIM(1)
  69.  
  70.  
  71.      -t {tag}    The file to edit and the initial cursor position depends on a
  72.                  "tag",  a  sort of goto label. {tag} is looked up in the tags
  73.                  file, the associated file becomes the current  file  and  the
  74.                  associated  command  is  executed.  Mostly this is used for C
  75.                  programs. {tag} then should be a function name. The effect is
  76.                  that  the  file  containing that function becomes the current
  77.                  file and the  cursor  is  positioned  on  the  start  of  the
  78.                  function (see reference.doc, section "tag searches").
  79.  
  80.      -e [errorfile]
  81.                  Start in quickFix mode. The file [errorfile] is read and  the
  82.                  first  error is displayed. If [errorfile] is omitted the file
  83.                  name is obtained from the  'errorfile'  option  (defaults  to
  84.                  "AztecC.Err"  for  the  Amiga,  "errors"  on  other systems).
  85.                  Further errors can be jumped to with the ":cn"  command.  See
  86.                  reference.doc section 5.5.
  87.  
  88. OOOPPPTTTIIIOOONNNSSS
  89.      The options, if present, must precede the filelist. The  options  may  be
  90.      given in any order.
  91.  
  92.      -r          Recovery mode. The autoscript  file  is  read  to  recover  a
  93.                  crashed editing session. It has almost the same effect as "-s
  94.                  file.vim".  See  reference.doc,  chapter  "Recovery  after  a
  95.                  crash".
  96.  
  97.      -v          View mode. The 'readonly' option will be set. You  can  still
  98.                  edit  the  buffer,  but  will  be  prevented  from accidental
  99.                  overwriting a file. If you do want to overwrite a  file,  add
  100.                  an  exclamation  mark  to  the  Ex  command, as in ":w!". The
  101.                  'readonly'  option  can  be  reset  with  ":set  noro"   (see
  102.                  reference.doc, options chapter).
  103.  
  104.      -b          Binary. A few options will be set that makes it  possible  to
  105.                  edit a binary or executable file.
  106.  
  107.      -x          (Amiga only) Vim is not restarted to open a new window.  This
  108.                  option  should be used when Vim is executed by a program that
  109.                  will wait for the edit session to  finish  (e.g.  mail).  The
  110.                  ":sh" and ":!" commands will not work.
  111.  
  112.      -n          No autoscript file will be written. Recovery  after  a  crash
  113.                  will  be  impossible.  Handy  if you want to edit a file on a
  114.                  very slow medium (e.g. floppy). Can also be done  with  ":set
  115.                  uc=0".
  116.  
  117.      -s {scriptin}
  118.                  The script file {scriptin} is read.  The  characters  in  the
  119.                  file  are  interpreted as if you had typed them. The same can
  120.                  be done with the command ":source! {scriptin}". If the end of
  121.                  the   file  is  reached  before  the  editor  exits,  further
  122.                  characters are read from the keyboard.
  123.  
  124.      -w {scriptout}
  125.                  All the characters that you type are  recorded  in  the  file
  126.                  {scriptout},  until  you exit VIM. This is useful if you want
  127.  
  128.  
  129.                                 28 March 1992                                2
  130.  
  131.  
  132.  
  133. VIM(1)                          USER COMMANDS                           VIM(1)
  134.  
  135.  
  136.                  to create  a  script  file  to  be  used  with  "vim  -s"  or
  137.                  ":source!".
  138.  
  139.      -T terminal Tells Vim the name of the terminal you are using. Should be a
  140.                  terminal  known  to  Vim  (builtin) or defined in the termcap
  141.                  file.
  142.  
  143.      -d device   Open "device" for use as  a  terminal.  Only  on  the  Amiga.
  144.                  Example:  "-d con:20/30/600/150".
  145.  
  146. SSSEEEEEE AAALLLSSSOOO
  147.      Vim  documentation:  Reference.doc,  index,   difference.doc,   unix.doc,
  148.      vim.hlp.
  149.  
  150. AAAUUUTTTHHHOOORRR
  151.      Most of VIM was made by Bram Moolenaar.
  152.      VIM is based on Stevie, worked on by: Tim Thompson, Tony Andrews and G.R.
  153.      (Fred) Walter
  154.  
  155. BBBUUUGGGSSS
  156.      Probably.
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                                 28 March 1992                                3
  195.  
  196.