usr/share/man/cat1/vi.0

VI(1)                        BSD Reference Manual                        VI(1)

N\bNA\bAM\bME\bE
     v\bvi\bi, v\bvi\bie\bew\bw - screen oriented (visual) display editor based on ex

S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
     v\bvi\bi [-\b-R\bR] [-\b-l\bl] [-\b-r\br] [-\b-t\bt _\bt_\ba_\bg] [-\b-w\bw _\bn] [+\b+_\bc_\bo_\bm_\bm_\ba_\bn_\bd] _\bn_\ba_\bm_\be _\b._\b._\b.

D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
     V\bVi\bi (visual) is a display oriented text editor based on ex(1).  Ex and v\bvi\bi
     run the same code; it is possible to get to the command mode of ex from
     within v\bvi\bi and vice-versa.

     V\bVi\bie\bew\bw is the same as ``vi -R'', e.g. run in read-only mode.

     Available options:

     -\b-R\bR         Read only. Changes to the file may not be written out.

     -\b-l\bl         Sets options for editing LISP source (options s\bsh\bho\bow\bwm\bma\bat\btc\bch\bh and
                l\bli\bis\bsp\bp).

     -\b-r\br         In the event of an editor or system crash, the -\b-r\br option will
                retrieve the last saved version of the specified file, or if
                no file is specified, a list of saved files is printed.

     -\b-t\bt _\bt_\ba_\bg     If tags are used (see ctags(1))  the editor is positioned at
                _\bt_\ba_\bg.

     -\b-w\bw_\bn        The default window size is set to _\bn.

     +\b+_\bc_\bo_\bm_\bm_\ba_\bn_\bd   Enter the file with _\bc_\bo_\bm_\bm_\ba_\bn_\bd_\b. Useful for positioning on a
                string or line number.

     The _\bV_\bi _\bQ_\bu_\bi_\bc_\bk _\bR_\be_\bf_\be_\br_\be_\bn_\bc_\be card and the _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn _\bt_\bo _\bD_\bi_\bs_\bp_\bl_\ba_\by _\bE_\bd_\bi_\bt_\bi_\bn_\bg _\bw_\bi_\bt_\bh
     _\bV_\bi provide full details on using v\bvi\bi.

E\bEN\bNV\bVI\bIR\bRO\bON\bNM\bME\bEN\bNT\bT
     The v\bvi\bi command uses the following environment variables.

     EXINIT      User specified startup values for ex and v\bvi\bi. Usually speci-
                 fied in the file _\b~_\b/_\b._\be_\bx_\br_\bc

     HOME        Default directory to search for the file _\b~_\b/_\b._\be_\bx_\br_\bc

     SHELL       Shell used for _\be_\bs_\bc_\ba_\bp_\be_\bd commands (with the ex :\b:!\b! command).

     TERM        Terminal type used to lookup terminal capabilities from the
                 file _\b/_\bu_\bs_\br_\b/_\bs_\bh_\ba_\br_\be_\b/_\bm_\bi_\bs_\bc_\b/_\bt_\be_\br_\bm_\bc_\ba_\bp.

     TERMCAP     If set, specifies an alternate termcap file.

F\bFI\bIL\bLE\bES\bS
     /usr/libexec/ex?.?strings   error messages
     /usr/libexec/ex?.?recover   recover command
     /usr/libexec/ex?.?preserve  preserve command
     /usr/share/misc/termcap     describes capabilities of terminals
     ~/.exrc                     editor startup file
     /tmp/Ex_\bn_\bn_\bn_\bn_\bn                editor temporary
     /tmp/Rx_\bn_\bn_\bn_\bn_\bn                named buffer temporary
     /var/preserve               preservation directory

S\bSE\bEE\bE A\bAL\bLS\bSO\bO
     awk(1),  ed(1),  grep(1),  sed(1),  grep(1),  vi(1),  termcap(5),  envi-
     ron(7)

     _\bV_\bi _\bQ_\bu_\bi_\bc_\bk _\bR_\be_\bf_\be_\br_\be_\bn_\bc_\be _\bC_\ba_\br_\bd.

     _\bA_\bn _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn _\bt_\bo _\bD_\bi_\bs_\bp_\bl_\ba_\by _\bE_\bd_\bi_\bt_\bi_\bn_\bg _\bw_\bi_\bt_\bh _\bV_\bi.

B\bBU\bUG\bGS\bS
     Software tabs using ^\b^T\bT work only immediately after the a\bau\but\bto\boi\bin\bnd\bde\ben\bnt\bt.

     Left and right shifts on intelligent terminals don't make use of insert
     and delete character operations in the terminal.

     The w\bwr\bra\bap\bpm\bma\bar\brg\bgi\bin\bn option can be fooled since it looks at output columns when
     blanks are typed.  If a long word passes through the margin and onto the
     next line without a break, then the line won't be broken.

     Insert/delete within a line can be slow if tabs are present on intelli-
     gent terminals, since the terminals need help in doing this correctly.

     Saving text on deletes in the named buffers is somewhat inefficient.

     The s\bso\bou\bur\brc\bce\be command does not work when executed as :\b:s\bso\bou\bur\brc\bce\be; there is no
     way to use the :\b:a\bap\bpp\bpe\ben\bnd\bd, :\b:c\bch\bha\ban\bng\bge\be, and :\b:i\bin\bns\bse\ber\brt\bt commands, since it is not
     possible to give more than one line of input to a :\b: escape.  To use these
     on a :\b:g\bgl\blo\bob\bba\bal\bl you must Q\bQ to ex command mode, execute them, and then reen-
     ter the screen editor with v\bvi\bi or o\bop\bpe\ben\bn.

H\bHI\bIS\bST\bTO\bOR\bRY\bY
     The v\bvi\bi command appeared in 3.0BSD.

3rd Berkeley Distribution      December 30, 1993                             2