Updated: 11 December 1998

Extensible Versatile Editor Reference Manual

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.)

Same as the DCL command.

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.
      

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

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
      

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

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
      

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.
      

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
      

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

Format

SHOW WILDCARDS

Description

The SHOW WILDCARDS command lists the wildcards available for the WILDCARD FIND command.

The list of wildcards appears in an EVE system buffer named SHOW. The output 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.

To set the type of wildcards, use the SET WILDCARD VMS command.

Related Commands

• SET WILDCARD VMS
• WILDCARD FIND

Example

To write out the information, so you can print the list later on, use the following commands. In this example, you write the information to a file called WILDCARDS.LIS.

Command: SHOW WILDCARDS
Command: BUFFER SHOW
Command: WRITE FILE WILDCARDS.LIS
      

Format

SHRINK WINDOW integer

Parameter

integer

The number of screen lines you want to subtract from the current window. 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 SHRINK WINDOW command shrinks the current window by the number of lines you specify, if you are using more than one window in EVE. SHRINK WINDOW subtracts lines from the bottom of the window unless the window is the bottommost window where it shrinks the lines from the top. The maximum size of a window depends on the size and type of terminal you are using. The minimum size is one line for text, one line for the status line, and in DECwindows, one line for the horizontal scroll bar.

For more information about using multiple windows in EVE, read the online help topic on Windows.

Related Commands

• DELETE WINDOW
• ENLARGE WINDOW
• ONE WINDOW
• SPLIT WINDOW
• TWO WINDOWS

Example

The following commands form two windows and then shrink the bottommost window by five lines:

Command: TWO WINDOWS
Command: SHRINK WINDOW 5
      

Key

Format

SPAWN [command-string]

Parameter

command-string

The system command you want executed in the subprocess, such as a utility you want to invoke. Exiting from that utility ends the subprocess and resumes your editing session. If you do not specify a command string, EVE spawns a subprocess for DCL. To resume your editing session, log out of the subprocess.

Description

The SPAWN command suspends, but does not end, your editing session so that you can work in a subprocess. You can use the SPAWN and ATTACH commands in EVE and at the DCL level or in other utilities such as MAIL. With the SPAWN command, you can keep an editing session active throughout your session (or login) while working in another subprocess. This makes it faster to resume editing, but uses more system resources.

To find out the names of your processes and subprocesses, use the following DCL command:

$ SHOW PROCESS/SUBPROCESS

You cannot use SPAWN with the DECwindows interface. However, because you can run other DECwindows applications concurrently or create DECterm windows, you may not need to use SPAWN.

Related Commands

• ATTACH
• DCL
• SPELL

Examples

To spawn a subprocess to run MAIL and then resume your editing session, use the following commands:

Command: SPAWN MAIL
MAIL>
       .
       .
       .
MAIL> EXIT
       [resumes your editing session]

 
      

To spawn a subprocess for DCL (indicated by the dollar sign prompt), including running other applications, and then to resume your editing session, use the following commands:

Command: SPAWN
$
       .
       .
       .
$ LOGOUT
      

Key

Format

SPELL [optional_parameters]

Parameter

optional_parameters

You can specify qualifiers for the OpenVMS DECspell utility.

Description

The SPELL command runs the OpenVMS DECspell utility if it is installed on your system to check spelling in the currently selected text or the entire buffer.

If you select less than a full line, EVE extends the select range to include the start and end of the line. If you do not select any text, SPELL checks the entire buffer.

EVE spawns a subprocess to run DECspell, and writes out the current buffer or the selected text to a temporary file in SYS$SCRATCH (which is usually your top-level login directory). After you make the corrections, exiting from DECspell resumes your editing session. EVE then replaces the buffer or range with the new version of the temporary file, containing any corrections, and deletes the temporary file.

SPELL with the DECwindow interface causes a DECterm window running the DECspell program to appear.

Do not use Ctrl/Y while using SPELL. This deletes lines in the temporary output file, and therefore destroys the selection or current buffer.

Related Commands

• BOX SELECT
• SELECT

Format

SPLIT WINDOW [integer]

Parameter

integer

The number of windows you want to form. If you do not specify a number, EVE splits the current window in two (the same as the TWO WINDOWS command). The maximum number of windows in EVE depends on the size and type of terminal you are using. With a 21-line main window (as on a VT220 terminal), you can have 11 windows, each displaying one line of text.

Description

The SPLIT WINDOW command splits the current EVE window into two or more smaller windows. You can view different buffers at the same time or different parts of the same buffer. The cursor appears in the bottom window. Each window has its own status line and displays the buffer you are currently editing.

To put a different buffer into the window, use one of the following commands:

• BUFFER
• GET FILE or OPEN
• NEW
• NEXT BUFFER or PREVIOUS BUFFER
• OPEN SELECTED
• SHOW BUFFERS or SHOW SYSTEM BUFFERS

For more information about using multiple windows in EVE, read the online help topic on Windows.

Related Commands

• DELETE WINDOW
• ENLARGE WINDOW
• NEXT WINDOW
• ONE WINDOW
• PREVIOUS WINDOW
• SHRINK WINDOW
• TWO WINDOWS

Example

The following command splits the current window into three smaller windows, putting the cursor in the bottommost of the three windows:

Command: SPLIT WINDOW 3
      

Copyright © Compaq Computer Corporation 1998. All rights reserved. Legal

6021PRO_014.HTML