OpenVMS User's Manual

EVE lets you view more than one window on your terminal screen at the same time. For example, you can have two windows on the terminal screen to view and edit different sections of the same buffer.

8.19.17 Keys Used with EVE Windows

The following table describes EVE keys used to create and manipulate windows:

Key or Key Sequence	Function in a Window Environment
GOLD Next Screen	Puts the cursor in the next (or other) window. Same as the NEXT WINDOW command. For more information about GOLD key combinations, see Section A.2.11.
GOLD Prev Screen	Puts the cursor in the previous (or other) window. Same as the PREVIOUS WINDOW command. For more information about GOLD key combinations, see Section A.2.11.

8.19.18 EVE Window Commands

To view two sections of a file at the same time, use the SPLIT WINDOW command. EVE splits your screen and creates two identical windows. The cursor maintains its position in the buffer but appears only in the bottom window. The buffer name is the same in both status lines.

Displaying two sections of a long file makes moving text within a file efficient. You can select and remove text from one part of the file and insert it into the other. To move the cursor from one window to the other, enter the NEXT WINDOW command.

To remove the second window from the screen and expand the current window to occupy the whole editing area, press the Do key, enter the command ONE WINDOW, and press the Return key.

8.19.20 Editing Two Buffers

The following procedure describes how to edit two buffers containing different files:

Step	Task
1	Create two windows on your screen by entering the SPLIT WINDOW command. EVE splits your screen and creates two windows. The cursor maintains its position in the buffer but appears only in the bottom window. The buffer name in each of the highlighted status lines is the same.
2	Use the GET FILE, OPEN, or OPEN SELECTED command to put a second file in the current window. To display a buffer that you created earlier in the editing session in the current window, enter the BUFFER command and the name of the buffer you want to display. Your terminal screen now displays two different buffers. You can select and remove text from one buffer and insert it into the other buffer. To move the cursor from one window to the other, enter the command NEXT WINDOW.

8.20 Creating a Subprocess

You can create a subprocess to switch between an EVE editing session and DCL command level without terminating your editing session. To create a subprocess, enter the SPAWN command. EVE suspends the current editing session and connects your terminal to a new subprocess. The DCL prompt ($) appears on your terminal screen.

8.20.1 Spawning

The most common reasons to spawn a subprocess are to invoke the Mail utility and to run screen-oriented programs, although your subprocess can invoke any OpenVMS utility or execute any DCL command.

To return to your editing session, log out of the subprocess by entering the DCL command LOGOUT. EVE resumes the editing session, and the cursor appears in the location it occupied before you spawned the subprocess. You can also supply a DCL command as a parameter to the SPAWN command to create a specific subprocess.

8.20.2 Example

In the following example, the Mail utility is spawned from EVE:

[End of file] 
 
 
Buffer: MAIN                           | Write | Insert | Forward 
Command: SPAWN MAIL

The prompt for the Mail utility (MAIL>) appears on the screen. When you exit from Mail, you are automatically logged out of the subprocess and EVE resumes the editing session.

8.20.3 Spawning to EVE from DCL

Rather than spawn a process to use DCL, you can spawn a process for an EVE editing session and then attach to the parent DCL process to use DCL commands and utilities.

When you want to return to the DCL command level, use the EVE command ATTACH to return to the parent process.

To resume your editing session, reconnect to the editing subprocess by using the DCL command ATTACH with the process name of the subprocess.

8.20.4 Example

In the following example, a subprocess is created using the DCL command SPAWN. The SPAWN command creates the subprocess SMITH_1. At the subprocess level, EVE is invoked and the editing session is conducted. At the end of the editing session, the ATTACH command is entered and you are returned to DCL. Then, to resume the editing session,the DCL command ATTACH is entered using the the process name of the subprocess SMITH_1:

$ SPAWN
%DCL-S-SPAWNED, process SMITH_1 spawned 
%DCL-S-ATTACHED, terminal now attached to process SMITH_1
 
 
[End of file] 
 
 
Buffer: MAIN                        | Write | Insert | Forward 
Command: ATTACH SMITH
 
$ ATTACH SMITH_1

Although the default text editor on the OpenVMS operating system is EVE, you may also wish to use the EDT editor. EDT is an interactive text editor with which you can create a new file, insert text into it, and modify that text. You can also edit text in existing files with EDT.

This chapter describes:

• Features of EDT
• Beginning EDT editing sessions
• Entering EDT line commands
• Entering EDT keypad commands
• Using online help in EDT
• Ending EDT editing sessions
• Changing editing modes
• Recovering from interruptions
• Summary of EDT commands

