 |
Extensible Versatile Editor Reference Manual
SET WIDTH
Format
SET WIDTH integer
Parameter
integer
The number of columns you want for the width of the display. Specifying
either 132 or 80 changes the video font accordingly; other values do
not affect the video font. If you do not specify a number, EVE prompts
for one. Pressing the Return key or the Do key at the prompt without
typing anything cancels the operation. The default width is the same as
your terminal setting---usually, 80 columns.
Do not use a width greater than 80 on VT100-series terminals without
the advanced video option (AVO).
Description
The SET WIDTH command sets the width of the EVE screen layout to the
number of columns you specify. SET WIDTH does not affect how many
characters you can put on a line (which is determined by the right
margin), but only how many characters are visible.
The width determines the default right margin, unless you specify
otherwise by using the SET RIGHT MARGIN command. Thus, if you use a
width of 120 columns, the default right margin is 119.
To find out the current width, use the SHOW command. Also, the
horizontal length of the status line indicates the width of the window.
The width applies to all EVE windows and is a global setting, applying
in all buffers; it is not saved in a section file or command
file. To keep your setting for future editing sessions, put SET WIDTH
in an initialization file (EVE$INIT.EVE).
SET WIDTH makes the right margin of the $DEFAULTS$ buffer one column
less than the width. Buffers you create thereafter will have the same
right margin as $DEFAULTS$. For example, the command SET WIDTH 132
makes the default right margin 131; the command SET WIDTH 80 makes the
default right margin 79. This does not affect the right margin of other
existing buffers but only those buffers you create after a SET WIDTH
command.
Related Commands
SET RIGHT MARGIN
SHIFT LEFT
SHIFT RIGHT
SHOW
SET WILDCARD VMS
Format
SET WILDCARD VMS
Description
The SET WILDCARD VMS command enables OpenVMS-style wildcards for the
WILDCARD FIND command. This is the default setting on OpenVMS systems.
OpenVMS-style wildcards (sometimes called metacharacters)
include the percent sign (%) to match any single character on a line,
the asterisk (*) to match any amount of text on a line, and the
backslash (\) and right angle bracket (>) to match end-of-line. For
a list of the available wildcards, use the SHOW WILDCARDS command or
see Table 2-16.
The setting applies to the WILDCARD FIND and SHOW WILDCARDS commands.
It does not affect the wildcards you use to specify files with
GET FILE, INCLUDE FILE, and so on.
Table 2-16 EVE OpenVMS-Style Wildcards
Patterns |
Matches... |
%
|
Any single character within a line.
|
*
|
Any amount of text within a line.
|
**
|
Any amount of text, crossing lines.
|
\<
|
Start of a line.
|
\>
|
End of a line.
|
\[abc]
|
Any character in the specified set. For example,
\[aeiou] is the set of all vowels.
|
\[a--z]
|
Any character in the specified range. For example,
\[1--9] is the set of digits from 1 through 9. A hyphen (--)
at the beginning or end of a set is treated as a literal character, not
as a wildcard.
|
\[~abc]
|
Any character
not in the specified set. For example,
\[~aeiou] excludes all the vowels. A tilde (~) that is
not the first character in the bracketed set is treated as a
literal character, not as a wildcard.
|
\[~a--z]
|
Any character
not in the specified range. For example,
\[~1--9] excludes the digits from 1 through 9.
|
\A
|
Any alphabetic character, including supplementals.
|
\D
|
Any decimal digit.
|
\F
|
Any formatting character, such as BS , CR , FF , HT , LF , or VT .
|
\L
|
Any lowercase letter. Makes the entire search case exact.
|
\N
|
Any alphanumeric character (letter or digit).
|
\O
|
Any octal digit.
|
\P
|
Any punctuation character.
|
\S
|
Any symbol constituent (alphanumeric, dollar sign, or underscore).
|
\U
|
Any uppercase letter. Makes the entire search case exact.
|
\W
|
Any amount of white space---spaces, tabs, or up to one line break.
|
\X
|
Any hexadecimal digit.
|
\^
|
Any control character.
|
\+
|
Any character with bit 7 set.
|
\.
|
Repeats the previous pattern zero or more times, including the original.
|
\:
|
Repeats the previous pattern at least once, including the original;
that is, it does
not match a null occurrence.
|
\
|
Quotes any of the following; that is, it treats the character as
literal text, rather than as a wildcard:
*
|
asterisk
|
%
|
percent sign
|
[
|
left bracket
|
~
|
tilde
|
\
|
backslash
|
For example, to find an actual backslash, use \\; to find an actual percent sign, use \%.
|
Related Commands
SHOW WILDCARDS
WILDCARD FIND
Example
The following commands enable OpenVMS-style wildcards and then find a
string like bet or But at the end of a line:
|
Command: SET WILDCARD VMS
Command: WILDCARD FIND b%t\>
|
SET WRAP
Format
SET WRAP
Description
The SET WRAP command enables automatic word wrap for the current
buffer. This is the default.
EVE also automatically wraps an existing word to a new line if you add
a character to the end of that word that pushes the cursor past the
right margin.
EVE wraps text as you type at the end of a line. For example, if your
right margin is set to 70, then as the text you type pushes the cursor
past column 70, EVE starts a new line at the current left margin (in
effect, doing a return for you). EVE does not wrap text when
you type at the start of a line or in the middle of a line.
To disable wrapping, use the SET NOWRAP command so that lines can go
past the right margin. This is useful for editing very long lines, such
as multicolumn tables or program statements that are progressively
indented.
Word wrap is a buffer-specific setting; you can disable and enable
wrapping for the current buffer without affecting other buffers.
Commands and keys that insert text, such as INSERT HERE, PASTE,
RESTORE, or RESTORE LINE do not automatically rewrap text. Depending on
where and how much you insert, your text may go past the right margin
or out of view. To rewrap existing text, use FILL commands.
To find out if word wrap is enabled, use the SHOW command.
Related Commands
FILL
SET NOWRAP
SET RIGHT MARGIN
SHOW
Example
This section describes an example of SET WRAP in use.
As you start a new word at the end of a line that is past column 70,
EVE starts a new line at the current left margin (in effect, doing a
return for you). You start a "new word" by first typing one or more
white-space characters (spaces and tabs), and then typing a
non-whitespace character.
If you add a character at the end of an existing work so that the
cursor goes past column 70, EVE wraps the existing word to a new line
at the current left margin. (An exception to this rule is if the word
starts at the left margin, with no white space to the left of the word.
In this case, EVE does not wrap the text.)
SHELL
Same as the DCL command.
SHIFT LEFT
Format
SHIFT LEFT integer
Parameter
integer
The number of columns you want to shift the window to the left. You
cannot shift the window left past column 1. If you do not specify a
number, EVE prompts for one. Pressing the Return key or the Do key at
the prompt without typing anything cancels the operation.
Description
The SHIFT LEFT command shifts the current EVE window to the left by the
number of columns you specify. With the SHIFT LEFT and SHIFT RIGHT
commands, you can view the undisplayed portion of very wide text, such
as lines 100 characters long, without having to change the width of the
window or use 132-column mode. This does not shift text within the
buffer, but shifts the window's horizontal position relative to the
buffer.
SHIFT LEFT and SHIFT RIGHT commands affect only the current window, if
you are using two or more windows in EVE.
To find out the current width and any shift, use the SHOW command.
Related Commands
SET WIDTH
SHIFT RIGHT
SHOW
Example
In the following example, you shift the current window five columns to
the right, and then another five columns to the right. Thus, column 11
of the buffer appears in the leftmost column of the screen. You then
shift the window back 10 columns to the left (so that column 1 of the
buffer is in the leftmost column of the screen). For each shift right,
EVE tells you the cumulative shift.
|
Command: SHIFT RIGHT 5
Window now shifted right 5 columns.
Command: SHIFT RIGHT 5
Window now shifted right 10 columns.
.
.
.
Command: SHIFT LEFT 10
Window now shifted right 0 columns.
|
SHIFT RIGHT
Format
SHIFT RIGHT integer
Parameter
integer
The number of columns you want to shift the window to the right. If you
do not specify a number, EVE prompts for one. Pressing the Return key
or the Do key at the prompt without typing anything cancels the
operation.
Description
The SHIFT RIGHT command shifts the current EVE window to the right by
the number of columns you specify. With the SHIFT RIGHT and SHIFT LEFT
commands, you can view the undisplayed portion of very wide text, such
as lines 100 characters long, without having to change the width of the
window or use 132-column mode. This does not shift text within the
buffer, but shifts the window's horizontal position relative to the
buffer.
SHIFT RIGHT and SHIFT LEFT commands affect only the current window, if
you are using two or more windows in EVE.
To find out the current width and any shift, use the SHOW command.
For an example of using SHIFT RIGHT and SHIFT LEFT, see the description
of the SHIFT LEFT command.
Related Commands
SET WIDTH
SHIFT LEFT
SHOW
SHOW
Format
SHOW
Description
The SHOW command shows information about the current buffer or other
buffers you created. SHOW displays the following information:
- Name of the buffer
- Input file for the buffer, if any
- Output file for the buffer, if any (usually the same as the input
file)
- Journal file for the buffer, if any
- Whether the buffer has been modified
- Total number of lines in the buffer
- Margins, tab stops, and other buffer settings
- Window width and any shift
- Names of markers in the buffer, if any
- List of nondefault keymaps for the buffer, if any
The output appears in an EVE system buffer named SHOW. If you created
other buffers, EVE first shows information about the current buffer.
To show information about your other buffers, if any, press the Do key.
To return to the current buffer, press any other key.
If you created only one buffer, press any key to return to that buffer.
The following is typical of the output from the SHOW command. In this
case, you are editing a file called JABBER.TXT in which you have made
several edits and marked two positions:
EVE V3.1 1993-03-17 08:47
Information about buffer EVE31_SHOW.TXT
Input file: DISK$1:[USERS.MEMOS]JABBER.TXT;1
Output file: DISK$1:[USERS.MEMOS]JABBER.TXT;
Journal file: DISK$1:[USER]JABBER_TXT.TPU$JOURNAL;1
Modified Left margin set to: 5
Mode: Insert Right margin set to: 72
Paragraph indent: -4 WPS word wrap indent: none
Write Modifiable
Direction: Forward Window width set to: 80
28 lines
Tab stops set every 10 columns.
Word wrap: on
Marks:
St. Keyne England sacred well
|
Related Commands
RESET
SHOW BUFFERS
SHOW DEFAULTS BUFFER
SHOW SUMMARY
SHOW WILDCARDS
Example
The output from the SHOW command remains in the SHOW buffer until you
do another SHOW command or exit from EVE. To write out the information,
so you can keep a record of the margins and tab stops you used, use the
following commands. In this example, you write the information to a
file called SHOWINFO.LIS:
|
Command: SHOW
Command: BUFFER SHOW
Command: WRITE FILE SHOWINFO.LIS
|
SHOW BUFFERS
Format
SHOW BUFFERS
Description
The SHOW BUFFERS command lists the buffers you created and puts the
cursor in the list so you can view or delete a buffer without having to
type the buffer name.
The list appears in an EVE system buffer named BUFFER LIST in the
current window. The name of the buffer you are in is highlighted, with
the cursor on the name of that buffer (unless you are in a system
buffer). To delete that buffer, use REMOVE, CUT, BOX CUT, or the WPS
Cut key.
This is the same as using the BUFFER or DELETE BUFFER command without
having to type the buffer name.
You can copy the list of buffers (in case you want to paste the list
elsewhere) by using the SHOW BUFFERS command to get a list of your
buffers, the SELECT ALL command to select all of the BUFFER LIST
buffer, and the STORE TEXT or COPY command to copy the selected text.
Related Commands
BUFFER
DELETE BUFFER
NEXT BUFFER
SHOW
SHOW SYSTEM BUFFERS
SHOW DEFAULTS BUFFER
Format
SHOW DEFAULTS BUFFER
Description
The SHOW DEFAULTS BUFFER command shows information about the $DEFAULTS$
buffer---margins, tab stops, direction, mode, maximum lines, and so on.
The $DEFAULTS$ buffer is an EVE system buffer whose settings are used
when you create new buffers.
If you use an initialization file to invoke EVE, commands in the
initialization file for buffer settings apply to the $DEFAULTS$ buffer
as well as to the MAIN (or first) buffer. Each buffer you create from
then on has the same setting (effectively, setting your own private
defaults). The default initialization file is EVE$INIT.EVE. If your
initialization file does not have commands for buffer settings, EVE
uses the default settings. For more information about EVE default
settings, read the online help topic on Defaults.
The output appears in an EVE system buffer named SHOW. To return to the
buffer you were editing, press any key.
The following is typical of the output from the SHOW DEFAULTS BUFFER
command:
EVE V3.1 1993-03-17 08:47
Information about buffer $DEFAULTS$
Not modified Left margin set to: 1
Mode: Insert Right margin set to: 79
Paragraph indent: none WPS word wrap indent: none
Read-only Unmodifiable
Direction: Forward
Max lines: no limit
Tab stops set every 8 columns.
Word wrap: on
|
Related Commands
SHOW
SHOW SYSTEM BUFFERS
Example
In the following example, the commands write the buffer information to
a file called DEFAULTS.LIS:
|
Command: SHOW DEFAULTS BUFFER
Command: BUFFER SHOW
Command: WRITE FILE DEFAULTS.LIS
|
SHOW KEY
Format
SHOW KEY keyname
Parameter
keyname
The key you want to know about. If you do not specify a key name, EVE
prompts you to press the key you want to know about. For information
about key names and nondefinable keys, read the online help topic on
Names For Keys.
Description
The SHOW KEY command shows the definition of a key, telling you the
command or keypad function bound to the key, if any. The output from
SHOW KEY appears in the message window at the bottom of the EVE screen
layout. If the key you specify is defined for a learn sequence, EVE
tells you the key is defined as "Sequence" because a learn
sequence may comprise several keystrokes or commands.
Example
The following command shows the definition of GOLD-KP8 when you set the
EDT keypad:
|
Command: SHOW KEY GOLD-KP8
GOLD-KP8 is defined as 'fill' in the EDT keypad.
|
SHOW SUMMARY
Format
SHOW SUMMARY
Description
The SHOW SUMMARY command shows statistics and other information about
EVE. SHOW SUMMARY displays the following:
- Version number of the software
- Current journal file specification, if any
- Current section file specification
- Total number of buffers (system- and user-created)
- Modules used in the current section file
- Other information about the EVE configuration
The output from SHOW SUMMARY is useful for DECTPU programming or when
you have to submit a software performance report (SPR). The output
appears in an EVE system buffer named SHOW. The output from SHOW
SUMMARY remains in the SHOW buffer until you do another SHOW command or
exit from EVE. To scroll through the list, press the <uparrow
symbol> and <downarrow symbol> keys or other cursor-movement
keys. To return to the buffer you were editing, press Do or use the
RESET command.
Related Commands
SHOW
SHOW BUFFERS
SHOW DEFAULTS BUFFER
SHOW SYSTEM BUFFERS
Example
To write out the information, use the following commands. In this
example, you write the SHOW buffer to a file called SUMMARY.LIS:
|
Command: SHOW SUMMARY
Command: BUFFER SHOW
Command: WRITE FILE SUMMARY.LIS
|
SHOW SYSTEM BUFFERS
Format
SHOW SYSTEM BUFFERS
Description
The SHOW SYSTEM BUFFERS command lists the buffers created by EVE and
puts the cursor in the list.
The list appears in an EVE system buffer named BUFFER LIST in the
current window. If you are in a system buffer (such as MESSAGES), the
name of that buffer is highlighted and the cursor is on the name of the
buffer.
To view that buffer in the current window, use SELECT or RETURN.
As a rule, do not delete system buffers, such as the INSERT HERE buffer
or $RESTORE$ buffer, and do not change their read/write status or other
attributes. Some system buffers cannot be deleted or changed.
Related Commands
SHOW BUFFERS
SHOW DEFAULT BUFFERS
|