!=======================================================================
! 11/29/1985
!=======================================================================
1 EDTPINI_HELP
The following FUNCTIONS/COMMANDS can be executed by KEY SEQUENCES
defined by the Ames Laboratory EDTPINI.EDT EDT startup command file.

Prompts are issued if additional input is required.  Items in {  }, for
example, {file_name}, {buffer_name}, etc, indicate the nature of any
required input.  Optional input is indicated in [ ].  Input can be
terminated by pressing the ENTER key, the RETURN key, or any function
key. 

Entering a ? causes the highest level help available within this 
library to be displayed.

Entering CONTROL Z terminates the HELP session and returns to the 
context of the edit session.



!=======================================================================
2 APPEND_SELECT
The key sequence GOLD A appends (copies) the SELECTed portion of the
buffer to the end of {buffer_name}.  The working buffer and cursor 
position are restored upon completion.

Equivalent to the NOKEYPAD command sequence:
 
       EXT COPY SELECT TO {buffer_name} END; FIND LAST.
!=======================================================================
2 BUFFER_DISPLAY
The key sequence GOLD B switches the context of the edit session to
{buffer_name}.  The last previous position of the cursor in that buffer
is reestablished. 

Equivalent to the NOKEYPAD command:

       EXT FIND={buffer_name}.
!=======================================================================
2 COPY_SELECT
The key sequence GOLD C copies the SELECTed portion of the buffer to
{buffer_name}.  The working buffer and cursor position are restored upon
completion. 

Equivalent to the NOKEYPAD command:

      EXT COPY SELECT TO={buffer_name}; FIND LAST.
!=======================================================================
2 DCL_COMMAND_EXECUTE
The key sequence GOLD CONTROL D prompts for {input_string},
creates a subprocess, and attaches the terminal to the subprocess.  

If the first character of {input_string} is a period, e. g, .DIRECTORY,
the symbols and logical names of the parent process are not passed to
the subprocess.  This speeds up the subprocess creation. 

If {input_string} is a DCL command, the subprocess executes the command,
creates a pause so the command results can be viewed, and then
resumes EDT operation.

If {input_string} is null, or contains only the optional period (.), the
subprocess is available to execute any number of DCL commands entered
from the terminal.  Informational messages given at appropriate times
and places indicate how to terminate the subprocess and how to resume
the edit session. 
!=======================================================================
2 DCL_Comment
The key sequence GOLD $ inserts the following DCL comment line before
the current cursor position: 

$!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!=======================================================================
2 DCL_HELP___
The key sequence GOLD CONTROL H prompts for {DCL_help_topic_name}, 
and then creates a subprocess to access the standard VAX/VMS HELP 
library.  

Because the help library is accessed by the subprocess, rather than
directly by EDT, information can be obtained on a number of topics
and/or subtopics before returning to the context of the edit session. 
!=======================================================================
2 DELETE_BUFFER
The key sequence GOLD DELETE prompts for {buffer_name} and then deletes
the contents of that buffer. 

Equivalent to the NOKEYPAD command:

        EXT CLEAR ?*'Delete contents of what buffer ? '.        
!=======================================================================
2 DELIMITERS_
The key sequence GOLD D toggles between two sets of WORD delimiters.  
Word delimiters are the characters EDT is told to recognize as denoting
the beginning/end of a word. 

One set, SPACE, TAB, CARRIAGE_RETURN, is useful for word processing;

The other set, SPACE, TAB, CARRIAGE_RETURN, +, -, (, ), /, *, and =, are
useful for creating and editing FORTRAN language programs.
!=======================================================================
2 EDT_HELP___
The key sequence GOLD CONTROL E prompts for {EDT_help_topic_name}, and then 
creates a subprocess to access the EDT HELP library for information on 
EDT_help_topic_name.

Because the help library is accessed by the subprocess, rather than
directly by EDT, information can be obtained on a number of topics
and/or subtopics before returning to the context of the edit session. 
!=======================================================================
2 EXACT_SEARCH
The key sequence GOLD E specifies that the SEARCH criterion is EXACT.  

That is, when searching for occurrences of a string, the search is not 
successful unless an EXACT match is found.  EXACT means that both the
character(s) and the case of the character(s) in the strings must match. 

Equivalent to the NOKEYPAD command: 

       EXT SET SEARCH EXACT.
!=======================================================================
2 EXIT_SAVE_FILE
The key sequence GOLD X concludes the edit session and saves the
contents of the MAIN buffer as a file with the same name as that stated
when the editor was invoked. 

     Equivalent to the NOKEYPAD command: EXT EXIT.

The key sequence GOLD Z also concludes the edit session and saves the 
contents of the MAIN buffer.  The response to a prompt for {file_name}
specifies the name to be used for the save file.

     Equivalent to the NOKEYPAD command: EXT EXIT {file_name}.