For more information on using the EDT editor, refer to OpenVMS EDT Reference Manual.

9.2 Editing Modes

EDT provides both line editing and keypad editing. In line editing, you type the editing command and the range of text you want the command to affect. In keypad editing, you move the cursor directly to the text you want to change and press keypad keys to enter the editing commands.

One way to use EDT is to use the keypad as the primary editing mode in combination with various line-editing commands.

9.3 Nokeypad Editing

You can also redefine certain keypad and control keys to perform editing functions not available in keypad mode. This is called nokeypad editing. Nokeypad commands are the basis for keypad mode key definitions and consist of English words and abbreviations. You can use nokeypad mode commands to define keys.

9.4 Beginning EDT Editing Sessions

The following sections describe how to begin a session using the EDT editor.

9.4.1 Invoking EDT

To invoke EDT, enter the DCL command EDIT/EDT followed by the name of the file you want to edit. The first few lines of the latest version of the file appear on the screen. The cursor is positioned at the top of the screen, and EDT is ready to receive a keypad-editing command.

9.4.2 Example

In the following example, a file named MEMO.TXT is edited:

$ EDIT/EDT MEMO.TXT
 
 
Once the weather turns cold, mice may find a crack in your 
foundation and enter your house.  They're looking for food and 
shelter from the harsh weather ahead. 
 
[EOB]

When you edit a file that already exists (for example, if you created the file during a previous session), EDT saves the existing versions and places a copy of the latest version in your buffer. A buffer is the temporary storage area in which you edit text. The existing versions of the file remain unchanged.

9.4.4 Creating Files

If you invoke EDT to create a file, the following message appears:

$ EDIT/EDT NEWFILE.TXT
 
Input file does not exist
[EOB]
*

Only the EDT message and the end-of-buffer symbol ([EOB]) appear on the screen, and EDT is ready to receive keypad-editing commands.

9.4.5 Changing Editing Modes

In the previous examples, you enter EDT in keypad (change) mode because a startup command file (SYS$LOGIN:EDTINI.EDT) containing the SET MODE CHANGE command has been executed. If this command is not executed in an EDT startup command file, you enter EDT in line mode. Enter the CHANGE command at the asterisk (*) prompt to change to keypad mode.

For information on creating a startup command file, see the OpenVMS EDT Reference Manual.

9.5 Using EDT Line Commands

The following sections describe how to use EDT line commands during an editing session.

9.5.1 Line Editing

EDT prompts for line-editing commands with an asterisk (*). Line-editing commands usually operate on a range of one or more lines of text that you specify as a parameter for the command. You can abbreviate EDT line-editing commands. For clarity, the examples in this chapter show complete line-editing commands.

9.5.2 Example: Line Editing

The following example shows the line editing command that you would enter to display an entire file on your screen:

*TYPE WHOLE

To help you locate and edit text, EDT assigns line numbers. These line numbers are not part of the text and are not kept when you end an editing session.

When you insert new text, EDT numbers the lines using decimal numbers. For example, if you add a line of text between lines 13 and 14, it is numbered 13.1. To avoid confusion when working with decimal numbers, enter the RESEQUENCE command. The RESEQUENCE command renumbers all the lines from the cursor to the end of the buffer in increments of one.

Note that the EDT line-editing command SET NUMBERS (the default) must be in effect for line numbers to be displayed in EDT line editing.

9.5.4 Example: Displaying Line Numbers

The following example shows how to display all the line numbers in an existing file:

* TYPE WHOLE
    1          oneoneoneoneoneoneone 
    2          twotwotwotwotwo 
    3          threethreethree 
    4          fourfourfourfour 
    5          fivefivefivefive
[EOB]
*

Some EDT line-mode commands can affect a range of lines. For example, the INSERT command will create a new line of text in your buffer; to insert a new line of text at the beginning of your buffer, enter the command INSERT BEGIN.

9.5.6 EDT Line-Mode Command Ranges

The following table describes the different ranges you can specify when you edit a file in line mode:

Range Type	Description
period (.)	Current line
number	EDT line number
'string'	Next line containing the quoted string
BEGIN	First line of the buffer
END	After the last line in the buffer ([EOB])
LAST	Last line EDT was at in the previous buffer
WHOLE	Entire buffer
BEFORE	All lines in the buffer before the current line
REST	All lines in the buffer starting with the current line and ending with the last line

9.5.7 EDT Command-Line Symbols for Specifying Ranges

The following table lists symbols and words that you can combine with the line-mode command ranges:

