Google
 

Trailing-Edge - PDP-10 Archives - tops10and20_integ_tools_v9_3-aug-86 - 70,6067/edt10/edt.mem
There is 1 other file named edt.mem in the archive. Click here to see a list.


                               November 1983












                             EDT EDITOR MANUAL



                           Order No. AA-M????-TK












                       DIGITAL EQUIPMENT CORPORATION



                        CONFIDENTIAL AND PROPRIETARY


              This is an unpublished work protected by Federal
              Copyright Law.  Any unauthorized reproduction is
                            strictly prohibited.



                    Software Version:       EDT-20 V1.00



           Digital Equipment Corporation, Maynard, Massachusetts










                                     i



                              Field Test Draft



   The information in this document is subject to change  without  notice
   and  should  not  be  construed  as  a commitment by Digital Equipment
   Corporation.  Digital Equipment Corporation assumes no  responsibility
   for any errors that appear in this document.

   The software described in this document is furnished under  a  license
   and  may  be  used or copied only in accordance with the terms of such
   license.

   No responsibility is assumed for the use or reliability of software on
   equipment that is not supplied by DIGITAL or its affiliated companies.




















            Copyright  c  1983 by Digital Equipment Corporation



   The following are tradmarks of Digital Equipment Corporation:

        DEC        VT               IAS
        DECUS      DECsystem-10     MASSBUS
        DECnet     DECsystem-20     PDT
        PDP        DECwriter        RSTS
        UNIBUS     DIBOL            RSX
        VAX        EduSystem        VMS











                                     ii



   CHAPTER 1       INTRODUCTION TO EDT

           1.1     OVERVIEW . . . . . . . . . . . . . . . . . . . . . 1-1
           1.2     AN OVERVIEW OF THE EDT EDITING SESSION . . . . . . 1-2
           1.3     TYPES OF EDT COMMANDS  . . . . . . . . . . . . . . 1-2
           1.3.1     Keypad Editing Functions . . . . . . . . . . . . 1-3
           1.3.2     Line Editing Commands  . . . . . . . . . . . . . 1-3
           1.3.3     Nokeypad Editing Commands  . . . . . . . . . . . 1-3
           1.3.4     The SET And SHOW Commands  . . . . . . . . . . . 1-3
           1.4     SPECIAL FEATURES . . . . . . . . . . . . . . . . . 1-4
           1.4.1     The HELP Facility  . . . . . . . . . . . . . . . 1-4
           1.4.2     The Journal Facility . . . . . . . . . . . . . . 1-4
           1.4.3     Startup Command Files  . . . . . . . . . . . . . 1-4
           1.4.4     Key Definitions For Keypad Function Keys . . . . 1-5
           1.4.5     Macros . . . . . . . . . . . . . . . . . . . . . 1-5
           1.4.6     Tabbing  . . . . . . . . . . . . . . . . . . . . 1-5


   CHAPTER 2       EDT BASICS

           2.1     INTRODUCTION . . . . . . . . . . . . . . . . . . . 2-1
           2.2     BASIC TERMINOLOGY AND CONCEPTS . . . . . . . . . . 2-1
           2.2.1     EDT Terminology  . . . . . . . . . . . . . . . . 2-2
           2.2.2     Editing Modes  . . . . . . . . . . . . . . . . . 2-5
           2.2.3     Editing Session  . . . . . . . . . . . . . . . . 2-5
           2.2.4     Prompts  . . . . . . . . . . . . . . . . . . . . 2-6
           2.2.5     Files  . . . . . . . . . . . . . . . . . . . . . 2-7
           2.2.6     Input And Output Files . . . . . . . . . . . . . 2-8
           2.2.7     File Specification . . . . . . . . . . . . . . . 2-8
           2.2.8     Buffers  . . . . . . . . . . . . . . . . . . . . 2-9
           2.2.9     Text Entities  . . . . . . . . . . . . . . . .  2-10
           2.2.10    Control Characters . . . . . . . . . . . . . .  2-12
           2.2.11    EDT's Position And Direction . . . . . . . . .  2-12
           2.2.12    Strings  . . . . . . . . . . . . . . . . . . .  2-13
           2.2.13    Select Ranges  . . . . . . . . . . . . . . . .  2-15
           2.2.14    Line Numbers . . . . . . . . . . . . . . . . .  2-15
           2.2.15    Line Ranges  . . . . . . . . . . . . . . . . .  2-16
           2.3     SPECIAL KEYS ON YOUR TERMINAL  . . . . . . . . .  2-16
           2.4     STARTING AND ENDING YOUR EDT SESSION . . . . . .  2-17
           2.4.1     How To Begin . . . . . . . . . . . . . . . . .  2-18
           2.4.2     Ending Your EDT Session  . . . . . . . . . . .  2-19
           2.5     RECOVERING YOUR EDT SESSION -- THE JOURNAL 
                   FACILITY . . . . . . . . . . . . . . . . . . . .  2-20


   CHAPTER 3       KEYPAD EDITING

           3.1     INTRODUCTION . . . . . . . . . . . . . . . . . . . 3-1
           3.2     DEFINITIONS OF TERMS USED IN CHAPTER 3 . . . . . . 3-2
           3.3     THE KEYBOARD AND KEYPAD  . . . . . . . . . . . . . 3-3
           3.4     STARTING YOUR EDT SESSION  . . . . . . . . . . . . 3-6
           3.5     ENDING YOUR EDT SESSION  . . . . . . . . . . . . . 3-8
           3.6     THE HELP FACILITY  . . . . . . . . . . . . . . .  3-10
           3.7     REFRESHING THE SCREEN -- CTRL/W  . . . . . . . .  3-12
           3.8     ENTERING TEXT IN AN EMPTY FILE . . . . . . . . .  3-12



                                    iii



           3.9     MOVING THE CURSOR  . . . . . . . . . . . . . . .  3-14
           3.10    DELETING TEXT  . . . . . . . . . . . . . . . . .  3-18
           3.10.1    Deleting And Undeleting Characters -- DEL C, 
                     DELETE, UND C  . . . . . . . . . . . . . . . .  3-19
           3.10.2    Deleting And Undeleting Words -- DEL W, 
                     LINEFEED, UND W  . . . . . . . . . . . . . . .  3-21
           3.10.3    Deleting And Undeleting Lines -- DEL L, DEL 
                     EOL, CTRL/U, UND L . . . . . . . . . . . . . .  3-24
           3.10.4    Other Uses For The Delete Functions  . . . . .  3-30
           3.11    ADDING LINES TO YOUR BUFFER -- RETURN AND OPEN 
                   LINE . . . . . . . . . . . . . . . . . . . . . .  3-30
           3.12    LOCATING STRINGS IN YOUR BUFFER -- FIND AND 
                   FNDNXT . . . . . . . . . . . . . . . . . . . . .  3-32
           3.12.1    FIND . . . . . . . . . . . . . . . . . . . . .  3-33
           3.12.2    Editing The Search String Or Cancelling The 
                     Search . . . . . . . . . . . . . . . . . . . .  3-35
           3.12.3    FNDNXT (Find Next) . . . . . . . . . . . . . .  3-35
           3.12.4    Examples Using FIND And FNDNXT . . . . . . . .  3-36
           3.13    FUNCTIONS THAT MANIPULATE BLOCKS OF TEXT --  . .  3-37
           3.13.1    SELECT . . . . . . . . . . . . . . . . . . . .  3-37
           3.13.2    Using RESET To Cancel A Select Range . . . . .  3-38
           3.13.3    CUT  . . . . . . . . . . . . . . . . . . . . .  3-38
           3.13.4    PASTE  . . . . . . . . . . . . . . . . . . . .  3-39
           3.13.5    APPEND . . . . . . . . . . . . . . . . . . . .  3-43
           3.13.6    REPLACE  . . . . . . . . . . . . . . . . . . .  3-45
           3.14    OTHER FUNCTIONS THAT USE THE SELECT RANGE -- . .  3-47
           3.14.1    CHNGCASE . . . . . . . . . . . . . . . . . . .  3-47
           3.14.2    FILL . . . . . . . . . . . . . . . . . . . . .  3-49
           3.15    SUBSTITUTING IN KEYPAD MODE -- SUBS  . . . . . .  3-50
           3.16    USING EDT'S PRESET TAB STOPS -- TAB  . . . . . .  3-53
           3.17    INSERTING SPECIAL CHARACTERS IN YOUR TEXT -- 
                   SPECINS  . . . . . . . . . . . . . . . . . . . .  3-54
           3.18    KEYPAD'S REPEAT FUNCTION -- GOLD + [-][N]  . . .  3-56
           3.19    USING COMMANDS FROM OTHER EDT MODES -- COMMAND, 
                   CTRL/Z . . . . . . . . . . . . . . . . . . . . .  3-58
           3.19.1    Using Line Mode Commands From Keypad Mode  . .  3-59
           3.19.2    Shifting To Line Mode For A Series Of Commands  3-60


   CHAPTER 4       LINE EDITING

           4.1     INTRODUCTION . . . . . . . . . . . . . . . . . . . 4-1
           4.2     DEFINITIONS OF TERMS USED IN CHAPTER 4 . . . . . . 4-3
           4.3     USING COMMANDS IN LINE EDITING . . . . . . . . . . 4-3
           4.3.1     Specifiers . . . . . . . . . . . . . . . . . . . 4-4
           4.3.2     Qualifiers . . . . . . . . . . . . . . . . . . . 4-4
           4.3.3     Correcting Errors On The Command Line  . . . . . 4-5
           4.3.4     Command Recognition  . . . . . . . . . . . . . . 4-6
           4.4     BUFFER AND RANGE SPECIFIERS  . . . . . . . . . . . 4-8
           4.4.1     The Buffer Specifier . . . . . . . . . . . . . . 4-8
           4.4.2     The Range Specifier  . . . . . . . . . . . . . . 4-9
           4.4.2.1     Period . . . . . . . . . . . . . . . . . . .  4-11
           4.4.2.2     Number . . . . . . . . . . . . . . . . . . .  4-12
           4.4.2.3     Strings  . . . . . . . . . . . . . . . . . .  4-12
           4.4.2.4     BEGIN  . . . . . . . . . . . . . . . . . . .  4-13



                                     iv



           4.4.2.5     END  . . . . . . . . . . . . . . . . . . . .  4-13
           4.4.2.6     LAST . . . . . . . . . . . . . . . . . . . .  4-14
           4.4.2.7     WHOLE  . . . . . . . . . . . . . . . . . . .  4-14
           4.4.2.8     BEFORE . . . . . . . . . . . . . . . . . . .  4-14
           4.4.2.9     REST . . . . . . . . . . . . . . . . . . . .  4-15
           4.4.2.10    SELECT . . . . . . . . . . . . . . . . . . .  4-15
           4.4.2.11    Specifying Line Numbers That Do Not Exist  .  4-15
           4.4.2.12    Using Range Specifiers With The _NULL> 
                       Command  . . . . . . . . . . . . . . . . . .  4-16
           4.4.2.13    Error Messages With Line Ranges  . . . . . .  4-16
           4.5     EDITING A FILE WITH LINE MODE  . . . . . . . . .  4-16
           4.6     THE COMMANDS THAT END YOUR EDT SESSION -- EXIT, 
                   QUIT . . . . . . . . . . . . . . . . . . . . . .  4-17
           4.7     THE HELP FACILITY -- HELP  . . . . . . . . . . .  4-18
           4.8     INSERTING AND DELETING LINES -- INSERT, DELETE .  4-19
           4.9     MOVING FROM PLACE TO PLACE -- FIND, _NULL>, TYPE 4-23
           4.10    PERFORMING SUBSTITUTIONS -- SUBSTITUTE, 
                   SUBSTITUTE NEXT  . . . . . . . . . . . . . . . .  4-26
           4.10.1    SUBSTITUTE . . . . . . . . . . . . . . . . . .  4-26
           4.10.2    SUBSTITUTE NEXT  . . . . . . . . . . . . . . .  4-29
           4.10.3    Comparing SUBSTITUTE And SUBSTITUTE NEXT . . .  4-30
           4.11    LINE EDITING IN ACTION -- SAMPLE SESSION . . . .  4-31
           4.12    USING DIFFERENT BUFFERS IN LINE MODE . . . . . .  4-37
           4.12.1    SHOW BUFFER  . . . . . . . . . . . . . . . . .  4-38
           4.12.2    FIND, _NULL>, And TYPE With A Buffer Specifier 4-39
           4.12.3    Deleting A Buffer With CLEAR . . . . . . . . .  4-41
           4.13    MOVING BLOCKS OF TEXT -- COPY, MOVE, AND REPLACE  4-41
           4.13.1    MOVE . . . . . . . . . . . . . . . . . . . . .  4-42
           4.13.2    COPY . . . . . . . . . . . . . . . . . . . . .  4-44
           4.13.3    REPLACE  . . . . . . . . . . . . . . . . . . .  4-47
           4.14    ADDITIONAL INFORMATION ABOUT DELETE, INSERT, AND 
                   REPLACE  . . . . . . . . . . . . . . . . . . . .  4-47
           4.14.1    DELETE . . . . . . . . . . . . . . . . . . . .  4-48
           4.14.2    INSERT . . . . . . . . . . . . . . . . . . . .  4-48
           4.14.3    REPLACE  . . . . . . . . . . . . . . . . . . .  4-49
           4.15    COMMANDS THAT USE EXTERNAL FILES -- INCLUDE, 
                   PRINT, WRITE . . . . . . . . . . . . . . . . . .  4-50
           4.15.1    INCLUDE  . . . . . . . . . . . . . . . . . . .  4-51
           4.15.2    WRITE  . . . . . . . . . . . . . . . . . . . .  4-52
           4.15.3    PRINT  . . . . . . . . . . . . . . . . . . . .  4-53
           4.16    LINE NUMBERING YOUR TEXT -- RESEQUENCE . . . . .  4-54
           4.17    FORMATTING TEXT -- FILL  . . . . . . . . . . . .  4-56
           4.18    TAB  . . . . . . . . . . . . . . . . . . . . . .  4-57
           4.19    USING SEVERAL LINE MODE COMMANDS ON A SINGLE LINE 4-58
           4.20    QUALIFIERS IN LINE MODE  . . . . . . . . . . . .  4-59
           4.20.1    /BRIEF . . . . . . . . . . . . . . . . . . . .  4-60
           4.20.2    /NOTYPE  . . . . . . . . . . . . . . . . . . .  4-60
           4.20.3    /QUERY . . . . . . . . . . . . . . . . . . . .  4-61
           4.20.4    /STAY  . . . . . . . . . . . . . . . . . . . .  4-62


   CHAPTER 5       NOKEYPAD EDITING

           5.1     INTRODUCTION . . . . . . . . . . . . . . . . . . . 5-1
           5.2     DEFINITIONS OF TERMS USED IN CHAPTER 5 . . . . . . 5-3



                                     v



           5.3     BASICS OF NOKEYPAD COMMANDS  . . . . . . . . . . . 5-3
           5.4     NOKEYPAD SPECIFIERS  . . . . . . . . . . . . . . . 5-4
           5.4.1     The Buffer Specifier . . . . . . . . . . . . . . 5-4
           5.4.2     The Count Specifier  . . . . . . . . . . . . . . 5-4
           5.4.3     The Sign (+|-) Specifier . . . . . . . . . . . . 5-5
           5.4.4     The String Specifier . . . . . . . . . . . . . . 5-5
           5.4.5     The Entity Specifier . . . . . . . . . . . . . . 5-6
           5.4.5.1     The "string" Entity  . . . . . . . . . . . .  5-12
           5.4.5.2     The V Entity . . . . . . . . . . . . . . . .  5-12
           5.5     USING NOKEYPAD EDITING . . . . . . . . . . . . .  5-14
           5.5.1     Starting To Edit In Nokeypad Mode  . . . . . .  5-15
           5.5.1.1     Line Mode's CHANGE Command . . . . . . . . .  5-16
           5.5.2     Ending Your Nokeypad Editing Session . . . . .  5-17
           5.5.3     Using Line Mode Commands In Nokeypad Mode  . .  5-18
           5.5.4     Using The EDT HELP File For Nokeypad 
                     Information  . . . . . . . . . . . . . . . . .  5-20
           5.6     EDITING TEXT IN NOKEYPAD MODE  . . . . . . . . .  5-21
           5.6.1     Inserting Text -- I  . . . . . . . . . . . . .  5-21
           5.6.2     Moving The Cursor -- "move"  . . . . . . . . .  5-23
           5.6.3     Deleting Text -- D . . . . . . . . . . . . . .  5-24
           5.6.4     The Undelete Commands -- UNDC, UNDW, UNDL  . .  5-27
           5.6.5     Combining The Delete And Insert Functions -- R  5-28
           5.6.6     Performing Substitutions -- S, SN  . . . . . .  5-29
           5.6.7     Commands That Change Case -- CHGC, CHGL, CHGU, 
                     DLWC, DMOV, DUPC . . . . . . . . . . . . . . .  5-32
           5.6.8     Using The Select Range -- SEL, DESEL, TGSEL, 
                     SSEL . . . . . . . . . . . . . . . . . . . . .  5-34
           5.6.8.1     SEL  . . . . . . . . . . . . . . . . . . . .  5-34
           5.6.8.2     DESEL  . . . . . . . . . . . . . . . . . . .  5-35
           5.6.8.3     TGSEL  . . . . . . . . . . . . . . . . . . .  5-36
           5.6.8.4     SSEL . . . . . . . . . . . . . . . . . . . .  5-36
           5.6.9     Moving And Copying Text -- CUT, PASTE, APPEND, 
                     KS . . . . . . . . . . . . . . . . . . . . . .  5-36
           5.6.9.1     CUT  . . . . . . . . . . . . . . . . . . . .  5-37
           5.6.9.2     PASTE  . . . . . . . . . . . . . . . . . . .  5-38
           5.6.9.3     APPEND . . . . . . . . . . . . . . . . . . .  5-41
           5.6.9.4     KS . . . . . . . . . . . . . . . . . . . . .  5-43
           5.7     COMMANDS THAT AFFECT YOUR EDITING SESSION  . . .  5-44
           5.7.1     Commands That Change EDT's Direction -- ADV, 
                     BACK . . . . . . . . . . . . . . . . . . . . .  5-44
           5.7.2     Nokeypad Commands Affecting The Display -- REF, 
                     SHL, SHR, TOP  . . . . . . . . . . . . . . . .  5-45
           5.7.2.1     REF  . . . . . . . . . . . . . . . . . . . .  5-45
           5.7.2.2     TOP  . . . . . . . . . . . . . . . . . . . .  5-46
           5.7.2.3     SHL And SHR  . . . . . . . . . . . . . . . .  5-46
           5.7.3     Clearing The Search String -- CLSS . . . . . .  5-47
           5.7.4     Sounding The Terminal Bell -- BELL . . . . . .  5-47
           5.8     FORMATTING TEXT WITH THE FILL COMMAND  . . . . .  5-48
           5.9     SPECIAL NOKEYPAD COMMANDS -- ASC, ^, DATE  . . .  5-49
           5.9.1     ASC  . . . . . . . . . . . . . . . . . . . . .  5-49
           5.9.2     The Circumflex (^) . . . . . . . . . . . . . .  5-50
           5.9.3     DATE . . . . . . . . . . . . . . . . . . . . .  5-51
           5.10    JOINING NOKEYPAD COMMANDS ON A SINGLE COMMAND 
                   LINE . . . . . . . . . . . . . . . . . . . . . .  5-51




                                     vi



   CHAPTER 6       THE SET AND SHOW COMMANDS

           6.1     INTRODUCTION . . . . . . . . . . . . . . . . . . . 6-1
           6.2     SUMMARY OF SET AND SHOW COMMANDS . . . . . . . . . 6-1
           6.3     SET/SHOW ENTITY  . . . . . . . . . . . . . . . . . 6-6
           6.3.1     SET ENTITY WORD  . . . . . . . . . . . . . . . . 6-7
           6.3.2     SET ENTITY SENTENCE  . . . . . . . . . . . . . . 6-8
           6.3.3     SET ENTITY PARAGRAPH . . . . . . . . . . . . . . 6-8
           6.3.4     SET ENTITY PAGE  . . . . . . . . . . . . . . . . 6-9
           6.4     SET/SHOW SEARCH  . . . . . . . . . . . . . . . .  6-10
           6.4.1     Parameters That Match Case . . . . . . . . . .  6-10
           6.4.2     Cursor Location  . . . . . . . . . . . . . . .  6-11
           6.4.3     Search Limits  . . . . . . . . . . . . . . . .  6-12
           6.5     SHOW BUFFER  . . . . . . . . . . . . . . . . . .  6-12
           6.6     SHOW KEY . . . . . . . . . . . . . . . . . . . .  6-14


   CHAPTER 7       ADVANCED EDT FACILITIES

           7.1     INTRODUCTION . . . . . . . . . . . . . . . . . . . 7-1
           7.2     COMMAND FILES  . . . . . . . . . . . . . . . . . . 7-1
           7.2.1     Creating A Startup Command File  . . . . . . . . 7-2
           7.2.2     Sample Startup Command Files . . . . . . . . . . 7-3
           7.2.3     Using SET COMMAND And SHOW COMMAND In A Startup 
                     Command File . . . . . . . . . . . . . . . . .  7-11
           7.2.4     Indirect Command Files . . . . . . . . . . . .  7-13
           7.3     DEFINING AND REDEFINING KEYS . . . . . . . . . .  7-13
           7.3.1     Basics . . . . . . . . . . . . . . . . . . . .  7-14
           7.3.2     What Keys Can Be Defined . . . . . . . . . . .  7-15
           7.3.2.1     Keypad Keys  . . . . . . . . . . . . . . . .  7-16
           7.3.2.2     Control Keys . . . . . . . . . . . . . . . .  7-16
           7.3.2.3     GOLD Control Keys  . . . . . . . . . . . . .  7-16
           7.3.2.4     GOLD Keyboard Keys . . . . . . . . . . . . .  7-17
           7.3.2.5     Special Keyboard Keys  . . . . . . . . . . .  7-17
           7.3.3     Nokeypad Definitions For Keypad Keys . . . . .  7-18
           7.3.4     Using Prompts In Key Definitions . . . . . . .  7-19
           7.3.5     The Key Definition Process . . . . . . . . . .  7-21
           7.3.5.1     Keypad Mode: CTRL/K  . . . . . . . . . . . .  7-22
           7.3.5.2     Editing And Testing Your CTRL/K Definitions   7-27
           7.3.5.3     Line Mode: DEFINE KEY  . . . . . . . . . . .  7-28
           7.3.6     Key Definitions At Work  . . . . . . . . . . .  7-32
           7.3.7     Creating A Table With User Defined Keys  . . .  7-36
           7.4     DEFINING EDT MACROS  . . . . . . . . . . . . . .  7-41
           7.5     SHIFTING EDITING MODES . . . . . . . . . . . . .  7-47
           7.5.1     Moving From Line Mode To The Change Modes  . .  7-47
           7.5.2     Shifting From Keypad Mode To Line Or Nokeypad 
                     Mode . . . . . . . . . . . . . . . . . . . . .  7-48
           7.5.2.1     Keypad To Line Mode  . . . . . . . . . . . .  7-48
           7.5.2.2     Keypad To Nokeypad . . . . . . . . . . . . .  7-50
           7.5.3     Shifting From Nokeypad Mode To Keypad Mode Or 
                     Line Mode  . . . . . . . . . . . . . . . . . .  7-52
           7.5.3.1     Nokeypad To Line Mode  . . . . . . . . . . .  7-52
           7.5.3.2     Nokeypad To Keypad . . . . . . . . . . . . .  7-52
           7.6     THE EDT JOURNAL FILE . . . . . . . . . . . . . .  7-53
           7.6.1     Looking At The Journal File  . . . . . . . . .  7-53



                                    vii



           7.6.2     Editing The Journal File . . . . . . . . . . .  7-57
           7.7     EDT'S TABBING FACILITY . . . . . . . . . . . . .  7-60
           7.7.1     Tabbing Operations In The Screen Modes . . . .  7-60
           7.7.2     Tabbing With EDT . . . . . . . . . . . . . . .  7-61
           7.7.2.1     Using The TAB Function To Arrange Text In 
                       Columns  . . . . . . . . . . . . . . . . . .  7-62
           7.7.2.2     Creating Layered Text Using SET TAB And Other 
                       Tab Functions  . . . . . . . . . . . . . . .  7-65
           7.7.2.3     CTRL/E -- The Tab Increment Function . . . .  7-66
           7.7.2.4     CTRL/D -- The Tab Decrement Function . . . .  7-66
           7.7.2.5     CTRL/A -- The Tab Compute Function . . . . .  7-66
           7.7.3     CTRL/T -- The Tab Adjust Function  . . . . . .  7-67
           7.7.4     Example  . . . . . . . . . . . . . . . . . . .  7-68
           7.7.5     Tabbing In Line Mode . . . . . . . . . . . . .  7-72
           7.8     USING HARDCOPY CHANGE MODE . . . . . . . . . . .  7-74
           7.8.1     Editing In Hardcopy Change Mode  . . . . . . .  7-75
           7.9     USING EDT LINE NUMBERS . . . . . . . . . . . . .  7-79
           7.9.1     Properties Of Line Numbers . . . . . . . . . .  7-80
           7.9.2     Using Line Numbered Files In Your EDT Session   7-80
           7.9.3     Line Numbers With The PRINT Command  . . . . .  7-81
           7.10    CREATING OR MODIFYING THE HELP FILE  . . . . . .  7-82
           7.10.1    HELP File Structure  . . . . . . . . . . . . .  7-83
           7.10.2    HELP File Format . . . . . . . . . . . . . . .  7-85
           7.10.3    Formatting The KEYPAD HELP Text  . . . . . . .  7-85
           7.10.4    Using Different HELP Files In Your EDT Session  7-88


   CHAPTER 8       EDT COMMAND REFERENCE

           8.1     INTRODUCTION . . . . . . . . . . . . . . . . . . . 8-1


   APPENDIX A      EDT MESSAGES



   APPENDIX B      EDT COMMAND SUMMARY

           B.1     KEYPAD COMMANDS  . . . . . . . . . . . . . . . . . B-1
           B.2     LINE COMMANDS  . . . . . . . . . . . . . . . . . . B-4
           B.3     NOKEYPAD COMMANDS  . . . . . . . . . . . . . . . . B-8


   APPENDIX C      TERMINAL SUPPORT AND INTERFACE FOR EDT

           C.1     TERMINALS THAT EDT SUPPORTS  . . . . . . . . . . . C-1
           C.2     TERMINAL INTERFACE . . . . . . . . . . . . . . . . C-2
           C.3     TERMINALS OPERATING AT LOW DATA TRANSMISSION RATES C-2


   APPENDIX D      ASCII CHARACTER SET







                                    viii



   APPENDIX E      USING EDT WITH THE TOPS-20 OPERATING SYSTEM

           E.1     CALLING UP EDT . . . . . . . . . . . . . . . . . . E-1
           E.2     INFORMATION ON USING FILES WITH EDT  . . . . . . . E-3
           E.3     EDIT COMMAND QUALIFIERS  . . . . . . . . . . . . . E-4
           E.4     CONTROL CHARACTERS THAT CANNOT BE DEFINED  . . . . E-7
           E.5     TERMINAL INFORMATION AND SETTINGS UNDER TOPS-20  . E-7
           E.6     INFORMATION ON HELP FILE FORMATS . . . . . . . . . E-9
           E.7     RUNNING EDT FROM A PROGRAM . . . . . . . . . . . . E-9

















































                                     ix
                                  PREFACE


   AUDIENCE

   EDT, DIGITAL's standard text editor, is  designed  for  use  on  these
   operating   systems:    VAX/VMS,  RSTS/E,  RSX-11M,  RSX-11M-PLUS  and
   TOPS-20.  This EDT Editor Manual describes how to use  EDT  to  create
   and  edit  text  files  interactively on the TOPS-20 operating system.
   This manual consists of  explanations  and  examples  of  EDT  editing
   operations  and  tasks, as well as a reference section which discusses
   each EDT editing command and function.

   The manual is intended for all levels of users  --  beginners  through
   experienced.  You must have:

        1.  Access to an operating system that has the EDT editor.

        2.  Knowledge of the basic system  commands  for  that  operating
            system, such as logging on and off, listing a file directory,
            and deleting files.

        3.  Familiarity with the terminal you will be using with EDT.

   New users with no previous computer editing experience will  find  the
   following manual helpful in learning how to use EDT:

   Introduction to the EDT Editor

        Teaches users with little or no computer experience how  to  edit
        text with the EDT editor.

   These manuals give information on the operating systems  that  support
   the EDT Editor:

   VAX/VMS:

   VAX/VMS Primer

        Introduces a new VAX/VMS user to  the  DIGITAL  Command  Language
        (DCL),  file  manipulation,  program  development, and elementary
        operating system concepts.

   VAX/VMS Command Language User's Guide

        Gives detailed  reference  information  on  the  VAX/VMS  DIGITAL
        Command Language (DCL).

   RSTS/E:

   RSTS/E Primer

        Introduces the RSTS/E operating system to new users.

   RSTS/E System User's Guide

        Describes  the  RSTS/E  V7.0  operating  system:   its  programs,
        features, and resources.



                                     x
                                  PREFACE


   RSX-11M/M-PLUS:

   Introduction to RSX-11M and RSX-11M-PLUS

        Teaches new users to use the RSX-11M/M-PLUS operating system.

   RSX-11M/M-PLUS Command Language Manual

        Describes the RSX DCL command language in detail.

   TOPS-20:

   Getting Started With TOPS-20

        Introduces a new user to the TOPS-20 operating system.

   TOPS-20 Commands Reference Manual

        Gives detailed user information on the TOPS-20 command language.


   USING THIS MANUAL

   This manual assumes that you know how to use your  terminal  and  that
   you  are  familiar with some basic computer procedures such as logging
   on and off, using a file directory, giving elementary system  commands
   to  delete, copy, or rename files, and pressing the RETURN key to send
   information to the computer.

   The EDT Editor Manual covers all aspects of EDT.  However,  those  who
   have  never  used a computer editor before will find it useful to read
   the  Introduction  to  the  EDT   Editor   volume,   which   describes
   introductory concepts and commands in greater detail.


   DOCUMENT STRUCTURE

   Chapter 1:     Provides a broad introduction to EDT on TOPS-20.

   Chapter 2:     Provides information on basic computer editing concepts
                  as they apply to EDT.  These include information on how
                  EDT works, how to start and end your EDT session, files
                  and  buffers,  text entities, strings, ranges, and line
                  numbers.  The  last  section  describes  EDT's  journal
                  facility,  which  enables you to recover your work if a
                  system interruption occurs.

   Chapter 3:     Presents an in-depth description of  the  major  keypad
                  editing functions and examples showing how to use them.

   Chapter 4:     Describes line editing commands and  techniques.   Some
                  line  mode  commands are useful even if you plan to use
                  keypad editing most of the time.  This chapter includes
                  a full discussion of line ranges.




                                     xi
                                  PREFACE


   Chapter 5:     Describes nokeypad  editing  and  includes  a  complete
                  table  of nokeypad entity specifiers.  Nokeypad mode is
                  used primarily to create  key  definitions  for  keypad
                  mode.

   Chapter 6:     Contains a reference table for all  the  SET  and  SHOW
                  commands as well as detailed descriptions of several of
                  the more complex  and  frequently  used  SET  and  SHOW
                  commands.

   Chapter 7:     Presents information on advanced features of EDT.   The
                  topics  covered  include  startup  command  files,  key
                  definitions,  macro  definitions,   tabbing,   shifting
                  modes,  EDT  line  numbers, and modification of the EDT
                  HELP file.

   Chapter 8:     Describes all EDT commands, qualifiers, and specifiers.
                  The items are arranged alphabetically, each starting at
                  the top of a page.  Directly under the item name is its
                  editing mode:  keypad, line, or nokeypad.  Examples are
                  given for most items.  A cross reference chart  at  the
                  beginning  of  the chapter groups commands in all three
                  editing modes by their type of function.

   Appendix A:    Contains all the EDT messages that can appear during an
                  editing session.  There is a brief explanation for each
                  message.

   Appendix B:    Presents a command summary, arranged by  editing  mode.
                  Use  this appendix to quickly refresh your memory about
                  a command's syntax, or to find out  what  commands  are
                  available in a particular mode.

   Appendix C:    Gives details on terminal support for EDT.  Check  here
                  to  find  out if you can use the screen modes with your
                  terminal.

   Appendix D:    Lists the ASCII Character Set with decimal  equivalents
                  for all characters in the set.

   Appendix E:    Includes information specific to using EDT on a TOPS-20
                  operating  system.   Qualifiers  and specifiers for the
                  TOPS-20 EDIT and CREATE commands are  described.   This
                  appendix  tells  you  how  to  call  EDT from a running
                  program on a TOPS-20 system.













                                    xii
                                CONVENTIONS


   This manual uses the following conventions and symbols:
         Symbol                       Description

   EDT                     In this manual refers to EDT-20 V1.

   Cursor             ||   A  shaded rectangle  represents  the cursor in
                           screen terminal examples.

   Control      |CTRL/x|   The  phrase  CTRL/x  (control x)  indicates  a
   Character               control  key  sequence.   First press  the key
   Sequence                labelled CTRL;  then,  while holding down that
                           key, press the keyboard character key.
                           Examples:  CTRL/Z or CTRL/[.

   GOLD         |GOLD/x|   The  phrase  GOLD/x  indicates  the  GOLD  key
   Character               sequence.   Press the GOLD keypad key and then
   Sequence                a keyboard key.   Examples:  GOLD/T or GOLD/*.
                           The GOLD key is the upper left-most key on the
                           keypad.  It is labelled PF1 on VT100 terminals
                           it is blue on VT52 terminals.

   Delete       |DELETE|   The  DELETE  key   (sometimes  called  RUBOUT)
   Key                     removes  the  character  to  the  left  of the
                           cursor  on  screen  terminals.    On  hardcopy
                           terminals it deletes  the characters  starting
                           with the one to the left of the print head.

   Return       |RETURN|   The  RETURN key  sends an  EDT command  to the
   Key                     computer in line and  nokeypad editing.   When
                           you insert text,  RETURN  moves the  cursor or
                           print head to  start a new  line in  all three
                           editing modes.

   Spacebar         |SP|   This symbol indicates the spacebar  or a space
   Space                   in the text.

   Keyboard        | A |   This is a keyboard character key.
   Key                     

   Keypad        |DEL L|   This is a keypad  function key.   When the key
   Function      |UND L|   is not preceded by GOLD, the upper function is
   Key                     the one performed, in this case DEL L.

          |GOLD|+|DEL L|   This is  an alternative  keypad  function key.
                 |UND L|   Pressing GOLD and then the function key causes
                           the lower  function to  be performed,  in this
                           case UND L.

   Command and    COPY     The  underlined  letters indicate  the minimum
   Qualifier               abbreviation for the command,  in this case CO
   Abbreviations           for COPY.   EDT  accepts  any input  from  the
                           minimum  abbreviation   through  the  complete
                           command name.   For clarity,  all  examples in
                           this manual show the complete command name.




                                    xiii
                                CONVENTIONS


   Optional          [ ]   Brackets enclose  optional material in command
   Material                statements.   This material  might  be  a file
                           specification, a line number, or a word.   For
                           example,  [range] shows  that you  can enter a
                           range  of lines  at that point  in the command
                           statement.   Never type brackets in the actual
                           command statement.

   Alternative       { }   Braces enclose a list of alternatives within a
   Command                 command.   Unless  the  braces  are  contained
   Words                   within brackets,  you must  specify one of the
                           alternatives  in your command statement.   The
                           alternatives are separated  from each other by
                           vertical bars (|).  Do not type braces or bars
                           in the actual command statement.

   Alternative         |   The   OR  symbol   (vertical  bar)   separates
   Command Word            specifiers   for   the   same   operation   or
   Separator               alternatives  contained  within  braces.   For
                           example,  'string'|"string" indicates that you
                           you can use either  single or double quotation
                           marks to surround a string.

   System         |hand|   The  hand  symbol  represents  your  operating
   Prompt                  system's  command  level  prompt.   The actual
                           prompt  symbol appears  at  the  left of  your
                           screen or paper.   The system  prompts include
                           $, >, and Ready.

   User            red     Red and brown  print in examples indicate what
   Input           brown   you  type  or  what  keys  you  press.    Most
                           examples  use red.   When keypad  examples for
                           VT52  terminals  differ from  those  for VT100
                           type  terminals,  the  VT52  input  appears in
                           brown.    Your  input for  line  and  nokeypad
                           editing is always red.

   Repetition        ...   The  horizontal   ellipsis  shows   indefinite
                           repetition   in  a  command  statement.    For
                           example [subtopic ...] indicates  that you can
                           specify more than one subtopic.

   Omission            .   The vertical  ellipsis indicates  that some of
                       .   the  lines in the  example or  figure are  not
                       .   shown.













                                    xiv
                                CONVENTIONS


            Summary of differences between EDT-20 V1 and EDT V3

   This release of EDT is similar to EDT V3 which runs  on  the  VAX/VMS,
   RSX-11M,  RSX-11M-PLUS,  and RSTS/E operating systems, but is designed
   to run on the TOPS-20 operating system.  This  means  that  there  are
   certain differences between EDT V3 and EDT-20 V1.  The following notes
   briefly describe these differences.

        1.  All line mode commands  take  advantage  of  the  recognition
            features  of  the  TOPS-20  command  interface  (that is, the
            ESCAPE and question mark keys).  Because  of  this,  any  key
            definitions  involving the question mark key must contain the
            question mark in double quotes.   For  example:   DEFINE  KEY
            GOLD  "?"  AS  ....  Also, the SET PROMPT keyword INSERTN has
            been changed to NINSERT to aid recognition.

        2.  Line mode commands require all quoted strings to be  enclosed
            in  double quotes (").  If you wish to include a double quote
            character in the string, simply  precede  it  with  a  second
            double   quote.    Also,  multiple  line  mode  commands  are
            separated by a backslash character (\).

        3.  In its handling of directories, EDT-20  takes  the  following
            default action:

             o  Searches  your  connected  directory  then  your   log-in
                directory for the startup command file.

             o  Assumes that help files are located in PS:HELP>.


        4.  EDT-20 provides the following new commands and qualifiers:

                 PUSH              command
                 SET [NO]CONTROL-T command
                 SHOW CONTROL-T    command
                 /GO               qualifier for the EXIT command

        5.  TOPS-20 places no restriction on the use of CTRL/x or  CTRL/Y
            as keypad command keys.

        6.  EDT-20 does not  provide  an  XLATE  command  --  Appendix  E
            describes how to call EDT-20 from a running program.

        7.  This release of EDT-20 does not support  eightbit  terminals,
            that  is,  terminals  which  use  the  full DEC Multinational
            Character Set.  Only the ASCII character set as used on VT100
            and VT52 style terminals is supported.




                                     xv