1 GOLD 
[H[J        [7m GOLD HELP gives help for the specially defined SLAVE sequences [m
        [7m developed at Sandia National Laboratories  for the EDT editor. [m
                [7m (For help on the keypad keys, press HELP.) [m

For access to these sequences, place the following line in your LOGIN.COM file:

			$ @SYS$PROCS:SLAVEDEF 

This will redefine the symbol EDT to invoke the editor via SLAVE.

The GOLD key followed by certain keyboard letters accesses commands defined in
this package.  To get help on any particular key, press GOLD HELP, then enter
the key for which you wish help.  For keys such as "up" and "del", enter ".up"
and ".del" (see the list below). To get a summary of all the gold extension
functions, enter ".all" in response to GOLD HELP. 

2 .ALL
[H[J[7m Summary of the SLAVE EDT extension package: [m
GOLD B ----	Changes EDT editing buffer
GOLD C ----	Copies selected lines of text to a buffer
GOLD E ----	Exit EDT, save file, and erase 'extraneous' characters
GOLD F ----	Finds previous buffer
GOLD H ----	Help for line mode or SETUP commands
GOLD I ----	Include file:    In buffer:
GOLD L ----	Locates the 'saved' cursor position
GOLD N ----	Tells you the name of the file that you are editing
GOLD P ----	Marks current cursor position with <cursor>
GOLD Q ---- 	Quit EDT without saving the current changes
GOLD R ----	Removes column position indicator
GOLD S ----	Save setup characteristics
GOLD V ----	Verifies column positions on screen
GOLD W ----	Writes to a specified file
GOLD Z ----	Enter/Exit setup mode
GOLD ) ----	Reset to saved setup characteristics
GOLD ? ----	Shows the name and # of lines in each buffer
GOLD ^H ---	Help for change mode subcommands
GOLD HELP  ---	Invokes the help utility for the gold extensions
GOLD ENTER ---	Subs:    With:			GOLD DEL   ---	Substitute next
GOLD 'up'  ---	Edit 132 columns wide		GOLD 'left'---	Shift to left
GOLD 'down'---	Edit 80  columns wide		GOLD 'right'--	Shift to right
2 B
[H[J[7m GOLD B [m

The "go to Buffer" function prompts you for the name of the editing buffer you
wish to access.  Enter the name of the buffer. To see what buffers currently
exist, type GOLD ?. You may create a new buffer by simply entering the name of
a buffer that does not yet exist. After entering a new buffer, you may return
to the previous buffer with GOLD F. 

2 C
[H[J[7m GOLD C [m 

The "copy to buffer" function prompts for a search string. After you have given
the string, SLAVE will prompt you again for a buffer name in which to store the
selected lines of text. All lines in the current buffer that contain the search
string will then be copied into the buffer. The lines in the current buffer
containing the search string are not deleted; if you wish to delete them as
well, you must explicitly delete them by entering, for instance, GOLD CMND
 
Command: [7m DELETE ALL 'search string' [m

2 E
[H[J[7m GOLD E [m

The "clean up and Exit" function searches your main buffer for remnants of the
editing session such as <cursor> position markers (left by GOLD P) and column
position indicators (left by GOLD V), deletes these if found, restores the
screen to 80-column width, and performs a normal exit from EDT. You are 
prompted for an optional file name and/or qualifiers.  If you give a filename, 
EDT will use that name for its output file, rather than using a new version 
of the input file.

2 F
[H[J[7m GOLD F [m

The "Find last" function puts you back into the buffer you were last in; it
even remembers the cursor position.  You may use it to flip back and forth
between two buffers for reference to some auxiliary file (previously
included by using the GOLD I function).  EDT can only remember one last
buffer, though, so if you go to a third buffer using GOLD B, GOLD N, GOLD I,
SETUP, or RESET, you must use GOLD B to get back to the first buffer. 

2 H
[H[J[7m GOLD H [m

The "line mode or SETUP Help" function ordinarily will provide help for line 
mode editing commands.  In response to the prompt, enter a line mode command.

In SETUP mode, this key functions differently.  Move the cursor to the line 
you wish to know more about, and type GOLD H.  You will get help on the 
particular SET command on that line.  EDT looks between the beginning of the 
line and the first tab character for the name of the command to give help on.

2 ^H
[H[J[7m GOLD ^H [m  (GOLD <backspace>)

The "change mode subcommand Help" function gives help on the commands used in 
nokeypad screen editing and in defining keys.  In response to the prompt, 
enter a change mode subcommand.

2 I
[H[J[7m GOLD I [m

The "Include file" function prompts you for the name of a file you wish to
include in this editing session.  You may use the same file specifications as
you would in DCL command level, i.e., optionally specifying the device,
directory, etc. After you give it a file name, the editor will prompt you for
the name of a buffer in which to put the file.  Your new cursor position will
be just after the last line in the included file. 

If you wish to include the file immediately before the current line in the
current buffer, respond with the current buffer name followed by a period, or 
just use the line mode "include" command.

2 L
[H[J[7m GOLD L [m

The "Locate cursor position" function searches the current buffer for the first
occurance of the string <cursor>, deletes it, and leaves the cursor at that
position.  It assumes that a cursor position has been previously marked using
the GOLD P function.  Because it uses the search and substitute functions, it
will replace the contents of those buffers; so the string you are using for 
FIND NEXT or SUBS NEXT may have to be re-entered with FIND or SUBS, 
respectively.

2 N
[H[J[7m GOLD N [m

The "file Name" function will show you the name of the file you are currently
editing.

Since it gets the file name from the buffer FNAME, the "previous buffer" you
access using GOLD F is reset to FNAME. 

2 P
[H[J[7m GOLD P [m

The "mark cursor Position" function inserts the string <cursor> in your file
just behind your cursor.  This cursor position indicator allows you to examine 
some other part of your file, then come back the location you had been working 
at, using GOLD L.  The word <cursor> really is inserted into the file; it is 
removed when you return to the position with GOLD L, or when you exit using 
GOLD E.

2 Q
[H[J[7m GOLD Q [m

The "clean up and Quit" function resets the screen to 80 columns wide, and 
terminates the editing session without saving the current changes to the file.
If you wish to save the journal file for the session, you may enter [7m /save [m
in response to the prompt.

2 R
[H[J[7m GOLD R [m

The "Remove column position indicator" function deletes the first line in the
current buffer beginning with the string "----_----1", but does not move the
cursor.  It is assumed that the deleted line had previously been inserted into
the buffer with GOLD V, to verify column positions. Because it uses the search
and substitute functions, it will replace the contents of those buffers; so
the string you are using for FIND NEXT or SUBS NEXT may have to be re-entered
with FIND or SUBS, respectively. 

2 S
[H[J[7m GOLD S [m

The "SAVE setup features" function, in SETUP mode, writes the current setup
list to the file SETUP.EDT .  This setup list, therefore, will be used next
time you press GOLD ) to reset, and will also initialize future editing
sessions.  You must have entered SETUP mode with GOLD Z to use this, however;
in ordinary editing, GOLD S does nothing. 

If you had a SETUP.EDT in your current (sub)directory, the saved version will 
replace that one; otherwise it will replace the one in your home directory.
If you had no SETUP.EDT in the current (sub)directory, but wish to have setup 
characteristics unique to this directory, save the setup features with GOLD W.
The next time you use the editor in this (sub)directory, these setup features
will characterize the session. 

2 V
[H[J[7m GOLD V [m

The "Verify column positions" function inserts a line above the current cursor
location to indicate columns.  The cursor position is unchanged.  This line 
may be removed using GOLD R, or by exiting with GOLD E. Because it uses the
search and substitute functions, it will replace the contents of those
buffers; so the string you are using for FIND NEXT or SUBS NEXT may have to be
re-entered with FIND or SUBS, respectively. 

2 W
[H[J[7m GOLD W [m

The "Write to file" function prompts for the name of a file.  If just a 
filename is given, EDT will write the entire buffer to the file.  (If no 
filename is given, EDT will use the name of the file you are editing, and 
write the current buffer to a new version of that file.)  Alternatively, you
may specify a range in addition to the filename, and have only that range
written to the file.  For example, you could define a select range, then do a
GOLD W, and enter 

Write to file: [7m Myfile.dat select [m

For more information on the write command, ask for help on "write" 
(for instance: GOLD H, write).

In SETUP mode, this key is specialized to write a copy of the SETUP buffer to 
the file SETUP.EDT in the current subdirectory.  Use GOLD W to save special
SETUP features for use in this subdirectory. 

2 Z
[H[J[7m GOLD Z [m

The "SETUP" function is a handy way of customizing the EDT editor to your 
personal needs.  GOLD Z will put you in SETUP mode, which displays a menu of 
setup features.  Set these however you wish using the editor (i.e., move the
cursor to the right position, then delete and/or insert characters to make the
SET command read correctly). You may get help on any of the setup features by
simply moving the cursor to the line you are interested in, and typing GOLD H. 
Once SETUP reads like you want it to, type GOLD S if you want to save the 
current setup features, and GOLD Z once again to return to normal editing.

In SETUP mode, most of the other special GOLD keys are turned off; you should
exit SETUP mode using GOLD Z before moving around to different buffers, etc.
When you exit SETUP, the setup features that are currently showing will be
put into effect. You may use SETUP to do things like DEFINE KEY as well. Using
SETUP or RESET makes EDT forget the last buffer you were in, so after SETUP or
RESET, GOLD F will take you to the buffer FNAME. 

The setup features are stored in a file named SETUP.EDT .  The editor will 
first look in your current (sub)directory for the file, then in your home 
directory.  If it does not find it in either place, it will copy one into your 
home directory from SYS$PROCS, and use that one.
2 )
[H[J[7m GOLD ) [m

The "RESET to saved setup features" function resets your setup buffer to the 
features you last saved.  If you have not saved any new features since 
beginning the EDT session, it will reset to the features that were in effect
when you began the session.

Using SETUP or RESET makes EDT forget the last buffer you were in, so after
SETUP or RESET, GOLD F will take you to the buffer FNAME. 

2 ?
[H[J[7m GOLD ? [m

The "show buffers" function lists the buffers being used during the current 
EDT session, including the number of lines of text in each buffer.  The 
current buffer is marked by an equals sign (=) before the name.  If an 
asterisk (*) follows the number of lines, it indicates that there is an input 
file connected to the buffer, and that there are more lines to be read from 
the file.  Hence, the starred number of lines is a count of the lines in the 
buffer "so far".

2 .ENTER
[H[J[7m GOLD ENTER [m

The "substitute" function will prompt for the string as it now reads (Subs: ) 
and then for the replacement string (With: ).  When both these are entered, 
EDT will search for the first occurance of the string, and substitute it with 
the replacement string, leaving the cursor there.  More substitutions of the 
same strings can be done using the substitute next function, GOLD DEL. If you
wish to use the current search string as a substitution string, simply hit
ENTER in response to the first prompt, and EDT will use the search string by
default. 

If you accidently hit GOLD ENTER and do not wish to do any substitutions, you 
may cancel the function by typing a CTRL_X in response to the prompt.

2 .DEL
[H[J[7m GOLD DEL [m

The "substitute next" function is used in conjunction with the substitute 
function, GOLD ENTER.  After one substitution has been made with GOLD ENTER, 
typing GOLD DEL will cause EDT to search for and substitute the next occurance
of the string.  If you would like to see the next string before you decide 
whether to go ahead and substitute, simply do a FNEXT first.  Then if you want 
to substitute, type GOLD DEL. You can change the search string without
re-entering the replacement string by using the FIND function, then directly
using GOLD DEL instead of GOLD ENTER. 

2 .UP
[H[J[7m GOLD UP [m

The "132 columns" function will set the screen to 132 columns.  This makes the 
individual letters narrower and harder to read, but may be a necessity for 
files with lines longer than 80 characters.  The GOLD .DOWN function sets the 
screen back to 80 columns.  The number of columns displayed may also be 
initialized and reset using SETUP.

2 .DOWN
[H[J[7m GOLD DOWN [m

The "80 columns" function will set the screen to 80 columns.  This is the 
normal mode of operation.  The GOLD .UP function sets the screen to 132 
columns for a wider view of the buffer.  The number of columns displayed may 
also be initialized and reset using SETUP.

2 .LEFT
[H[J[7m GOLD LEFT [m

The "shift left" function is a standard EDT function, not a Sandia extension.
Typing GOLD followed by the left arrow will shift the screen image to the left
by 8 spaces. This allows you to view data that extends beyond the right
extreme of the screen.  Contrary to appearances, it does not actually do
anything to the data in your buffer; it simply shifts your viewpoint.  GOLD
'right' will shift the screen image back to the right. 

2 .RIGHT
[H[J[7m GOLD RIGHT [m 

The "shift right" function is a standard EDT function, not a Sandia extension.
Typing GOLD followed by the right arrow will shift the screen image to the
right by 8 spaces.  It will not shift beyond the left margin, however, so it
is primarily intended to counter the effects of the "shift left" function. As
with the "shift left" function, it does not actually do anything to the data
in your buffer; it simply shifts your viewpoint. 

1 SET
The SET (abbreviation: SE) command sets options that control other
editor operations. Once set, these options are in effect throughout the
rest of the edit session or until changed by the SET command.  
2 CASE
Format:	   	SET CASE { UPPER | LOWER | NONE }
 
Use the SET CASE (abbreviation: SE CA) command on terminals which are
capable of displaying upper case characters only.  SET CASE instructs
EDT to flag with a preceding apostrophe either the upper case characters,
the lower case characters, or neither.  The default for SET CASE is
NONE, which means no characters are flagged.
 
The keywords can be abbreviated as follows:
 
	CASE 	CA
	UPPER	U
	LOWER	L
	NONE	N
2 CURSOR
Format:		 SET CURSOR top:bottom 
 
The SET CURSOR (abbreviation: SE CU) command, used with screen editing,
sets the limits within which the cursor is allowed to move without
scrolling the screen.
 
Top and bottom are the line numbers at the top of the screen and  the
bottom of the screen.  The line numbers must be in the range of 0 to 21,
with 0 specifying the top of the screen and 21 the bottom.  The
default  setting is 7:14, allowing the cursor to move within the
middle third of  the screen.  
2 ENTITY
Format:		SET ENTITY   entity-type 'delimiter string'
 
Entity-type is one of the following:
 
	WORD		(abbreviation: W)
	SENTENCE	(abbreviation: S)
	PAGE		(abbreviation: PAG)
	PARAGRAPH	(abbreviation: PAR)
 
The SET ENTITY (abbreviation: SE EN) command sets the 
delimiters for the user-defined change mode entities.  For the 
WORD and SENTENCE entities, the delimiter string is a set of single 
character delimiters.  For PAGE and PARAGRAPH, the delimiter is a
character string which delimits the entity.  See HELP CHANGE
ENTITIES for explanations of the entities.
2 KEYPAD
Format:		SET [NO]KEYPAD
 
The SET KEYPAD (abbreviation: SE K) option controls whether or not the 
editing keypad is to be used when you are in CHANGE mode.  KEYPAD is set by 
default for VT52 and VT100 terminals, which means the alternate keypad
is used to enter change mode commands.  If you prefer the change mode
compatible with EDT version 1, use the SET NOKEYPAD command.
2 NOKEYPAD
Format:		SET [NO]KEYPAD
 
The SET KEYPAD (abbreviation: SE K) option controls whether or not the 
editing keypad is to be used when you are in CHANGE mode.  KEYPAD is set by 
default for VT52 and VT100 terminals, which means the alternate keypad
is used to enter change mode commands.  If you prefer the change mode
compatible with EDT version 1, use the SET NOKEYPAD command.
2 LINES
The SET LINES (abbreviation: SE L) command controls the number of 
screen lines used in either of the screen versions of change mode.  
Use this option to reduce the time it takes to refresh the
screen image when editing at low baud rates.
 
Format:		SET LINES n
 
where n is the number of lines to use.  n must be between 1 and 22.
By default, n is set to 22 lines.
2 MODE
The SET MODE (abbreviation: SE M) command determines which 
mode of editing should be entered after all initial processing is 
complete.  This command is useful only in the startup command file.
 
Format:		SET MODE { LINE | CHANGE }
 
By default, EDT enters line mode when the startup processing is 
complete.  Use SET MODE CHANGE in your startup file to cause EDT to
enter change mode immediately.
2 NUMBERS
Format:		SET [NO]NUMBERS
 
The SET NUMBERS (abbreviation: SE NU) command controls the typing of
line numbers on the terminal.  Numbers is set on by default.
If you want to suppress numbers, use SET NONUMBERS (abbreviation: NON).
2 NONUMBERS
Format:		SET [NO]NUMBERS
 
The SET NUMBERS (abbreviation: SE NU) command controls the typing of
line numbers on the terminal.  Numbers is set on by default.
If you want to suppress numbers, use SET NONUMBERS (abbreviation: NON).
2 QUIET
The SET QUIET (abbreviation: SE Q) command controls whether or not the 
bell will sound when an error is made in change mode.
	
Format:		SET [NO]QUIET
	
The quiet option is off (meaning the bell will sound) by default.
2 NOQUIET
The SET QUIET (abbreviation: SE Q) command controls whether or not the 
bell will sound when an error is made in change mode.
	
Format:		SET [NO]QUIET
	
The quiet option is off (meaning the bell will sound) by default.
2 SEARCH
The SET SEARCH (abbreviation: SE SE) command controls 
several options related to string searching.
 
Format:		SET SEARCH	{ GENERAL | EXACT }
				{ [UN]BOUNDED }
				{ BEGIN | END }
 
The GENERAL (abbreviation: G) / EXACT (abbreviation: EX) option 
controls whether or not the case of alphabetic characters must be the
same as those in the search string to match.  The default is GENERAL,
which means that case is ignored in string searches.     
 
The BOUNDED (abbreviation: BO) option defines whether or not the search
is bounded by a page delimiter.  By default, the search is unbounded, 
which means that the entire buffer will be searched.  This option has 
effect only in change mode.
 
The BEGIN (abbreviation: B) / END (abbreviation: E) option determines 
whether the cursor is left at the beginning or end of the search 
string when it is found.  By default, the cursor is left at the 
beginning.  This option has effect only in change mode. 
2 SCREEN
The SET SCREEN (abbreviation: SE SC) command controls the 
number of characters displayed on a line.
 
Format:		SET SCREEN w
 
where w is the width of the screen line.  By default, the screen width
is set to 80 characters.
2 TAB
The SET TAB (abbreviation: SE TA) command enables the 
structured tab feature and sets the logical tab size.
 
Format:		SET [NO]TAB n
 
where n is the number of columns in a logical tab stop.
 
With the structured tab feature, EDT keeps a counter of 
the tab level, which is set to 1 when the SET TAB command is issued.
When you use the tab key in change mode at the beginning of a line, 
EDT will insert enough tabs and spaces to move the cursor to the column 
defined by the level n times the tab size.  There are change mode
subcommands to alter the tab level.  The structured tab feature is
disabled by default. 
 
The tab size set by the tab command is also used by the TABS ADJUST
command.
2 NOTAB
The SET TAB (abbreviation: SE TA) command enables the 
structured tab feature and sets the logical tab size.
 
Format:		SET [NO]TAB n
 
where n is the number of columns in a logical tab stop.
 
With the structured tab feature, EDT keeps a counter of 
the tab level, which is set to 1 when the SET TAB command is issued.
When you use the tab key in change mode at the beginning of a line, 
EDT will insert enough tabs and spaces to move the cursor to the column 
defined by the level n times the tab size.  There are change mode
subcommands to alter the tab level.  The structured tab feature is
disabled by default. 
 
The tab size set by the tab command is also used by the TABS ADJUST
command.
2 TERMINAL
Format:		SET TERMINAL { HCPY | VT52 | VT100 }
 
The SET TERMINAL (abbreviation: SE TE) command identifies to EDT 
the type of terminal you are using.  Normally, EDT will set the 
terminal type by asking the operating system what type it is.  If it
does not appear to have set the type correctly, you can use the SHOW
TERMINAL command to see what EDT thinks your terminal is and the SET
TERMINAL command to correct it if necessary.  If your terminal is not
a VT52 or a VT100, it should be set to HCPY (hardcopy).
2 TRUNCATE
The SET TRUNCATE (abbreviatin: SE TR) command controls the 
handling of long lines in change mode.
 
Format:		SET [NO]TRUNCATE
 
By default, truncate mode is set, which means long lines will be 
truncated on the display (the actual text is not altered).  If you turn
off truncate mode by using SET NOTRUNCATE, long lines will
be wrapped to as many screen lines as are necessary to display the
entire line. 
2 NOTRUNCATE
The SET TRUNCATE (abbreviatin: SE TR) command controls the 
handling of long lines in change mode.
 
Format:		SET [NO]TRUNCATE
 
By default, truncate mode is set, which means long lines will be 
truncated on the display (the actual text is not altered).  If you turn
off truncate mode by using SET NOTRUNCATE, long lines will
be wrapped to as many screen lines as are necessary to display the
entire line. 
2 VERIFY
The SET VERIFY (abbreviation: SE V) command controls the
listing of commands which are executed from the startup file or from a
macro.
 
Format:		SET [NO]VERIFY
 
Verify is off by default, which means the lines are not typed.  If you
turn it on, each command line is typed as it is executed.
2 NOVERIFY
The SET VERIFY (abbreviation: SE V) command controls the
listing of commands which are executed from the startup file or from a
macro.
 
Format:		SET [NO]VERIFY
 
Verify is off by default, which means the lines are not typed.  If you
turn it on, each command line is typed as it is executed.
2 WRAP
Format:		SET [NO]WRAP n

The SET WRAP (abbreviation: SE W) command enables word wrapping and
specifies the right margin.  Word wrapping is a mode in which EDT
will automatically insert carriage returns when you are typing in
new text and the line exceeds a right margin.  Word wrapping is in
effect in change mode only and only if you have used the SET WRAP
command.  
 
The SET WRAP command is also used to set the right margin for the 
change mode FILL subcommmand.

SET NOWRAP (abbreviation: SE NOW) disables the word wrapping feature.
2 NOWRAP
Format:		SET [NO]WRAP n

The SET WRAP (abbreviation: SE W) command enables word wrapping and
specifies the right margin.  Word wrapping is a mode in which EDT
will automatically insert carriage returns when you are typing in
new text and the line exceeds a right margin.  Word wrapping is in
effect in change mode only and only if you have used the SET WRAP
command.  
 
The SET WRAP command is also used to set the right margin for the 
change mode FILL subcommmand.

SET NOWRAP (abbreviation: SE NOW) disables the word wrapping feature.