Symbol or Word	Description
, or AND	Used to join noncontiguous ranges in a list; only single lines can be joined in this way
: or THRU	Indicates a group of lines starting with the first range specifier and ending with the second
n	Indicates the number of lines from the current line
# n or FOR n	Indicates the next n number of lines
+ "string" or "n"	Indicates that string or n refers to a line or lines after the current line
-- "string" or "n"	Indicates that string or n refers to a line or lines before the current line
ALL "string" or "n"	Indicates that the command applies to all lines containing string

9.5.8 Canceling EDT Commands

Use Ctrl/C to cancel the currently executing EDT command without affecting previous edits. For example, to stop the display of a long file, press Ctrl/C.

*TYPE WHOLE
 . 
     . 
     .
[Ctrl/C]
Cancel
Press return to continue
[Return]
Aborted by CTRL/C

While line editing allows you to manipulate large portions of text easily, keypad editing provides easy manipulation of small units of text. EDT keypad commands enable you to find, insert, delete, substitute, and move text in a file. The cursor can be moved through a file in a variety of ways. The position of the cursor in a file determines how text will be affected by EDT commands.

9.6.1 Keypad Editing

In keypad editing, the screen displays editing changes as you make them. You type text from the main keyboard and enter keypad-editing commands from the numeric keypad. To display a diagram of the keypad keys, press PF2 while in keypad mode. To initiate keypad editing, you must first enter the line-editing command CHANGE or have SET MODE CHANGE in your EDT startup file. See Section 9.9.2 for information on the CHANGE command.

In keypad mode, you can manipulate the cursor with commands that move it unit-by-unit through the text or with commands that move it directly to a particular location.

9.6.2 Using the Keypad

Each key in the keypad performs at least one editing command; most perform two. Pressing a key invokes the primary function. To invoke the alternate function of a key, press the GOLD key (labeled PF1) first, then press the desired key. In the examples that follow, a small diagram of the keypad highlights the key or key sequences that perform the command being described. The text associated with the keypad illustrates the effect of that editing command.

The supplemental editing keys on the keypad perform the same functions as some of the EDT keypad keys.

9.6.3 Example: Using the WORD Function

Keypad key 1 (KP1) performs both the WORD and the CHNGCASE functions. To enter the WORD command, press KP1. The cursor moves to the beginning of the next word.

Once the weather turns cold, mice may 
find a crack in your foundation and enter your house.  They're 
looking for food and shelter from the harsh weather ahead. 
 
[EOB]

To enter the CHNGCASE command, press the GOLD key first and then CHNGCASE. The character at the cursor (or the characters highlighted with the Select key) changes from lowercase to uppercase or from uppercase to lowercase.

Once The weather turns cold, mice may 
find a crack in your foundation and enter your house.  They're 
looking for food and shelter from the harsh weather ahead. 
 
[EOB]

The "T" in the word "The" is now capitalized.

9.7 Using Online Help in EDT

The following sections describe how to use online help during an EDT editing session.

9.7.1 Getting Keypad Help

In keypad mode, you can display a diagram of the keypad keys by pressing PF2. On LK201-series keyboards, you can also use the Help key on the supplemental editing keypad. To display information about a particular keypad command, first press the Help key and then press the keypad key.

9.7.2 Getting Line Mode Help

To request help in EDT while in line mode, enter the HELP command at the asterisk (*) prompt and press Return. To display information about a particular command, type HELP followed by the name of the command. EDT displays information about the command and lists related topics. For example, to request help on the COPY command, enter the following command line:

*HELP COPY [Return]

If you are in nokeypad mode and want to get help information about nokeypad commands, enter HELP CHANGE at the asterisk (*) prompt.

9.8 Ending EDT Editing Sessions

To terminate an EDT session, press Ctrl/Z. This puts you into line-editing mode. You can type EXIT or QUIT at the asterisk (*) prompt. EXIT saves your edits in a new version of the file; QUIT terminates the editing session and does not save your edits.

The existing versions of a file remain unchanged regardless of how you end the editing session. To override the default output file name, enter the EXIT command with a new file specification as the parameter. Note that if a file is given the same file name as an existing file, the two files will have the same file name and file type, but different version numbers and content.

9.8.1 Saving Edits

By default, the EXIT command creates an output file with the same file name and file type as the input file but with the version number incremented by 1.

9.8.2 Examples

• In the following example, the EXIT command is entered after a file named MEMO.TXT;3, is edited. EDT then creates a higher version named MEMO.TXT;4:

  *EXIT
  DISK1:[USER]MEMO.TXT;4  2 lines
  $
  

