Most options have two names -- a short name that is easy to type in, and a longer descriptive name. You can type in either name; they work equivalently. Elvis always outputs the longer name when it is listing values.
Each option accepts a specific type of value. The most common types are boolean, number, string, and one-of, but some options have weird types.
Each option serves as an attribute of something. The group of an option designates what it is an attribute of. For example, the "filename" option is an attribute of buffers; when you switch to a different buffer, it will have a different value for the "filename" option. Other options are attributes of windows, or display modes, etc. Here's a complete list:
.---------.-------------------------------------------------------. | GROUP | DESCRIPTION | |---------|-------------------------------------------------------| | buf | Attributes of buffers | | win | Attributes of windows | | syntax | Attributes of the "syntax" display mode | | x11 | Attributes of the "x11" user interface | | tcap | Attributes of the "termcap" user interface | | windows | Attributes of the "windows" user interface | | win32 | User interface attributes for the Win32 port | | global | Global options | | lp | Printing options | | user | User variables a - z (Global, useful in ex scripts) | ^---------^-------------------------------------------------------^You don't need to know an option's group to set that option. You can output the values of all options in a group by passing the group name followed by a question mark to the :set command. The following example outputs all of the attributes of the current buffer:
:set buf?
.---------------------.---------.--------.-----------------------------. | OPTION NAMES | TYPE | GROUP | DESCRIPTION | |---------------------|---------|--------|-----------------------------| | filename, file | String | buf | name of file in buffer | | bufname, buffer | String | buf | name of buffer | | bufid, bufferid | Number | buf | ID number of user buffer | | retain, ret | Boolean | buf | keep buffer in session file | | modified, mod | Boolean | buf | buffer differs from file | | edited, samename | Boolean | buf | buffer loaded from filename | | newfile, new | Boolean | buf | filename doesn't exist yet | | readonly, ro | Boolean | buf | don't overwrite filename | | defaultreadonly, dro| Boolean | global | assume all files readonly | | locked, lock | Boolean | win | prevent any alterations | | autowrite, aw | Boolean | global | save file before switching | | writeany, wa | Boolean | global | don't warn of existing file | | backup, bk | Boolean | global | make *.bak file before write| | undolevels, ul | Number | buf | number of undoable commands | | beautify, bf | Boolean | global | strip ctrl chars from files | ^---------------------^---------^--------^-----------------------------^The filename option stores the name of the text file whose text was initially loaded into the buffer. If no file name is known (e.g., for an internal buffer or a new, untitled buffer) then this will be an empty string. The :file command can be used to change the filename. Also, the filename is set automatically when you write the buffer out, if it had no filename before.
The bufname option stores the name of the buffer. Usually this will be the same as the filename, but it can be different. Every buffer has a bufname, even if it doesn't have a filename. The name of a buffer can be changed via the :buffer command.
For user buffers, the bufid option stores
a unique id number for each buffer.
Anyplace where you can use the (name) notation
to specify a buffer, you can also use (n)
as an abbreviation for the buffer whose bufid=n.
Also, for filenames you can use #n for the filename of
the buffer whose bufid=n.
The retain option indicates whether the buffer is intended to survive past the end of this elvis process. If this option is true and the tempsession option is false (":set retain notempsession") then elvis will allow you to exit even if this buffer hasn't been saved since its last change. When you restart the session, the buffer will still exist with all its changed text intact. By default, the retain option is false (":set noretain") because that mimics traditional vi behavior.
The modified option indicates whether the buffer has been modified since the last time it was written out completely.
The edited option indicates whether the filename option has been modified since the last time it was written out. If this option is false, elvis will be more cautious about writing the file out.
The newfile option indicates that when the buffer was created it tried to load the file identified by the filename option, but that file did not exist at that time.
The readonly option indicates that when the buffer was loaded, the original file was marked as being unwritable. Either that, or the defaultreadonly option was set to true (probably via the -R command line flag). This option has two purposes: it gives you a way to detect that you can't write the file out, and it protects you from writing out a file that you meant to just look at without modifying.
The locked option prevents you from modifying the buffer. Nearly any command which would modify the buffer will fail. The only exceptions are "undo" commands, and commands such as :e which merely reload the buffer from its original file.
Setting the autowrite option allows elvis to automatically write the current buffer out to a file if it has been modified, before switching to another buffer. By default this option is off, so if you try to switch away from a modified buffer, elvis will just give an error message and refuse to switch until you manually write the file out.
Elvis tries to save you from accidentally clobbering existing files. Setting the writeany option disables this protection; elvis will allow you to overwrite any file that the operating system will allow, without giving any warnings.
The backup option isn't used internally by elvis, but the default elvis.bwf file checks this flag to determine whether it should attempt to make a backup of a file it is about to overwrite. By default, this option is false, so backups will not be made.
For each buffer, the undolevels option indicates the number of "undo" versions elvis will maintain. Each undo level requires at least three blocks of the session file (typically 2K bytes each, 6K total) so you probably don't want to set this higher than 100 or so, and you probably want to keep it much lower. The default is 0, which is a special case that mimics vi's traditional behavior.
If the beautify option is true, then whenever elvis reads text from a file or external program, it will strip any control characters other than tab, linefeed or formfeed. This is false by default.
.---------------------.---------.--------.-----------------------------. | OPTION NAMES | TYPE | GROUP | DESCRIPTION | |---------------------|---------|--------|-----------------------------| | readeol, reol | One of | buf | newline mode when reading | | writeeol, weol | One of | global | newline mode when writing | | bufchars, bc | Number | buf | number of characters | | buflines, bl | Number | buf | number of lines | | partiallastline, pll| Boolean | buf | file didn't end with newline| | errlines | Number | buf | buflines when :make was run | | internal | Boolean | buf | elvis requires this buffer | | putstyle, ps | One of | buf | type of text in a cut buffer| ^---------------------^---------^--------^-----------------------------^The readeol option determines how elvis reads the file into a buffer. It can be one of the following:
The writeeol option influences how elvis writes buffers out to a
file.
If a buffer's readeol option is set to "binary", then the value of
writeeol is ignored for that buffer; the file will be written in binary.
Otherwise it can be one of the following to determine the output format:
readeol option is used to control the output format.
The bufchars and buflines options indicate the number of characters and lines in the buffer, respectively. The buflines option works by counting newline characters; it is unaffected by vagaries of the display mode. These options can't be set.
The partiallastline option indicates whether the file's last line
ended with a newline.
Text files should always end with a newline.
Traditionally, when vi loaded a file that contained a partial last line,
it would append a newline to the edit buffer to complete that last line.
The extra newline would be written out when the buffer was saved to a file.
That's great for vi, but elvis can edit binary files as well as text, and
appending newlines onto binary files could cause some problems.
So elvis appends a newline just like vi, but also sets the
partiallastline option to remind itself that when the buffer
is saved in binary mode, the last newline should be omitted.
Also, the hex display mode is smart enough
to hide the added newline when this option is set.
The errlines option is used to store the number of lines that were in the buffer when the last :make or :cc command was run. Any difference between buflines and errlines is used to adjust the line numbers reported in any error messages, to compensate for lines which have been inserted or deleted since then.
The internal option indicates that elvis uses the buffer internally. Such buffers can't be deleted.
The putstyle option is only relevant for cut buffers. It indicates whether the cut buffer contains characters, whole lines, or a rectangular area. It is set automatically whenever you yank or cut text into a cut buffer; when you put (paste) the contents of that buffer, elvis checks the value of this option to determine how the text should be inserted into your edit buffer.
.---------------------.---------.--------.-----------------------------. | OPTION NAMES | TYPE | GROUP | DESCRIPTION | |---------------------|---------|--------|-----------------------------| | matchchar, mc | String | global | characters matched by % | | paragraphs, para | String | buf | nroff paragraph commands | | sections, sect | String | buf | nroff section commands | | sentenceend, se | String | global | punct at end of sentence | | sentencequote, sq | String | global | punct allowed after se | | sentencegap, sg | Number | global | spaces required after sq | | scroll, scr | Number | win | scroll amount for ^D/^U | ^---------------------^---------^--------^-----------------------------^The matchchar option stores a list of matching character pairs, for use by the % visual command. In each pair, the first character should be an opening parenthesis (or whatever) and the second character should be the corresponding closing parenthesis. If both characters are identical, then the % command will try to guess whether it should search forward or backward. The default value is
mc=[]{}(), but you may wish to add
:set mc=[]{}()<>\"\" to your ~/.exrc (or ~/elvis.rc) file.
The paragraphs option stores a list of
two-letter nroff paragraph commands. This list is used by the
{
and } movement commands.
Similarly, the sections option stores a list
of section commands, affecting the [[ and
]] commands.
Their defaults are paragraphs="PPppIPLPQP" and
sections="NHSHSSSEse".
The sentenceend, sentencequote, and sentencegap options
all affect the ( and
) sentence motion commands.
The sentenceend option is a list of punctuation characters which can appear
at the end of a sentence. The sentencegap option is the number spaces that
must follow a sentenceend character in order for it to count as the end of a
sentence. The sentencequote option is a list of punctuation characters that
can appear between the sentenceend character and the spaces.
Their defaults are sentenceend="?!.", sentencequote=")\"",
and sentencegap=2, which meets the proposed POSIX specifications.
The scroll option indicates the number of lines that the ^U and ^D commands should scroll the screen by. Its default value is 12.
.---------------------.---------.--------.-----------------------------. | OPTION NAMES | TYPE | GROUP | DESCRIPTION | |---------------------|---------|--------|-----------------------------| | autoindent, ai | Boolean | buf | auto-indent new text | | inputtab, it | One-Of | buf | input mode's (Tab) key | | smarttab, sta | Boolean | global | if indenting, (Tab) shifts | | completebinary, cob | Boolean | global | complete names of binaries? | | autotab, at | Boolean | buf | allow autoindent to use '\t'| | tabstop, ts | Number | buf | width of tabstop columns | | shiftwidth, sw | Number | buf | width used by < and > | | textwidth, tw | Number | buf | width for word-wrap, or 0 | | wrapmargin, wm | (weird) | win | set textwidth from right | | digraph, dig | Boolean | global | allow X-backspace-Y entry | ^---------------------^---------^--------^-----------------------------^Setting the autoindent option causes elvis to automatically insert whitespace at the start of each line, to make it line up with the preceding line. This is convenient when you're editing C source code. It is off by default.
The inputtab option controls the behavior of the Tab key. It can be set to one of the following values:
filename setting can make.
It can also complete ex command names, tag names, option names,
and option values.
This is the default for the (Elvis ex history) buffer,
which is used for entering in ex commands.
The smarttab option only affects the
behavior of the Tab key in input mode,
when the cursor is in the indentation portion of a line
-- before the first nonwhitespace character.
If this option is true, then Tab is treated like ^T,
so the line is shifted rightward by one shiftwidth.
By default this option is false, so the Tab key is treated normally
(in accordance with the The completebinary option controls
whether binary files are included in the list of possible filename completions.
The default setting is nocompletebinary, so binary files are
omitted.
This is handy when you're editing source code -- if your directory contains
"foo.c" and "foo.o" (or "FOO.OBJ" in the Land of the Lost), then typing
f-o-o-TAB will complete the "foo.c" name.
The autotab option affects the behavior of the < and > operator commands, and the ^D and ^T input mode keystrokes. If autotab is true then elvis will include tab characters in the indentation whitespace; if it is false then the indentation whitespace will consist entirely of space characters. By default, it is true.
Note that if you start with a buffer which contains no tabs, and do a
":set inputtab=spaces noautotab" then no amount of editing will
result in the buffer containing tabs... unless you get tricky with
^V or something.
The tabstop option affects the way tab characters are displayed, by specifying how far apart the tab stops should be located. When elvis displays a file with tabs, it displays the tabs as a variable number of spaces. You should probably leave this option at its default value (8) since changing this will make your file look strange in any other context. If you want to use indentation levels of less than 8 characters, you're better off changing shiftwidth.
The shiftwidth option indicates how far left or right the < and > operator commands (and the ^D and ^T input mode keystrokes) should shift the line of text. This is used for adjusting the indentation of lines.
When editing a text file in "normal" display mode, the textwidth option can be used to cause word-wrap to occur when a line gets too long. The default value of textwidth is 0, which disables automatic word-wrap. Setting it to any larger value causes word-wrap to occur when text is inserted into a line, causing that line to become wider than textwidth columns. (Note that this has nothing to do with the display formatting of the "html" and "man" display modes.)
The wrapmargin option is provided for
backwards compatibility.
It allows you to set the textwidth relative to the right edge of the window,
instead of the left edge.
This option's value is actually derived from the textwidth option's value
and the window's width,
so if you resize a window this option's value will appear to change to
correspond to the new width; textwidth will not change.
Digraphs allow you to enter non-ASCII characters as a combination of two ASCII characters. There are two ways to enter digraphs: ^K X Y and X backspace Y. The second form can cause some confusion if you're not expecting it, so the digraph option was created as a way to disable that second form. The first form of digraphs is always available. This option is false by default, to avoid the confusion.
.---------------------.---------.--------.-----------------------------. | OPTION NAMES | TYPE | GROUP | DESCRIPTION | |---------------------|---------|--------|-----------------------------| | prompt | Boolean | global | issue ":" prompt in ex mode | | autoprint, ap | Boolean | global | print current line in ex | | report | Number | global | minimum # lines to report | | optionwidth, ow | Number | global | widths of ":set all" values | ^---------------------^---------^--------^-----------------------------^The prompt option controls whether a ":" prompt is issued before reading each command line in EX mode. It is true by default, and should usually be left that way.
The autoprint option causes elvis to display the current line of the edit buffer in certain circumstances, while you're in EX mode. It is true by default.
The report option determines the minimum
number of lines that must change in a file, before elvis will bother to
display a count of the changed lines.
As a special case, if report=0 then it won't report any changes,
or failed :s/old/new/ commands.
Its default value is 5, so small changes won't be reported but big ones will.
optionwidth sets a limit on
how wide a single option can be when output by a ":set" or ":set all" command.
Limiting the widths is a good idea, because otherwise a single option that
has a long value could force the output to use fewer columns, forcing
some options scrolling off the top of the screen before you can read them.
The ":set" command likes to leave at least two spaces after each column.
The default value is optionwidth=24,
which guarantees that at least 3 columns can fit on an 80-character terminal, since 80/(24+2)=3.
Note that optionwidth has no effect on options that you explicitly
name in a ":set" command; for example, ":set tags?" will
show you the entire tag path regardless of the value of
optionwidth.
.---------------------.---------.--------.-----------------------------. | OPTION NAMES | TYPE | GROUP | DESCRIPTION | |---------------------|---------|--------|-----------------------------| | windowid, id | Number | win | ID number of current window | | columns, cols | Number | win | width of window | | lines, rows | Number | win | height of window | ^---------------------^---------^--------^-----------------------------^The windowid option stores the ID number of the current window. These window IDs are listed by the :buffer command. Some GUIs may also display the window ID as part of the window's title. This value is set to a unique value automatically when the window is created. You can't change it.
The columns and lines options indicate the size of the window.
.---------------------.---------.--------.-----------------------------. | OPTION NAMES | TYPE | GROUP | DESCRIPTION | |---------------------|---------|--------|-----------------------------| | list, li | Boolean | win | show markups, newlines, etc.| | showmarkups, smu | Boolean | global | show markup at cursor | | bufdisplay, bd | String | buf | default display mode | | display, mode | String | win | name of current display mode| | number, nu | Boolean | win | display line numbers | | ruler, ru | Boolean | win | display cursor's line/column| | showcmd, sc | Boolean | win | display command characters | | showmatch, sm | Boolean | win | highlight matching parens | | showmode, smd | Boolean | win | display the command state | | showname, snm | Boolean | global | display the buffer name | | showtag, st | Boolean | global | display tag on status line | | nonascii, asc | One-Of | global | how to display non-ascii | | showstack, sstk | Boolean | win | display some debugging info | ^---------------------^---------^--------^-----------------------------^In the "normal" or "syntax" display modes, the list option causes tab characters to be shown as ^I instead of being expanded to the appropriate amount of whitespace, and it causes the end of each line to be marked with a $ character. In "html" or "man" mode, it causes all of the markups to be displayed.
In "html" or "man" mode, the showmarkups option causes the markup at the cursor to be displayed, but leaves other markups hidden. It has no effect in other display modes. This option is off by default, so markups won't suddenly become visible as you move the cursor around.
Each buffer has a bufdisplay option, which indicates that buffer's preferred display mode. Whenever a window starts to show a buffer, it switches its display mode to that buffer's bufdisplay mode. You should set bufdisplay to the name of a supported display mode: normal, syntax, html, man, tex, or hex. The compiled-in default is normal but the standard elvis.arf file tries to choose a more clever default, based on the extension of the buffer's filename.
The display option indicates which display mode the window is currently in. You can't set this option directly; you must use the :display command instead.
The number option causes a line number to be prepended to the start of each line. The line numbers are defined as "one plus the number of newlines preceding the start of the line," which is not necessarily how the current display mode defines lines. Consequently, the line numbers may not increment by 1 every time. These line numbers do correspond to the ruler and the visual G command, though. This option is false by default.
The ruler option causes the current line number and column number to be displayed at the bottom of the screen. This uses the same definition of "line number" as the number option, above. This option is false by default.
When entering multi-character commands, the showcmd option causes the preceding characters of the command to be displayed at the bottom of the window.
The showmatch option helps you locate matching parentheses. When you're in input mode, and you type a ), ], or } character, elvis will cause the matching (, [, or { character to be highlighted on the screen. This option is false by default.
The showmode option causes elvis to display a one-word label for its current parse state in the lower right-hand corner of the window. Usually, this will be either "Command" or "Input". This option is false by default, but I suggest you make it true because it really is handy.
The showname option causes elvis to display the buffer name on the bottom row of each window, unless it has something else to show there such as an error message.
The showtag option causes elvis to display (on the bottom row of each window) the name of the tag being defined at the cursor's position. Usually, this means it tells you the name of the function you're editing. When this option is true, each time you load a text file into an edit buffer elvis will scan the "tags" file for any tags which are defined in the text file. Elvis builds a table of those tags, and stores it in RAM for the sake of speed. Then, each time the window is updated, elvis will compare the cursor position to the definition lines of each tag, and display the name of the last tag it found which is defined at or before the cursor position. By default, this option is false because the tag loading can be slow.
The version of ctags distributed with elvis has a "-l" flag which causes it to generate "ln" hints, which give the line number where the tag is defined. Elvis can use these hints to greatly accelerate the loading of tags when you switch files. The "-l" option is enabled by default if you don't give any flags, so you don't need to give it explicitly unless you're also giving some other flags.
NOTE: The MS-DOS version of elvis is normally configured to
omit the showtag option, because memory is tight in the lower 640K.
The nonascii option tells elvis how to display characters 0x80 through 0xff. It can have one of the following values:
.-------.------------------------------------------------. | VALUE | MEANING | |-------|------------------------------------------------| | all | All characters 0x80-0xff are visible | | most | Chars 0xa0-0xff are visible, but not 0x80-0x9f | | none | Chars 0x80-0xff are not visible | | strip | Convert 0xa0-0xfe to ASCII; others not visible | ^-------^------------------------------------------------^Any characters which aren't visible will be displayed as '.' characters. Note that this only affects the way the characters are displayed; they are actually stored with their true 8-bit value. The default value of
nonascii is "most", because that is the correct
value for the Latin-1 symbol set.
The showstack option causes some debugging output to appear on the bottom row of the window. It is false by default, and you should leave it that way.
.---------------------.---------.--------.-----------------------------. | OPTION NAMES | TYPE | GROUP | DESCRIPTION | |---------------------|---------|--------|-----------------------------| | commentfont, cfont | One-Of | syntax | font used for comments | | stringfont, sfont | One-Of | syntax | font used for strings | | keywordfont, kfont | One-Of | syntax | font used for reserved words| | functionfont, ffont | One-Of | syntax | font used for function names| | variablefont, vfont | One-Of | syntax | font used for variables | | prepfont, pfont | One-Of | syntax | font used for preprocessor | | otherfont, ofont | One-Of | syntax | font used for other symbols | | includepath, inc | String | syntax | where to find #include files| ^---------------------^---------^--------^-----------------------------^In the syntax display mode, the commentfont, stringfont, keywordfont, functionfont, variablefont, prepfont and otherfont options specify which font is to be used for different parts of the source code. Each option can be set to normal, bold, emphasized, italic, underlined, or fixed. The prepfont is used for preprocessor directives. The keywordfont is used for reserved words such as "int" and "return". The functionfont is used for any other word which is followed by an opening parenthesis character. The otherfont is used for any other word which matches some language-dependent criteria; for C, the word must either contain no lowercase letters or end with a "_t" (probably a constant or a user-defined type). The variablefont is used for all other words. Punctuation is always in the normal font; you can't control that.
You can set these variables during initialization, in the .exrc or elvis.rc file. After that, your window must actually be in the "syntax" mode for these to be accessible.
As a separate step, some user interfaces allow you to specify a color to be used for each font, via the :color command.
The includepath option contains a list of directory names where elvis should look for #include files. When you look up a tag whose name begins with a quote character, elvis searches through those directories for a file with the same name as the tag (with the quotes stripped off). This means that you can move the cursor onto a #include file name, hit ^], and have elvis load the indicated header file.
.---------------------.---------.--------.-----------------------------. | OPTION NAMES | TYPE | GROUP | DESCRIPTION | |---------------------|---------|--------|-----------------------------| | terse, te | Boolean | global | don't translate messages | | verbose | Numeric | global | give more status messages | | errorbells, eb | Boolean | global | ring bell for error message | | warningbells, wb | Boolean | global | ring bell for warning msg | | flash, vbell | Boolean | global | substitute flash for bell | ^---------------------^---------^--------^-----------------------------^The terse option indicates whether elvis should attempt to translate messages via the elvis.msg file. If terse is true, then no such translation takes place; the built-in messages are used. If terse is false, then elvis will search through the file (actually the "Elvis messages" buffer) for a line which looks like "terse:verbose" and if found it'll use the verbose version instead. By default, terse is false.
The verbose option has nothing to do with
the terse option.
Instead, it indicates the number of -V flags given when elvis
was invoked.
Larger values indicate that the user wants more status messages to be generated.
This is handy when elvis isn't initializing itself the way you expected it to;
elvis' initialization code frequently tests the value of verbose
and automatically writes status messages when verbose is set to
a high enough level.
Values normally range from 0 (no extra output) to 9 (maximum output).
The errorbells and warningbells options cause the terminal's bell to ring when an error message or warning message is generated, respectively. By default the errorbells option is true, and the warningbells option is false.
Setting the flash option causes elvis to use a visible alternative to the bell, if one exists. This is nice in a crowded terminal room. By default this option is false.
.---------------------.---------.--------.-----------------------------. | OPTION NAMES | TYPE | GROUP | DESCRIPTION | |---------------------|---------|--------|-----------------------------| | true, True | String | global | locale's True value | | false, False | String | global | locale's False value | | submit, Submit | String | x11 | locale's Submit label | | cancel, Cancel | String | x11 | locale's Cancel label | | help, Help | String | x11 | locale's Help label | ^---------------------^---------^--------^-----------------------------^These options store words, which are translated via the elvis.msg file when elvis starts up. The default versions of all of them are their capitalized English names.
The true and false options exist primarily to allow the
english words true and false to be used
in expressions to represent Boolean literals. Also, the value of
false is used as an alternative false string, in addition
to "", "0", or "false". (In a Boolean context, any string that isn't false
is considered to be true, so elvis never compares a string to the
true option's value.) A Boolean option will return the value
of either the true or false option, as appropriate.
If you're using the "x11" user interface, then values of the submit
and cancel options are used as the labels for the [Submit] and [Cancel]
buttons in a dialog. Also, if the dialog contains any Boolean options, the
value will be displayed using values of the true and
false options.
Currently the help option does nothing. Eventually I expect to add
pull-down menus to the "x11" interface, though, and in Motif menu bars
the "Help" menu traditionally appears on the far right edge. The value of
the help option will allow elvis to recognize the "Help" menu.
.---------------------.---------.--------.-----------------------------. | OPTION NAMES | TYPE | GROUP | DESCRIPTION | |---------------------|---------|--------|-----------------------------| | term, ttytype | String | tcap | terminal's termcap entry | | ttyrows, ttylines | Number | tcap | height of screen | | ttycolumns, ttycols | Number | tcap | width of screen | | ttyunderline, ttyu | Boolean | tcap | okay to mix color & underln | | codepage, cp | Number | win32 | console character set | |---------------------|---------|--------|-----------------------------| | scrollbar, sb | Boolean | (gui) | enable the scrollbar | | toolbar, tb | Boolean | (gui) | enable the toolbar | | statusbar, stb | Boolean | (gui) | enable the statusbar | |---------------------|---------|--------|-----------------------------| | menubar, mb | Boolean | windows| enable the menubar | | font, fnt | String | windows| base font | | normalstyle, nfn | String | windows| n or combination of b/i/u | | boldstyle, bfn | String | windows| n or combination of b/i/u | | italicstyle, ifn | String | windows| n or combination of b/i/u | | fixedstyle, ffn | String | windows| n or combination of b/i/u | | emphasizedstyle, efn| String | windows| n or combination of b/i/u | | underlinedstyle, nfn| String | windows| n or combination of b/i/u | |---------------------|---------|--------|-----------------------------| | normalfont, xfn | String | x11 | name of normal font | | boldfont, xfb | String | x11 | name of bold font | | italicfont, xfi | String | x11 | name of italic font | | controlfont, xfc | String | x11 | name of toolbar font | | underline, uln | Boolean | x11 | enables underlining | | toolbar, xtb | Boolean | x11 | enables the toolbar | | scrollbarleft, xsl | Boolean | x11 | enable scrollbar on side | | scrollbarwidth, xsw | Number | x11 | size of scrollbar, in pixels| | scrollbartime, xst | Number | x11 | delay for scrollbar repeat | | borderwidth, xbw | Number | x11 | size of text area's border | | dblclicktime, xdct | Number | x11 | double-click speed, 1/10 Sec| | blinktime, xbt | Number | x11 | cursor blink rate, 1/10 Sec | | textcursor, tc | Number | x11 | one of hollow, opaque, xor | | xrows, xlines | Number | x11 | height of new windows | | xcolumns, xcols | Number | x11 | width of new windows | | firstx, xpos | Number | x11 | horiz. position of first win| | firsty, ypos | Number | x11 | vert. position of first win | | stagger | Number | x11 | offset for next new window | | icon | Boolean | x11 | use the built-in icon? | | stopshell, ssh | String | x11 | interactive shell command | | autoiconify, aic | Boolean | x11 | iconify old window | | altkey, metakey | One of | x11 | effect of the Alt key | | focusnew, fn | Boolean | x11 | force focus into new window | | warpto, wt | One of | x11 | ^W^W forces pointer movement| | warpback, xwb | Boolean | x11 | upon exit, point to xterm | | outlinemono, om | Number | x11 | char outlining for X11-mono | ^---------------------^---------^--------^-----------------------------^
The term, ttyrows, ttycolumns, and ttyunderline options are only present if you're using the termcap user interface. They indicate the name of the termcap entry being used (normally taken from the TERM environment variable), the size of the screen, and whether it is safe to try underlining text when colors have been assigned to fonts. The ttyunderline option is true by default, but it should be made false on the Linux console, because the console driver has a bug which prevents underlined text from being shown in color.
The codepage option only exists in the Win32 version with the termcap interface (WindowsNT or Windows95, in console mode). It indicates which code page (character map) the console is using. Its value is persistent; if you change it in elvis, the console will remain changed even after you exit elvis. Changing the code page has no effect on the digraph table, or elvis' idea of which non-ASCII characters are printable or should be treated as letters; it only reconfigures the console driver. Typical values are 437 for the standard IBM PC character set, and 850 for extra European characters.
The scrollbar, toolbar, and statusbar options indicate whether the scrollbar, toolbar, and statusbar should be visible, respectively. By default, all are are visible.
The menubar option indicates whether the menu bar should be visible. By default, it is visible.
The font option stores the name of the base font. The easiest way to set it is via the "Options->Font" menu item.
The normalstyle, boldstyle, italicstyle,
fixedstyle, emphasizedstyle, and underlinedstyle
options determine how elvis will derive each of its fonts from the base font.
The values of these options are strings. If the string is "n" then the
base font is used unmodified. Other possibilities are any combination of
"b" for bold, "i" for italic (slanted), and "u" for underlined. For example,
":set ufn=bu" causes elvis' underlined font to be drawn
in bold with an underline.
The other options all apply to the x11 interface. The normalfont, boldfont, and italicfont options control the X fonts used for displaying text. Typically, the elvis.ini or ".exrc" file will set these. If you do choose to set them in one of these files, be sure to have your initialization script check which interface is being used because if elvis is using the termcap interface then these x11 options won't exist. These options all default to an empty string; this is a special case which causes elvis to use the "fixed" font for normal text, and to derive the bold and italic fonts from the normal font.
The controlfont option determines which font is used for displaying the labels of toolbar buttons, and also the statusbar. Unlike the other fonts, this one is permitted to have a variable pitch. If it is unset, then elvis will use the font named "variable" by default.
The underline option determines whether characters in the "underlined" font should be displayed as underlined. Normally, underline is true, so they are underlined. Setting nounderline will cause them to be displayed as normal characters, but in the color of underlined text.
The toolbar option controls whether the toolbar is visible or not. It is normally true, which makes the toolbar visible. The toolbar can be configured via the :gui command.
The statusbar option controls the visibility of the statusbar. It is true by default, which makes the statusbar is visible. The statusbar always displays the information which would otherwise be shown on the bottom row of the text area only when the ruler and showmode options were true. When you press a toolbar button, the button's one-line description is shown on the statusbar.
The scrollbarleft option determines which side of the window the scrollbar will be drawn on. This option is false by default, so the scrollbar appears on the right side of the window. Making it true will cause the scrollbar to be drawn on the left.
The scrollbarwidth option controls the size of the x11 scrollbar. The default value is 14 pixels, and the allowed range is 5 to 40 pixels.
The scrollbar buttons automatically repeat if you hold a mouse button down scrollbartime tenths of a second. The default is 4 tenths of a second.
The main text area of a window looks better when the characters aren't drawn immediately adjacent to the edge. The borderwidth option allows you to specify how many pixels should be left blank between a character and any edge of the text area. The default is 1 pixel.
The dblclicktime option allows you to adjust the speed of mouse double-clicks to match your own clicking habits. The default is 3 tenths of a second.
The blinktime option controls the cursor blink rate. If set to 0, the cursor will not blink. If set to a value from 1 to 10, then the cursor will first be visible for that many tenths of a second, and then invisible for the same amount of time. The cursor will only blink in the window which currently has keyboard focus.
The textcursor option controls the way the block text cursor is drawn. It can be xor, hollow, or opaque. The default is xor, which causes the cursor to be drawn as a filled rectangle with the XOR bitblt function. This converts the background color to the cursor color, and the foreground color to an unpredictable color; hopefully the foreground color will contrast with the cursor color well enough to allow you to discern what the underlying character is. The hollow cursor style causes the cursor to be drawn as an unfilled rectangle. This allows you to easily see the underlying character, and detect whether it is highlighted or not. The opaque cursor style draws a filled rectangle, which is easier to locate but you can only see the underlying character between blinks.
The xrows and xcolumns options control the initial size of windows. They default to 34 and 80, respectively, and can also be set via the -geometry command-line flag. After a window has been created, you can use your window manager to resize the window.
The firstx and firsty options, if set, control the position of the first window that elvis creates. If they are unset, then elvis doesn't specify a position for the window. The -geometry command-line flag can be used to set these options. After the first window has been created, if the stagger option is set to a non-zero value then any new windows are created that many pixels down and to the right of the current window. If stagger is zero, then elvis won't specify a position for the new windows, so the window manager can choose the location itself.
The icon option can only be set in an initialization file such as elvis.ini or ".exrc"; once the first window has been created it is too late to change it. This option controls whether the window will be given the default, built-in icon. It is true by default, so windows will get the icon. This is usually a good thing. Some window managers don't allow you to override built-in icons, though, so if you want your window manager to use a different icon for elvis then you'll need to have a "set noicon" in your elvis.ini file.
The stopshell option stores a command which runs an interactive shell. It is used for the :shell and :stop ex commands, and the ^Z visual command. Normally, this is set to "xterm &" so you get a shell in a window. The "&" at the end of the command allows elvis to continue responding to user input while the shell is running.
When the ^W^W visual command switches keyboard control to an X11 window which as been iconified, elvis automatically deiconifies it. When it does this, if the autoiconify option is set then elvis will iconify the previl | locale's True value | | false, False | String | global | locale's False value | | submit, Submit | String | x11 | locale's Submit label | | cancel, Cancel | String | x11 | locale's Cancel label | | help, Help | String | x11 | locale's Help label | ^---------------------^---------^--------^-----------------------------^ These options store words, which are translated via the elvis.msg file when elvis starts up. The default versions of all of them are their capitalized English names.
The true and false options exist primarily to allow the
english words true and false to be used
in expressions to represent Boolean literals. Also, the value of
false is used as an alternative false string, in addition
to "", "0", or "false". (In a Boolean context, any string that isn't false
is considered to be true, so elvis never compares a string to the
true option's value.) A Boolean option will return the value
of either the true or false option, as appropriate.
If you're using the "x11" user interface, then values of the submit
and cancel options are used as the labels for the [Submit] and [Cancel]
buttons in a dialog. Also, if the dialog contains any Boolean options, the
value will be displayed using values of the true and
false options.
Currently the help option does nothing. Eventually I expect to add
pull-down menus to the "x11" interface, though, and in Motif menu bars
the "Help" menu traditionally appears on the far right edge. The value of
the help option will allow elvis to recognize the "Help" menu.
.---------------------.---------.--------.-----------------------------. | OPTION NAMES | TYPE | GROUP | DESCRIPTION | |---------------------|---------|--------|-----------------------------| | term, ttytype | String | tcap | terminal's termcap entry | | ttyrows, ttylines | Number | tcap | height of screen | | ttycolumns, ttycols | Number | tcap | width of screen | | ttyunderline, ttyu | Boolean | tcap | okay to mix color & underln | | codepage, cp | Number | win32 | console character set | |---------------------|---------|--------|-----------------------------| | scrollbar, sb | Boolean | (gui) | enable the scrollbar | | toolbar, tb | Boolean | (gui) | enable the toolbar | | statusbar, stb | Boolean | (gui) | enable the statusbar | |---------------------|---------|--------|-----------------------------| | menubar, mb | Boolean | windows| enable the menubar | | font, fnt | String | windows| base font | | normalstyle, nfn | String | windows| n or combination of b/i/u | | boldstyle, bfn | String | windows| n or combination of b/i/u | | italicstyle, ifn | String | windows| n or combination of b/i/u | | fixedstyle, ffn | String | windows| n or combination of b/i/u | | emphasizedstyle, efn| String | windows| n or combination of b/i/u | | underlinedstyle, nfn| String | windows| n or combination of b/i/u | |---------------------|---------|--------|-----------------------------| | normalfont, xfn | String | x11 | name of normal font | | boldfont, xfb | String | x11 | name of bold font | | italicfont, xfi | String | x11 | name of italic font | | controlfont, xfc | String | x11 | name of toolbar font | | underline, uln | Boolean | x11 | enables underlining | | toolbar, xtb | Boolean | x11 | enables the toolbar | | scrollbarleft, xsl | Boolean | x11 | enable scrollbar on side | | scrollbarwidth, xsw | Number | x11 | size of scrollbar, in pixels| | scrollbartime, xst | Number | x11 | delay for scrollbar repeat | | borderwidth, xbw | Number | x11 | size of text area's border | | dblclicktime, xdct | Number | x11 | double-click speed, 1/10 Sec| | blinktime, xbt | Number | x11 | cursor blink rate, 1/10 Sec | | textcursor, tc | Number | x11 | one of hollow, opaque, xor | | xrows, xlines | Number | x11 | height of new windows | | xcolumns, xcols | Number | x11 | width of new windows | | firstx, xpos | Number | x11 | horiz. position of first win| | firsty, ypos | Number | x11 | vert. position of first win | | stagger | Number | x11 | offset for next new window | | icon | Boolean | x11 | use the built-in icon? | | stopshell, ssh | String | x11 | interactive shell command | | autoiconify, aic | Boolean | x11 | iconify old window | | altkey, metakey | One of | x11 | effect of the Alt key | | focusnew, fn | Boolean | x11 | force focus into new window | | warpto, wt | One of | x11 | ^W^W forces pointer movement| | warpback, xwb | Boolean | x11 | upon exit, point to xterm | | outlinemono, om | Number | x11 | char outlining for X11-mono | ^---------------------^---------^--------^-----------------------------^
The term, ttyrows, ttycolumns, and ttyunderline options are only present if you're using the termcap user interface. They indicate the name of the termcap entry being used (normally taken from the TERM environment variable), the size of the screen, and whether it is safe to try underlining text when colors have been assigned to fonts. The ttyunderline option is true by default, but it should be made false on the Linux console, because the console driver has a bug which prevents underlined text from being shown in color.
The codepage option only exists in the Win32 version with the termcap interface (WindowsNT or Windows95, in console mode). It indicates which code page (character map) the console is using. Its value is persistent; if you change it in elvis, the console will remain changed even after you exit elvis. Changing the code page has no effect on the digraph table, or elvis' idea of which non-ASCII characters are printable or should be treated as letters; it only reconfigures the console driver. Typical values are 437 for the standard IBM PC character set, and 850 for extra European characters.
The scrollbar, toolbar, and statusbar options indicate whether the scrollbar, toolbar, and statusbar should be visible, respectively. By default, all are are visible.
The menubar option indicates whether the menu bar should be visible. By default, it is visible.
The font option stores the name of the base font. The easiest way to set it is via the "Options->Font" menu item.
The normalstyle, boldstyle, italicstyle,
fixedstyle, emphasizedstyle, and underlinedstyle
options determine how elvis will derive each of its fonts from the base font.
The values of these options are strings. If the string is "n" then the
base font is used unmodified. Other possibilities are any combination of
"b" for bold, "i" for italic (slanted), and "u" for underlined. For example,
":set ufn=bu" causes elvis' underlined font to be drawn
in bold with an underline.
The other options all apply to the x11 interface. The normalfont, boldfont, and italicfont options control the X fonts used for displaying text. Typically, the elvis.ini or ".exrc" file will set these. If you do choose to set them in one of these files, be sure to have your initialization script check which interface is being used because if elvis is using the termcap interface then these x11 options won't exist. These options all default to an empty string; this is a special case which causes elvis to use the "fixed" font for normal text, and to derive the bold and italic fonts from the normal font.
The controlfont option determines which font is used for displaying the labels of toolbar buttons, and also the statusbar. Unlike the other fonts, this one is permitted to have a variable pitch. If it is unset, then elvis will use the font named "variable" by default.
The underline option determines whether characters in the "underlined" font should be displayed as underlined. Normally, underline is true, so they are underlined. Setting nounderline will cause them to be displayed as normal characters, but in the color of underlined text.
The toolbar option controls whether the toolbar is visible or not. It is normally true, which makes the toolbar visible. The toolbar can be configured via the :gui command.
The statusbar option controls the visibility of the statusbar. It is true by default, which makes the statusbar is visible. The statusbar always displays the information which would otherwise be shown on the bottom row of the text area only when the ruler and showmode options were true. When you press a toolbar button, the button's one-line description is shown on the statusbar.
The scrollbarleft option determines which side of the window the scrollbar will be drawn on. This option is false by default, so the scrollbar appears on the right side of the window. Making it true will cause the scrollbar to be drawn on the left.
The scrollbarwidth option controls the size of the x11 scrollbar. The default value is 14 pixels, and the allowed range is 5 to 40 pixels.
The scrollbar buttons automatically repeat if you hold a mouse button down scrollbartime tenths of a second. The default is 4 tenths of a second.
The main text area of a window looks better when the characters aren't drawn immediately adjacent to the edge. The borderwidth option allows you to specify how many pixels should be left blank between a character and any edge of the text area. The default is 1 pixel.
The dblclicktime option allows you to adjust the speed of mouse double-clicks to match your own clicking habits. The default is 3 tenths of a second.
The blinktime option controls the cursor blink rate. If set to 0, the cursor will not blink. If set to a value from 1 to 10, then the cursor will first be visible for that many tenths of a second, and then invisible for the same amount of time. The cursor will only blink in the window which currently has keyboard focus.
The textcursor option controls the way the block text cursor is drawn. It can be xor, hollow, or opaque. The default is xor, which causes the cursor to be drawn as a filled rectangle with the XOR bitblt function. This converts the background color to the cursor color, and the foreground color to an unpredictable color; hopefully the foreground color will contrast with the cursor color well enough to allow you to discern what the underlying character is. The hollow cursor style causes the cursor to be drawn as an unfilled rectangle. This allows you to easily see the underlying character, and detect whether it is highlighted or not. The opaque cursor style draws a filled rectangle, which is easier to locate but you can only see the underlying character between blinks.
The xrows and xcolumns options control the initial size of windows. They default to 34 and 80, respectively, and can also be set via the -geometry command-line flag. After a window has been created, you can use your window manager to resize the window.
The firstx and firsty options, if set, control the position of the first window that elvis creates. If they are unset, then elvis doesn't specify a position for the window. The -geometry command-line flag can be used to set these options. After the first window has been created, if the stagger option is set to a non-zero value then any new windows are created that many pixels down and to the right of the current window. If stagger is zero, then elvis won't specify a position for the new windows, so the window manager can choose the location itself.
The icon option can only be set in an initialization file such as elvis.ini or ".exrc"; once the first window has been created it is too late to change it. This option controls whether the window will be given the default, built-in icon. It is true by default, so windows will get the icon. This is usually a good thing. Some window managers don't allow you to override built-in icons, though, so if you want your window manager to use a different icon for elvis then you'll need to have a "set noicon" in your elvis.ini file.
The stopshell option stores a command which runs an interactive shell. It is used for the :shell and :stop ex commands, and the ^Z visual command. Normally, this is set to "xterm &" so you get a shell in a window. The "&" at the end of the command allows elvis to continue responding to user input while the shell is running.
When the ^W^W visual command switches keyboard control to an X11 window which as been iconified, elvis automatically deiconifies it. When it does this, if the autoiconify option is set then elvis will iconify the previl | locale's True value | | false, False | String | global | locale's False value | | submit, Submit | String | x11 | locale's Submit label | | cancel, Cancel | String | x11 | locale's Cancel label | | help, Help | String | x11 | locale's Help label | ^---------------------^---------^--------^-----------------------------^ These options store words, which are translated via the elvis.msg file when elvis starts up. The default versions of all of them are their capitalized English names.
The true and false options exist primarily to allow the
english words true and false to be used
in expressions to represent Boolean literals. Also, the value of
false is used as an alternative false string, in addition
to "", "0", or "false". (In a Boolean context, any string that isn't false
is considered to be true, so elvis never compares a string to the
true option's value.) A Boolean option will return the value
of either the true or false option, as appropriate.
If you're using the "x11" user interface, then values of the submit
and cancel options are used as the labels for the [Submit] and [Cancel]
buttons in a dialog. Also, if the dialog contains any Boolean options, the
value will be displayed using values of the true and
false options.
Currently the help option does nothing. Eventually I expect to add
pull-down menus to the "x11" interface, though, and in Motif menu bars
the "Help" menu traditionally appears on the far right edge. The value of
the help option will allow elvis to recognize the "Help" menu.
.---------------------.---------.--------.-----------------------------. | OPTION NAMES | TYPE | GROUP | DESCRIPTION | |---------------------|---------|--------|-----------------------------| | term, ttytype | String | tcap | terminal's termcap entry | | ttyrows, ttylines | Number | tcap | height of screen | | ttycolumns, ttycols | Number | tcap | width of screen | | ttyunderline, ttyu | Boolean | tcap | okay to mix color & underln | | codepage, cp | Number | win32 | console character set | |---------------------|---------|--------|-----------------------------| | scrollbar, sb | Boolean | (gui) | enable the scrollbar | | toolbar, tb | Boolean | (gui) | enable the toolbar | | statusbar, stb | Boolean | (gui) | enable the statusbar | |---------------------|---------|--------|-----------------------------| | menubar, mb | Boolean | windows| enable the menubar | | font, fnt | String | windows| base font | | normalstyle, nfn | String | windows| n or combination of b/i/u | | boldstyle, bfn | String | windows| n or combination of b/i/u | | italicstyle, ifn | String | windows| n or combination of b/i/u | | fixedstyle, ffn | String | windows| n or combination of b/i/u | | emphasizedstyle, efn| String | windows| n or combination of b/i/u | | underlinedstyle, nfn| String | windows| n or combination of b/i/u | |---------------------|---------|--------|-----------------------------| | normalfont, xfn | String | x11 | name of normal font | | boldfont, xfb | String | x11 | name of bold font | | italicfont, xfi | String | x11 | name of italic font | | controlfont, xfc | String | x11 | name of toolbar font | | underline, uln | Boolean | x11 | enables underlining | | toolbar, xtb | Boolean | x11 | enables the toolbar | | scrollbarleft, xsl | Boolean | x11 | enable scrollbar on side | | scrollbarwidth, xsw | Number | x11 | size of scrollbar, in pixels| | scrollbartime, xst | Number | x11 | delay for scrollbar repeat | | borderwidth, xbw | Number | x11 | size of text area's border | | dblclicktime, xdct | Number | x11 | double-click speed, 1/10 Sec| | blinktime, xbt | Number | x11 | cursor blink rate, 1/10 Sec | | textcursor, tc | Number | x11 | one of hollow, opaque, xor | | xrows, xlines | Number | x11 | height of new windows | | xcolumns, xcols | Number | x11 | width of new windows | | firstx, xpos | Number | x11 | horiz. position of first win| | firsty, ypos | Number | x11 | vert. position of first win | | stagger | Number | x11 | offset for next new window | | icon | Boolean | x11 | use the built-in icon? | | stopshell, ssh | String | x11 | interactive shell command | | autoiconify, aic | Boolean | x11 | iconify old window | | altkey, metakey | One of | x11 | effect of the Alt key | | focusnew, fn | Boolean | x11 | force focus into new window | | warpto, wt | One of | x11 | ^W^W forces pointer movement| | warpback, xwb | Boolean | x11 | upon exit, point to xterm | | outlinemono, om | Number | x11 | char outlining for X11-mono | ^---------------------^---------^--------^-----------------------------^
The term, ttyrows, ttycolumns, and ttyunderline options are only present if you're using the termcap user interface. They indicate the name of the termcap entry being used (normally taken from the TERM environment variable), the size of the screen, and whether it is safe to try underlining text when colors have been assigned to fonts. The ttyunderline option is true by default, but it should be made false on the Linux console, because the console driver has a bug which prevents underlined text from being shown in color.
The codepage option only exists in the Win32 version with the termcap interface (WindowsNT or Windows95, in console mode). It indicates which code page (character map) the console is using. Its value is persistent; if you change it in elvis, the console will remain changed even after you exit elvis. Changing the code page has no effect on the digraph table, or elvis' idea of which non-ASCII characters are printable or should be treated as letters; it only reconfigures the console driver. Typical values are 437 for the standard IBM PC character set, and 850 for extra European characters.
The scrollbar, toolbar, and statusbar options indicate whether the scrollbar, toolbar, and statusbar should be visible, respectively. By default, all are are visible.
The menubar option indicates whether the menu bar should be visible. By default, it is visible.
The font option stores the name of the base font. The easiest way to set it is via the "Options->Font" menu item.
The normalstyle, boldstyle, italicstyle,
fixedstyle, emphasizedstyle, and underlinedstyle
options determine how elvis will derive each of its fonts from the base font.
The values of these options are strings. If the string is "n" then the
base font is used unmodified. Other possibilities are any combination of
"b" for bold, "i" for italic (slanted), and "u" for underlined. For example,
":set ufn=bu" causes elvis' underlined font to be drawn
in bold with an underline.
The other options all apply to the x11 interface. The normalfont, boldfont, and italicfont options control the X fonts used for displaying text. Typically, the elvis.ini or ".exrc" file will set these. If you do choose to set them in one of these files, be sure to have your initialization script check which interface is being used because if elvis is using the termcap interface then these x11 options won't exist. These options all default to an empty string; this is a special case which causes elvis to use the "fixed" font for normal text, and to derive the bold and italic fonts from the normal font.
The controlfont option determines which font is used for displaying the labels of toolbar buttons, and also the statusbar. Unlike the other fonts, this one is permitted to have a variable pitch. If it is unset, then elvis will use the font named "variable" by default.
The underline option determines whether characters in the "underlined" font should be displayed as underlined. Normally, underline is true, so they are underlined. Setting nounderline will cause them to be displayed as normal characters, but in the color of underlined text.
The toolbar option controls whether the toolbar is visible or not. It is normally true, which makes the toolbar visible. The toolbar can be configured via the :gui command.
The statusbar option controls the visibility of the statusbar. It is true by default, which makes the statusbar is visible. The statusbar always displays the information which would otherwise be shown on the bottom row of the text area only when the ruler and showmode options were true. When you press a toolbar button, the button's one-line description is shown on the statusbar.
The scrollbarleft option determines which side of the window the scrollbar will be drawn on. This option is false by default, so the scrollbar appears on the right side of the window. Making it true will cause the scrollbar to be drawn on the left.
The scrollbarwidth option controls the size of the x11 scrollbar. The default value is 14 pixels, and the allowed range is 5 to 40 pixels.
The scrollbar buttons automatically repeat if you hold a mouse button down scrollbartime tenths of a second. The default is 4 tenths of a second.
The main text area of a window looks better when the characters aren't drawn immediately adjacent to the edge. The borderwidth option allows you to specify how many pixels should be left blank between a character and any edge of the text area. The default is 1 pixel.
The dblclicktime option allows you to adjust the speed of mouse double-clicks to match your own clicking habits. The default is 3 tenths of a second.
The blinktime option controls the cursor blink rate. If set to 0, the cursor will not blink. If set to a value from 1 to 10, then the cursor will first be visible for that many tenths of a second, and then invisible for the same amount of time. The cursor will only blink in the window which currently has keyboard focus.
The textcursor option controls the way the block text cursor is drawn. It can be xor, hollow, or opaque. The default is xor, which causes the cursor to be drawn as a filled rectangle with the XOR bitblt function. This converts the background color to the cursor color, and the foreground color to an unpredictable color; hopefully the foreground color will contrast with the cursor color well enough to allow you to discern what the underlying character is. The hollow cursor style causes the cursor to be drawn as an unfilled rectangle. This allows you to easily see the underlying character, and detect whether it is highlighted or not. The opaque cursor style draws a filled rectangle, which is easier to locate but you can only see the underlying character between blinks.
The xrows and xcolumns options control the initial size of windows. They default to 34 and 80, respectively, and can also be set via the -geometry command-line flag. After a window has been created, you can use your window manager to resize the window.
The firstx and firsty options, if set, control the position of the first window that elvis creates. If they are unset, then elvis doesn't specify a position for the window. The -geometry command-line flag can be used to set these options. After the first window has been created, if the stagger option is set to a non-zero value then any new windows are created that many pixels down and to the right of the current window. If stagger is zero, then elvis won't specify a position for the new windows, so the window manager can choose the location itself.
The icon option can only be set in an initialization file such as elvis.ini or ".exrc"; once the first window has been created it is too late to change it. This option controls whether the window will be given the default, built-in icon. It is true by default, so windows will get the icon. This is usually a good thing. Some window managers don't allow you to override built-in icons, though, so if you want your window manager to use a different icon for elvis then you'll need to have a "set noicon" in your elvis.ini file.
The stopshell option stores a command which runs an interactive shell. It is used for the :shell and :stop ex commands, and the ^Z visual command. Normally, this is set to "xterm &" so you get a shell in a window. The "&" at the end of the command allows elvis to continue responding to user input while the shell is running.
When the ^W^W visual command switches keyboard control to an X11 window which as been iconified, elvis automatically deiconifies it. When it does this, if the autoiconify option is set then elvis will iconify the previl | locale's True value | | false, False | String | global | locale's False value | | submit, Submit | String | x11 | locale's Submit label | | cancel, Cancel | String | x11 | locale's Cancel label | | help, Help | String | x11 | locale's Help label | ^---------------------^---------^--------^-----------------------------^ These options store words, which are translated via the elvis.msg file when elvis starts up. The default versions of all of them are their capitalized English names.
The true and false options exist primarily to allow the
english words true and false to be used
in expressions to represent Boolean literals. Also, the value of
false is used as an alternative false string, in addition
to "", "0", or "false". (In a Boolean context, any string that isn't false
is considered to be true, so elvis never compares a string to the
true option's value.) A Boolean option will return the value
of either the true or false option, as appropriate.
If you're using the "x11" user interface, then values of the submit
and cancel options are used as the labels for the [Submit] and [Cancel]
buttons in a dialog. Also, if the dialog contains any Boolean options, the
value will be displayed using values of the true and
false options.
Currently the help option does nothing. Eventually I expect to add
pull-down menus to the "x11" interface, though, and in Motif menu bars
the "Help" menu traditionally appears on the far right edge. The value of
the help option will allow elvis to recognize the "Help" menu.
.---------------------.---------.--------.-----------------------------. | OPTION NAMES | TYPE | GROUP | DESCRIPTION | |---------------------|---------|--------|-----------------------------| | term, ttytype | String | tcap | terminal's termcap entry | | ttyrows, ttylines | Number | tcap | height of screen | | ttycolumns, ttycols | Number | tcap | width of screen | | ttyunderline, ttyu | Boolean | tcap | okay to mix color & underln | | codepage, cp | Number | win32 | console character set | |---------------------|---------|--------|-----------------------------| | scrollbar, sb | Boolean | (gui) | enable the scrollbar | | toolbar, tb | Boolean | (gui) | enable the toolbar | | statusbar, stb | Boolean | (gui) | enable the statusbar | |---------------------|---------|--------|-----------------------------| | menubar, mb | Boolean | windows| enable the menubar | | font, fnt | String | windows| base font | | normalstyle, nfn | String | windows| n or combination of b/i/u | | boldstyle, bfn | String | windows| n or combination of b/i/u | | italicstyle, ifn | String | windows| n or combination of b/i/u | | fixedstyle, ffn | String | windows| n or combination of b/i/u | | emphasizedstyle, efn| String | windows| n or combination of b/i/u | | underlinedstyle, nfn| String | windows| n or combination of b/i/u | |---------------------|---------|--------|-----------------------------| | normalfont, xfn | String | x11 | name of normal font | | boldfont, xfb | String | x11 | name of bold font | | italicfont, xfi | String | x11 | name of italic font | | controlfont, xfc | String | x11 | name of toolbar font | | underline, uln | Boolean | x11 | enables underlining | | toolbar, xtb | Boolean | x11 | enables the toolbar | | scrollbarleft, xsl | Boolean | x11 | enable scrollbar on side | | scrollbarwidth, xsw | Number | x11 | size of scrollbar, in pixels| | scrollbartime, xst | Number | x11 | delay for scrollbar repeat | | borderwidth, xbw | Number | x11 | size of text area's border | | dblclicktime, xdct | Number | x11 | double-click speed, 1/10 Sec| | blinktime, xbt | Number | x11 | cursor blink rate, 1/10 Sec | | textcursor, tc | Number | x11 | one of hollow, opaque, xor | | xrows, xlines | Number | x11 | height of new windows | | xcolumns, xcols | Number | x11 | width of new windows | | firstx, xpos | Number | x11 | horiz. position of first win| | firsty, ypos | Number | x11 | vert. position of first win | | stagger | Number | x11 | offset for next new window | | icon | Boolean | x11 | use the built-in icon? | | stopshell, ssh | String | x11 | interactive shell command | | autoiconify, aic | Boolean | x11 | iconify old window | | altkey, metakey | One of | x11 | effect of the Alt key | | focusnew, fn | Boolean | x11 | force focus into new window | | warpto, wt | One of | x11 | ^W^W forces pointer movement| | warpback, xwb | Boolean | x11 | upon exit, point to xterm | | outlinemono, om | Number | x11 | char outlining for X11-mono | ^---------------------^---------^--------^-----------------------------^
The term, ttyrows, ttycolumns, and ttyunderline options are only present if you're using the termcap user interface. They indicate the name of the termcap entry being used (normally taken from the TERM environment variable), the size of the screen, and whether it is safe to try underlining text when colors have been assigned to fonts. The ttyunderline option is true by default, but it should be made false on the Linux console, because the console driver has a bug which prevents underlined text from being shown in color.
The codepage option only exists in the Win32 version with the termcap interface (WindowsNT or Windows95, in console mode). It indicates which code page (character map) the console is using. Its value is persistent; if you change it in elvis, the console will remain changed even after you exit elvis. Changing the code page has no effect on the digraph table, or elvis' idea of which non-ASCII characters are printable or should be treated as letters; it only reconfigures the console driver. Typical values are 437 for the standard IBM PC character set, and 850 for extra European characters.
The scrollbar, toolbar, and statusbar options indicate whether the scrollbar, toolbar, and statusbar should be visible, respectively. By default, all are are visible.
The menubar option indicates whether the menu bar should be visible. By default, it is visible.
The font option stores the name of the base font. The easiest way to set it is via the "Options->Font" menu item.
The normalstyle, boldstyle, italicstyle,
fixedstyle, emphasizedstyle, and underlinedstyle
options determine how elvis will derive each of its fonts from the base font.
The values of these options are strings. If the string is "n" then the
base font is used unmodified. Other possibilities are any combination of
"b" for bold, "i" for italic (slanted), and "u" for underlined. For example,
":set ufn=bu" causes elvis' underlined font to be drawn
in bold with an underline.
The other options all apply to the x11 interface. The normalfont, boldfont, and italicfont options control the X fonts used for displaying text. Typically, the elvis.ini or ".exrc" file will set these. If you do choose to set them in one of these files, be sure to have your initialization script check which interface is being used because if elvis is using the termcap interface then these x11 options won't exist. These options all default to an empty string; this is a special case which causes elvis to use the "fixed" font for normal text, and to derive the bold and italic fonts from the normal font.
The controlfont option determines which font is used for displaying the labels of toolbar buttons, and also the statusbar. Unlike the other fonts, this one is permitted to have a variable pitch. If it is unset, then elvis will use the font named "variable" by default.
The underline option determines whether characters in the "underlined" font should be displayed as underlined. Normally, underline is true, so they are underlined. Setting nounderline will cause them to be displayed as normal characters, but in the color of underlined text.
The toolbar option controls whether the toolbar is visible or not. It is normally true, which makes the toolbar visible. The toolbar can be configured via the :gui command.
The statusbar option controls the visibility of the statusbar. It is true by default, which makes the statusbar is visible. The statusbar always displays the information which would otherwise be shown on the bottom row of the text area only when the ruler and showmode options were true. When you press a toolbar button, the button's one-line description is shown on the statusbar.
The scrollbarleft option determines which side of the window the scrollbar will be drawn on. This option is false by default, so the scrollbar appears on the right side of the window. Making it true will cause the scrollbar to be drawn on the left.
The scrollbarwidth option controls the size of the x11 scrollbar. The default value is 14 pixels, and the allowed range is 5 to 40 pixels.
The scrollbar buttons automatically repeat if you hold a mouse button down scrollbartime tenths of a second. The default is 4 tenths of a second.
The main text area of a window looks better when the characters aren't drawn immediately adjacent to the edge. The borderwidth option allows you to specify how many pixels should be left blank between a character and any edge of the text area. The default is 1 pixel.
The dblclicktime option allows you to adjust the speed of mouse double-clicks to match your own clicking habits. The default is 3 tenths of a second.
The blinktime option controls the cursor blink rate. If set to 0, the cursor will not blink. If set to a value from 1 to 10, then the cursor will first be visible for that many tenths of a second, and then invisible for the same amount of time. The cursor will only blink in the window which currently has keyboard focus.
The textcursor option controls the way the block text cursor is drawn. It can be xor, hollow, or opaque. The default is xor, which causes the cursor to be drawn as a filled rectangle with the XOR bitblt function. This converts the background color to the cursor color, and the foreground color to an unpredictable color; hopefully the foreground color will contrast with the cursor color well enough to allow you to discern what the underlying character is. The hollow cursor style causes the cursor to be drawn as an unfilled rectangle. This allows you to easily see the underlying character, and detect whether it is highlighted or not. The opaque cursor style draws a filled rectangle, which is easier to locate but you can only see the underlying character between blinks.
The xrows and xcolumns options control the initial size of windows. They default to 34 and 80, respectively, and can also be set via the -geometry command-line flag. After a window has been created, you can use your window manager to resize the window.
The firstx and firsty options, if set, control the position of the first window that elvis creates. If they are unset, then elvis doesn't specify a position for the window. The -geometry command-line flag can be used to set these options. After the first window has been created, if the stagger option is set to a non-zero value then any new windows are created that many pixels down and to the right of the current window. If stagger is zero, then elvis won't specify a position for the new windows, so the window manager can choose the location itself.
The icon option can only be set in an initialization file such as elvis.ini or ".exrc"; once the first window has been created it is too late to change it. This option controls whether the window will be given the default, built-in icon. It is true by default, so windows will get the icon. This is usually a good thing. Some window managers don't allow you to override built-in icons, though, so if you want your window manager to use a different icon for elvis then you'll need to have a "set noicon" in your elvis.ini file.
The stopshell option stores a command which runs an interactive shell. It is used for the :shell and :stop ex commands, and the ^Z visual command. Normally, this is set to "xterm &" so you get a shell in a window. The "&" at the end of the command allows elvis to continue responding to user input while the shell is running.
When the ^W^W visual command switches keyboard control to an X11 window which as been iconified, elvis automatically deiconifies it. When it does this, if the autoiconify option is set then elvis will iconify the previl | locale's True value | | false, False | String | global | locale's False value | | submit, Submit | String | x11 | locale's Submit label | | cancel, Cancel | String | x11 | locale's Cancel label | | help, Help | String | x11 | locale's Help label | ^---------------------^---------^--------^-----------------------------^ These options store words, which are translated via the elvis.msg file when elvis starts up. The default versions of all of them are their capitalized English names.
The true and false options exist primarily to allow the
english words true and false to be used
in expressions to represent Boolean literals. Also, the value of
false is used as an alternative false string, in addition
to "", "0", or "false". (In a Boolean context, any string that isn't false
is considered to be true, so elvis never compares a string to the
true option's value.) A Boolean option will return the value
of either the true or false option, as appropriate.
If you're using the "x11" user interface, then values of the submit
and cancel options are used as the labels for the [Submit] and [Cancel]
buttons in a dialog. Also, if the dialog contains any Boolean options, the
value will be displayed using values of the true and
false options.
Currently the help option does nothing. Eventually I expect to add
pull-down menus to the "x11" interface, though, and in Motif menu bars
the "Help" menu traditionally appears on the far right edge. The value of
the help option will allow elvis to recognize the "Help" menu.
.---------------------.---------.--------.-----------------------------. | OPTION NAMES | TYPE | GROUP | DESCRIPTION | |---------------------|---------|--------|-----------------------------| | term, ttytype | String | tcap | terminal's termcap entry | | ttyrows, ttylines | Number | tcap | height of screen | | ttycolumns, ttycols | Number | tcap | width of screen | | ttyunderline, ttyu | Boolean | tcap | okay to mix color & underln | | codepage, cp | Number | win32 | console character set | |---------------------|---------|--------|-----------------------------| | scrollbar, sb | Boolean | (gui) | enable the scrollbar | | toolbar, tb | Boolean | (gui) | enable the toolbar | | statusbar, stb | Boolean | (gui) | enable the statusbar | |---------------------|---------|--------|-----------------------------| | menubar, mb | Boolean | windows| enable the menubar | | font, fnt | String | windows| base font | | normalstyle, nfn | String | windows| n or combination of b/i/u | | boldstyle, bfn | String | windows| n or combination of b/i/u | | italicstyle, ifn | String | windows| n or combination of b/i/u | | fixedstyle, ffn | String | windows| n or combination of b/i/u | | emphasizedstyle, efn| String | windows| n or combination of b/i/u | | underlinedstyle, nfn| String | windows| n or combination of b/i/u | |---------------------|---------|--------|-----------------------------| | normalfont, xfn | String | x11 | name of normal font | | boldfont, xfb | String | x11 | name of bold font | | italicfont, xfi | String | x11 | name of italic font | | controlfont, xfc | String | x11 | name of toolbar font | | underline, uln | Boolean | x11 | enables underlining | | toolbar, xtb | Boolean | x11 | enables the toolbar | | scrollbarleft, xsl | Boolean | x11 | enable scrollbar on side | | scrollbarwidth, xsw | Number | x11 | size of scrollbar, in pixels| | scrollbartime, xst | Number | x11 | delay for scrollbar repeat | | borderwidth, xbw | Number | x11 | size of text area's border | | dblclicktime, xdct | Number | x11 | double-click speed, 1/10 Sec| | blinktime, xbt | Number | x11 | cursor blink rate, 1/10 Sec | | textcursor, tc | Number | x11 | one of hollow, opaque, xor | | xrows, xlines | Number | x11 | height of new windows | | xcolumns, xcols | Number | x11 | width of new windows | | firstx, xpos | Number | x11 | horiz. position of first win| | firsty, ypos | Number | x11 | vert. position of first win | | stagger | Number | x11 | offset for next new window | | icon | Boolean | x11 | use the built-in icon? | | stopshell, ssh | String | x11 | interactive shell command | | autoiconify, aic | Boolean | x11 | iconify old window | | altkey, metakey | One of | x11 | effect of the Alt key | | focusnew, fn | Boolean | x11 | force focus into new window | | warpto, wt | One of | x11 | ^W^W forces pointer movement| | warpback, xwb | Boolean | x11 | upon exit, point to xterm | | outlinemono, om | Number | x11 | char outlining for X11-mono | ^---------------------^---------^--------^-----------------------------^
The term, ttyrows, ttycolumns, and ttyunderline options are only present if you're using the termcap user interface. They indicate the name of the termcap entry being used (normally taken from the TERM environment variable), the size of the screen, and whether it is safe to try underlining text when colors have been assigned to fonts. The ttyunderline option is true by default, but it should be made false on the Linux console, because the console driver has a bug which prevents underlined text from being shown in color.
The codepage option only exists in the Win32 version with the termcap interface (WindowsNT or Windows95, in console mode). It indicates which code page (character map) the console is using. Its value is persistent; if you change it in elvis, the console will remain changed even after you exit elvis. Changing the code page has no effect on the digraph table, or elvis' idea of which non-ASCII characters are printable or should be treated as letters; it only reconfigures the console driver. Typical values are 437 for the standard IBM PC character set, and 850 for extra European characters.
The scrollbar, toolbar, and statusbar options indicate whether the scrollbar, toolbar, and statusbar should be visible, respectively. By default, all are are visible.
The menubar option indicates whether the menu bar should be visible. By default, it is visible.
The font option stores the name of the base font. The easiest way to set it is via the "Options->Font" menu item.
The normalstyle, boldstyle, italicstyle,
fixedstyle, emphasizedstyle, and underlinedstyle
options determine how elvis will derive each of its fonts from the base font.
The values of these options are strings. If the string is "n" then the
base font is used unmodified. Other possibilities are any combination of
"b" for bold, "i" for italic (slanted), and "u" for underlined. For example,
":set ufn=bu" causes elvis' underlined font to be drawn
in bold with an underline.
The other options all apply to the x11 interface. The normalfont, boldfont, and italicfont options control the X fonts used for displaying text. Typically, the elvis.ini or ".exrc" file will set these. If you do choose to set them in one of these files, be sure to have your initialization script check which interface is being used because if elvis is using the termcap interface then these x11 options won't exist. These options all default to an empty string; this is a special case which causes elvis to use the "fixed" font for normal text, and to derive the bold and italic fonts from the normal font.
The controlfont option determines which font is used for displaying the labels of toolbar buttons, and also the statusbar. Unlike the other fonts, this one is permitted to have a variable pitch. If it is unset, then elvis will use the font named "variable" by default.
The underline option determines whether characters in the "underlined" font should be displayed as underlined. Normally, underline is true, so they are underlined. Setting nounderline will cause them to be displayed as normal characters, but in the color of underlined text.
The toolbar option controls whether the toolbar is visible or not. It is normally true, which makes the toolbar visible. The toolbar can be configured via the :gui command.
The statusbar option controls the visibility of the statusbar. It is true by default, which makes the statusbar is visible. The statusbar always displays the information which would otherwise be shown on the bottom row of the text area only when the ruler and showmode options were true. When you press a toolbar button, the button's one-line description is shown on the statusbar.
The scrollbarleft option determines which side of the window the scrollbar will be drawn on. This option is false by default, so the scrollbar appears on the right side of the window. Making it true will cause the scrollbar to be drawn on the left.
The scrollbarwidth option controls the size of the x11 scrollbar. The default value is 14 pixels, and the allowed range is 5 to 40 pixels.
The scrollbar buttons automatically repeat if you hold a mouse button down scrollbartime tenths of a second. The default is 4 tenths of a second.
The main text area of a window looks better when the characters aren't drawn immediately adjacent to the edge. The borderwidth option allows you to specify how many pixels should be left blank between a character and any edge of the text area. The default is 1 pixel.
The dblclicktime option allows you to adjust the speed of mouse double-clicks to match your own clicking habits. The default is 3 tenths of a second.
The blinktime option controls the cursor blink rate. If set to 0, the cursor will not blink. If set to a value from 1 to 10, then the cursor will first be visible for that many tenths of a second, and then invisible for the same amount of time. The cursor will only blink in the window which currently has keyboard focus.
The textcursor option controls the way the block text cursor is drawn. It can be xor, hollow, or opaque. The default is xor, which causes the cursor to be drawn as a filled rectangle with the XOR bitblt function. This converts the background color to the cursor color, and the foreground color to an unpredictable color; hopefully the foreground color will contrast with the cursor color well enough to allow you to discern what the underlying character is. The hollow cursor style causes the cursor to be drawn as an unfilled rectangle. This allows you to easily see the underlying character, and detect whether it is highlighted or not. The opaque cursor style draws a filled rectangle, which is easier to locate but you can only see the underlying character between blinks.
The xrows and xcolumns options control the initial size of windows. They default to 34 and 80, respectively, and can also be set via the -geometry command-line flag. After a window has been created, you can use your window manager to resize the window.
The firstx and firsty options, if set, control the position of the first window that elvis creates. If they are unset, then elvis doesn't specify a position for the window. The -geometry command-line flag can be used to set these options. After the first window has been created, if the stagger option is set to a non-zero value then any new windows are created that many pixels down and to the right of the current window. If stagger is zero, then elvis won't specify a position for the new windows, so the window manager can choose the location itself.
The icon option can only be set in an initialization file such as elvis.ini or ".exrc"; once the first window has been created it is too late to change it. This option controls whether the window will be given the default, built-in icon. It is true by default, so windows will get the icon. This is usually a good thing. Some window managers don't allow you to override built-in icons, though, so if you want your window manager to use a different icon for elvis then you'll need to have a "set noicon" in your elvis.ini file.
The stopshell option stores a command which runs an interactive shell. It is used for the :shell and :stop ex commands, and the ^Z visual command. Normally, this is set to "xterm &" so you get a shell in a window. The "&" at the end of the command allows elvis to continue responding to user input while the shell is running.
When the ^W^W visual command switches keyboard control to an X11 window which as been iconified, elvis automatically deiconifies it. When it does this, if the autoiconify option is set then elvis will iconify the previl | locale's True value | | false, False | String | global | locale's False value | | submit, Submit | String | x11 | locale's Submit label | | cancel, Cancel | String | x11 | locale's Cancel label | | help, Help | String | x11 | locale's Help label | ^---------------------^---------^--------^-----------------------------^ These options store words, which are translated via the elvis.msg file when elvis starts up. The default versions of all of them are their capitalized English names.
The true and false options exist primarily to allow the
english words true and false to be used
in expressions to represent Boolean literals. Also, the value of
false is used as an alternative false string, in addition
to "", "0", or "false". (In a Boolean context, any string that isn't false
is considered to be true, so elvis never compares a string to the
true option's value.) A Boolean option will return the value
of either the true or false option, as appropriate.
If you're using the "x11" user interface, then values of the submit
and cancel options are used as the labels for the [Submit] and [Cancel]
buttons in a dialog. Also, if the dialog contains any Boolean options, the
value will be displayed using values of the true and
false options.
Currently the help option does nothing. Eventually I expect to add
pull-down menus to the "x11" interface, though, and in Motif menu bars
the "Help" menu traditionally appears on the far right edge. The value of
the help option will allow elvis to recognize the "Help" menu.
.---------------------.---------.--------.-----------------------------. | OPTION NAMES | TYPE | GROUP | DESCRIPTION | |---------------------|---------|--------|-----------------------------| | term, ttytype | String | tcap | terminal's termcap entry | | ttyrows, ttylines | Number | tcap | height of screen | | ttycolumns, ttycols | Number | tcap | width of screen | | ttyunderline, ttyu | Boolean | tcap | okay to mix color & underln | | codepage, cp | Number | win32 | console character set | |---------------------|---------|--------|-----------------------------| | scrollbar, sb | Boolean | (gui) | enable the scrollbar | | toolbar, tb | Boolean | (gui) | enable the toolbar | | statusbar, stb | Boolean | (gui) | enable the statusbar | |---------------------|---------|--------|-----------------------------| | menubar, mb | Boolean | windows| enable the menubar | | font, fnt | String | windows| base font | | normalstyle, nfn | String | windows| n or combination of b/i/u | | boldstyle, bfn | String | windows| n or combination of b/i/u | | italicstyle, ifn | String | windows| n or combination of b/i/u | | fixedstyle, ffn | String | windows| n or combination of b/i/u | | emphasizedstyle, efn| String | windows| n or combination of b/i/u | | underlinedstyle, nfn| String | windows| n or combination of b/i/u | |---------------------|---------|--------|-----------------------------| | normalfont, xfn | String | x11 | name of normal font | | boldfont, xfb | String | x11 | name of bold font | | italicfont, xfi | String | x11 | name of italic font | | controlfont, xfc | String | x11 | name of toolbar font | | underline, uln | Boolean | x11 | enables underlining | | toolbar, xtb | Boolean | x11 | enables the toolbar | | scrollbarleft, xsl | Boolean | x11 | enable scrollbar on side | | scrollbarwidth, xsw | Number | x11 | size of scrollbar, in pixels| | scrollbartime, xst | Number | x11 | delay for scrollbar repeat | | borderwidth, xbw | Number | x11 | size of text area's border | | dblclicktime, xdct | Number | x11 | double-click speed, 1/10 Sec| | blinktime, xbt | Number | x11 | cursor blink rate, 1/10 Sec | | textcursor, tc | Number | x11 | one of hollow, opaque, xor | | xrows, xlines | Number | x11 | height of new windows | | xcolumns, xcols | Number | x11 | width of new windows | | firstx, xpos | Number | x11 | horiz. position of first win| | firsty, ypos | Number | x11 | vert. position of first win | | stagger | Number | x11 | offset for next new window | | icon | Boolean | x11 | use the built-in icon? | | stopshell, ssh | String | x11 | interactive shell command | | autoiconify, aic | Boolean | x11 | iconify old window | | altkey, metakey | One of | x11 | effect of the Alt key | | focusnew, fn | Boolean | x11 | force focus into new window | | warpto, wt | One of | x11 | ^W^W forces pointer movement| | warpback, xwb | Boolean | x11 | upon exit, point to xterm | | outlinemono, om | Number | x11 | char outlining for X11-mono | ^---------------------^---------^--------^-----------------------------^
The term, ttyrows, ttycolumns, and ttyunderline options are only present if you're using the termcap user interface. They indicate the name of the termcap entry being used (normally taken from the TERM environment variable), the size of the screen, and whether it is safe to try underlining text when colors have been assigned to fonts. The ttyunderline option is true by default, but it should be made false on the Linux console, because the console driver has a bug which prevents underlined text from being shown in color.
The codepage option only exists in the Win32 version with the termcap interface (WindowsNT or Windows95, in console mode). It indicates which code page (character map) the console is using. Its value is persistent; if you change it in elvis, the console will remain changed even after you exit elvis. Changing the code page has no effect on the digraph table, or elvis' idea of which non-ASCII characters are printable or should be treated as letters; it only reconfigures the console driver. Typical values are 437 for the standard IBM PC character set, and 850 for extra European characters.
The scrollbar, toolbar, and statusbar options indicate whether the scrollbar, toolbar, and statusbar should be visible, respectively. By default, all are are visible.
The menubar option indicates whether the menu bar should be visible. By default, it is visible.
The font option stores the name of the base font. The easiest way to set it is via the "Options->Font" menu item.