set.opt.roff

早期freebsd实现

editor was invoked, they will stay turned off.
This option only permits you to disallow messages for the edit session.
See the
.Xr mesg 1
utility for more information.
#endif
.It Li "modelines, modeline [off]"
#ifdef MANUAL
Read the first and last few lines of each file for
.Nm ex
commands.
#endif
#ifdef REFERENCE
If the
.Sy modelines
option is set,
.Nm ex/vi
has historically scanned the first and last five lines of each file as
it is read for editing, looking for any
.Nm \&ex
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
.Dq \&e
or
.Dq \&v
followed by
.Dq \&x
or
.Dq \&i ,
at the beginning of a line or following a tab or space character,
and followed by a
.Dq \&: ,
an
.Nm \&ex
command, and another
.Dq \&: .
This option is a security problem of immense proportions,
and should not be used under any circumstances.
#endif
.br
.Em "This option will never be implemented."
.It Li "number, nu [off]"
Precede each line displayed with its current line number.
.It Li "octal [off]"
Display unknown characters as octal numbers, instead of the default
hexadecimal.
.It Li "open [on]"
.Nm \&Ex
only.
If this option is not set, the
.Sy open
and
.Sy visual
commands are disallowed.
.It Li "optimize, opt [on]"
.Nm \&Vi
only.
#ifdef MANUAL
Optimize text throughput to dumb terminals.
#endif
#ifdef REFERENCE
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.
#endif
.br
.Em "This option is not yet implemented."
.It Li "paragraphs, para [IPLPPPQPP LIpplpipbp]"
.Nm \&Vi
only.
Define additional paragraph boundaries for the
.Sy \&{
and
.Sy \&}
commands.
#ifdef REFERENCE
The value of this option must be a character string consisting
of zero or more character pairs.
.Pp
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 paragraph boundary.
For example, if the option were set to
.Dq "LaA ##" ,
then all of the following additional paragraph boundaries would be
recognized:
.Bd -literal -offset indent -compact
<newline>.La
<newline>.A<space>
<newline>.##
.Ed
#endif
.It Li "prompt [on]"
.Nm \&Ex
only.
#ifdef MANUAL
Display a command prompt.
#endif
#ifdef REFERENCE
This option causes
.Nm \&ex
to prompt for command input with a
.Dq \&:
character; when it's not set, no prompt is displayed.
#endif
.It Li "readonly, ro [off]"
#ifdef MANUAL
Mark the file as read-only.
#endif
#ifdef REFERENCE
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
.Fl R
command line option, or editing a file which lacks write permission.
#endif
.It Li "recdir [/var/tmp/vi.recover]"
The directory where recovery files are stored.
.It Li "redraw, re [off]"
.Nm \&Vi
only.
#ifdef MANUAL
Simulate an intelligent terminal on a dumb one.
#endif
#ifdef REFERENCE
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).
#endif
.br
.Em "This option is not yet implemented."
.It Li "remap [on]"
#ifdef MANUAL
Remap keys until resolved.
#endif
#ifdef REFERENCE
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
.Dq \&A
is mapped to
.Dq \&B ,
and
.Dq \&B
is mapped to
.Dq \&C ,
The keystroke
.Dq \&A
will be mapped to
.Dq \&C
if
.Sy remap
is set, and to
.Dq \&B
if it is not set.
#endif
.It Li "remapmax [on]"
#ifdef MANUAL
Limit the number of times a key may be remapped.
#endif
#ifdef REFERENCE
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.
#endif
.It Li "report [5]"
#ifdef MANUAL
Set the number of lines about which the editor reports changes.
#endif
#ifdef REFERENCE
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.
#endif
.It Li "ruler [off]"
.Nm \&Vi
only.
Display a row/column ruler on the colon command line.
.It Li "scroll, scr [window / 2]"
#ifdef MANUAL
Set the number of lines scrolled.
#endif
#ifdef REFERENCE
Set the number of lines scrolled by the
.Nm \&vi
commands
.Sy \&^D
and
.Sy \&^U .
.Pp
Historically, the
.Nm ex
.Sy z
command, when specified without a count, used two times the size of the
scroll value; the POSIX 1003.2 standard specified the window size, which
is a better choice.
#endif
.It Li "sections, sect [NHSHH HUnhsh]"
.Nm \&Vi
only.
Define additional section boundaries for the
.Sy \&[[
and
.Sy \&]]
commands.
#ifdef REFERENCE
The
.Sy sections
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
.Sy paragraph
option boundaries are defined.
#endif
.It Li "shell, sh [environment variable SHELL, or /bin/sh]"
Select the shell used by the editor.
#ifdef REFERENCE
The specified path is the pathname of the shell invoked by the
.Nm \&vi
.Sy \&!
shell escape command and by the
.Nm \&ex
.Sy shell
command.
This program is also used to resolve any shell meta-characters in
.Nm \&ex
commands.
#endif
.It Li "shiftwidth, sw [8]"
Set the autoindent and shift command indentation width.
#ifdef REFERENCE
This width is used by the
.Sy autoindent
option and by the
.Sy \&< ,
.Sy \&> ,
and
.Sy shift
commands.
#endif
.It Li "showdirty [off]"
.Nm \&Vi
only.
Display an asterisk on the colon command line if the file has been modified.
.It Li "showmatch, sm [off]"
.Nm \&Vi
only.
#ifdef MANUAL
Note matching
.Dq \&{
and
.Dq \&(
for
.Dq \&}
and
.Dq \&)
characters.
#endif
#ifdef REFERENCE
This option causes
.Nm \&vi ,
when a
.Dq \&}
or
.Dq \&)
is entered, to briefly move the cursor the matching
.Dq \&{
or
.Dq \&( .
See the
.Sy matchtime
option for more information.
#endif
.It Li "showmode [off]"
.Nm \&Vi
only.
#ifdef MANUAL
Display the current editor mode (command or input).
#endif
#ifdef REFERENCE
This option causes
.Nm \&vi
to display the strings
.Dq Command
or
.Dq Input
on the colon command line, based on the current mode of the editor.
#endif
.It Li "sidescroll [16]"
.Nm \&Vi
only.
#ifdef MANUAL
Set the amount a left-right scroll will shift.
#endif
#ifdef REFERENCE
Sets the number of columns that are shifted to the left or right,
when
.Nm \&vi
is doing left-right scrolling and the left or right margin is
crossed.
See the
.Sy leftright
option for more information.
#endif
.It Li "slowopen, slow [off]"
#ifdef MANUAL
Delay display updating during text input.
#endif
#ifdef REFERENCE
This option affects the display algorithm used by
.Nm \&vi ,
holding off display updating during input of new text to improve
throughput when the terminal in use is slow and unintelligent.
#endif
.br
.Em "This option is not yet implemented."
.It Li "sourceany [off]"
#ifdef MANUAL
Read startup files not owned by the current user.
#endif
#ifdef REFERENCE
If this option is turned on,
.Nm \&vi
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 under any circumstances.
#endif
.br
.Em "This option will never be implemented."
.It Li "tabstop, ts [8]"
This option sets tab widths for the editor display.
.It Li "taglength, tl [0]"
#ifdef MANUAL
Set the number of significant characters in tag names.
#endif
#ifdef REFERENCE
This option sets the maximum number of characters that are considered
significant in a tag name.
Setting the value to 0 makes all of the characters in the tag name
significant.
#endif
.It Li "tags, tag [tags /var/db/libc.tags /sys/kern/tags]"
#ifdef MANUAL
Set the list of tags files.
#endif
#ifdef REFERENCE
Sets the list of tags files, in search order,
which are used when the editor searches for a tag.
#endif
.It Li "term, ttytype, tty [environment variable TERM]"
Set the terminal type.
#ifdef REFERENCE
Setting this option causes
.Nm ex/vi
to set (or reset) the environmental variable
.Ev TERM .
#endif
.It Li "terse [off]"
This option has historically made editor messages less verbose.
It has no effect in this implementation.
#ifdef REFERENCE
See the
.Sy verbose
option for more information.
#endif
.It Li "timeout, to [on]"
#ifdef MANUAL
Time out on keys which may be mapped.
#endif
#ifdef REFERENCE
If this option is set,
.Nm ex/vi
waits for a specific period for a subsequent key to complete a key
mapping (see the
.Sy keytime
option).
If the option is not set, the editor waits until enough keys are
entered to resolve the ambiguity, regardless of how long it takes.
#endif
.It Li "ttywerase [off]"
.Nm \&Vi
only.
#ifdef MANUAL
Select an alternate erase algorithm.
#endif
#ifdef REFERENCE
This option changes how
.Nm \&vi
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.
#endif
.It Li "verbose [off]"
.NM \&Vi
only.
#ifdef MANUAL
Display an error message for every error.
#endif
#ifdef REFERENCE
.Nm \&Vi
historically bells the terminal for many obvious mistakes, 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 displayed for all errors.
#endif
.It Li "w300 [no default]"
.Nm \&Vi
only.
Set the window size if the baud rate is less than 1200 baud.
#ifdef REFERENCE
See the
.Sy window
option for more information.
#endif
.It Li "w1200 [no default]"
.Nm \&Vi
only.
Set the window size if the baud rate is equal to 1200 baud.
#ifdef REFERENCE
See the
.Sy window
option for more information.
#endif
.It Li "w9600 [no default]"
.Nm \&Vi
only.
Set the window size if the baud rate is greater than 1200 baud.
#ifdef REFERENCE
See the
.Sy window
option for more information.
#endif
.It Li "warn [on]"
.Nm \&Ex
only.
This option causes a warning message to the terminal if the file has
been modified, since it was last written, before a
.Sy \&!
command.
.It Li "window, w, wi [environment variable LINES]"
#ifdef MANUAL
Set the window size for the screen.
#endif
#ifdef REFERENCE
This option determines the default number of lines in a screenful,
as written by the
.Sy \&z
command.
It also determines the number of lines scrolled by the
.Nm \&vi
commands
.Sy \&^F
and
.Sy \&^B .
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
.Sy window
option is the same as using the
.Fl w
command line option.
.Pp
If the value of
.Sy window
(as set by the
.Sy window ,
.Sy w300 ,
.Sy w1200
or
.Sy w9600
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.
#endif
.It Li "wrapmargin, wm [0]"
.Nm \&Vi
only.
#ifdef MANUAL
Break lines automatically when they reach the right-hand margin.
#endif
#ifdef REFERENCE
If the value of wrapmargin is non-zero,
.Nm \&vi
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.
#endif
.It Li "wrapscan, ws [on]"
#ifdef MANUAL
Set searches to wrap around the end or beginning of the file.
#endif
#ifdef REFERENCE
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.
#endif
.It Li "writeany, wa [off]"
#ifdef MANUAL
Turn off file-overwriting checks.
#endif
#ifdef REFERENCE
If this option is set, file-overwriting checks that would usually be
made before the
.Sy write
and
.Sy xit
commands, or before an automatic write (see the
.Sy autowrite
option), are not made.
This allows a write to any file, provided the file permissions allow it.
#endif
.El