!=======================================================================
2 FILL_PARAGRAPH
The key sequence GOLD F FILLs (rearranges or reformats) the portion of 
the buffer between the cursor and the next PARAGRAPH boundary so that 
the contents are contained within the current WRAP setting.  

Equivalent to the NOKEYPAD command: 

       (SEL PAR FILLSR).
!=======================================================================
2 FORTRAN_Comment
The key sequence GOLD * inserts the following FORTRAN comment line
before the current cursor position: 

C***********************************************************************
!=======================================================================
2 FORTRAN_HELP
The key sequence GOLD CONTROL F prompts for {FORTRAN_help_topic_name},
and then creates a subprocess to access a library that contains HELP 
regarding the FORTRAN language.

The library contains HELP on the FORTRAN language only (identical to
that contained in the system HELP library), but it does not contain HELP
concerning the DCL FORTRAN command.  HELP on the latter can be obtained
by using GOLD CONTROL H and entering FORTRAN in response to the "Help on
what DCL topic ?" prompt. 

In either case because the help library is accessed by the subprocess,
rather than directly by EDT, information can be obtained on a number of
topics and/or subtopics before returning to the context of the edit
session. 
!=======================================================================
2 GENERAL_SEARCH
The key sequence GOLD G set the SEARCH criterion to GENERAL.  

That is, when searching for occurrences of a string, the search can be
successful when only a GENERAL match is found.  A GENERAL match requires
that the character(s) of the two strings match, but does not require that
the case of the characters also match. 

For example, both "hero" and "HeRo" satisfy the GENERAL criterion for a 
successful SEARCH for "hERO". 

Equivalent to the NOKEYPAD command: 

       EXT SET SEARCH EXACT.
!=======================================================================
2 INCLUDE_FILE
The key sequence GOLD I prompts for {file_name} and then INCLUDEs the
contents of that file before the current cursor position. 
 
Equivalent to the NOKEYPAD command: 

        EXT INCLUDE {file_name}.
!=======================================================================
2 KUT_SELECT_
The key sequence GOLD K CUTs the SELECTed portion of the buffer from the 
current buffer, and puts the SELECTed material in {buffer_name}.  The 
current buffer and cursor position are not changed.

Equivalent to the NOKEYPAD command:
 
      CUTSR={buffer_name}.
!=======================================================================
2 MAIN_BUFFER
The key sequence GOLD M establishes MAIN as the current buffer and 
restores the previous position of the cursor in that buffer.

Equivalent to the NOKEYPAD command:

      EXT FIND=MAIN.
!=======================================================================
2 NORMAL_WRAP79
The key sequence GOLD N sets WRAP 79.  

In that case, if the last word being entered on a line would cause the
line to exceed 79 characters, then EDT automatically moves that word
to the beginning of the next line. 

Equivalent to the NOKEYPAD command:

      EXT SET WRAP 79.
!=======================================================================
2 Next_Screen
The key sequence GOLD down_arrow advances the cursor 22 lines, 
IF ADVANCE IS SET. 

If BACKUP is set, the cursor moves 22 lines in the reverse direction.
!=======================================================================
2 OUTPUT_TO_FILE
The key sequence GOLD O writes the contents of the current buffer to
{file_name}. 

Equivalent to the NOKEYPAD command: 

       EXT WRITE {file_name}.
!=======================================================================
2 PASTE_FROM_BUFFER
The key sequence GOLD P prompts for {buffer_name} and then copies
(PASTEs) the contents of the specified buffer before the current cursor
position. 

Equivalent to the NOKEYPAD command: 

       PASTE={buffer_name}.
!=======================================================================
2 Previous_screen
The key sequence GOLD up_arrow reverses the cursor 22 lines,
IF ADVANCE IS SET. 

If BACKUP is set, the cursor moves 22 lines in the normal forward
direction. 
!=======================================================================
2 QUIT_NO_SAVE
The key sequence GOLD Q terminates the edit session --
WITHOUT SAVING THE WORK PERFORMED DURING THE SESSION. 

Equivalent to the NOKEYPAD command: 
 
       QUIT.
!=======================================================================
2 REPLACE_STRING
The key sequence GOLD CONTROL R prompts for {string1}, {string2}, and
{[/Q]}, and then replaces {string1} by {string2} throughout the entire
current buffer.  If the optional /Q is entered, EDT will display the
line that contains string1 each time an occurrence of string1 is found,
and will prompt for whether the substitution is to be performed or not. 

NOTE: The number of occurences of {string1} may depend on whether 
SET SEARCH EXACT or SET SEARCH GENERAL is in force. 

