RSX11M-PLUS VERSION 2.0 DOCUMENTATION
                            THE BERGEN RECORD



     ----------------------------------------------------------------
            SUBJECT: TECO macros to aid in editing HELP files.
                         AUTHOR: Allen A. Watson
                       LAST REVISION DATE: 6-OCT-82
     ----------------------------------------------------------------












                              CHAPTER 1

                  TECO MACROS FOR EDITING HELP FILES





    Two TECO macros have  been  created  to  aid  system  managers  in
    editing  HELP  files.   These  macros  take  you  directly  to the
    appropriate HELP  file  in  [1,2]  using  the  regular  HELP  file
    qualifier  indices,  and open the file for edit at that point.  No
    longer do you have to manually search through the HELP  file  tree
    to find the correct point at which to edit.



    1.1  TEH.TEC -- TECO edit of HELP file.


    USE:  MUN [1,2]TEH,DCL|MCR qual1 qual2 qual3 ...


    For example, to edit the help file  concerning  the  SET  TERMINAL
    command, you would type:
     
        MUN [1,2]TEH,DCL SET TERMINAL
     
    The TEH macro will open the file [1,2]DCL.HLP,  search  for  a  "1
    SET"  qualifier,  and then commence searching for "2 SET".  If the
    line following "1 SET" is an indirect  file  reference,  TEH  will
    open that file before continuing its search.

    When a match on the final qualifier is found, TEH  will  note  the
    position  and open the file for editing with the cursor positioned
    following the qualifier string.  TECO  will  be  in  split  screen
    scroll mode, and the current portion of the file will be displayed
    on the top 18 lines of the screen.

    When a match on the final qualifier is not found, TEH will jump to
    the  end  of  the  file,  insert the qualifier you have specified,
    warning you that it is doing so, and then open the file  for  edit
    so you can add appropriate help information on that topic.

    Note that like the HELP command itself, TEH will match on  partial
    qualifiers.  Thus, the above command could have been:

TECO MACROS FOR EDITING HELP FILES                            Page 1-2



     
        MUN [1,2]TEH,DCL SET TER



    1.2  EDH.TEC -- EDT edit of HELP file.


    For those who do not know how to edit with TECO, or simply  prefer
    text editing with EDT, the EDH macro will perform exactly the same
    function as the TEH macro, except that the file will be opened for
    editing with EDT.  This is done by spawning an EDT command to MCR.
    EDH first creates a special EDTINI file called EDHINI.  This is  a
    copy  of  any  EDTINI file that is found in the default UIC with a
    search command for the qualifier string appended to  the  end,  so
    that  when EDT opens the file, it will scroll to the correct point
    in the file to begin your edit.

    Usage is identical to TEH:  MUN [1,2]EDH,DCL|MCR qual1 qual2 ...



    1.3  Making it even easier with CCL.


    If you have CCL installed as catchall to  MCR,  you  can  add  the
    following commands to your USERCCL or SYSCCL file:
     
        $3300EDH
        *MUN [1,2]EDH,%A%%$
        
        $3300TEH
        *MUN [1,2]TEH,%A%%$
     
    With these CCL commands, the above commandline simplifies to:
     
        EDH DCL SET TERMINAL
     
    The sources  for  the  above  macros,  unsquished,  are  found  in
    [1,2]EDH.TES and [1 ,2]TEH.TES.







                          Table of Contents


    1.0  TECO MACROS FOR EDITING HELP FILES . . . 1-1
    1.1  TEH.TEC -- TECO edit of HELP file. . . . 1-1
    1.2  EDH.TEC -- EDT edit of HELP file.  . . . 1-2
    1.3  Making it even easier with CCL.  . . . . 1-2