diff options
Diffstat (limited to 'usr.bin/vi/docs/vi.ref.txt')
| -rw-r--r-- | usr.bin/vi/docs/vi.ref.txt | 634 |
1 files changed, 634 insertions, 0 deletions
diff --git a/usr.bin/vi/docs/vi.ref.txt b/usr.bin/vi/docs/vi.ref.txt new file mode 100644 index 000000000000..e5fc627072db --- /dev/null +++ b/usr.bin/vi/docs/vi.ref.txt @@ -0,0 +1,634 @@ +EX/VI REFERENCE MANUAL(1) BSD Reference Manual EX/VI REFERENCE MANUAL(1) + +NNAAMMEE + eexx,, vvii,, vviieeww - text editors + +DDEESSCCRRIIPPTTIIOONN + VVii is a screen oriented text editor. EExx is a line-oriented text editor. + EExx and vvii are different interfaces to the same program, and it is possi- + ble to switch back and forth during an edit session. VViieeww is the equiva- + lent of using the --RR (read-only) option of vvii. + + This reference manual is the one provided with the nneexx//nnvvii versions of + the eexx//vvii text editors. NNeexx//nnvvii are intended as bug-for-bug compatible + replacements for the original Fourth Berkeley Software Distribution + (4BSD) eexx and vvii programs. This reference manual is accompanied by a + traditional-style manual page. That manual page describes the function- + ality found in eexx//vvii in far less detail than the description here. In + addition, it describes the system interface to eexx//vvii, e.g. command line + options, environmental variables, and similar things. + + This reference is intended for users already familiar with eexx//vvii. Anyone + else should almost certainly read a good tutorial on the editor first. + If you're in an unfamiliar environment, and you absolutely have to get + work done immediately, see the section entitled FAST STARTUP in the manu- + al page. It's probably enough to get you going. + + For the rest of this reference, nneexx//nnvvii is used only when it's necessary + to distinguish it from the historic implementations of eexx//vvii. + +AADDDDIITTIIOONNAALL FFEEAATTUURREESS + There are a few features in nneexx//nnvvii that are not found in historic ver- + sions of eexx//vvii. A list of those features is as follows: + + 8-bit clean data, large lines, files + NNvvii//nneexx will edit any format file. Line lengths are limited by + available memory, and file sizes are limited by available disk + space. The command ``^Vx[0-9A-Fa-f]*'', in input mode, will in- + sert any legal character value into the text. + + Split screens + The command ``:sp[lit] [file ...]'' splits the screen in vi mode. + The key ``^W'' switches between the foreground screens, and the + ``:resize count'' command can be used to grow or shrink a partic- + ular screen. + + Background and foreground screens + The command ``:bg'' backgrounds the current screen, and the com- + mand ``:fg [file]'' foregrounds the backgrounded screen that is + editing the specified file, or, by default, the first background + screen on the queue. The command ``:di[splay] s[creens]'' lists + the background screens. + + Shell screens + The command ``:sc[ript] [file ...]'' runs a shell in the screen. + Editing is unchanged, with the exception that a <carriage-return> + enters the current line (stripped of any prompt) as input to the + shell. + + Tag stacks + Tags are now maintained in a stack. The command ``^T'' returns + to the previous tag location. The command ``:tagpop [number + file]'' returns to the most recent tag location by default, or, + optionally to a specific tag number in the tag stack, or the most + recent tag from the specified file. Use the command ``:di[splay] + t[ags]'' to view the tags stack. The command ``:tagtop'' returns + + to the top of the tag stack. + + New displays + The command ``:di[splay] b[uffers] s[creens] t[ags]'' can be + used to display, respectively, the current cut buffers, the back- + grounded screens, and the tags stack. + + Infinite undo + The changes made during an edit session may be rolled backward + and forward. A '.' command immediately after a 'u' command con- + tinues either forward or backward depending on whether the 'u' + command was an undo or a redo. + + Usage information + The command ``:exu[sage] [cmd]'' and ``viu[sage] [key]'' provide + usage information for all of the ex and vi commands by default, + or, optionally, for a specific command or key. + + Extended regular expressions + The ``:set extended'' command treats search and other command + regular expressions as extended (egrep(1) style) regular expres- + sions. + + Word search + The command ``^A'' searches for the word referenced by the cur- + sor. + + Number increment + The command ``#'' increments the number referenced by the cursor. + + Previous file + The command ``:prev[ious][!]'' edits the previous file from the + argument list. + + Left-Right scrolling + The command ``:set leftright'' makes nnvvii do left-right screen + scrolling, instead of the traditional vvii line wrapping. + +RREECCOOVVEERRYY + There is no recovery program for nnvvii, nor does nnvvii run setuid. Users may + recover any file which they may read, and the superuser may recover any + edit session. + + Edit sessions are backed by files in _/_v_a_r_/_t_m_p_/_v_i_._r_e_c_o_v_e_r, and are named + ``vi.XXXX'', where ``XXXX'' is a number related to the process id. When + a file is first modified, a second file, which contains an email message + for the user, is created, and is named ``recover.XXXX'', where, again, + ``XXXX'' is associated with the process id. Both files are removed at + the end of a normal edit session, but will remain if the edit session is + abnormally terminated or the user enters the ex/vi ``preserve'' command. + The use of the _/_v_a_r_/_t_m_p directory may be changed setting the rreeccddiirr op- + tion in the user's or system startup information. + + The recovery directory should have the ``sticky-bit'' set so that only + the owners of files may remove them. If this is not possible on the sys- + tem, then a pseudo-user should own the recovery directory. The recovery + directory must be both read and write-able by any user. + + The recovery file has all of the necessary information in it to enable + the user to recover the edit session. In addition, it has all of the + necessary email headers for sendmail. When the system is rebooted, all + of the files in _/_v_a_r_/_t_m_p_/_v_i_._r_e_c_o_v_e_r named ``recover.XXXX'' should be sent + by email, using the --tt flag of sendmail (or a similar mechanism in other + mailers). A simple way to do this is to insert the following script into + + your _/_e_t_c_/_r_c_._l_o_c_a_l (or other startup) file: + virecovery=`echo /var/tmp/vi.recover/recover.*` + if [ "$virecovery" != "/var/tmp/vi.recover/recover.*" ]; then + echo 'Recovering vi editor sessions' + for i in $virecovery; do + sendmail -t < $i + done + fi + + If eexx//vvii receives a hangup (SIGHUP) signal, it will email the recovery + information to the user itself. + + If you don't have the sendmail program on your system, the source file + _n_v_i_/_r_e_c_o_v_e_r_._c will have to be modified to use your local mail delivery + programs. + +SSTTAARRTTUUPP IINNFFOORRMMAATTIIOONN + EExx//vvii interprets one of two possible environmental variables and reads up + to three of five possible files during startup. The variables and files + are expected to contain eexx commands, not vvii commands. In addition, they + are interpreted _b_e_f_o_r_e the file to be edited is read, and therefore many + eexx commands may not be used. Generally, any command that requires output + to the screen or that needs a file upon which to operate, will cause an + error if included in a startup file or environmental variable. + + First, the file _/_e_t_c_/_v_i_._e_x_r_c is read. Second, the environmental variable + NEXINIT (or the variable EXINIT, if NEXINIT isn't set) is interpreted. + Third, if neither NEXINIT or EXINIT was set, the file _$_H_O_M_E_/_._n_e_x_r_c (or + the file _$_H_O_M_E_/_._e_x_r_c, if _$_H_O_M_E_/_._n_e_x_r_c doesn't exist) is read. Fourth, + the file _._n_e_x_r_c (or the file _._e_x_r_c, if _._n_e_x_r_c doesn't exist) is read. + + Startup files will not be read if they are owned by anyone other than the + real user-id of the user running vvii, (or by ``root'' in the case of the + file _/_e_t_c_/_v_i_._e_x_r_c) or if they are writable by anyone other than the own- + er. Home directory startup files (i.e. _$_H_O_M_E_/_._n_e_x_r_c and _$_H_O_M_E_/_._e_x_r_c) + will not be read if the ``HOME'' environmental variable is not set. Lo- + cal startup files (i.e. _._n_e_x_r_c and _._e_x_r_c) will not be read if the eexxrrcc + option is turned off in the _/_e_t_c_/_v_i_._e_x_r_c, _$_H_O_M_E_/_._n_e_x_r_c, or _$_H_O_M_E_/_._e_x_r_c + files, or in the NEXINIT or EXINIT environmental variables. It is not an + error for any of the startup environmental variables or files not to ex- + ist. + + Because the eexx command set supported by nneexx//nnvvii is a superset of the com- + mand set supported by most historical implementations of eexx, nneexx//nnvvii can + use the startup files created for the historical implementations, but the + converse is often not true. + +SSIIZZIINNGG TTHHEE SSCCRREEEENN + The size of the screen can be set in a number of ways. EExx//vvii takes the + following steps until values are obtained for both the number of rows and + number of columns in the screen. + + 1. If the environmental variable LINES exists, it is used to specify + the number of rows in the screen. + 2. If the environmental variable COLUMNS exists, it is used to specify + the number of columns in the screen. + 3. The TIOCGWINSZ ioctl(2) is attempted on the standard error file de- + scriptor. + 4. The termcap entry is checked for the ``li'' entry (rows) and the + ``co'' entry (columns). + 5. The number of rows is set to 24, and the number of columns is set to + 80. + + If a window change size signal (SIGWINCH) is received, the same steps are + taken with the exception that the first two steps are skipped. + +RREEGGUULLAARR EEXXPPRREESSSSIIOONNSS AANNDD RREEPPLLAACCEEMMEENNTT SSTTRRIINNGGSS + Regular expressions are used in line addresses, as the first part of + ssuubbssttiittuuttee, gglloobbaall, and vvgglloobbaall commands, and in search patterns. + + The regular expressions supported by eexx and vvii are, by default, the Basic + Regular Expressions (BRE's) described in the IEEE POSIX Standard 1003.2. + The eexxtteennddeedd option causes all regular expressions to be interpreted as + the Extended Regular Expressions (ERE's) described by the same standard. + (See re_format(7) for more information. Generally speaking, BRE's are + ed(1) and grep(1) style regular expressions, and ERE's are egrep(1) style + regular expressions.) + + There are some special strings and characters that can be used in RE's: + 1. An empty RE (e.g. ``//'') is equivalent to the last RE used. + 2. The construct ``\<'' matches the beginning of a word. + 3. The construct ``\>'' matches the end of a word. + 4. The character ``~'' matches the replacement part of the last + ssuubbssttiittuuttee command. + + When the mmaaggiicc option is _n_o_t set, the only characters with special mean- + ings are ``^'' at the beginning of an RE, ``$'' at the end of an RE, and + the escaping character ``\''. The characters ``.'', ``*'', ``['', and + ``~'' are treated as ordinary characters unless preceded by a ``\''; when + preceded by a ``\'' they regain their special meaning. + + Replacement strings are the second part of a ssuubbssttiittuuttee command. + + The character ``&'' (or ``\&'' if the mmaaggiicc option is _n_o_t set) in the re- + placement string stands for the text matched by the RE that's being re- + placed. The character ``~'' (or ``\~'' if the mmaaggiicc option is _n_o_t set) + stands for the replacement part of the previous ssuubbssttiittuuttee command. + + The string ``\#'', where ``#'' is an integer value from 1 to 9, stands + for the text matched by the portion of the RE enclosed in the #'th set of + escaped parentheses, e.g. ``\('' and ``\)''. For example, + ``s/abc\(.*\)def/\1/'' deletes the strings ``abc'' and ``def'' from the + matched pattern. + + The strings ``\l'', ``\u'', ``\L'', and ``\U'' can be used to modify the + case of elements in the replacement string. The string ``\l'' causes the + next character to be converted to lowercase; the string ``\u'' behaves + similarly, but converts to uppercase. The strings ``\L'' causes charac- + ters up to the end of the string or the next occurrence of the strings + ``\e'' or ``\E'' to be converted to lowercase; the string ``\U'' behaves + similarly, but converts to uppercase. + + In vvii, inserting a <control-M> into the replacement string will cause the + matched line to be split into two lines at that point. + +SSEETT OOPPTTIIOONNSS + There are a large number of options that may be set (or unset) to change + the editor's behavior. This section describes the options, their abbre- + viations and their default values. + + In each entry below, the first part of the tag line is the full name of + the option, followed by any equivalent abbreviations. (Regardless of the + abbreviations, it is only necessary to use the minimum number of charac- + ters necessary to distinguish an abbreviation from all other commands for + it to be accepted, in nneexx//nnvvii. Historically, only the full name and the + official abbreviations were accepted by eexx//vvii. Using full names in your + startup files and environmental variables will probably make them more + portable.) The part in square brackets is the default value of the op- + tion. Most of the options are boolean, i.e. they are either on or off, + and do not have an associated value. + + + Options apply to both eexx and vvii modes, unless otherwise specified. + + For information on modifying the options or to display the options and + their current values, see the ``set'' command in the Ex Commands section. + altwerase [off] + VVii only. Change how vvii does word erase during text input. When + this option is set, text is broken up into three classes: alphabet- + ic, numeric and underscore characters, other non-blank characters, + and blank characters. Changing from one class to another marks the + end of a word. In addition, the class of the first character + erased is ignored (which is exactly what you want when erasing + pathname components). + autoindent, ai [off] + If this option is set, whenever you create a new line (using the vvii + AA, aa, CC, cc, II, ii, OO, oo, RR, rr, SS, and ss commands, or the eexx aappppeenndd, + cchhaannggee, and iinnsseerrtt commands) the new line is automatically indented + to align the cursor with the first non-blank character of the line + from which you created it. Lines are indented using tab characters + to the extent possible (based on the value of the ttaabbssttoopp option) + and then using space characters as necessary. For commands insert- + ing text into the middle of a line, any blank characters to the + right of the cursor are discarded, and the first non-blank charac- + ter to the right of the cursor is aligned as described above. + + The indent characters are themselves somewhat special. If you do + not enter more characters on the new line before moving moving to + another line, or entering <escape>, the indent character will be + deleted and the line will be empty. For example, if you enter + <carriage-return> twice in succession, the line created by the + first <carriage-return> will not have any characters in it, regard- + less of the indentation of the previous or subsequent line. + + Indent characters also require that you enter additional erase + characters to delete them. For example, if you have an indented + line, containing only blanks, the first <word-erase> character you + enter will erase up to end of the indent characters, and the second + will erase back to the beginning of the line. (Historically, only + the ^^DD key would erase the indent characters. Both the ^^DD key and + the usual erase keys work in nnvvii ..)) In addition, if the cursor is + positioned at the end of the indent characters, the keys ``0^D'' + will erase all of the indent characters for the current line, re- + setting the indentation level to 0. Similarly, the keys ``^^D'' + (i.e. a carat followed by a <control-D>) will erase all of the in- + dent characters for the current line, leaving the indentation level + for future created lines unaffected. + + Finally, if aauuttooiinnddeenntt is set, the SS and cccc commands change from + the first non-blank of the line to the end of the line, instead of + from the beginning of the line to the end of the line. + autoprint, ap [off] + EExx only. EExx only. Cause the current line to be automatically dis- + played after the eexx commands <<, >>, ccooppyy, ddeelleettee, jjooiinn, mmoovvee, ppuutt, + tt, UUnnddoo, and uunnddoo. This automatic display is suppressed during + gglloobbaall and vvgglloobbaall commands, and for any command where optional + flags are used to explicitly display the line. + autowrite, aw [off] + If this option is set, the vvii !! ^^^^ ^^]] and ^^ZZ commands, and the eexx + eeddiitt, nneexxtt, rreewwiinndd, ssttoopp, ssuussppeenndd, ttaagg, ttaaggppoopp, and ttaaggttoopp commands + automatically write the current file back to the current file name + if it has been modified since it was last written. If the write + fails, the command fails and goes no further. + + Appending the optional force flag ``!'' to the eexx commands nneexxtt, + rreewwiinndd, ssttoopp, ssuussppeenndd, ttaagg, ttaaggppoopp, and ttaaggttoopp stops the automatic + write from being attempted. + + + (Historically, the nneexxtt command ignored the optional force flag.) + Note, the eexx commands eeddiitt, qquuiitt, sshheellll, and xxiitt are _n_o_t affected + by the aauuttoowwrriittee option. + beautify, bf [off] + If this option is set, all control characters that are not current- + ly being specially interpreted, other than <tab>, <newline>, and + <form-feed>, are discarded from commands read in by eexx from command + files, and from input text entered to vvii (either into the file or + to the colon command line). Text files read by eexx//vvii are _n_o_t af- + fected by the bbeeaauuttiiffyy option. + cdpath [environment variable CDPATH, or ``.''] + This option is used to specify a colon separated list of directo- + ries which are used as path prefixes for any relative path names + used as arguments for the ccdd command. The value of this option de- + faults to the value of the environmental variable CDPATH if it is + set, otherwise to the current directory. For compatibility with + the POSIX 1003.2 shell, the ccdd command does _n_o_t check the current + directory as a path prefix for relative path names unless it is ex- + plicitly specified. It may be so specified by entering an empty + string or a ``.'' into the CDPATH variable or the option value. + columns, co [80] + The number of columns in the screen. Setting this option causes + eexx//vvii to set (or reset) the environmental variable COLUMNS. See the + SCREEN SIZING section for more information. + comment [off] + VVii only. If the first non-empty line of the file begins with the + string ``/*'', this option causes vvii to skip to the end of that C + comment (probably a terribly boring legal notice) before displaying + the file. + directory, dir [environment variable TMPDIR, or /tmp] + The directory where temporary files are created. The environmental + variable TMPDIR is used as the default value if it exists, other- + wise _/_t_m_p is used. + edcompatible, ed [off] + This option causes the presence or absence of gg and cc suffixes on + ssuubbssttiittuuttee commands to be remembered, and to be toggled by repeat- + ing the suffices. The suffix rr makes the substitution be as in the + ~~ command, instead of like the && command. + _T_h_i_s _o_p_t_i_o_n _i_s _n_o_t _y_e_t _i_m_p_l_e_m_e_n_t_e_d_. + errorbells, eb [off] + EExx only. Causes eexx error messages to be preceded by a bell. + _T_h_i_s _o_p_t_i_o_n _i_s _n_o_t _y_e_t _i_m_p_l_e_m_e_n_t_e_d_. + exrc, ex [off] + If this option is turned off in the system or $HOME startup files, + the local startup files are never read (unless they are the same as + the system or $HOME startup files). Turning it on has no effect, + i.e. the normal checks for local startup files are performed, re- + gardless. See the STARTUP INFORMATION section for more informa- + tion. + extended [off] + This option causes all regular expressions to be treated as POSIX + 1003.2 extended regular expressions (which are similar to historic + egrep(1) style expressions). + flash [on] + This option causes the screen to flash instead of beeping the key- + board, on error, if the terminal has the capability. + hardtabs, ht [8] + This option defines the spacing between hardware tab settings, i.e. + the tab expansion done by the operating system and/or the terminal + itself. As nneexx//nnvvii never writes tabs to the terminal, unlike his- + toric versions of eexx//vvii, this option does not currently have any + affect. + ignorecase, ic [off] + This option causes regular expressions, both in eexx commands and in + + searches, to be evaluated in a case-insensitive manner. + keytime [6] + The 10th's of a second eexx//vvii waits for a subsequent key to complete + a key mapping. + leftright [off] + VVii only. This option causes the screen to be scrolled left-right + to view lines longer than the screen, instead of the traditional vvii + screen interface which folds long lines at the right-hand margin of + the terminal. + lines, li [24] + VVii only. The number of lines in the screen. Setting this option + causes eexx//vvii to set (or reset) the environmental variable LINES. + See the Screen Sizing section for more information. + lisp [off] + VVii only. This option changes the behavior of the vvii ((, )), {{, }}, [[[[ + and ]]]] commands to match the Lisp language. Also, the aauuttooiinnddeenntt + option's behavior is changed to be appropriate for Lisp. + _T_h_i_s _o_p_t_i_o_n _i_s _n_o_t _y_e_t _i_m_p_l_e_m_e_n_t_e_d_. + list [off] + This option causes lines to be displayed in an unambiguous fashion. + Specifically, tabs are displayed as control characters, i.e. + ``^I'', and the ends of lines are marked with a ``$'' character. + magic [on] + This option is on by default. Turning the mmaaggiicc option off causes + all regular expression characters except for ``^'' and ``$'', to be + treated as ordinary characters. To re-enable characters individu- + ally, when the mmaaggiicc option is off, precede them with an ``\''. See + the REGULAR EXPRESSIONS AND REPLACEMENT STRINGS section for more + information. + matchtime [7] + VVii only. The 10th's of a second eexx//vvii pauses on the matching char- + acter when the sshhoowwmmaattcchh option is set. + mesg [on] + This option allows other users to contact you using the talk(1) and + write(1) utilities, while you are editing. EExx//vvii does not turn + message on, i.e. if messages were turned off when the editor was + invoked, they will stay turned off. This option only permits you + to disallow messages for the edit session. See the mesg(1) utility + for more information. + modelines, modeline [off] + If the mmooddeelliinneess option is set, eexx//vvii has historically scanned the + first and last five lines of each file as it is read for editing, + looking for any eexx commands that have been placed in those lines. + After the startup information has been processed, and before the + user starts editing the file, any commands embedded in the file are + executed. Commands are recognized by the letters ``e'' or ``v'' + followed by ``x'' or ``i'', at the beginning of a line or following + a tab or space character, and followed by a ``:'', an eexx command, + and another ``:''. This option is a security problem of immense + proportions, and should not be used under any circumstances. + _T_h_i_s _o_p_t_i_o_n _w_i_l_l _n_e_v_e_r _b_e _i_m_p_l_e_m_e_n_t_e_d_. + number, nu [off] + Precede each line displayed with its current line number. + open [on] + EExx only. If this option is not set, the ooppeenn and vviissuuaall commands + are disallowed. + optimize, opt [on] + VVii only. Throughput of text is expedited by setting the terminal + to no do automatic carriage returns when printing more than one + (logical) line of output, greatly speeding output on terminals + without addressable cursors when text with leading white space is + printed. + _T_h_i_s _o_p_t_i_o_n _i_s _n_o_t _y_e_t _i_m_p_l_e_m_e_n_t_e_d_. + paragraphs, para [IPLPPPQPP LIpplpipbp] + VVii only. Define additional paragraph boundaries for the {{ and }} + commands. The value of this option must be a character string con- + sisting of zero or more character pairs. + + In the text to be edited, the character string <newline>.<char- + pair>, (where <char-pair> is one of the character pairs in the op- + tion's value) defines a paragraph boundary. For example, if the + option were set to ``LaA ##'', then all of the following additional + paragraph boundaries would be recognized: + <newline>.La + <newline>.A<space> + <newline>.## + prompt [on] + EExx only. This option causes eexx to prompt for command input with a + ``:'' character; when it's not set, no prompt is displayed. + readonly, ro [off] + This option causes a force flag to be required to attempt to write + the file back to the original file name. Setting this option is + equivalent to using the --RR command line option, or editing a file + which lacks write permission. + recdir [/var/tmp/vi.recover] + The directory where recovery files are stored. + redraw, re [off] + VVii only. The editor simulates (using great amounts of output), an + intelligent terminal on a dumb terminal (e.g. during insertions in + visual mode the characters to the right of the cursor are refreshed + as each input character is typed). + _T_h_i_s _o_p_t_i_o_n _i_s _n_o_t _y_e_t _i_m_p_l_e_m_e_n_t_e_d_. + remap [on] + If this option is set, it's possible to define macros in terms of + other macros. Otherwise, each key is only remapped up to one time. + For example, if ``A'' is mapped to ``B'', and ``B'' is mapped to + ``C'', The keystroke ``A'' will be mapped to ``C'' if rreemmaapp is set, + and to ``B'' if it is not set. + remapmax [on] + If this option is set, a key may only be remapped 50 times. If it + is not set, a key may be remapped an infinite number of times, and + the editor can be placed into infinite loops. + report [5] + Set the threshold of the number of lines that need to be changed + before a message will be displayed to the user. The value is the + largest value about which the editor is silent, i.e. by default, 6 + lines must change before the user is notified. + ruler [off] + VVii only. Display a row/column ruler on the colon command line. + scroll, scr [window / 2] + Set the number of lines scrolled by the vvii commands ^^DD and ^^UU. + + Historically, the eexx zz command, when specified without a count, + used two times the size of the scroll value; the POSIX 1003.2 stan- + dard specified the window size, which is a better choice. + sections, sect [NHSHH HUnhsh] + VVii only. Define additional section boundaries for the [[[[ and ]]]] + commands. The sseeccttiioonnss option should be set to a character string + consisting of zero or more character pairs. In the text to be + edited, the character string <newline>.<char-pair>, (where <char- + pair> is one of the character pairs in the option's value), defines + a section boundary in the same manner that ppaarraaggrraapphh option bound- + aries are defined. + shell, sh [environment variable SHELL, or /bin/sh] + Select the shell used by the editor. The specified path is the + pathname of the shell invoked by the vvii !! shell escape command and + by the eexx sshheellll command. This program is also used to resolve any + shell meta-characters in eexx commands. + shiftwidth, sw [8] + Set the autoindent and shift command indentation width. This width + is used by the aauuttooiinnddeenntt option and by the <<, >>, and sshhiifftt com- + + mands. + showdirty [off] + VVii only. Display an asterisk on the colon command line if the file + has been modified. + showmatch, sm [off] + VVii only. This option causes vvii, when a ``}'' or ``)'' is entered, + to briefly move the cursor the matching ``{'' or ``(''. See the + mmaattcchhttiimmee option for more information. + showmode [off] + VVii only. This option causes vvii to display the strings ``Command'' + or ``Input'' on the colon command line, based on the current mode + of the editor. + sidescroll [16] + VVii only. Sets the number of columns that are shifted to the left + or right, when vvii is doing left-right scrolling and the left or + right margin is crossed. See the lleeffttrriigghhtt option for more infor- + mation. + slowopen, slow [off] + This option affects the display algorithm used by vvii, holding off + display updating during input of new text to improve throughput + when the terminal in use is slow and unintelligent. + _T_h_i_s _o_p_t_i_o_n _i_s _n_o_t _y_e_t _i_m_p_l_e_m_e_n_t_e_d_. + sourceany [off] + If this option is turned on, vvii historically read startup files + that were owned by someone other than the editor user. See the + STARTUP INFORMATION section for more information. This option is a + security problem of immense proportions, and should not be used un- + der any circumstances. + _T_h_i_s _o_p_t_i_o_n _w_i_l_l _n_e_v_e_r _b_e _i_m_p_l_e_m_e_n_t_e_d_. + tabstop, ts [8] + This option sets tab widths for the editor display. + taglength, tl [0] + This option sets the maximum number of characters that are consid- + ered significant in a tag name. Setting the value to 0 makes all + of the characters in the tag name significant. + tags, tag [tags /var/db/libc.tags /sys/kern/tags] + Sets the list of tags files, in search order, which are used when + the editor searches for a tag. + term, ttytype, tty [environment variable TERM] + Set the terminal type. Setting this option causes eexx//vvii to set (or + reset) the environmental variable TERM. + terse [off] + This option has historically made editor messages less verbose. It + has no effect in this implementation. See the vveerrbboossee option for + more information. + timeout, to [on] + If this option is set, eexx//vvii waits for a specific period for a sub- + sequent key to complete a key mapping (see the kkeeyyttiimmee option). If + the option is not set, the editor waits until enough keys are en- + tered to resolve the ambiguity, regardless of how long it takes. + ttywerase [off] + VVii only. This option changes how vvii does word erase during text + input. If this option is set, text is broken up into two classes, + blank characters and non-blank characters. Changing from one class + to another marks the end of a word. + verbose [off] + only. VVii historically bells the terminal for many obvious mis- + takes, e.g. trying to move past the left-hand margin, or past the + end of the file. If this option is set, an error message is dis- + played for all errors. + w300 [no default] + VVii only. Set the window size if the baud rate is less than 1200 + baud. See the wwiinnddooww option for more information. + w1200 [no default] + VVii only. Set the window size if the baud rate is equal to 1200 + + baud. See the wwiinnddooww option for more information. + w9600 [no default] + VVii only. Set the window size if the baud rate is greater than 1200 + baud. See the wwiinnddooww option for more information. + warn [on] + EExx only. This option causes a warning message to the terminal if + the file has been modified, since it was last written, before a !! + command. + window, w, wi [environment variable LINES] + This option determines the default number of lines in a screenful, + as written by the zz command. It also determines the number of + lines scrolled by the vvii commands ^^FF and ^^BB. The value of window + can be unrelated to the real screen size, although it starts out as + the number of lines on the screen (see the SCREEN SIZING section). + Setting the value of the wwiinnddooww option is the same as using the --ww + command line option. + + If the value of wwiinnddooww (as set by the wwiinnddooww, ww330000, ww11220000 or ww99660000 + options) is smaller than the actual size of the screen, large + screen movements will result in displaying only that smaller number + of lines on the screen. (Further movements in that same area will + result in the screen being filled.) This can provide a performance + improvement when viewing different places in one or more files over + a slow link. + wrapmargin, wm [0] + VVii only. If the value of wrapmargin is non-zero, vvii will break + lines, that are more than that number of characters long, into two + lines at the blank character closest to the value. If wrapmargin + is 0, or if there is no blank character upon which to break the + line, the line will not be broken. + wrapscan, ws [on] + This option causes searches to wrap around the end or the beginning + of the file, and back to the starting point. Otherwise, the end or + beginning of the file terminates the search. + writeany, wa [off] + If this option is set, file-overwriting checks that would usually + be made before the wwrriittee and xxiitt commands, or before an automatic + write (see the aauuttoowwrriittee option), are not made. This allows a + write to any file, provided the file permissions allow it. + +4.4BSD March 18, 1994 10 |