Equivalent to the NOKEYPAD command:

        EXT SUBSTITUTE`string1`string2`WHOLE[/QUERY].
!=======================================================================
2 RULER_INSERT
The key sequence GOLD R inserts the following RULER line before the
current cursor position: 

....v....1....v....2....v....3....v....4....v....5....v....6....v....7....v....
 
It is useful for determining what column a character is in.
!=======================================================================
2 SHOW_BUFFERS
The key sequence GOLD S lists all accessible buffers involved in the
current edit session.  The name of the current buffer is preceded by an
equal sign. 

Some of the buffers listed are created by the EDTPINI startup command 
file. 

Equivalent to the NOKEYPAD command: 

       EXT SHOW BUFFER.
!=======================================================================
2 SPECIAL_KEYS_HELP
The key sequence GOLD PF2 displays this HELP.
!=======================================================================
2 SUMMARY_TABLE
         FUNCTION                                         KEY SEQUENCE 

DELETE the contents of {buffer_name}                      GOLD DELETE 
Display SPECIAL_KEYS_HELP (this HELP)                     GOLD PF2 
Insert DCL comment line                                   GOLD $ 
Insert FORTRAN comment line                               GOLD * 
Advance cursor 22 lines (Next_screen)                     GOLD [down arrow]

Reverse cursor 22 lines (Previous_screen)                 GOLD [up arrow]
APPEND (Copy) SELECT_RANGE to end of {buffer_name}        GOLD A 
Switch to (FIND=) {buffer_name}                           GOLD B
COPY SELECT_RANGE to {buffer_name}                        GOLD C
Change WORD DELIMITERS from word processing to FORTRAN    GOLD D
 and from FORTRAN to word processing 

Set search EXACT (character case must match)              GOLD E
FILL (reformat) paragraph within wrap setting             GOLD F
Set search GENERAL (character case need not match)        GOLD G
INCLUDE {file_name} before current cursor position        GOLD I 
KUT (CUT) SELECT_RANGE to {buffer_name}                   GOLD K

Switch to (FIND=) MAIN buffer                             GOLD M
Set wrap 79 (NORMAL setting)                              GOLD N
OUTPUT entire contents of buffer to {file_name}           GOLD O
PASTE contents of {buffer_name} before cursor position    GOLD P
QUIT (Terminate edit session; do not save work.)          GOLD Q

Insert a RULER with column indicators before cursor       GOLD R
Show BUFFER(s) (= indicates current buffer)               GOLD S
Set wrap 65 (setting for TEXT entry)                      GOLD T
Change WIDTH from 80 to 132 and from 132 to 80            GOLD W
    (also changes WRAP from 79 to 131 and from 131 to 79)
EXIT (Conclude edit session; save work in new file.)      GOLD X

EXIT and save work in {file_name}                         GOLD Z
Create a subprocess to execute {[.]DCL_command}           GOLD CONTROL D
    OR create a subprocess and attach to it {[.]}
    (Optional . indicates that the subprocess should
     not have the symbols and logical names of the parent)
Execute EDT HELP                                          GOLD CONTROL E
Execute FORTRAN HELP                                      GOLD CONTROL F
Execute DCL HELP                                          GOLD CONTROL H

REPLACE {string1} by {string2} in entire buffer {[/Q]}    GOLD CONTROL R
    (optional /Q invokes query before each substitution.)
Toggle between TRUNCATE and NO_TRUNCATE setups.           GOLD CONTROL W
!=======================================================================
2 TEXT_EDITING
The key sequence GOLD T sets WRAP 65.

In that case, if the last word being entered on a line would cause the
line to exceed 65 characters, then EDT automatically moves that word to
the beginning of the next line. 

This wrap setting is useful for editing text (word processing). 

Equivalent to the NOKEYPAD command:

      EXT SET WRAP 65.
!=======================================================================
2 TRUNCATE|NOTRUNCATE
The key sequence GOLD CONTROL W toggles between the two setups described 
below.  The TRUNCATE setup is useful when editing on a terminal that
does not have the Advanced Video Option. 

TRUNCATE setup:
Lines longer than the current screen width are NOT wrapped to the next 
line.
The key sequence GOLD [right_arrow] shifts the buffer display 40 spaces left 
and shifts the cursor 40 spaces right.
The key sequence GOLD [left_arrow] shifts buffer display 40 spaces right 
and shifts the cursor 40 spaces left.

NOTRUNCATE setup (in force on startup):
Lines longer than the current screen width are wrapped to the next line.
GOLD [left_arrow] moves the cursor to the beginning of the current line.
GOLD [right_arrow] moves the cursor to the end of the current line.
!=======================================================================
2 WIDTH_TOGGLE
The key sequence GOLD W toggles between SCREEN 80 and SCREEN 132 widths,
and WRAP 79 and WRAP 131 settings.
!=======================================================================
