Document revision date: 30 March 2001

## Extensible Versatile Editor Reference Manual

Previous | Contents | Index

## 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

Previous | Next | Contents | Index

| privacy and legal statement |
6021PRO_014.HTML