• If the same editing session is ended with the command EXIT MICE.TXT, EDT names the output file MICE.TXT;1, provided no other file named MICE.TXT exists. If a file named MICE.TXT exists, EDT names the output file MICE.TXT; version-number, where version-number is one greater than the highest version number of an existing MICE.TXT file.

To terminate EDT without saving your edits, use the line-editing command QUIT. All edits you have made to the text are ignored, and no output file is created.

The QUIT command is a useful way to terminate EDT when you have opened a file by mistake. No new file version is created.

9.9 Changing Editing Modes

You can switch back and forth between line and keypad editing. You can also enter line-editing commands from keypad mode. If find yourself frequently returning to line mode to enter EDT commands, you might find it easier to work in line mode. For example, if you are examining a file on a line-by-line basis, using line numbers as reference points, line-mode editing is more appropriate. In contrast, if you need to examine, cut, and paste large chunks of text between nonadjacent areas within a file or between two files, keypad editing might be faster.

9.9.1 Changing from Keypad to Line Editing

To change from keypad editing to line editing, press Ctrl/Z. When you see the asterisk (*) prompt at the bottom of your screen, enter a line-editing command at the prompt. For example:

Once the weather turns cold, mice may find a crack in your 
foundation and enter your house.  They're looking for food and 
shelter from the harsh weather ahead.  
 
[EOB]
[Ctrl/Z]
 
 
 
* INSERT

To change from line editing to keypad editing, enter the CHANGE command:

*CHANGE

The first 22 lines of the file display on your screen. If the file has fewer than 22 lines, the [EOB] symbol appears below the last line of the file.

9.9.3 Entering Line-Editing Commands from Keypad Mode

The keypad COMMAND function allows you to enter line-editing commands without leaving keypad mode. First, enter the COMMAND function by pressing the GOLD key (PF1) and then the COMMAND key (KP7).

EDT displays the Command: prompt. At the prompt, enter a line-editing command.

9.9.4 Example

The following example enters the line-editing command SET QUIET, which suppresses the sound made when EDT issues an error message. To execute the command, press the Enter key. (If you press Return by mistake, ^M appears; delete the ^M by pressing the Delete key on the main keyboard and press Enter.)

Once the weather turns cold, mice may find a crack in your 
foundation and enter your house.  They're looking for food and 
shelter from the harsh weather ahead.  
 
[EOB]
Command:   SET QUIET

The following sections describe how to recover from interruptions during an EDT editing session.

9.10.1 Restoring the Display

Pressing Ctrl/W removes extraneous characters (such as a broadcast message or a message indicating that you have received electronic mail) from the screen and restores the previous display. Use Ctrl/W to ensure that the cursor is in the correct position.

9.10.2 Recovering from Ctrl/Y

The DCL command CONTINUE resumes an editing session that was interrupted by pressing Ctrl/Y, as long as only built-in DCL commands were entered after pressing Ctrl/Y. For example, you could press Ctrl/Y, enter the command SHOW TIME, and return to your editing session with the CONTINUE command. You enter the SHOW TIME and CONTINUE commands at the DCL prompt.

After you enter the CONTINUE command, press Ctrl/W to refresh the screen display. EDT redisplays the text of your editing session.

9.10.3 Journal Files

By default, EDT keeps a journal file with the same file name as the input file and a file type .JOU. If the editing session ends without interruption, the journal file is deleted when you terminate the session. If the editing session is aborted (for example, during a system failure, in response to pressing Ctrl/Y, or entering the QUIT/SAVE command), you can recover your edits with the exception of those commands entered just prior to the interruption. Enter the same command line you used to begin the editing session, adding the /RECOVER qualifier. For example:

$ EDIT/RECOVER MICE.TXT

EDT will reproduce the editing session, reading the commands from the journal file and executing them on the screen.

9.11 Summary of EDT Commands

The following sections list the commands and keys you can use to perform specific EDT operations.

9.11.1 Changing Editing Modes

The following table describes commands and keys that can be used to change edit modes:

Keypad Mode	Line Mode	Nokeypad Mode	Description
COMMAND		EXT (Extend)	Enables you to enter a line-mode command while EDT is still in keypad or nokeypad mode.
Ctrl/Z	CHANGE	EX	Transfers your editing session from one mode (line, keypad, or nokeypad) to another.
	SET MODE		Establishes the initial mode of the EDT session when used in a startup command file.
	SHOW MODE		Indicates which SET MODE command was most recently issued.

9.11.2 Moving the Cursor

The following table describes commands and keys that can be used to move the cursor:

