Conference vaxuum::document_ft

223.0. "TAGEXPAND; allows SDML tag abbreviations" by AUTHOR::WELLCOME (Steve) Wed Apr 08 1987 15:29

Although the LSE (allegedly) makes entering of lengthy SDML tags "easy", 
there are many times, especially when doing .RNO file conversions, when
you just gotta type 'em in, in all their lengthy glory.  This gets 
tedious pretty fast, and to make the task easier I've written a command
procedure that recognizes and expands SDML tag abbreviations.  The
writeup below explains how it works.  If you have any questions or
suggestions, send me mail at AUTHOR::WELLCOME.



                           How to Use TAGEXPAND

     The command procedure TAGEXPAND recognizes a set of abbreviations
     for  the  more  commonly  used and lengthy SDML tags.  Instead of
     typing  in  finger-benders   like   <VALID_TABLE_ROW_BREAK>   and
     <ENDALIGN_CHAR>, you can instead type in <VTRB> and <EAC>.  Then,
     when you've created your .GNC file,  you  run  the  file  through
     TAGEXPAND.   TAGEXPAND  searches for abbreviated SDML tags in the
     file and expands them to their full form.   This  speeds  up  tag
     entry  considerably, and also reduces the chance of typing errors
     (it's easier to make a mistake typing in 23 characters than it is
     typing in 6).

     TAGEXPAND is set up for use on AUTHOR.  It  consists  of  a  TECO
     macro  TAGEXPAND.TEC,  and a command procedure TAGEXPAND.COM.  To
     use TAGEXPAND, put the following line in your login command file:

        TAGEXPAND :== @AUTHOR::USER:[RTINDEX]TAGEXPAND

*** If you're on a different node, copy TAGEXPAND.TEC and TAGEXPAND.COM ***
*** from AUTHOR::USER:[RTINDEX] to your system.  You'll have to edit    ***
*** TAGEXPAND.COM to change where it looks for TAGEXPAND.TEC.  How to   ***
*** do that should be obvious if you look at the file.                  ***

     Then, to expand tags in a file, type

        TAGEXPAND filename

     in response to the VMS $ prompt.

     TAGEXPAND reads the file you specify, expands  tag  abbreviations
     it  recognizes,  and  writes  a  new  file  of the same name with
     incremented version number.   If  TAGEXPAND  does  not  find  any
     abbreviated tags, nothing gets changed and the output file is the
     same as the input file.

     TAGEXPAND recognizes wildcards in the  filename,  and  assumes  a
     .GNC extension.

     If TAGEXPAND finds a great number of abbreviated tags to  expand,
     a  buffer  overflow  error  may  occur.   If  this happens, put a
     formfeed character (CTRL/L) at intervals  in  the  .GNC  file  to
     break the file into smaller sections.

                                                                Page 2


     List of abbreviations recognized by TAGEXPAND:

     Abbreviation       Tag
     ------------       -------
     <AA>               <ALIGN_AFTER>
     <AC>               <ALIGN_CHAR>
     <EAC>              <ENDALIGN_CHAR>

     <CE>               <CODE_EXAMPLE>
     <ECE>              <ENDCODE_EXAMPLE>

     <ELS>              <ENDLIST>

     <SQ>               <SINGLE_QOUTE>
     <DQ>               <DOUBLE_QUOTE>
     <PC>               <PARENDCHAR>

     <EM>               <EMPHASIS>
     <REF>              <REFERENCE>
     <SS>               <SUBSCRIPT>

     <F>                <FIGURE>
     <FA>               <FIGURE_ATTRIBUTES>
     <FF>               <FIGURE_FILE>
     <FSP>              <FIGURE_SPACE>
     <EF>               <END_FIGURE>

     <IN>               <INTERACTIVE>
     <EIN>              <ENDINTERACTIVE>

     <LA>               <LINE_ART>
     <ELA>              <ENDLINE_ART>

     <LIT>              <LITERAL>

     <T>                <TABLE>
     <TS>               <TABLE_SETUP>
     <TH>               <TABLE_HEADS>
     <TA>               <TABLE_ATTRIBUTES>
     <TR>               <TABLE_ROW>
     <TF>               <TABLE_FILE>
     <TU>               <TABLE_UNIT>
     <TUH>              <TABLE_UNIT_HEADS>
     <ETU>              <ENDTABLE_UNIT>
     <TK>               <TABLE_KEY>
     <TKR>              <TABLE_KEYREF>
     <TSP>              <TABLE_SPACE>
     <ET>               <ENDTABLE>

     <TRB>              <TABLE_ROW_BREAK>
     <VB>               <VALID_BREAK>
     <VTRB>             <VALID_TABLE_ROW_BREAK>
     <NTB>              <NESTED_TABLE_BREAK>

    New version available with more abbreviations.  Copy from same
    place as in 223.0.