home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / textedit / vim.zip / VIM.MAN < prev    next >
Text File  |  1993-04-08  |  6KB  |  196 lines
  1.  
  2.  
  3. VIM(1)                          USER COMMANDS                           VIM(1)
  4.  
  5.  
  6. NNNAAAMMMEEE
  7.      vim - Vi IMitation, 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
  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          Start in quickFix mode. The error file "AztecC.Err"  is  read
  81.                  and  the  first  error  is  displayed.  Further errors can be
  82.                  jumped to with the ":cn" command. See  reference.doc  section
  83.                  5.6.
  84.  
  85. OOOPPPTTTIIIOOONNNSSS
  86.      The options, if present, must precede the filelist. The  options  may  be
  87.      given in any order.
  88.  
  89.      -r          Recovery mode. The autoscript  file  is  read  to  recover  a
  90.                  crashed editing session. It has almost the same effect as "-s
  91.                  file.vim".  See  reference.doc,  chapter  "Recovery  after  a
  92.                  crash".
  93.  
  94.      -v          View mode. The 'readonly' option will be set. You  can  still
  95.                  edit  the  buffer,  but  will  be  prevented  from accidental
  96.                  overwriting a file. If you do want to overwrite a  file,  add
  97.                  an  exclamation  mark  to  the  Ex  command, as in ":w!". The
  98.                  'readonly'  option  can  be  reset  with  ":set  noro"   (see
  99.                  reference.doc, options chapter).
  100.  
  101.      -n          No autoscript file will be written. Recovery  after  a  crash
  102.                  will  be  impossible.  Handy  if you want to edit a file on a
  103.                  very slow medium (e.g. floppy). Can also be done  with  ":set
  104.                  uc=0".
  105.  
  106.      -s {scriptin}
  107.                  The script file {scriptin} is read.  The  characters  in  the
  108.                  file  are  interpreted as if you had typed them. The same can
  109.                  be done with the command ":source! {scriptin}". If the end of
  110.                  the   file  is  reached  before  the  editor  exits,  further
  111.                  characters are read from the keyboard.
  112.  
  113.      -w {scriptout}
  114.                  All the characters that you type are  recorded  in  the  file
  115.                  {scriptout},  until  you exit VIM. This is useful if you want
  116.                  to create  a  script  file  to  be  used  with  "vim  -s"  or
  117.                  ":source!".
  118.  
  119.      -T terminal Tells Vim the name of the terminal you are using. Should be a
  120.                  terminal  known  to  Vim  (builtin) or defined in the termcap
  121.                  file.
  122.  
  123.      -d device   Open "device" for use as  a  terminal.  Only  on  the  Amiga.
  124.                  Example:  "-d con:20/30/600/150".
  125.  
  126.  
  127.  
  128.  
  129.                                 28 March 1992                                2
  130.  
  131.  
  132.  
  133. VIM(1)                          USER COMMANDS                           VIM(1)
  134.  
  135.  
  136. SSSEEEEEE AAALLLSSSOOO
  137.      Vim  documentation:  Reference.doc,  index,   difference.doc,   unix.doc,
  138.      vim.hlp.
  139.  
  140. AAAUUUTTTHHHOOORRR
  141.      Most of VIM was made by Bram Moolenaar.
  142.      VIM is based on Stevie, worked on by: Tim Thompson, Tony Andrews and G.R.
  143.      (Fred) Walter
  144.  
  145. BBBUUUGGGSSS
  146.      Probably.
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  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.