Keypad Mode	Line Mode	Nokeypad Mode	Description
BACKSPACE		BL	Moves the cursor to the beginning of the current line.
BOTTOM	TYPE END	ER	Moves the cursor to the end of the buffer, after the last character position in the buffer.
CHAR		C	Moves the cursor one character in the current direction (forward or backward, depending on whether ADVANCE or BACKUP is in effect).
Down arrow key		Down arrow key	Moves the cursor down one line toward the bottom of the buffer, regardless of whether ADVANCE or BACKUP is in effect.
EOL		EL	Moves the cursor to the end of the current line if the direction is forward. If the current direction is backward, the cursor moves to the end of the previous line.
Left arrow key		Left arrow key	Moves the cursor one character to the left, regardless of whether ADVANCE or BACKUP is in effect.
		"move"	Moves the cursor within the current buffer.
LINE		L	Moves the cursor to the beginning of the next line if the direction is forward or to the beginning of the current line if the direction is backward. If the direction is backward, pressing LINE again moves the cursor to the beginning of the previous line.
		KS	Modifies the position of the cursor at the completion of the PASTE command.
PAGE		PAGE PAGETOP	Moves the cursor to the right of the next page marker or to the next form-feed character. If you have no page markers (defined with the SET ENTITY PAGE command), the PAGE entity is the whole buffer.
		TOP	Moves the cursor to the top of the screen.
Right arrow key		Right arrow key	Moves the cursor one character to the right, regardless of of whether ADVANCE or BACKUP is in effect.
SECT		16L.	Moves the cursor one section (16 lines) toward the end or the beginning of the buffer, depending on whether ADVANCE or BACKUP is in effect.
	SET CURSOR		Controls scrolling of the screen relative to the cursor position. This command has no effect if you are editing in line mode.
	SHOW CURSOR		Displays values set by the SET CURSOR command.
TOP		BR	Moves the cursor to the first character at the beginning of the buffer.
Up arrow key		Up arrow key	Moves the cursor up one line toward the top of the buffer regardless of of whether ADVANCE or BACKUP is in effect.
WORD		W	Moves the cursor to the beginning of the next word in the current direction (forward or backward, depending on whether ADVANCE or BACKUP is in effect).

9.11.3 Inserting Text

The following table describes commands and keys that can be used to insert text:

Keypad Mode	Line Mode	Nokeypad Mode	Description
Ctrl/L		^L.	Inserts a form-feed character (<FF>) into your text.
Ctrl/M		^M.	Inserts a carriage-return character (<CR>) into your text.
Ctrl/R	Ctrl/R	REF	Clears and redraws the screen display (in keypad mode) or line (in line mode), eliminating any extraneous characters or messages. The current text you are editing remains unchanged. In keypad mode, Ctrl/R is identical to Ctrl/W.
Ctrl/W		REF	Clears and redraws the screen display (in keypad mode) or line (in line mode), eliminating any extraneous characters or messages. The current text you are editing remains unchanged.
	Ctrl/Z	Ctrl/Z	Completes the insert operation and returns EDT to the command state. Used with the INSERT (nokeypad I) and REPLACE (nokeypad R) commands.
FILL (VT100) Ctrl/F (VT52)	FILL	FILL FILLSR	Takes a select range of lines and reorganizes the text so that the maximum number of whole words can fit within the current line width. In line mode, fills a selected range of lines.
	INCLUDE		Copies external files into the EDT text buffer. In line mode, EDT displays an asterisk (*) prompt when the INCLUDE command finishes copying the file. In keypad or nokeypad mode, the included text appears on the screen.
OPEN LINE	INSERT	I [Return]	Inserts a line terminator in the text you are editing at the current cursor position and makes the line terminator the new cursor character.
	INSERT	I	Adds text to the current or specified buffer.
SPECINS		ASC (ASCII) Circumflex (^)	Enables you to insert any character from the DEC Multinational character set into your text, using the character's decimal equivalent value (see Appendix B). The circumflex (^) works only for characters with decimal values 0 to 31.

9.11.4 Deleting and Restoring Text

The following table describes commands and keys that can be used to delete and restore text:

Keypad Mode	Line Mode	Nokeypad Mode	Description
Ctrl/U		DBL	Deletes everything from the character to the left of the cursor to the beginning of the line.
	DELETE	D	Deletes a line or group of lines, depending on the range that you specify. If you do not specify a buffer or a range, EDT deletes the current line. If you specify a buffer but not a range, EDT moves to that buffer and deletes its entire contents.
DEL C	DELETE	DC	Deletes the character on which the cursor is positioned.
		D-C	Deletes the character to the left of the cursor.
		D+C	Deletes the character to the right of the cursor.
