next up previous
Next: 19.4 Unexpected Termination Up: 19. RC Files Previous: 19.2 Saving Option Information

Subsections

19.3 The RC File

The following section lists all the valid options is an RC file. In all cases upper and lower case letters are identical. When processing a file all blank space at the start of a line is discarded. Any lines beginning with a ``#'' as well as blank lines are ignored.

Errors in RC files are silently ignored. They can be printed to a ``vedrc.log'' file if you start Ved with the ``-l'' option on the command line (see Section 2.8).

For a complete listing of all the various RC file options, it is best to refer to the actual data generated with the ``RC Save'' option.

Most string arguments must be enclosed in delimters. A delimiter can be any character which does not appear in the string. Examples of permitted delimited strings include "value" /value/ and CvalueC. Note that 'it's' would not work as expected.

19.3.1 Areas

The different frame, menu and editing areas can all be adjusted. A line for changing the area colors and attributes appears as:

area AREA FOREGOUND BACKGROUND ATTRIBUTE

where

AREA
is one of the valid window areas (see below),

the FORE/BACKGROUND
colors are Black, Red, etc. Please note that setting the value does not matter what the colors are (white white and green green do exactly the same thing),

the ATTRIBUTE
is Normal, Reverse, Bold, etc.

When a window is created or text is displayed, it uses the attribute/color setting for that area.

The_background
The background window. Text is never displayed in this area. In most cases it's best to leave this as the default color (White White Normal).

Dir_Normal
Normal display for the directory selections.

Dir_Highlight
Highlighted directory selection.

Dir_Menu
Normal display of the menu, border, and bottom line in directories.

Dir_Menu_Highlight
Active menu selection in directories.

Editor_Normal
Normal display for characters in the editor.

Editor_HighLight
Display of 'special characters', blocks, etc. in the editor.

Editor_Menu
Normal display of the menu, border and status (bottom) line in the editor.

Editor_Menu_Highlight
Active menu selection in the editor.

Dialog_Border
The border around a dialog and the progress bar window.

Dialog_Normal
Normal characters in a dialog window.

Dialog_HighLight
Highlighted characters (outside of the ascii printing range) in a dialog window.

19.3.2 Characters

The appearance of Each character displayed in a edit screen can be changed though an RC file. For example, the following line in an RC file:

character 10 Editor_Highlight 48 65

will cause EOL characters to be displayed in the color and attribute associated with the Editor_Highlight value as the two characters ``0a''.

When an RC file is saved, only those characters which are not set to the defaults are printed, with one exception: the above line is always printed as an example line.

The syntax is very specific:

Character
The value of the character to set. This is a normal Ved expression. Values such as 10, $0a, ^L all represent the EOL character.

Area
The area attribute to apply to this character. Valid choices would include Editor_Highlight and Dir_Menu. In most cases you will use Editor_Normal or Editor_Highlight. Please note that this does not refer to where the character is displayed, but the display color/attribute to use.

Values
A list of up to 5 values representing the characters to use when displaying the character. In the above example, a EOL character will be displayed as the ASCII characters ``0'' and ``A'' (which are the hexadecimal value of a line feed). If you would like the character to be displayed as a small, reverse video circle you might want to use a line like:

character $0a Editor_Highlight 248

Not all characters can be displayed on all terminals.

The effects of the ``Option CharSet'' option (see Section 19.5) will override any setting made with the ``Character'' setting, so make sure this appears after ``Option CharSet'' in your RC file.

19.3.3 Directory Options

The following options can be set for the on-screen file selector:

Directory rm "rm 2>/dev/null"

This sets the program to use to delete a file. The default program is ``rm 2>/dev/null''. Note that the program name must be enclosed in a delimiter pair. The ``2>dev/null'' redirects any error output from ``rm'' to a bit bucket so that the error messages do not disrupt the display.

Directory cp "cp 2>dev/null"

This sets the program used to copy a file. The default program is ``cp''. Note that the program name must be enclosed in a delimter pair. The ``2>dev/null'' redirects any error output from ``cp'' to a bit bucket so that the error messages do not disrupt the display.

Directory Extend FALSE

By default a short directory form is used (names only). Setting this option to ``True'' generates a more detailed listing. This can also be set with the [X] key in a directory screen.

Directory Invisible FALSE

By default invisible entries (those starting with a ``.'') are not displayed. Setting this option to ``True'' cause all entries to be displayed. This option can also be toggled with the [I] or [.] keys in a directory screen.

Directory Reverse FALSE

This option will cause the sort order to be reversed if it is set to ``True''. This can also be accomplished in a directory screen with the [-] key.

Directory Scale 80

By default, the directory screen takes up an area 80% of the height and width of the terminal. You can change this by adjusting the ``scale'' value. The scale value must be between 20 and 100.

Directory Field Name

By default the directory is sorted by name. You can change this to ``extension'', ``type'', ``date'' or ``size''. You can also change the sort order in a menu screen with the menu selections or with [1], [2], [3], [4] and [0].


next up previous
Next: 19.4 Unexpected Termination Up: 19. RC Files Previous: 19.2 Saving Option Information
2004-05-02