DEL EOL	DELETE	DEL	Deletes everything on a line from the current cursor position up to, but not including, the line terminator.
DEL L	DELETE	D+NL	Deletes everything on a line from the current cursor position up to and including the line terminator.
DEL W	DELETE	DEW	Deletes words or parts of words.
LINEFEED		DBW	Deletes the word or characters in a word to the left of the cursor up to the beginning of the previous word.
REPLACE	REPLACE	R (Replace)	In keypad mode, deletes text in the select range and replaces it with the contents of the PASTE buffer. In line and nokeypad mode, deletes the lines specified by range from the current or specified buffer and replaces the deleted lines with text that you enter at the terminal.
UND C		UNDC	Inserts the current contents of the delete character buffer into text to the left of the cursor.
UND L		UNDL	Inserts the current contents of the delete line buffer into text to the left of the cursor.
UND W		UNDW	Inserts the current contents of the delete word buffer into text to the left of the cursor.

9.11.5 Locating Text

The following table describes commands and keys that can be used to locate text:

Keypad Mode	Line Mode	Nokeypad Mode	Description
ADVANCE		ADV	Sets the direction for subsequent editing work to forward (to the right of the cursor and down toward the end of the buffer).
BACKUP		BACK	Sets the direction for subsequent editing work to backward (to the left of the cursor and toward the beginning of the buffer).
		CLSS	Clears the text string currently in the search buffer.
FIND	FIND	"string" ^@.	Searches for specified text.
FNDNXT	FIND ""	""	Searches for the next occurrence of a string defined by the FIND command.
RESET		RESET	Cancels the active select range, sets the direction to advance, and sets EDT to the DMOV (default move) state.
		DESEL	Cancels the active select range.
		TGSEL	Combines the SEL and DESEL commands. When there is an active select range, the TGSEL command cancels it, performing the same function as the DESEL command. When there is no active select range, TGSEL initiates the process of creating a select range, just as the SEL command does.
SELECT		SEL	Sets up a select range for use with keypad functions such as APPEND, CHNGCASE, CUT, FILL, REPLACE, SUBS, and Ctrl/T.
		SSEL	Finds a string and designates it as a select range.
	SET SEARCH		Determines how EDT locates strings during your editing sessions.
	SHOW SEARCH		Indicates the search parameters EDT uses to locate strings in text.

9.11.6 Substituting Text

The following table describes commands and keys that can be used to substitute text:

Keypad Mode	Line Mode	Nokeypad Mode	Description
SUBS	SUBSTITUTE	S	In keypad mode, replaces the current search string with the contents of the PASTE buffer. In line and nokeypad mode, replaces one string with another throughout the specified range.
	SUBSTITUTE NEXT	SN	Searches for the next occurrence of a string and replaces it with another string. This command uses strings that have been stored in the search buffer and in the substitute buffer.

9.11.7 Moving Text

The following table describes commands and keys that can be used to move text:

Keypad Mode	Line Mode	Nokeypad Mode	Description
APPEND		APPEND	Deletes the select range (keypad mode) or specified entity (nokeypad mode) from the current buffer and adds it to the end of either the PASTE buffer (the default) or the specified buffer.
	COPY		Copies the specified text to the specified location. You can copy a range of text from one location to another within the same buffer, or you can copy to and from different buffers, creating new buffers as appropriate. No text is deleted. The /DUPLICATE qualifier enables you to copy the specified text n times.
CUT		CUT	In keypad mode, removes the active select range from the current buffer and stores it in the PASTE buffer. In nokeypad mode, removes the specified entity from the text buffer and stores it in another specified buffer.
CUT + PASTE	MOVE	CUT + PASTE	Moves lines from one location to another within the current buffer or from one buffer to another. The lines are deleted from their original position and are inserted at the new location.
PASTE	COPY MOVE	PASTE	Copies or moves text within a buffer. In keypad mode, PASTE copies the PASTE buffer contents into the current buffer. In nokeypad mode, PASTE copies the contents of any buffer into the current buffer.

9.11.8 Indenting Text

The following table describes commands and keys that can be used to indent text:

Keypad Mode	Line Mode	Nokeypad Mode	Description
Ctrl/A		TC (Tab Compute)	Establishes a tab position and resets the indentation level. The indentation level is the number of columns, starting at the left of the screen, that you want to leave blank before beginning a line of text. To use this command, the current cursor position must be a multiple of the SET TAB value.
Ctrl/D		TD (Tab Decrement)	Decreases the current indentation level count by one setting. The indentation level count is generally set by the Ctrl/A or TC (Tab Compute) command.
Ctrl/E		TI (Tab Increment)	Increases the current indentation level count by one setting. The indentation level count is generally set by the Ctrl/A or TC (Tab Compute) command.
Ctrl/T	TAB ADJUST	TADJ (Tab Adjust)	Uses the value established by the line-mode SET TAB command to indent lines of text in a select range. Requires SET TAB to be in effect.
	SET TAB SHOW TAB		Establishes the SET TAB value for the various tabbing functions (tab compute, tab adjust, tab increment, and tab decrement). SHOW TAB indicates the SET TAB value and the tab indentation level count.
		SHL (Shift Left)	Moves the entire buffer text eight characters (one tab stop) to the left.
		SHR (Shift Right)	Moves the entire buffer text eight characters (one tab stop) to the right.
TAB Ctrl/I		TAB	Moves text to the right, regardless of whether ADVANCE or BACKUP are in effect. The number of column positions that the text moves depends on the cursor position, the value set by the SET TAB command (if one is in effect), and the indentation level count (if one is in effect).

9.11.9 Changing the Case of Text

The following table describes commands and keys that can be used to change the case of text:

Keypad Mode	Line Mode	Nokeypad Mode	Description
CHNGCASE		CHGC	Changes the case of letters in your text. Uppercase letters become lowercase; lowercase letters become uppercase.
		CHGL	Changes all uppercase letters within the specified entity to be lowercase. Letters that are already lowercase remain unchanged.
		CHGU	Changes all lowercase letters within the specified entity to be uppercase. Letters that are already uppercase remain unchanged.
		DLWC	Changes uppercase letters to lowercase wherever the cursor is moved.
		DUPC	Changes lowercase letters to uppercase wherever the cursor is moved.
		DMOV	Returns the editing session to the default state after you use either DLWC (default lowercase) or DUPC (default uppercase).
	SET CASE SHOW CASE		Uses flags to distinguish uppercase and lowercase letters at a single-case terminal. SHOW CASE indicates which case (upper, lower, or none) has been established by the SET CASE command.

9.11.10 Using Multiple Buffers

The following table describes commands and keys that can be used when using multiple buffers:

Keypad Mode	Line Mode	Nokeypad Mode	Description
	CLEAR		Deletes the contents of the specified buffer.
	SHOW BUFFER		Lists all accessible buffers currently in your EDT session.

9.11.11 Defining Keys

The following table describes commands and keys that can be used to define keys:

Keypad Mode	Line Mode	Nokeypad Mode	Description
		BELL	Causes the terminal bell to sound when a command is processed. Used primarily in keypad key definitions.
Ctrl/K	DEFINE KEY	DEFK	Defines or redefines function keys used in keypad editing. Key definitions are based on nokeypad commands. In keypad mode, Ctrl/K starts the key definition process. In nokeypad mode, you can define a key sequence other than Ctrl/K to handle the key definition process.
	SHOW KEY		Displays the definition of any keys that have keypad editing functions.
	SET [NO]KEYPAD SHOW KEYPAD		Determines which screen editing mode (keypad or nokeypad) EDT accesses from line mode when you enter the CHANGE command. SHOW KEYPAD indicates which mode is in effect.

9.11.12 Controlling Screen and Terminal Settings

The following table describes commands and keys that can be used to control the EDT screen and terminal settings:

Keypad Mode	Line Mode	Nokeypad Mode	Description
[Return]			Adds a line terminator to the left of the current cursor position in the text you are editing.
	SET [NO]AUTOREPEAT		Prevents keypad keys (including arrow keys) from repeating faster than EDT can update the screen.
	SHOW AUTOREPEAT		Indicates whether autorepeat is in effect.
	SET LINES		Limits the number of lines that EDT displays on the terminal screen at one time.
	SHOW LINES		Displays the line limit.
	SET [NO]NUMBERS		Determines whether EDT displays line numbers during line-mode editing.
	SHOW NUMBERS		Displays the current setting.
	SET PARAGRAPH [NO]WPS		Sets paragraph default boundary limits.
	SHOW PARAGRAPH		Indicates whether SET PARAGRAPH WPS or SET PARAGRAPH NOWPS is in effect.
	SET [NO]QUIET		Silences the terminal bell that ordinarily sounds whenever EDT displays an error message during a screen-mode editing session.
	SHOW QUIET		Indicates whether the bell has been turned off.
	SET [NO]REPEAT		Disallows use of the GOLD key repeat feature, which allows you to repeat functions in keypad mode, and the SPECINS keypad function.
	SHOW SCREEN		Displays the current screen width setting.
	SET TERMINAL SHOW TERMINAL		Corrects or changes terminal settings to match the type of terminal you are using. SHOW TERMINAL displays the terminal settings that are currently in effect for your editing session.
	SET TERMINAL		Corrects or changes terminal settings to match the type of terminal you are using.
	SHOW TEXT		Indicates what text is displayed for the form-feed character or the end-of-buffer mark.
	SET [NO]TRUNCATE		Causes lines longer than the current screen width to wrap onto subsequent lines when you are working in screen mode. (In line mode, EDT always wraps long lines.) SET TRUNCATE does not take word boundaries into consideration; enter SET WRAP to break lines at word boundaries.
	SHOW TRUNCATE		Indicates whether SET TRUNCATE is in effect.
	SET WORD [NO]DELIMITER		Determines how word entity boundaries are interpreted by EDT. By default, word delimiters are treated as separate words (SET WORD DELIMITER).
	SHOW WORD		Indicates whether SET WORD NODELIMITER is in effect.
	SET [NO]WRAP		Causes lines of text to wrap when new text is inserted into a buffer in keypad mode. The SET WRAP command also determines the line length for the FILL command.
	SHOW WRAP		Indicates whether the SET WRAP command is in effect and, if so, what the SET WRAP value is.

9.11.13 Processing EDT Commands

The following table describes commands and keys that can be used to process EDT commands:

Keypad Mode	Line Mode	Nokeypad Mode	Description
Ctrl/C	Ctrl/C	Ctrl/C	Interrupts certain operations (such as a search through a long file) before EDT finishes processing them.
Do (LK201 only)	Return	Period (.)	Processes searches and line editing commands.
Enter	Return	Return	Processes searches, line editing commands, and key definitions.
	SET ENTITY		Defines the delimiters that mark the word, sentence, paragraph, and page boundaries for commands and functions.
	SHOW ENTITY		Lists the current delimiters.
	SET COMMAND		Processes additional startup command files at the beginning of your EDT session. This command is valid only in an EDT startup command file.
	SHOW COMMAND		Displays the name of the active startup command file. This command is valid only in an EDT startup command file.
	SET [NO]VERIFY SHOW VERIFY		Displays the commands in a startup command file or EDT macro as the commands are processed. SHOW VERIFY indicates whether SET VERIFY is in effect.

9.11.14 Other EDT Commands

The following table describes miscellaneous commands and keys available in EDT:

Keypad Mode	Line Mode	Nokeypad Mode	Description
		DATE	Inserts the current date into your text.
	DEFINE MACRO		Creates new line-mode commands for the duration of your editing session.
	EXIT		Creates an external file, copies the contents of the MAIN buffer into that file, and ends the editing session.
GOLD			Performs various editing functions when used with other keypad and keyboard keys.
Help	Help	Help	In keypad and line modes, accesses the EDT Help utility. In nokeypad mode, defines a different key or key sequence in keypad mode to carry out the keypad Help function.
	PRINT		Copies the specified range of lines or specified buffer to an external file in a specified directory. EDT adds a form feed and two blank lines for every 60 lines it copies. The EDT line numbers become part of the text in the external file.
	QUIT	QUIT	Ends the session without copying text to an external file.
	RESEQUENCE		Assigns new EDT line numbers to the lines of the current or specified buffer.
	SHOW FILES		Displays the current input file and output file for your EDT session.
	SET [NO]FNF		Suppresses the message that appears when you use EDT to create a new file (FNF stands for File Not Found). This command is used only in startup command files.
	SHOW FNF		Indicates whether SET FNF or SET NOFNF is in effect. This command is used only in startup command files.
	SET HELP		Enables you to access different help files for your EDT session.
	SHOW HELP		Displays the name of the help file currently available for your editing session.
	SET [NO]SUMMARY SHOW SUMMARY		Suppresses summary information displayed when you enter the EXIT or WRITE commands. By default, EDT displays the complete file specification and number of lines in the file that EDT has created as a result of entering the EXIT or WRITE command. SHOW SUMMARY indicates whether the SET SUMMARY command is in effect.
	SHOW VERSION		Displays the version of EDT that is being used by your operating system.
	TYPE		Displays lines of text at your terminal.
	WRITE		Copies text from an EDT buffer to an external file.
		XLATE	Passes information back to the calling program. You can enter this command when EDT has been called by a running program.

DIGITAL Standard Runoff (DSR) is a text-formatting facility. This chapter describes:

• Entering DSR commands
• Invoking DSR
• Creating tables of contents
• Creating indexes
• Summary of DSR commands

  6489P014.HTM
  OSSG Documentation
  22-NOV-1996 13:16:55.01

Copyright © Digital Equipment Corporation 1996. All Rights Reserved.

Legal