                    Waterloo SCRIPT GML User's Guide                           

                    Department of Computing Services                           

                         University of Waterloo                                
                           Waterloo, Ontario                                   
                            Canada  N2L 3G1                                    

                            October 18, 1988                                   


               (c) Department of Computing Services, 1988                      
                                                                               

 page ii                               Waterloo SCRIPT GML User's Guide        
                                                                               

 Waterloo SCRIPT GML User's Guide                              page iii        


                                ABSTRACT                                       

 A generalized markup language (GML) provides a convenient way of anno-        
 tating document source  for computerized composition.   With  the GML,        
 each component of the document is identified by a "tag".  For example,        
 the GDOC tag indicates  the start of the document,  and  the eGDOC tag        
 indicates the end of the document.                                            

    This document describes  a GML for use with  Waterloo SCRIPT.   The        
 input for  a GML-prepared document is  a SCRIPT file of  the following        
 form:                                                                         

      .im GMLxxxxx                                                             
      :GDOC                                                                    
      :FRONTM                                                                  
      the front-matter component                                               
      :eFRONTM                                                                 
      :BODY                                                                    
      the body component                                                       
      :eBODY                                                                   
      :APPENDIX                                                                
      the appendix component                                                   
      :eAPPENDIX                                                               
      :BACKM                                                                   
      the back-matter component                                                
      :eBACKM                                                                  
      :eGDOC                                                                   

 The "GMLxxxxx" file that you imbed  at the beginning controls the lay-        
 out  of  the resulting  output.    The  layouts  defined to  date  are        
 described in  the first  appendix.   The GMLguide  layout was  used to        
 produce this document.  Additional layouts are described in the second        
 appendix.                                                                     
                                                                               

 page iv                               Waterloo SCRIPT GML User's Guide        
         
                                                                               

 Waterloo SCRIPT GML User's Guide                                page v        
         


              THE ROLES IN THE DOCUMENT-PRODUCTION PROCESS                     

 This User's Guide describes a mark-up  language that has been designed        
 to conform to a general class of documents encompassing a wide variety        
 of layout styles.  As such, the User's Guide describes two related but        
 very different items:                                                         

 1.    the set of GML tags appropriate to that class of documents              

 2.    the different layouts supporting that set of tags                       

 The extent to which you will need to know and need to use the informa-        
 tion contained herein is,  therefore,  dependent on which role(s)  you        
 are fulfilling.                                                               


 Notes to Authors                                                              

 The information below describes an organizational-unit approach to the        
 overall task of document preparation, production, and maintenance,  in        
 parallel with the authoring role.    In many environments,  the author        
 may be the one and only person carrying out all of these tasks.               


 Organizational Considerations                                                 

 The preparation, production, and maintenance of documentation involves        
 four distinct and very different sets of responsibilities and skills.         

 Document  Administrator:   This  is the  individual  who  has  overall        
   responsibility for  determining what documents  are to  be produced,        
   what the component parts of those documents are,  for defining docu-        
   ment layout  standards (what the  finished results must  look like),        
   and for the selection and supervision  of those fulfilling the addi-        
   tional roles described below.  Requirements for this role include an        
   understanding of  the process  of document-component  analysis,  the        
   aesthetics of  "good" layout  design,  and  the capabilities  of the        
   computer-based system being used.                                           

 Text Programmer:  The  Text Programmer implements a  set of high-level        
   markup tags  that represent  the component  parts of  the documents,        
   implements the  associated processing functions that  will recognize        
   those tags and produce a composed  document that adheres to the lay-        
   out standards,   and documents the tags  for use by  those described        
   below.  Requirements for this role include programming ability and a        
   thorough working familiarity with  the process of document-component        
   analysis and the  capabilities of the computer-based  system as they        
   pertain to the application.                                                 

 Mark-up Editor:  The Mark-up Editor  receives manuscripts from authors        
   and pencils  in the markup tags  to identify the component  parts of        
   the document.  Requirements for this role include editorial authori-        
                                                                               

 page vi                               Waterloo SCRIPT GML User's Guide        
         


   ties and a thorough working familiarity  with the set of markup tags        
   that have been designed for the application.                                

 Text-Entry Operator:  After  the manuscript has been  processed by the        
   Mark-up Editor, the Text-Entry Operator uses the system to enter the        
   manuscript text and markup tags into  "document files" and to output        
   formatted documents.   Requirements for this  role include an excel-        
   lent typing ability  and a working familiarity  with the text-editor        
   program of the system.                                                      

 In any organizational unit with  responsibilities for preparing,  pro-        
 ducing,  and  maintaining documentation,  the  success of  the overall        
 effort is clearly dependent on  matching the responsibilities with the        
 individuals who have the required skills  and the enthusiasm for using        
 them.   While the  responsibilities of Document Administrator  will be        
 assigned to one  and only one individual within the  unit (for obvious        
 practical reasons),  the nature of the workload will determine how the        
 other three roles are assigned ...  the number of people per role,  or        
 the number of roles per person.                                               


 Notes to Document Administrators                                              

 Only you  can determine whether these  GML tags and layouts,   as they        
 currently exist, meet your requirements.   It is possible that the GML        
 tags described herein  are appropriate for the kinds  of documents you        
 must produce,  but there may not be  a layout that meets your require-        
 ments.   In that  case,  your Text Programmer will have  to create the        
 additional layout(s) that you require.  It is also possible that these        
 particular GML tags  do not adequately describe the  components of the        
 kinds of documents that you must produce.   In that case, you and your        
 Text Programmer can still use this document as a case-study example in        
 designing a particular set of GML  tags to meet your own requirements,        
 and your Text Programmer can implement SCRIPT macros and whatever dif-        
 ferent layout variations  are required,  and write a  user's guide for        
 use by your Mark-up Editor(s) and Text-Entry Operator(s).                     
                                                                               

 Waterloo SCRIPT GML User's Guide                              page vii        
         


                          IMPLEMENTATION NOTES                                 

 Compatibility of the Standard Tag Set and Layouts                             

 The tags  described herein are an  expanded version of a  "GML Starter        
 Set" that is part of an IBM  program product called DCF,  the Document        
 Composition Facility [2].   The GML tags shown below are NOT described        
 by the DCF/GML tag  set,  and should not be used  if you are concerned        
 about the portability of your  document,  either to a non-SCRIPT-based        
 GML processor or to a computing  installation that might use IBM's DCF        
 instead of Waterloo SCRIPT.                                                   

 BIBID, BIBREF, BL, BIB, eBL                                                   
    the tags for bibliographic references and bibliography list                

 BOX, eBOX                                                                     
    the tags for boxes                                                         

 EN, eEN, ENDNOTES, ENREF                                                      
    the tags for endnotes                                                      

 INCLUDE                                                                       
    include an external file                                                   

 SET                                                                           
    set a global default (described in an appendix)                            

 TABID, FIGID                                                                  
    the tags for pre-generating table and figure numbers                       

 tables                                                                        
    the tags for tables                                                        

 *  the comment tag, :*                                                        

 In addition, the following tags function differently:                         

 FN the footnote reference is always  generated,  independent of the ID        
    attribute's presence or absence                                            

 UL may be nested to a depth of six, instead of three.                         


 The Non-Standard Tag Sets and Layouts                                         

 Neither the  non-standard layouts  nor the tags  peculiar to  them are        
 known to exist with any other  implementation of a GML-based document-        
 composition processor.                                                        
                                                                               

 page viii                             Waterloo SCRIPT GML User's Guide        
         


 Beware!                                                                       

 While this implementation  of GML is built on top  of Waterloo SCRIPT,        
 it is intended that you DO NOT  USE SCRIPT control words in your docu-        
 ments.  The implementation of the processing function for each GML tag        
 alters  the underlying  SCRIPT environment  in  various manners,   and        
 SCRIPT control  words may  only be used  safely within  the body  of a        
 table, a figure, or an example component.                                     
                                                                               

 Waterloo SCRIPT GML User's Guide                               page ix        
         


                                CONTENTS                                       


 Abstract  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  iii        

 The Roles in the Document-Production Process  . . . . . . . . . . .  v        
    Notes to Authors . . . . . . . . . . . . . . . . . . . . . . . .  v        
    Organizational Considerations  . . . . . . . . . . . . . . . . .  v        
    Notes to Document Administrators . . . . . . . . . . . . . . . . vi        

 Implementation Notes  . . . . . . . . . . . . . . . . . . . . . .  vii        
    Compatibility of the Standard Tag Set and Layouts  . . . . . .  vii        
    The Non-Standard Tag Sets and Layouts  . . . . . . . . . . . .  vii        
    Beware!  . . . . . . . . . . . . . . . . . . . . . . . . . . . viii        


 Part 1:  Tags, Attributes, and Text . . . . . . . . . . . . . . . .  1        

    GML Tag Syntax . . . . . . . . . . . . . . . . . . . . . . . . .  1        
       Tag Name  . . . . . . . . . . . . . . . . . . . . . . . . . .  1        
       Tag Text  . . . . . . . . . . . . . . . . . . . . . . . . . .  1        
          Heading Tagtext  . . . . . . . . . . . . . . . . . . . . .  2        
          Start of Text Block  . . . . . . . . . . . . . . . . . . .  2        
          Continued Text . . . . . . . . . . . . . . . . . . . . . .  2        
       Attributes  . . . . . . . . . . . . . . . . . . . . . . . . .  2        
    GDOC and eGDOC Tags and Attributes . . . . . . . . . . . . . . .  3        
    Language Customization . . . . . . . . . . . . . . . . . . . . .  3        
    The INCLUDE Tag  . . . . . . . . . . . . . . . . . . . . . . . .  4        
    The Comment Tag  . . . . . . . . . . . . . . . . . . . . . . . .  4        


 Part 2:  The Front Matter . . . . . . . . . . . . . . . . . . . . .  5        

    The Title Page . . . . . . . . . . . . . . . . . . . . . . . . .  5        
       Title . . . . . . . . . . . . . . . . . . . . . . . . . . . .  5        
       Author  . . . . . . . . . . . . . . . . . . . . . . . . . . .  6        
       Address . . . . . . . . . . . . . . . . . . . . . . . . . . .  6        
       Document Number . . . . . . . . . . . . . . . . . . . . . . .  7        
       Date  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7        
       Copyright Line  . . . . . . . . . . . . . . . . . . . . . . .  7        
       Copyright Notice  . . . . . . . . . . . . . . . . . . . . . .  7        
    Abstract . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7        
    Preface  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  8        
    Tables of Contents . . . . . . . . . . . . . . . . . . . . . . .  8        


 Part 3:  The Body . . . . . . . . . . . . . . . . . . . . . . . . . 11        

    Heading Levels -- the Divisions of the Body  . . . . . . . . . . 11        
       Layout-Dependent Considerations . . . . . . . . . . . . . . . 11        
       Level-Zero Components . . . . . . . . . . . . . . . . . . . . 12        
       Level-One Subheadings . . . . . . . . . . . . . . . . . . . . 12        
                                                                               

 page x                                Waterloo SCRIPT GML User's Guide        
         


       Referring to Headings . . . . . . . . . . . . . . . . . . . . 12        


 Part 4:  The Appendix Component . . . . . . . . . . . . . . . . . . 15        


 Part 5:  The Back Matter  . . . . . . . . . . . . . . . . . . . . . 17        

    Index  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17        
    The Bibliography . . . . . . . . . . . . . . . . . . . . . . . . 17        
       The Bibliographic Items . . . . . . . . . . . . . . . . . . . 18        
       Referencing Bibliographic Items . . . . . . . . . . . . . . . 18        
       Numbered Bibliography Lists . . . . . . . . . . . . . . . . . 18        
       Labelled Bibliography Lists . . . . . . . . . . . . . . . . . 19        
       Referencing a List or Range of Items  . . . . . . . . . . . . 19        
    Other Back-Matter Components . . . . . . . . . . . . . . . . . . 20        


 Part 6:  Basic Document Components  . . . . . . . . . . . . . . . . 21        

    Paragraphs . . . . . . . . . . . . . . . . . . . . . . . . . . . 21        
    Notes  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21        
    Footnotes  . . . . . . . . . . . . . . . . . . . . . . . . . . . 22        
       Footnote Identifiers and References . . . . . . . . . . . . . 22        
       Creating a Footnote to a Level-One Heading  . . . . . . . . . 23        
       Creating a Footnote to the Document TITLE . . . . . . . . . . 23        
    Endnotes . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23        
       Additional References to an Endnote . . . . . . . . . . . . . 24        
       Positioning the Endnotes  . . . . . . . . . . . . . . . . . . 24        
    Citations  . . . . . . . . . . . . . . . . . . . . . . . . . . . 25        
    Quotations . . . . . . . . . . . . . . . . . . . . . . . . . . . 25        
       Long Quotations . . . . . . . . . . . . . . . . . . . . . . . 25        
       Short Quotations  . . . . . . . . . . . . . . . . . . . . . . 25        
    Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26        
    Highlighted Phrases  . . . . . . . . . . . . . . . . . . . . . . 26        
    Boxes  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27        
    List Structures  . . . . . . . . . . . . . . . . . . . . . . . . 27        
       Ordered Lists . . . . . . . . . . . . . . . . . . . . . . . . 27        
       Unordered Lists . . . . . . . . . . . . . . . . . . . . . . . 29        
       Simple Lists  . . . . . . . . . . . . . . . . . . . . . . . . 29        
       List Items with Headings  . . . . . . . . . . . . . . . . . . 29        
       Referring to List Items . . . . . . . . . . . . . . . . . . . 31        
       Definition Lists  . . . . . . . . . . . . . . . . . . . . . . 31        
       Definition Lists with Term and Description Headings . . . . . 32        
       Glossary Lists  . . . . . . . . . . . . . . . . . . . . . . . 32        
       Nesting Various Types of Lists  . . . . . . . . . . . . . . . 33        
       Interrupting the Items in a List -- the List Paragraph  . . . 33        
    Tables and Figures . . . . . . . . . . . . . . . . . . . . . . . 34        
       Figures . . . . . . . . . . . . . . . . . . . . . . . . . . . 34        
       Tables  . . . . . . . . . . . . . . . . . . . . . . . . . . . 35        
       Defining the Body of a Table or Figure  . . . . . . . . . . . 35        
          Pasted-In Material . . . . . . . . . . . . . . . . . . . . 36        
                                                                               

 Waterloo SCRIPT GML User's Guide                               page xi        
         


          Textual Material . . . . . . . . . . . . . . . . . . . . . 36        
          Textual and Pasted-In Material . . . . . . . . . . . . . . 36        
       Referencing Tables and Figures  . . . . . . . . . . . . . . . 36        
       Forward Out-of-Sequence References  . . . . . . . . . . . . . 37        
       Referencing a List or Range of Figures or Tables  . . . . . . 37        
    Formulae . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38        
       In-Line Formula . . . . . . . . . . . . . . . . . . . . . . . 38        
       Display-Mode Formula  . . . . . . . . . . . . . . . . . . . . 38        
       Numbering a Display-Mode Formula  . . . . . . . . . . . . . . 38        
       Referring to a Numbered Display-Mode Formula  . . . . . . . . 39        
    Process-Specific Code  . . . . . . . . . . . . . . . . . . . . . 39        
    Tags for Constructing Indexes  . . . . . . . . . . . . . . . . . 39        
       Index Terms and Page References . . . . . . . . . . . . . . . 39        
       The Index-Term Tags . . . . . . . . . . . . . . . . . . . . . 40        
       An Example  . . . . . . . . . . . . . . . . . . . . . . . . . 40        
       Index-Term Identifiers  . . . . . . . . . . . . . . . . . . . 40        
       Special Page References . . . . . . . . . . . . . . . . . . . 41        
       Repeating an Index Term . . . . . . . . . . . . . . . . . . . 41        
       The Index-Header Tags . . . . . . . . . . . . . . . . . . . . 42        
       Printing the Resulting Index in the Back Matter . . . . . . . 42        
       Multiple Indexes  . . . . . . . . . . . . . . . . . . . . . . 42        


 Appendix A:  Layouts for the Standard Tagset  . . . . . . . . . . . 45        

    Major Features of the Standard-Tagset Layouts  . . . . . . . . . 45        
    Miscellaneous Layouts  . . . . . . . . . . . . . . . . . . . . . 45        
       GMLgdoc . . . . . . . . . . . . . . . . . . . . . . . . . . . 45        
       GMLfoils  . . . . . . . . . . . . . . . . . . . . . . . . . . 45        
       GMLsdoc . . . . . . . . . . . . . . . . . . . . . . . . . . . 45        
       GMLresum  . . . . . . . . . . . . . . . . . . . . . . . . . . 46        
    Manuals and Reports  . . . . . . . . . . . . . . . . . . . . . . 47        
       GMLguide  . . . . . . . . . . . . . . . . . . . . . . . . . . 47        
       GMLman  . . . . . . . . . . . . . . . . . . . . . . . . . . . 47        
       GMLrefg . . . . . . . . . . . . . . . . . . . . . . . . . . . 47        
       GMLss . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47        
       GMLworkt  . . . . . . . . . . . . . . . . . . . . . . . . . . 47        
       GMLuwcpc  . . . . . . . . . . . . . . . . . . . . . . . . . . 47        
    Layouts for Papers . . . . . . . . . . . . . . . . . . . . . . . 47        
       GMLpaper  . . . . . . . . . . . . . . . . . . . . . . . . . . 47        
       GMLaipj . . . . . . . . . . . . . . . . . . . . . . . . . . . 47        
       GMLapaj . . . . . . . . . . . . . . . . . . . . . . . . . . . 47        
       GMLieee . . . . . . . . . . . . . . . . . . . . . . . . . . . 48        
       GMLmwcs . . . . . . . . . . . . . . . . . . . . . . . . . . . 48        
       GMLnhcrc  . . . . . . . . . . . . . . . . . . . . . . . . . . 48        
    Layouts for Theses . . . . . . . . . . . . . . . . . . . . . . . 48        
       GMLthesi  . . . . . . . . . . . . . . . . . . . . . . . . . . 48        
       GMLapa  . . . . . . . . . . . . . . . . . . . . . . . . . . . 48        
       GMLmla  . . . . . . . . . . . . . . . . . . . . . . . . . . . 48        
    Additional Tags for the Front Material of a Thesis . . . . . . . 48        
       THESIS  . . . . . . . . . . . . . . . . . . . . . . . . . . . 48        
       COURSE  . . . . . . . . . . . . . . . . . . . . . . . . . . . 49        
                                                                               

 page xii                              Waterloo SCRIPT GML User's Guide        
         


       DECLARE . . . . . . . . . . . . . . . . . . . . . . . . . . . 49        
       BORROW  . . . . . . . . . . . . . . . . . . . . . . . . . . . 49        


 Appendix B:  Layouts for the Non-Standard Tagsets . . . . . . . . . 50        

    GMLgroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50        
    GMLlet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50        
    GMLmemo  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52        
    GMLmins  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53        
       Confidential Minutes, Drafts, Etc . . . . . . . . . . . . . . 55        
       Meeting Agendas . . . . . . . . . . . . . . . . . . . . . . . 56        
    GMLagree . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56        
    GMLpp  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57        
       Using GMLpp for Job-Description documents . . . . . . . . . . 57        


 Appendix C:  The SET Tag  . . . . . . . . . . . . . . . . . . . . . 58        

    Number of Heading Levels . . . . . . . . . . . . . . . . . . . . 58        
    Page Settings  . . . . . . . . . . . . . . . . . . . . . . . . . 58        
    Line-Spacing Modes . . . . . . . . . . . . . . . . . . . . . . . 59        
    Font Selections for Special Output Devices . . . . . . . . . . . 59        
    Relative Numbering . . . . . . . . . . . . . . . . . . . . . . . 60        
    Bibliography-List Styles . . . . . . . . . . . . . . . . . . . . 61        
    Figure and Table Names . . . . . . . . . . . . . . . . . . . . . 61        
    Figure and Table Printing  . . . . . . . . . . . . . . . . . . . 62        
    Heading-Level Names  . . . . . . . . . . . . . . . . . . . . . . 62        
    Heading-Level Numbering Styles . . . . . . . . . . . . . . . . . 62        
    Heading Levels in the Table of Contents  . . . . . . . . . . . . 62        
    Notes  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63        
    Ordered-List Annotation Styles . . . . . . . . . . . . . . . . . 63        
    Indentation for Basic Document Components  . . . . . . . . . . . 63        
    Vertical Spacing for Document Components . . . . . . . . . . . . 64        
    Numbering All Display-Mode Formulae  . . . . . . . . . . . . . . 64        


 Appendix D:  Summary of Tags, Attributes, and Values for the                  
              Standard Tagset  . . . . . . . . . . . . . . . . . . . 65        


 Appendix E:  Multiple-Font Output Devices . . . . . . . . . . . . . 73        


 Appendix F:  Using SCRIPT . . . . . . . . . . . . . . . . . . . . . 74        

    Output Devices and Output-Page Margins . . . . . . . . . . . . . 74        
    SCRIPT Options . . . . . . . . . . . . . . . . . . . . . . . . . 74        
    Specifying Your Own Fonts  . . . . . . . . . . . . . . . . . . . 75        
    Beware!  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76        
                                                                               

 Waterloo SCRIPT GML User's Guide                             page xiii        
         


 Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79        

 Bibliography  . . . . . . . . . . . . . . . . . . . . . . . . . . . 81        


                                                                               
                                 FIGURES                                       


 1.  This is the Figure Caption  . . . . . . . . . . . . . . . . . . 34        


                                                                               
                                 TABLES                                        


 1.  This is the Table Caption . . . . . . . . . . . . . . . . . . . 35        

 2.  The Table Caption . . . . . . . . . . . . . . . . . . . . . . . 37        

 3.  Major Features of the Standard-Tagset Layouts . . . . . . . . . 46        
                                                                               

 page xiv                              Waterloo SCRIPT GML User's Guide        
         
                                                                               

 Waterloo SCRIPT GML User's Guide                                page 1        
         


                                 Part 1                                        

                       TAGS, ATTRIBUTES, AND TEXT                              


                                                                               
                             GML TAG SYNTAX                                    

 A tag can appear anywhere on an input line;  it does not have to start        
 at the beginning of the input line.    The various ways in which a GML        
 tag can be specified can be represented as follows:                           

      :tagname                                                                 
      :tagname.tagtext                                                         
      :tagname attribute list                                                  
      :tagname attribute list.tagtext                                          

 In this document,  items enclosed in  "<" and ">" characters represent        
 optional specifications; for example,                                         

      :tagname< attributes>.tagtext                                            

 documents  a tag  for which  attributes  are optional  but tagtext  is        
 required.                                                                     


 Tag Name                                                                      

 In its  simplest form,  a  GML tag  consists of the  GML tag-indicator        
 character (the colon) followed by the tagname; for example,                   

      :tagname                                                                 

 The tagname may be specified in  uppercase,  lowercase,  or a mixture.        
 Throughout this document,  uppercase characters  are used to represent        
 things that  you must  specify exactly  as documented,   and lowercase        
 characters are  used where you  are to  specify something of  your own        
 choosing.                                                                     


 Tag Text                                                                      

 Some tags either require or accept "tag text".   In that case, the GML        
 tag is used as                                                                

      :tagname.tagtext                                                         

 The period  is only required  after the  tagname in those  cases where        
 tagtext appears.                                                              
                                                                               

 page 2                                Waterloo SCRIPT GML User's Guide        
         


 Heading Tagtext:   Some of the GML tags treat the tagtext as a heading        
 (see H1, for example).  These tags are documented as                          

      :tagname.Heading Tagtext                                                 

 The first letter  of each significant word in the  heading text should        
 be capitalized.   The appearance of the heading in the resulting docu-        
 ment is dependent on the layout you have selected.                            

 Start of Text Block:  With tags that are documented in the form               

      :tagname.Start of text block ...                                         

 the tagtext represents the start of text for a block (see P, for exam-        
 ple).  It is not necessary that the tag be used with tagtext;                 

      :tagname                                                                 
      Start of text block ...                                                  

 will produce the same result.                                                 

 Continued Text:  With tags that are documented in the form                    

      :tagname.continued text                                                  

 the first  character of  the tagtext  (if any  is specified)   will be        
 placed  immediately after  the last  character already  on the  output        
 line, without any intervening blanks (see eFN,  for example).   There-        
 fore,  you  should not specify tagtext  with such tags unless  that is        
 what you want to achieve.                                                     


 Attributes                                                                    

 In their fullest form,  some GML tags can consist of the GML tag indi-        
 cator, the tagname, an "attribute list",  a period,  and tagtext;  for        
 example,                                                                      

      :tagname attribute list.tagtext                                          

 There are two forms of attributes.  In the more common form, an attri-        
 bute consists  of an attribute name,   an "=",  and a  value,  without        
 intervening blanks.   In  the less common form,  an  attribute name by        
 itself is used.  For example,                                                 

      :tagname att1=value1 att2 att3=value3.tagtext                            

 If an attribute's value contains anything  other than letters and dig-        
 its, it must be delimited by apostrophes or quotes, such as                   

      :tagname attname='the value'                                             
      :tagname attname="it's the value"                                        
      :tagname attname='1.5'                                                   
                                                                               

 Waterloo SCRIPT GML User's Guide                                page 3        
         


    A reference summary of all tags  and their attributes and values is        
 provided in an appendix.                                                      


                                                                               
                   GDOC AND EGDOC TAGS AND ATTRIBUTES                          

 The GDOC and  eGDOC tags are always required.   The  SEC= attribute of        
 the GDOC tag enables you to  specify a "security classification" or to        
 indicate that the document is a "draft" version.  For example,                

      :GDOC SEC='Confidential'                                                 

 indicates that the information in the document is confidential, where-        
 as                                                                            

      :GDOC SEC='Draft'                                                        

 indicates that the document is not yet in its final form.                     

    Most of the GML layouts utilize the  value of the SEC= attribute as        
 information to  be included on  the title page,   if a value  has been        
 specified for SEC=.  Some also include the SEC= value in top or bottom        
 running titles;  layouts that do not  currently utilize the SEC= value        
 will be enhanced to do so in some future version.                             


                                                                               
                         LANGUAGE CUSTOMIZATION                                

 Many of the GML layouts cause words  to appear in output pages in ways        
 that are not associated  with specific GML tags or the  text from your        
 input files.  For example, the word "page" may be generated as part of        
 the "page numbering" that a layout performs.                                  

    By default, all such words are in English.  However, it is possible        
 to specify that such words should be generated in some other language,        
 by specifying                                                                 

      :GDOC LANGUAGE=value                                                     

 where "value" may  be one of ENGLISH,  FRENCH,   GERMAN,  SPANISH,  or        
 SWEDISH.   (Doing  so will  also cause  the Waterloo  SCRIPT document-        
 composition program to  use a set of hyphenation  rules appropriate to        
 the specified language.)                                                      
                                                                               

 page 4                                Waterloo SCRIPT GML User's Guide        
         


                            THE INCLUDE TAG                                    

 You may often find it useful to prepare large documents as a series of        
 smaller input files.   The INCLUDE tag  allows you to specify that the        
 contents of another file are to be included during processing:                

      :INCLUDE FILE=filename                                                   

 The file to be included may  contain whatever combination of text and/        
 or tags is appropriate.                                                       

    The INCLUDE tag may also be useful  if you are preparing memos (see        
 the GMLmemo layout),  since it enables  you to construct the distribu-        
 tion list by including one or more files containing people's names.           


                                                                               
                            THE COMMENT TAG                                    

 The :* tag may appear anywhere in  an input line.   It causes the rest        
 of the input line to be ignored.                                              
                                                                               

 Waterloo SCRIPT GML User's Guide                                page 5        
         


                                 Part 2                                        

                            THE FRONT MATTER                                   


                                                                               
 The front matter of a document  includes the title-page components and        
 any other preliminary information,  including  the tables of contents.        
 The start and end  of the front matter are identified  with the FRONTM        
 and eFRONTM tags:                                                             

      :FRONTM                                                                  
      tags and text for the front matter                                       
      <:eFRONTM>                                                               

    With most of the GML layouts,  all of the pages in the front matter        
 of a document will be numbered in lowercase roman numerals.   The tags        
 that may be  used to identify the  components of the front  matter are        
 described below.                                                              


                                                                               
                             THE TITLE PAGE                                    

 The input for the title page is prepared in the following form:               

      :TITLEP                                                                  
      tags for the title-page components                                       
      :eTITLEP                                                                 

 The  TITLEP tag  indicates the  start of  the information  that is  to        
 appear on the  title page,  and the  eTITLEP tag indicates the  end of        
 that information.  The layout of the title-page information depends on        
 the GML  layout that you have  selected;  some produce a  "full" title        
 page,  and others  produce a "partial" title page in  which the title-        
 page  information occupies  only  as  much of  the  first  page as  it        
 requires.   For layouts that produce a full title page, the title page        
 will be considered  as page "i",  although  a page number will  not be        
 printed on that page.                                                         

    The tags  that describe the components  of the title page  are dis-        
 cussed below.  It is not necessary that you use all of them.                  


 Title                                                                         

 The title of the document is described by the TITLE tag.  It is of the        
 form                                                                          

      :TITLE.This is the Title of the Document                                 
                                                                               

 page 6                                Waterloo SCRIPT GML User's Guide        
         


 Some of the GML  layouts also cause the title to be  used as a running        
 title at  the top  or bottom of  subsequent even-  and/or odd-numbered        
 pages.   If the title is too long to be suitable for this purpose, you        
 can provide a shortened version of  that title by including the STITLE        
 attribute:                                                                    

      :TITLE stitle='Short Title'.Full Title                                   

    Multi-line titles can be defined by repeated use of the :TITLE tag:        

      :TITLE.First Line of Title                                               
      :TITLE.Second Line of Title                                              
      :TITLE.Last Line of Title                                                

 With those layouts  that use the title  as a running title,   only the        
 title (or short title)  from the first  TITLE tag is used for the run-        
 ning title.                                                                   


 Author                                                                        

 The name of the author is specified as:                                       

      :AUTHOR.Name of Author                                                   

 If the document has  more than one author,  repeat the  AUTHOR tag for        
 each author's name.                                                           


 Address                                                                       

 If it  is appropriate to  place the name  and address of  the author's        
 organization on the title page, then indicate the start of that infor-        
 mation by  using the ADDRESS tag,   describe each line of  the address        
 information  by using  the ALINE  tag,  and  indicate the  end of  the        
 address information by using the eADDRESS tag:                                

      :ADDRESS                                                                 
      :ALINE.Company name                                                      
      :ALINE.first line of address                                             
         .                                                                     
         .                                                                     
      :ALINE.last line of address                                              
      :eADDRESS                                                                
                                                                               

 Waterloo SCRIPT GML User's Guide                                page 7        
         


 Document Number                                                               

 If the document is part of a  series that has some form of publication        
 series number, that number is specified as:                                   

      :DOCNUM.document number                                                  


 Date                                                                          

 The DATE  tag,  if specified  by itself,   will cause today's  date to        
 appear on the title page.  If specified with text, as in                      

      :DATE.date of publication                                                

 that text will be used as the date of publication of the document.            


 Copyright Line                                                                

 The COPYRIGHT tag causes a copyright line to be included in the title-        
 page information.  It is of the form                                          

      :COPYRIGHT<.Text Line>                                                   

 If tagtext is  specified,  the copyright line will consist  of a copy-        
 right symbol  followed by  the specified tagtext.    If no  tagtext is        
 specified, the information in the resulting copyright line will depend        
 on the layout you have selected.                                              


 Copyright Notice                                                              

 The COPYNOTE  tag indicates  the start  of a  "copyright notice"  text        
 block that  is to  appear after  the copyright  line.   The  copyright        
 notice is of the form                                                         

      :COPYNOTE<.Start of text block>                                          
      more text for the copyright notice                                       
      :eCOPYNOTE                                                               


                                                                               
                                ABSTRACT                                       

 If the document requires an Abstract,  the heading and text are speci-        
 fied as:                                                                      

      :ABSTRACT<.Heading Text>                                                 
      text of the abstract                                                     
      <:eABSTRACT>                                                             
                                                                               

 page 8                                Waterloo SCRIPT GML User's Guide        
         


 If specified without  heading text,  the word "Abstract"  will be used        
 for the heading.                                                              


                                                                               
                                PREFACE                                        

 Any additional preliminary  components that are required  in the docu-        
 ment must be identified as follows:                                           

      :PREFACE<.Heading Text>                                                  
      text for this component                                                  
      <:ePREFACE>                                                              

 If used by itself without heading text, the PREFACE tag will use "Pre-        
 face" for the heading.                                                        


                                                                               
                           TABLES OF CONTENTS                                  

 The tables  of contents are the  last components of the  front matter.        
 They consist of three optional components:  the table of contents, the        
 list of figures, and the list of tables.  They are specified as               

      :TOC<.Heading Text>                                                      
      :FIGLIST<.Heading Text>                                                  
      :TABLIST<.Heading Text>                                                  

 The  information that  will appear  in these  components is  collected        
 automatically from the tagtext  of all heading-level,  figure-caption,        
 and table-caption  tags in  your document.   If  your document  is not        
 large enough to  warrant the inclusion of  any or all of  these compo-        
 nents, specify only the one(s)  you want.   All three tags are ignored        
 by the layouts in the "paper" category, since papers are smaller docu-        
 ments that do not warrant tables of contents.                                 

    The table of  contents will include the heading text  of all level-        
 zero through level-four heading tags in the document; if TOC is speci-        
 fied without tagtext,   the heading will be "Contents".    The list of        
 figures will include the figure captions of  all of the figures in the        
 document; if FIGLIST is specified without tagtext, the heading will be        
 "Figures".   The list of tables will include the table captions of all        
 of the tables  in the document;  if TABLIST is  specified without tag-        
 text, the heading will be "Tables".                                           

    Note:   The tables of contents are the last components of the front        
 matter of a document.   If you  are SCRIPTing your document in single-        
 pass mode,   however,  the  tables-of-contents entries  for the  body,        
 appendix,  and back matter have not yet been encountered.   Therefore,        
 the tables of contents will be printed at the end of the document, and        
 it is  your responsibility to  move the  resulting pages of  output to        
                                                                               

 Waterloo SCRIPT GML User's Guide                                page 9        
         


 their proper position in the document.  If you SCRIPT your document in        
 multiple-passes mode, the tables of contents will print in their prop-        
 er place,   as the  last components  of the  front matter.    However,        
 multiple-passes  processing  consumes additional  resources.    It  is        
 therefore not recommended unless you have some other compelling reason        
 for using it.                                                                 
                                                                               

 page 10                               Waterloo SCRIPT GML User's Guide        
         
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 11        
         


                                 Part 3                                        

                                THE BODY                                       


                                                                               
 The start and end of the body  of the document are identified with the        
 BODY and eBODY tags:                                                          

      :BODY                                                                    
      tags and text for the body                                               
      <:eBODY>                                                                 


                                                                               
              HEADING LEVELS -- THE DIVISIONS OF THE BODY                      

 The body of the  document will consist of one or  more level-one divi-        
 sions,  each with a heading.   The start of each level-one division is        
 specified as                                                                  

      :H1.Heading Text                                                         
      text and "basic document components"                                     

 If a  level-one division  is large  enough that  it needs  to be  sub-        
 divided, the start of each second-level division is specified as              

      :H2.Heading Text                                                         
      text and "basic document components"                                     

    In the same fashion,  a level-two division can be sub-divided using        
 a H3 tag, level-three divisions by H4, level-four divisions by H5, and        
 level-five divisions by using the H6 tag.                                     


 Layout-Dependent Considerations                                               

 The tagtext for each heading level will  be composed in a style appro-        
 priate to the layout you have selected and the output device for which        
 you are SCRIPTing the document.                                               

    Some of the GML layouts also  use the level-one and level-two head-        
 ings as running titles at the  tops and/or bottoms of subsequent even-        
 and/or odd-numbered  pages.   If the  heading text  is too long  to be        
 suitable for this purpose,  then you may specify the STITLE attribute,        
 in the manner described for the TITLE tag.                                    

    The ABSTRACT and  PREFACE tags are logically  level-one components.        
 Therefore, you may also use the H2,  H3,  ...  tags to subdivide those        
 components.                                                                   
                                                                               

 page 12                               Waterloo SCRIPT GML User's Guide        
         


 Level-Zero Components                                                         

 A special tag,   H0,  is provided for  large documents in which  it is        
 appropriate to group the level-one divisions  of the body.   For exam-        
 ple, one might do this in a thesis or reference manual, thereby group-        
 ing into "parts" the level-one divisions that comprise the "chapters".        


 Level-One Subheadings                                                         

 A H1SUB  tag exists for those  situations in which  additional heading        
 text is required immediately after a level-one heading.   For example,        
 the input sequence                                                            

      :H1.Heading Text                                                         
      :H1SUB.Additional Heading Text                                           
      :H1SUB.And Still More Heading Text                                       
      text and "basic document components"                                     

 specifies a level-one  heading followed by two  level-one subheadings.        
 The tagtext for the subheadings will be composed immediately after the        
 level-one tagtext, in the same style as the level-one heading.  Level-        
 one subheadings are not included in the table of contents.                    


 Referring to Headings                                                         

 In order to generate  a reference to a heading,  you  must assign that        
 heading an identifier.   All of the heading-level GML tags (H0 through        
 H6, and all other tags equivalent to H1) provide an ID= attribute that        
 allows you define such an identifier.   For example, the heading above        
 was specified in the form                                                     

      :H2 ID=hd2ref.Referring to Headings                                      

 The name of  the identifier can contain from one  to seven characters,        
 and can be used in the HDREF tag  to generate a reference to that par-        
 ticular heading.  For example, the input sequence                             

      This is discussed under the heading                                      
      :HDREF REFID=hd2ref., and this                                           
      particular example is known as a                                         
      :Q.backward reference:eQ..                                               

 results in:   This is discussed under  the heading "Referring to Head-        
 ings", and this particular example is known as a "backward reference".        
 If tagtext is specified with the HDREF tag, it will be treated as con-        
 tinued text.                                                                  

    If the heading and the heading  reference are on different pages of        
 the composed document,  then the words "on page" and the number of the        
 page on  which the heading  appears will be  generated as part  of the        
 heading reference.                                                            
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 13        
         


    Note:  You will sometimes wish to generate a reference to a heading        
 at some  point in the document  before that heading occurs.    This is        
 known as a forward reference ...   you are referring to something that        
 occurs later in the input sequence.    In order to achieve the correct        
 output, you must SCRIPT your document in multiple-pass mode.                  
                                                                               

 page 14                               Waterloo SCRIPT GML User's Guide        
         
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 15        
         


                                 Part 4                                        

                         THE APPENDIX COMPONENT                                


                                                                               
 If the document  has appendices,  they normally belong  after the body        
 and before the start of the back matter (if there is any).   The start        
 and end of the appendix component are indicated by                            

      :APPENDIX                                                                
      tags and text for each appendix                                          
      <:eAPPENDIX>                                                             

    The start of each appendix is specified by the H1 tag,                     

      :H1<.Heading Text>                                                       
                                                                               

 page 16                               Waterloo SCRIPT GML User's Guide        
         
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 17        
         


                                 Part 5                                        

                            THE BACK MATTER                                    


                                                                               
 The back matter of a document,  if there is any,  will usually consist        
 of components such as bibliographies,  glossaries,  and indexes.   The        
 start and  end of the back-matter  components are identified  with the        
 BACKM and eBACKM tags:                                                        

      :BACKM                                                                   
      tags and text for the back matter                                        
      <:eBACKM>                                                                

 The tags specific to the back matter are described below.                     


                                                                               
                                 INDEX                                         

 GML provides tags for generating index-item entries (discussed later).        
 If you  have used these  index-item tags  to create index  entries for        
 your document, then use the tag                                               

      :INDEX<.Heading Text>                                                    

 to define the index heading and to  cause the index entries to be com-        
 posed and included  in the output.   The index heading  is logically a        
 level-one heading;  if tagtext is not  specified,  the heading will be        
 "Index".                                                                      


                                                                               
                            THE BIBLIOGRAPHY                                   

 The heading for the bibliography is indicated with a H1 tag.  The bib-        
 liography is a list of bibliographic items.  Its start is indicated by        
 the BL tag, and its end by the eBL tag.  The input sequence for a bib-        
 liography will therefore be in the following form:                            

      :H1.Bibliography                                                         
      Text prior to the list, if desired.                                      
      :BL                                                                      
      first bibliographic item                                                 
         ...                                                                   
      last bibliographic item                                                  
      :eBL                                                                     
      Text following the list, if desired.                                     
                                                                               

 page 18                               Waterloo SCRIPT GML User's Guide        
         


 The Bibliographic Items                                                       

 The input sequence  to define an item  in the bibliography list  is of        
 the form:                                                                     

      :BIB                                                                     
      Author's Name, Initials.                                                 
      :CIT.Title of Cited Work:eCIT..                                          
      other information                                                        

    The CIT and  eCIT tags indicate the  start and end of  the title of        
 the cited work.   Most  manuals of style are quite specific  as to the        
 other information that is required in a bibliographic item; if you are        
 using a GML  layout that has been  designed to adhere to  the require-        
 ments of some specific manual of style, please consult that manual for        
 the exact nature and ordering of this other information.                      


 Referencing Bibliographic Items                                               

 At various places throughout your document, you will need to make ref-        
 erence to items that are in your bibliography.  Most modern manuals of        
 style suggest that you place some combination of the author's name and        
 the date of publication in (parentheses) or [brackets] at the point of        
 reference,  since  this provides both  an immediate indication  of the        
 source and  the least disruption in  the readability of  the document.        
 Other manuals of style  suggest that you use a footnote  or endnote to        
 provide that information.   Still others suggest that you provide some        
 form of numeric annotation reference number, and that the bibliograph-        
 ic list  be numbered  accordingly.   Unless  you must  adhere to  this        
 numeric-list-annotation style,  you do not  need to read the remaining        
 information on "The Bibliography" on page 17.                                 


 Numbered Bibliography Lists                                                   

 Some of  the GML  layouts will  automatically number  the bibliography        
 list.   To gain access to these  reference numbers,  you must assign a        
 unique identifier to  each of the BIB tags in  your bibliography list,        
 as                                                                            

      :BL                                                                      
      :BIB ID=name1                                                            
           ...                                                                 
      :BIB ID=name2                                                            
           ...                                                                 
      :eBL                                                                     

 The identifier name  may contain no more than  eight characters.   You        
 must also use  the BIBID tag to pre-generate the  reference numbers at        
 the beginning of the document,  in the  same order as you have defined        
 the items in the bibliography list:                                           
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 19        
         


      :GDOC                                                                    
      :BIBID REFID=name1                                                       
      :BIBID REFID=name2                                                       
      :BIBID REFID=name3                                                       
        ...                                                                    

 At any point in your document where you  must refer to an item in your        
 bibliography list, you then use the BIBREF tag:                               

      :BIBREF REFID=name<.continued text>                                      

 For example, the input sequence                                               

      As discussed in :BIBREF REFID=turab.,                                    
      this is how you refer to a bibliographic item.                           

 will produce a bibliographic reference in  the style of the GML layout        
 you are using;  in the layout being used to produce this document, the        
 above input sequence results in:   As  discussed in [12],  this is how        
 you refer to a bibliographic item.                                            

    If you are using a GML layout  that numbers the items in the bibli-        
 ography list and  you wish to eliminate that numbering,   you must use        
 the SET tag (described in an appendix) to set the bibliographic refer-        
 ence style to NONE.   If you are using a GML layout that does not num-        
 ber the items in the bibliography list and you wish to force that num-        
 bering,  you must  use the SET tag to set  the bibliographic reference        
 style to NUMBER.                                                              


 Labelled Bibliography Lists                                                   

 A few  manuals of style  suggest that you  devise a short  "label" for        
 each item in  your bibliography list,  formed by taking  the first few        
 characters of the (primary)  author's last name and the year of publi-        
 cation, plus a letter to identify more than one work by that author in        
 that  year (if  needed).    To do  this,   you must  use  the SET  tag        
 (described in an appendix) to set the bibliographic reference style to        
 LABEL,  and specify the label as the ID attribute of BIB and the REFID        
 attribute of the BIBREF tag.  Do not use the BIBID tag.                       


 Referencing a List or Range of Items                                          

 The  REFID attribute  can be  specified  in a  list-notation and/or  a        
 range-notation form, as well; for example,                                    

      :BIBREF REFID='one two three'                                            
      :BIBREF REFID='one-two'                                                  
      :BIBREF REFID='one two-three four'                                       
                                                                               

 page 20                               Waterloo SCRIPT GML User's Guide        
         


 The first is a list of three items that will be punctuated as "1,2,3".        
 The second is a  range of two items that will  be punctuated as "1-2".        
 The  third  is a  list  of  four  items  that will  be  punctuated  as        
 "1,2-3,4".                                                                    


                                                                               
                      OTHER BACK-MATTER COMPONENTS                             

 If additional back-matter components are required, they must be initi-        
 ated by using the H1 tag.                                                     
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 21        
         


                                 Part 6                                        

                       BASIC DOCUMENT COMPONENTS                               


                                                                               
 There are  a great many document  components that may  appear (almost)        
 anywhere in the front matter, body, appendix, and back matter.                


                                                                               
                               PARAGRAPHS                                      

 The start of a paragraph is indicated with the P tag,                         

      :P.Start of text block ...                                               
      rest of paragraph text block                                             

    It is  considered "bad  style" in most  publications to  indent the        
 first line of the first paragraph after a heading.   Therefore,  it is        
 suggested that you avoid using P in the manner                                

      :Hn.Heading Text                                                         
      :P.Start of text block ...                                               

 and instead think  of P as that  which marks the end  of one paragraph        
 and the start of the next.                                                    


                                                                               
                                 NOTES                                         

 A note is a block of text that is intended to qualify or clarify.  The        
 NOTE and eNOTE tags are used to create a note, in the form                    

      :NOTE.Start of note block ...                                            
      more of note block ...                                                   
      last of note block.                                                      
      <:eNOTE>                                                                 

 For example, the above input sequence produces:                               

    Note:   Start of note block ...   more  of note block ...   last of        
 note block.                                                                   
                                                                               

 page 22                               Waterloo SCRIPT GML User's Guide        
         


                               FOOTNOTES                                       

 The FN and eFN tags are used to define the start and end of a block of        
 footnote text:                                                                

      This is the sentence containing the word                                 
      :FN.Start of text block ...                                              
      rest of footnote text block.                                             
      :eFN.,                                                                   
      and the footnote text appears below.                                     

 The last word before the FN tag  will have a footnote reference number        
 appended to it,  and the footnote text block will appear at the bottom        
 of the current output page (or column,   if the layout being used pro-        
 duces its output in multiple-columns-per-page mode).  For example, the        
 sequence above produces  the following result:   This  is the sentence        
 containing the word, and the footnote text appears below.  If tagtext        
 is specified with the eFN tag, it will be treated as continued text.          


 Footnote Identifiers and References                                           

 The FN tag provides an ID attribute that defines a footnote identifier        
 name:                                                                         

      :FN ID=name.Start of text block ...                                      

 The name can contain up to seven letters and/or digits.                       

    The FNREF tag allows you to  generate another footnote reference to        
 a previous footnote,   by specifying its identifier name  as the REFID        
 attribute:                                                                    

      :FNREF REFID=name.continued text                                         

 For example, the input sequence                                               

      One of the footnotes in this document                                    
      :FNREF REFID=foot                                                        
      was defined with ID=foot.                                                

 results in:   One of the footnotes  in this document was defined with        
 ID=foot.                                                                      


                                                                               


                                                          

  Start of text block ...   rest of footnote text block.   This second        
   sentence is included  to demonstrate the offset  of subsequent lines        
   of the text block.                                                          
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 23        
         


 Creating a Footnote to a Level-One Heading                                    

 The H1  tag accepts a  special-case FNID  attribute that causes  it to        
 generate a footnote  reference symbol after the text  of the level-one        
 heading.   The  H1 tag is followed  by the FN/eFN footnote  block,  as        
 shown below.                                                                  

      :H1 FNID=idname.Creating a Footnote to a Level-One Heading               
      :FN REFID=idname                                                         
      This footnote refers to the above level-one heading.                     
      :eFN                                                                     


 Creating a Footnote to the Document TITLE                                     

 The TITLE tag also accepts the  FNID attribute.   However,  the subse-        
 quent  FN/eFN block  must not  be contained  within the  range of  the        
 TITLEP/eTITLEP tags;  instead,   it must follow immediately  after the        
 eTITLEP tag.                                                                  

    Note:   This severely  limits the usefulness of  the FNID attribute        
 with the TITLE tag  when used with a layout that  produces a full-page        
 titlepage,  since the  footnote will appear at the bottom  of the next        
 page, not at the bottom of the titlepage.   It is hoped that it may be        
 possible to rectify this shortcoming in some future implementation.           


                                                                               
                                ENDNOTES                                       

 A footnote is that which comes at the bottom (foot) of something.   An        
 endnote is  that which comes at  the end of something.    Endnotes are        
 created in much  the same way as  footnotes.   The EN tag  defines the        
 start of  the endnote text  block,  and the  eEN tag defines  its end.        
 They are used in the following fashion:                                       

      Sentence containing a word                                               
      :EN.Start of endnote text block ...                                      
      rest of endnote text block.                                              
      :eEN<.continued text>                                                    
      for which an endnote is to be generated.                                 

 The above input sequence produces the following:   Sentence containing        
 a word[1] for which an endnote is to be generated.                            
                                                                               

 page 24                               Waterloo SCRIPT GML User's Guide        
         


 Additional References to an Endnote                                           

 The ENREF tag  allows you to make additional references  to an endnote        
 that has been specified with the  ID attribute.   For example,  if the        
 endnote above had been defined with                                           

      :EN ID=above                                                             

 then                                                                          

      This is an additional reference to                                       
      the previous endnote                                                     
      :ENREF REFID=above..                                                     

 produces:   This  is an additional  reference to the  previous endnote        
 [1].                                                                          


 Positioning the Endnotes                                                      

 You control where you want the  endnotes to be printed,  by specifying        
 the ENDNOTES  tag.  Any already-defined  endnotes will be  printed at        
 that point in the document, and endnote numbering will resume at 1 for        
 the first endnote defined thereafter.   Therefore,   you can use it as        
 many times as you wish.   For  example,  you might define endnotes and        
 then cause them to be printed at the end of each level-one division of        
 the body of your document.  For example, the following input sequence         

      :H2.Positioning the Endnotes                                             
      You control where you want ...                                           
      rest of text comprising the above discussion ...                         
      results in:                                                              
      :ENDNOTES                                                                
      followed by additional text.                                             

 results in:                                                                   

 [1] Start of endnote text block ...  rest of endnote text block.  This        
     additional text has  been added to demonstrate a  larger number of        
     lines in the endnote text block.                                          

 followed by additional text.                                                  


                                                                               


                                                                               

                                                          

  If you do not,  the endnotes will be printed automatically by SCRIPT        
   at the end of your document ... and you will not like the result!           
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 25        
         


                               CITATIONS                                       

 References to other works are identified  using the CIT and eCIT tags.        
 For example,                                                                  

      This is the                                                              
      :CIT.Waterloo SCRIPT GML User's Guide:eCIT                               
      document.                                                                

 results in:   This  is the Waterloo SCRIPT GML  User's Guide document.        
 If tagtext is specified with the eCIT tag,  it will be treated as con-        
 tinued text.                                                                  


                                                                               
                               QUOTATIONS                                      

 Long Quotations                                                               

 These are also  referred to as block quotations,   to distinguish them        
 from in-line quotations.  A long quotation is identified as follows:          

      text before long quotation                                               
      :LQ<.start of>                                                           
      long-quotation text block                                                
      :eLQ                                                                     
      text after long quotation                                                

 The result will be displayed in a  manner determined by the layout you        
 have selected.  The layout selected for this document produces:               

      This is a  long-quotation text block.   The  indentation and             
      spacing of the text in the  block are controlled by the lay-             
      out you select for your document.                                        

 followed by whatever text comes after the long quote.                         


 Short Quotations                                                              

 These are also referred to as  in-line quotations.   The example shown        
 in the following input sequence                                               

      Text before short quotation                                              
      :Q                                                                       
      short-quotation text block                                               
      :eQ                                                                      
      text after short quotation.                                              

 produces the following:   Text before short quotation "short-quotation        
 text block" text after short quotation.   If tagtext is specified with        
 the eQ tag, it will be treated as continued text.                             
                                                                               

 page 26                               Waterloo SCRIPT GML User's Guide        
         


                                EXAMPLES                                       

 The start of a  block of text that represents an  example is indicated        
 with the XMP tag,  and the end  of the example block is indicated with        
 the eXMP tag.  For example,                                                   

      :XMP                                                                     
      This is the first input line of the                                      
      example block, and this is the                                           
      last input line of the block.                                            
      :eXMP                                                                    

 produces the following result:                                                

      This is the first input line of the                                      
      example block, and this is the                                           
      last input line of the block.                                            


                                                                               
                          HIGHLIGHTED PHRASES                                  

 Four levels of highlighted phrases are provided by tags of the form           

      :HPn<.start of>                                                          
      text to be highlighted                                                   
      (n=0,1,2,3)                                                              
      :eHPn<.continued text>                                                   

 The HP0/eHP0  tags enclose text  that will  appear as normal  text (in        
 other  words,  the  text  will not  be  highlighted).   The  HP1/eHP1,        
 HP2/eHP2,  and HP3/eHP3 tags result in increasing levels of highlight-        
 ing.                                                                         

    If you wish to highlight text that  is within a block that is being        
 placed  in the  output  document exactly  as  entered  (line by  line,        
 instead of the block mode in which  normal text is produced),  you can        
 do so by specifying the highlighted-phrase tags in the form                   

      This is level :HP0.zero:eHP0. highlighting.                              
      This is level :HP1.one:eHP1. highlighting.                               
      This is level :HP2.two:eHP2. highlighting.                               
      This is level :HP3.three:eHP3. highlighting.                             
                                                          

  If the document is SCRIPTed for  an output device that supports mul-        
   tiple fonts,   these levels of  highlighting will  be (respectively)        
   italic,  boldface,  and boldface italic.   If the output device does        
   not have  multiple fonts  or if  the fonts  provided by  GML do  not        
   include those  faces,  alternative  approaches to  highlighting will        
   result.  For example, for simple terminals and line printers, under-        
   scoring is used to represent italics, overprinting is used to repre-        
   sent boldface, and both are used to represent boldface italics.             
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 27        
         


 For example, the above input sequence produces:                               

      This is level zero highlighting.                                         
      This is level one highlighting.                                          
      This is level two highlighting.                                          
      This is level three highlighting.                                        

 This same in-line  technique can also be used for  citations and short        
 quotations within example blocks.                                             


                                                                               
                                 BOXES                                         

 The BOX and eBOX tags define the start and end of a text block that is        
 to be enclosed in a box.  They are used in the manner                         

      Text before box.                                                         
      :BOX                                                                     
      This text block is enclosed in a box.                                    
      The result has been ...                                                  
      :eBOX                                                                    
      Text after box.                                                          

 and result in the following:  Text before box.                                

 Ŀ        
 |                                                                    |        
 |  This text  block is  enclosed in  a box.    The result  has been  |        
 |  achieved through  the use of  the BOX  and eBOX tags.    You may  |        
 |  include within the  box any other GML tags that  do not generate  |        
 |  headings or  indicate the start or  end of a major  component of  |        
 |  the document.                                                     |        
 |                                                                    |        
         

 Text after box.                                                               


                                                                               
                            LIST STRUCTURES                                    

 Ordered Lists                                                                 

 In an ordered list, each item in the list is annotated in some fashion        
 -- with arabic numerals, with letters, or with roman numerals.  The OL        
 tag identifies the start of an ordered  list.   The start of each item        
 in the list is identified with the LI tag.  The eOL tag identifies the        
 end of the ordered list.  For example, the sequence                           
                                                                               

 page 28                               Waterloo SCRIPT GML User's Guide        
         


      :OL                                                                      
      :LI.This is the text for ordered list item 1.                            
      :LI.This is the text for ordered list item 2.                            
      This second sentence demonstrates the offset of                          
      subsequent lines of the list item.                                       
      :LI.This is the text for ordered list item 3.                            
      :eOL                                                                     

 produces the following result:                                                

 1.    This is the text for ordered list item 1.                               

 2.    This is the text for ordered list item 2.   This second sentence        
       demonstrates the offset of subsequent lines of the list item.           

 3.    This is the text for ordered list item 3.                               

    Ordered lists can be nested within ordered lists, as is demonstrat-        
 ed by the input sequence                                                      

      :OL                                                                      
      :LI.This is ordered list item 1, level 1.                                
      :LI.This is ordered list item 2, level 1.                                
      :OL                                                                      
      :LI.This is ordered list item 1, level 2.                                
      :eOL                                                                     
      :LI.This is ordered list item 3, level 1.                                
      :eOL                                                                     

 The maximum depth to which ordered lists  can be nested is six,  as is        
 demonstrated below.                                                           

 1.    This is ordered list item 1, level 1.                                   

       a.    This is ordered list item 1, level 2.                             

             i.    This is ordered list item 1, level 3.                       

                   1)    This is ordered list item 1, level 4.                 

                         a)    This is ordered list item 1, level 5.           

                               i)    This is ordered list item 1, level        
                                     6.                                        
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 29        
         


 Unordered Lists                                                               

 Unordered lists are formed in the same way as ordered lists;  the only        
 difference is the style of annotation of the list items.  The start of        
 an unordered list is  identified with the UL tag.   The  start of each        
 list item is identified with the LI tag.  The end of an unordered list        
 is identified with the  eUL tag.   Unordered lists can be  nested to a        
 depth of 6, as is demonstrated below.                                         

    This is unordered list item 1, level 1.                                   

        This is unordered list item 1, level 2.                               

         --  This is unordered list item 1, level 3.                           

             -   This is unordered list item 1, level 4.                       

                 -   This is unordered list item 1, level 5.                   

                     -   This is unordered list item 1, level 6.               


 Simple Lists                                                                  

 Simple lists are formed the same  as ordered and unordered lists;  the        
 only difference is that the list  items are not annotated.   The start        
 of a simple list is identified with the  SL tag.   The end of a simple        
 list is identified with the eSL tag.   Simple lists can be nested to a        
 depth of 6, as is demonstrated below.                                         

     This is simple list item 1, level 1.                                      

         This is simple list item 1, level 2.                                  

             This is simple list item 1, level 3.                              

                 This is simple list item 1, level 4.                          

                     This is simple list item 1, level 5.                      

                         This is simple list item 1, level 6.                  


 List Items with Headings                                                      

 As an alternative  to LI,  the LIHD  tag can also be  used to identify        
 items in an ordered, unordered, or simple list.  For example,                 

      :LIHD.List Item Heading                                                  

 The LIHD tag  functions in the same  fashion as LI with  the exception        
 that it treats the tagtext as a heading.  The tagtext should therefore        
                                                                               

 page 30                               Waterloo SCRIPT GML User's Guide        
         


 not end with any form of punctuation.  The text on the lines following        
 the LIHD tag  will become the body  of the list item.    The following        
 demonstrates the  effect of using  LIHD in  the six levels  of ordered        
 lists.                                                                        

 1.    LIST ITEM HEADING AT LEVEL 1                                            

       This is the text following the List Item Heading, and is format-        
       ted as the body of the list item.                                       

       a.    List Item Heading at Level 2                                      

             This is the text following the  List Item Heading,  and is        
             formatted as the body of the list item.                           

             i.    LIST ITEM HEADING AT LEVEL 3:  This is the text fol-        
                   lowing the List  Item Heading,  and is  formatted as        
                   the body of the list item.                                  

                   1)    List Item  Heading at Level  4:   This  is the        
                         text following the List  Item Heading,  and is        
                         formatted as the body of the list item.               

                         a)    List Item Heading at  Level 5:   This is        
                               the text  following the List  Item Head-        
                               ing, and is formatted as the body of the        
                               list item.                                      

                               i)    List  Item  Heading  at  Level  6:        
                                     This  is  the text  following  the        
                                     List Item Heading,  and is format-        
                                     ted as the body of the list item.         

    Note that you  can mix LI and LIHD  tags in the same  list,  as has        
 been done in the unordered list below:                                        

    This is a list item and looks just like the list items in the pre-        
     vious examples.                                                           

    LIST ITEM WITH HEADING                                                    

     This is the text following the List Item Heading, and is formatted        
     as the body of the list item.                                             

    And this is another list item without a heading.                          
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 31        
         


 Referring to List Items                                                       

 An identifier can be  assigned to a list item on the  LI or LIHD tags,        
 and then a reference can be generated later to a list item:                   

      :OL                                                                      
      :LI ID=one.List item one.                                                
      :LIHD ID=two.List item two.                                              
      :eOL                                                                     
      These are references to list items                                       
      :LIREF REFID=one                                                         
      and :LIREF REFID=two                                                     
      from the above list.                                                     

 produces:                                                                     

 1.    List item one.                                                          

 2.    LIST ITEM TWO.                                                          

 These are references  to list items "1. List item  one."  and "2. List        
 item two."  from the above list.                                             


 Definition Lists                                                              

 The start of a definition list is identified with the DL tag.  The end        
 of a definition list  is identified with the eDL tag.    The manner of        
 identifying  list items  for definition  lists is  different than  for        
 ordered, unordered, or simple lists.  Two GML tags must be used.  They        
 are of the form                                                               

      :DT.term                                                                 
      :DD.text of definition list item                                         

 The DT tag identifies the definition  term,  and the DD tag identifies        
 the definition description.                                                   

    You can have multiple DT tags per DD tag,  and multiple DD tags per        
 DT tag.   Definition lists can be nested to a depth of 6, as is demon-        
 strated below.                                                                

 term      This is definition list item 1, level 1.                            

           term one                                                            
           term two  This is definition list item 1,  level 2.   It has        
                     multiple terms for one definition.                        

                                                          

  Because of the  nature of the annotation styles for  items in simple        
   and unordered lists,  there seems to  be little point in referencing        
   their list items; it works, but seems pointless.                            
                                                                               

 page 32                               Waterloo SCRIPT GML User's Guide        
         


                     term      This is definition list item 1, level 3.        

                               It  has  multiple  definitions  for  one        
                               term.                                           

                               term      This is  definition list  item        
                                         1, level 4.                           

                                         term      This  is  definition        
                                                   list item  1,  level        
                                                   5.                          

                                                   term      This    is        
                                                             definition        
                                                             list  item        
                                                             1,   level        
                                                             6.                


 Definition Lists with Term and Description Headings                           

 The DTHD and  DDHD tags provide a means for  creating definition terms        
 and descriptions as headings.  For example, the input sequence                

      :DL                                                                      
      :DTHD.heading                                                            
      :DDHD.description heading                                                
      :DT.term                                                                 
      :DD.text of definition list item                                         
      :eDL                                                                     

 produces                                                                      

 heading   description heading                                                 

 term      text of definition list item                                        


 Glossary Lists                                                                

 Glossary lists  are defined in a  manner similar to  definition lists.        
 They are useful  when the term is  a phrase instead of  a single word.        
 The start of a glossary list is  identified with the GL tag.   The end        
 of a glossary list is identified with  the eGL tag.   Each item in the        
 list is defined in the fashion:                                               

      :GT.word or phrase                                                       
      :GD.text of glossary list item                                           

 Six levels of glossary lists are provided.  A glossary list appears as        
 follows on output.                                                            
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 33        
         


 This is a glossary term:  This is glossary description 1.  This second        
   sentence demonstrates the  offset of subsequent lines  of a glossary        
   description.                                                                

 This is another glossary term:  This is glossary description 2.   This        
   second sentence  demonstrates the  offset of  subsequent lines  of a        
   glossary description.                                                       


 Nesting Various Types of Lists                                                

 The various types of lists can be intermixed, as shown below.                 

 1.    This is ordered list item 1, level 1.  This sentence serves only        
       to pad out the block of text to demonstrate offsets.                    

 2.    This is ordered list item 2, level 1.                                   

       first     This is definition  item 1,  level 2.    This sentence        
                 pads the block to demonstrate offsets.                        

       second    This is definition item 2, level 2.                           

                    This is unordered list item 1, level 3.                   

                     glossary term 1:  level 4                                 

                    This is unordered list item 2, level 3.                   

                         This is simple list item 1, level 4.                  

       third     This is definition  item 3,  level 2.    This sentence        
                 serves only to pad out the block of text to illustrate        
                 offsets.                                                      

 3.    This is ordered list item 3, level 1.                                   

 We are now back to normal text outside the list structure.                    


 Interrupting the Items in a List -- the List Paragraph                        

 The LP tag indicates the start of a list paragraph that will interrupt        
 the items in  a list.   The text  of the list paragraph  will be posi-        
 tioned so  that it  appears at the  same level  of indentation  as the        
 annotation symbols for the list.  For example, the input sequence             

      :OL                                                                      
      :LI.This is the first list item.                                         
      :LP.This is the first line of the list paragraph.                        
      :LI.This is the second list item.                                        
      :eOL                                                                     
                                                                               

 page 34                               Waterloo SCRIPT GML User's Guide        
         


 produces the following result:                                                

 1.    This is the first list item.                                            

 This is the first line of the list paragraph.                                 

 2.    This is the second list item.                                           

 The LP tag can be used anywhere in any type of list structure.                


                                                                               
                           TABLES AND FIGURES                                  

 Tables and figures may be defined anywhere in your document.  If there        
 is room in the current output column,  the table or figure will appear        
 at exactly the position in which it was defined.   Otherwise,  it will        
 be promoted to the top of the next output column.                             


 Figures                                                                       

 The GML tags to define a figure are used as follows:                          

      Last text line of paragraph in which the                                 
      first reference to the figure is made.                                   
      :FIG                                                                     
      Text for body of figure.                                                 
      Each input line will appear as entered.                                  
      :FIGCAP.This is the Figure Caption                                       
      :FIGDESC.And this is the figure description,                             
      which is optional text providing additional                              
      descriptive information about the figure.                                
      <:eFIGDESC>                                                              
      :eFIG                                                                    

 The above input sequence produces the following ...  Last text line of        
 paragraph in which the first reference to the figure is made.                 


 Ŀ        
 |                                                                    |        
 |  Text for body of figure.                                          |        
 |  Each input line will appear as entered.                           |        
 |                                                                    |        
 |  Figure 1:  This is the Figure Caption.    And this is the figure  |        
 |             description,  which is optional  text providing addi-  |        
 |             tional descriptive information about the figure.       |        
 |                                                                    |        
         
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 35        
         


    The definition  of the  figure is  then followed  by an  input line        
 defining the start of the next paragraph, or a heading.                       


 Tables                                                                        

 The GML tags to define a table are used as follows:                           

      Last text line of paragraph in which the                                 
      first reference to the table is made.                                    
      :TAB                                                                     
      :TABCAP.This is the Table Caption                                        
      :TABDESC.And this is the table description,                              
      which is optional text providing additional                              
      descriptive information about the table.                                 
      :eTABDESC                                                                
      Text for body of table.                                                  
      Each input line will appear as entered.                                  
      :eTAB                                                                    

 This is text that comes before the table,  just to show how formatting        
 is currently being handled.                                                   


 Ŀ        
 |                                                                    |        
 |                Table 1:  This is the Table Caption                 |        
 |                                                                    |        
 |  And this is the table description,   which is optional text pro-  |        
 |  viding additional descriptive information about the table.  Note  |        
 |  that the table description, if present,  MUST be terminated with  |        
 |  the eTABDESC tag!                                                 |        
 |                                                                    |        
 |  This is the body of the table.                                    |        
 |  Each input line will appear as entered.                           |        
 |                                                                    |        
         


    This is the first line of the  next paragraph,  to show that we are        
 back to the normal formatting environment.                                    


 Defining the Body of a Table or Figure                                        

 The body of a table or figure  may consist of textual information,  or        
 blank lines  (if the body  is to be pasted  in after the  document has        
 been printed), or both.                                                       
                                                                               

 page 36                               Waterloo SCRIPT GML User's Guide        
         


 Pasted-In Material:  Both the FIG and TAB tags have a DEPTH attribute.        
 This allows you  to specify the number  of blank lines that  are to be        
 generated as the body of the table or figure.  For example, specifying        

      :FIG DEPTH=36                                                            
      :FIGCAP.Figure Caption                                                   
      :eFIG                                                                    

 will cause 36 blank lines to be generated as the body of this particu-        
 lar figure.                                                                   

 Textual Material:    Lines of text that  occur after the FIG  tag (for        
 figures) and the TABCAP and eTABDESC tags (for tables), will be output        
 in a one-line-in/one-line-out fashion.                                        

 Textual and Pasted-In Material:   You  can specify the DEPTH attribute        
 and also provide text.  For a figure, the blank lines will be generat-        
 ed before the  text;  for a table,   they will be generated  after the        
 text.                                                                         


 Referencing Tables and Figures                                                

 The tags and text  that define a table or figure  should be positioned        
 at the end of the paragraph that first references the table or figure.        
 In some cases,  you  may wish to refer to that table  or figure by its        
 number, before or after the tags and text that define it.   The FIGREF        
 and TABREF tags are provided for  this purpose.  If tagtext is speci-        
 fied with these tags, it will be treated as continued text.                   

    For example,  assume that you must now make your first reference to        
 a particular table,  before you have defined the table.   At the point        
 where you wish  to reference it,  use  the TABREF tag to  assign it an        
 identifier:                                                                   

      As is illustrated in                                                     
      :TABREF REFID=example.,                                                  
      the rest of the sentence ...                                             

 Identifiers can be a maximum of 7 characters long.   The name that you        
 chose for a table or figure identifier must be unique (you cannot have        
 two figures with the same identifier,  but you can have a figure and a        
 table with the  same identifier).   The above  input sequence produces        
 the following result:   As is illustrated in  Table 2 on page 37,  the        
 rest of the sentence ...                                                      

    Then,  at the end of the  paragraph in which that sentence appears,        
 use the ID attribute of the TAB tag:                                          

                                                          

  For forward references when the  document is SCRIPTed in single-pass        
   mode, these tags pre-generate the figure or table number.                   
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 37        
         


      :TAB ID=example                                                          
      :TABCAP.The Table Caption                                                
      body of table                                                            
      :eTAB                                                                    

 The table that the above defines appears below.                               


 Ŀ        
 |                                                                    |        
 |                    Table 2:  The Table Caption                     |        
 |                                                                    |        
 |  body of table                                                     |        
 |                                                                    |        
         


 Forward Out-of-Sequence References                                            

 Using the REFID= attribute of FIGREF  and TABREF and the ID= attribute        
 of FIG and  TAB results in tables  and figures that will  each be num-        
 bered in  the order  in which  their identifiers  occur in  the input.        
 However,  those  numbers will be incorrect  if you are  making out-of-        
 sequence forward references  to some tables or figures  (that is,  you        
 reference the second table and then reference the first table and then        
 define the first table and then define the second table).  Two special        
 tags, TABID and FIGID,  allow you to pre-generate the table and figure        
 reference values, at the beginning of your document, so that the iden-        
 tifiers will already  have values when they are  encountered as attri-        
 butes of the FIGREF, TABREF, FIG, or TAB tags.  For example,                  

      :TABID REFID=dog                                                         
      :TABID REFID=cat                                                         

 will assign successive values to the identifiers.  Thereafter, you can        
 make out-of-sequence references to these two tables.                          

    Once you have  associated an identifier with a table,   you can use        
 the TABREF tag to make other references to it,  anywhere thereafter in        
 your document.                                                                


 Referencing a List or Range of Figures or Tables                              

 The  REFID attribute  can be  specified  in a  list-notation and/or  a        
 range-notation form, as well; for example,                                    

      :FIGREF REFID='one two three'                                            
      :FIGREF REFID='one-two'                                                  
      :FIGREF REFID='one two-three four'                                       
                                                                               

 page 38                               Waterloo SCRIPT GML User's Guide        
         


 The first is a list of three items that will be of the form "Figure 1,        
 Figure 2, and Figure 3".  The second is a range of two items that will        
 be of the form  "Figure 1 to Figure 2".   The third is  a list of four        
 items that will be of the form "Figure  1,  Figure 2 to Figure 3,  and        
 Figure 4".   Each reference  that is to a Figure on  a page other than        
 the current page will be followed by  the words "on page" and the page        
 number.                                                                       


                                                                               
                                FORMULAE                                       

 The Waterloo  SCRIPT implementation of GML  provides two sets  of tags        
 for encoding  mathematical,  scientific,  and engineering  notation in        
 either an in-line (F/eF) or display-mode (DF/eDF) block.   The details        
 of the  encoding language  are described  in the  publication Waterloo        
 SCRIPT with Formula Processing, and will not be described here.               


 In-Line Formula                                                               

 As its name implies,  an in-line formula will be treated just like the        
 rest of the text in a paragraph,  rather than being set apart like the        
 result of an XMP/eXMP block.                                                  

      The equation for a straight line can be                                  
      represented by :F.y = a x + b:eF..                                       


 Display-Mode Formula                                                          

 If the  in-line formula above were  desired in display mode  (that is,        
 set apart from the rest of the text), then the input sequence becomes:        

      The equation for a straight line can be represented by:                  
      :DF                                                                      
      y = a x + b                                                              
      :eDF                                                                     


 Numbering a Display-Mode Formula                                              

 Any display-mode formula  that is defined with the  ID= attribute will        
 be numbered.  For example,                                                    

      :DF ID=line                                                              
      y = a x + b                                                              
      :eDF                                                                     
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 39        
         


 Referring to a Numbered Display-Mode Formula                                  

 The DFREF tag generates a reference to a display-mode formula that has        
 been defined with an ID= attribute.  For example,                             

      The equation for a straight line                                         
      is given in :DFREF REFID=line. above.                                    


                                                                               
                         PROCESS-SPECIFIC CODE                                 

 It is sometimes desirable to include in a document's input file infor-        
 mation whose  appearance in the resulting  output is dependent  on the        
 output device for which the document is being processed.                      

      :PSC PROC='device1 device2 ... deviceN'                                  
      process-specific code block                                              
      :ePSC                                                                    

 For example,  a block  to be processed only if the  output device is a        
 line printer,   an IBM 3820 (or  3812),  or a PostScript  device would        
 appear as:                                                                    

      :PSC PROC='PRINT I3820 POSTS'                                            
      contents of block                                                        
      :ePSC                                                                    

 If the output device for which the  document is being processed is not        
 one of those specified in the PROC= list (or if no PROC= list is spec-        
 ified), the contents of the block will not be processed.                      


                                                                               
                     TAGS FOR CONSTRUCTING INDEXES                             

 Index terms are created throughout the  document by using the I1,  I2,        
 I3, and IREF tags, and the resulting index is printed in the back mat-        
 ter by using the INDEX tag.                                                   

    The IX  attribute of these  tags enables you  to create up  to nine        
 indexes for a document.   When any of the tags are used without the IX        
 attribute, index number 1 is assumed.                                         


 Index Terms and Page References                                               

 An index consists of some number of  index terms,  each of which has a        
 corresponding list of one or more  page references to the locations in        
 the document  where that information  is discussed.   In  the simplest        
 case,  a page reference will be the  number of the page that was being        
 produced at the time the index term was added to the index.                   
                                                                               

 page 40                               Waterloo SCRIPT GML User's Guide        
         


    Three levels  of index  terms can  be created.    When an  index is        
 printed, the index terms appear in alphabetical order, by level.   For        
 example,                                                                      

      level-one term ... list of page references                               
         level-two term ... list of page references                            
            level-three term ... list of page references                       
      next level-one term ... list of page references                          


 The Index-Term Tags                                                           

 The index term  specified with the I1 tag  is added to the  index as a        
 level-one index term,  and the current  page number in the document is        
 added to its list of page references.  When an index term is specified        
 with the I2 tag,  that term is added  to the index as a level-two term        
 under the  most-recently-specified level-one index  term.   Similarly,        
 the I3 tag  adds its index term  as a level-three term  under the most        
 recent level-one and level-two index terms.                                   


 An Example                                                                    

 The following example demonstrates the use of the I1, I2,  and I3 tags        
 to add  several index terms  to the index  for a document  about house        
 pets.  Each line shown as "(text on page ..)" represents the number of        
 the page  that was  being produced at  the time the  tag below  it was        
 encountered.                                                                  

      (text on page 10)                                                        
      :I1.cats                                                                 
      (text on page 34)                                                        
      :I2.proper care                                                          
      (text on page 42)                                                        
      :I3.life span                                                            

 If  these were  the only  index terms  created in  the document,   the        
 resulting index, when printed, would appear as follows:                       

      cats ... 10                                                              
         proper care ... 34                                                    
            life span ... 42                                                   


 Index-Term Identifiers                                                        

 The ID attribute  enables you to assign an index-identifier  name to a        
 particular  index term.    This makes  it considerably  easier to  add        
 lower-level index terms without having  to re-specify the higher-level        
 tag again.   For example,  we can  extend the previous example as fol-        
 lows:                                                                         
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 41        
         


      (text on page 57)                                                        
      :I3 ID=groom.grooming                                                    

    The ID attribute assigns an identifier to the resulting index term.        
 If used  with I2  or I3,  this  identifier also  refers to  this index        
 term's higher-level terms.   The use of ID above defines "groom" as an        
 identifier that can  thereafter be used as a REFID  or SEEID attribute        
 to refer to the three-level index term "cats, proper care,  grooming".        
 If used  as the REFID  attribute of a subsequent  I2 or I3  tags,  the        
 index term  of that  tag will  be added  under the  higher-level index        
 term(s)   named by  identifier "groom",   instead of  under the  most-        
 recently-specified term.                                                      


 Special Page References                                                       

 The PG and SEE attributes apply to  the manner in which information is        
 added to the list of page references  for an index term.   If MAJOR is        
 specified for the  PG attribute,  the current page number  is added at        
 the front of the list of page references.  With the SEE attribute, the        
 value specified  is added  to the list  of page  references as  a "see        
 item", instead of the current page number.                                    

      (text on page 82)                                                        
      :I3 PG=MAJOR.grooming                                                    
      :I3 SEE=diet.grooming                                                    

    The  SEEID attribute  enables you  to specify  an identifier  whose        
 index term(s)  will  be generated as the "see"  reference,  instead of        
 specifying the "see" reference as the text of the SEE attribute.              


 Repeating an Index Term                                                       

 The IREF tag  specifies that another occurrence of an  index term that        
 already exists is to be added to the index.  It is used in the form           

      :IREF REFID=identifier                                                   

 The current page number  will be added to the list  of page references        
 for the index term(s)  associated  with the specified identifier name.        
 For example,                                                                  

      (text on page 94)                                                        
      :IREF REFID=groom                                                        

 would cause the number  94 to be added to the  list of page references        
 for "cats, proper care, grooming" of the identifier "groom".                  
                                                                               

 page 42                               Waterloo SCRIPT GML User's Guide        
         


 The Index-Header Tags                                                         

 The IH1,  IH2,  and IH3 tags function in a manner identical to the I1,        
 I2,  and I3 tags with the exception that no page reference is added to        
 the index term that they add to the index.                                    


 Printing the Resulting Index in the Back Matter                               

 The INDEX tag is used in the back  matter to cause the printing of the        
 index terms and  page references.   For example,  all  of the examples        
 presented above,  plus  the INDEX tag,  would appear  in the following        
 sequence:                                                                     

      (text on page 10)                                                        
      :I1.cats                                                                 
      (text on page 34)                                                        
      :I2.proper care                                                          
      (text on page 42)                                                        
      :I3.life span                                                            
      (text on page 57)                                                        
      :I3 ID=groom.grooming                                                    
      (text on page 64)                                                        
      :I3.diet                                                                 
      (text on page 82)                                                        
      :I3 PG=MAJOR.grooming                                                    
      :I3 SEE=diet.grooming                                                    
      (text on page 94)                                                        
      :IREF REFID=groom                                                        
        ... rest of body ...                                                   
      :eBODY                                                                   
      :BACKM                                                                   
      :INDEX<.Heading Text>                                                    

 If no tagtext is specified,  the  heading will be "Index".   The index        
 terms and page references will appear below the heading, as:                  

      cats ... 10                                                              
        proper care ... 34                                                     
          diet ... 64                                                          
          grooming ... 82, 57, see "diet", 94                                  
          life span ... 42                                                     


 Multiple Indexes                                                              

 Each of the tags described above accepts an IX attribute,  whose value        
 must be an integer between 1 and 9.   This allows you to specify index        
 items for up to 9 separate indexes.  If the IX attribute is not speci-        
 fied, the tag applies to index number 1.   For example,  in a document        
 that required  one index for authors  and another index  for subjects,        
 the index tags might be used as shown below:                                  
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 43        
         


      :I1 IX=1.Ima N. Author                                                   
      :I1 IX=2.index term for subject index                                    
           ...                                                                 
      :BACKM                                                                   
      :INDEX IX=1.Index of Authors                                             
      :INDEX IX=2.Subject Index                                                
                                                                               

 page 44                               Waterloo SCRIPT GML User's Guide        
         
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 45        
         


                               Appendix A                                      

                    LAYOUTS FOR THE STANDARD TAGSET                            


                                                                               
 The layout of the document,  when processed by SCRIPT,  will depend on        
 the particular GML layout file that you have selected.                        


 Major Features of the Standard-Tagset Layouts                                 

 The layouts are described below,  and  their major features are summa-        
 rized in the accompanying table.                                              

    Note:  A small test file is provided that demonstrates the style of        
 headings and other document components that differ from layout to lay-        
 out.   If you want to see precisely what a particular layout produces,        
 then SCRIPT  the GMLTEST file by  specifying the desired  layout;  for        
 example,                                                                      

      SCript GMLTEST (LAYout GMLPAPER                                          

 This will produce between 2 and 12  pages of output,  depending on the        
 layout selected.                                                              


 Miscellaneous Layouts                                                         

 GMLgdoc:   This layout has a very small part-page title page;  some of        
 the titlepage tags are ignored.                                               

 GMLfoils:   GMLfoils is a layout for producing foils.   It accepts all        
 the tags of the standard-tagset layouts,  and produces output suitable        
 for use as foils.  A level-zero heading defines the start of a related        
 set of foils.   A  level-one heading defines the start of  a new foil.        
 For foils,  the text passages will  usually consist of list structures        
 rather than paragraphs.                                                       

    If the document  is processed for a  SCRIPT-supported output device        
 that has multiple fonts and pointsizes,  a larger-than-usual pointsize        
 with fewer-than-usual lines per page will  be used,  to make the foils        
 easier for the audience to  read during the presentation.   Therefore,        
 GMLfoils can also be used to process a complete document that has been        
 encoded in the standard  tagset,  such as a paper,  to  produce a copy        
 that will be easier  for the speaker to refer to  during the presenta-        
 tion.                                                                         

 GMLsdoc:  A layout for small simple documents; useful if your document        
 consists of  only a few  pages of text and  a few headings.    Only H0        
 causes the start of a new page.                                               
                                                                               

 page 46                               Waterloo SCRIPT GML User's Guide        
         


 Ŀ        
 |                                                                    |        
 |      Table 3:  Major Features of the Standard-Tagset Layouts       |        
 |                                                                    |        
 |  With the exception  of layouts bearing the name  of a particular  |        
 |  publishing body, all of the basic document component tags result  |        
 |  in the same style of output for all layouts.                      |        
 |                                                                    |        
 |  feature:                                                          |        
 |  1=full or part title page (f,p)                                   |        
 |  2=creates tables of contents (y,n)                                |        
 |  3=level to which body headings start at page top (n=none)         |        
 |  4=level to which headings in body are numbered (n=none)           |        
 |  5=single or double spaced text (s,d)                              |        
 |  6=text columns per page                                           |        
 |  7=title used as running heading/footing (y,n)                     |        
 |                                                                    |        
 |                                               1  2  3  4  5  6  7  |        
 |                                                                    |        
 |  miscellaneous:                                                    |        
 |    GMLgdoc  . . . . . . . . . . . . . . . .   p  y  0  0  s  1  y  |        
 |    GMLfoils . . . . . . . . . . . . . . . .   f  n  1  n  d  1  n  |        
 |    GMLsdoc  . . . . . . . . . . . . . . . .   p  n  0  0  s  1  n  |        
 |    GMLresum . . . . . . . . . . . . . . . .   p  n  n  n  s  1  y  |        
 |                                                                    |        
 |  manuals and reports:                                              |        
 |    GMLguide . . . . . . . . . . . . . . . .   f  y  0  0  s  1  y  |        
 |    GMLman   . . . . . . . . . . . . . . . .   f  y  1  4  s  1  n  |        
 |    GMLrefg  . . . . . . . . . . . . . . . .   f  y  1  6  s  1  y  |        
 |    GMLss    . . . . . . . . . . . . . . . .   f  y  1  0  s  1  y  |        
 |    GMLworkt . . . . . . . . . . . . . . . .   f  y  1  4  d  1  n  |        
 |    GMLuwcpc . . . . . . . . . . . . . . . .   f  y  1  0  s  1  n  |        
 |                                                                    |        
 |  papers:                                                           |        
 |    GMLpaper . . . . . . . . . . . . . . . .   p  n  0  0  s  1  y  |        
 |    GMLaipj  . . . . . . . . . . . . . . . .   p  n  0  4  d  1  n  |        
 |    GMLapaj  . . . . . . . . . . . . . . . .   f  n  1  0  d  1  y  |        
 |    GMLieee  . . . . . . . . . . . . . . . .   p  n  n  0  s  2  n  |        
 |    GMLmwcs  . . . . . . . . . . . . . . . .   p  n  n  0  s  2  n  |        
 |    GMLnhcrc . . . . . . . . . . . . . . . .   p  n  n  0  s  1  y  |        
 |                                                                    |        
 |  theses:                                                           |        
 |    GMLthesi . . . . . . . . . . . . . . . .   f  y  1  4  d  1  n  |        
 |    GMLapa   . . . . . . . . . . . . . . . .   f  y  1  0  d  1  n  |        
 |    GMLmla   . . . . . . . . . . . . . . . .   f  y  1  4  d  1  n  |        
 |                                                                    |        
         


 GMLresum:  A layout suitable for a resume.                                    
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 47        
         


 Manuals and Reports                                                           

 GMLguide:   Like GMLgdoc,  with the  exceptions that a full-page title        
 page is produced  and all front-material and  back-material components        
 start at  the top of  an output page.    You might consider  using the        
 GMLguide layout if you  do not know that another layout  is more suit-        
 able.                                                                         

 GMLman:   Each  level-zero heading  is named  "Part" and  is numbered.        
 Each level-one heading  is named "Chapter" and  is numbered.   Heading        
 levels two through four are numbered using the Dewey-decimal numbering        
 system.                                                                       

 GMLrefg:   Intended for reference documents.   Heading levels are num-        
 bered and each heading level and text is indented successively.  TITLE        
 and H1 heading text is used as running  titles on the tops of all pag-        
 es.                                                                           

 GMLss:   A layout in the style of  the DSMPROF3 layout provided by the        
 IBM Document Composition Facility (DCF)  [2]  for its Starter Set tag-        
 set.                                                                          

 GMLworkt:  A layout for the University of Waterloo co-op student Work-        
 Term Report [11].  This layout is not yet complete.                           

 GMLuwcpc:  A layout for the University of Waterloo Correspondence Pro-        
 gram "course/lecture/page"  grid sheets.   The  SEC= attribute  of the        
 GDOC tag must be used to specify the course code,  and the H1 tag must        
 be used to indicate the start of each lecture.  Do not use the H0 tag.        


 Layouts for Papers                                                            

 GMLpaper:    A general-purpose  layout for  papers.   TITLEP  material        
 appears as a  part title page at  the beginning of the  first page and        
 TOC,  FIGLIST,  and TABLIST are not  produced even if specified in the        
 input.                                                                        

 GMLaipj:   For papers submitted to  journals published by the American        
 Institute of Physics and its member societies [1].  This layout is not        
 yet completely accurate in its output; the heading styles are correct,        
 but the placement of components such  as footnotes and figure captions        
 in the output are not yet proper;   this will be corrected in a future        
 version.                                                                      

 GMLapaj:   A layout for papers being submitted to the American Psycho-        
 logical Association [6].    (See the description of the SET  tag for a        
 description of the HEADLEVEL item that specifies the number of heading        
 levels in the document.)                                                      
                                                                               

 page 48                               Waterloo SCRIPT GML User's Guide        
         


 GMLieee:   The general IEEE two-column layout,  for papers that are to        
 be produced  on the U-44  grid sheets  provided by the  IEEE Editorial        
 Department [4].  If the paper requires the reserved area at the bottom        
 of the first  column of the first  page,  imbed the GMLieee  layout by        
 specifying                                                                    

      .im GMLieee reserve=yes                                                  

 GMLmwcs:   A GMLieee-like layout for use with the grid sheets provided        
 by McGregor and Werner Conference Services [5].                               

 GMLnhcrc:   A layout for papers in the style of the North-Holland Pub-        
 lishing Company's Camera-Ready-Copy Department.                               


 Layouts for Theses                                                            

 GMLthesi:  A layout in the style suggested by the University of Water-        
 loo for theses [10].   GMLthesi produces output that is almost identi-        
 cal to  that of  GMLman.   Level-one  heading numbers  are printed  as        
 uppercase roman numerals instead of as arabic numerals.                       

 GMLapa:   A thesis  layout in the style of  the American Psychological        
 Association [6].   (See the description of  the SET tag for a descrip-        
 tion of the HEADLEVEL item that specifies the number of heading levels        
 in the document.)                                                             

 GMLmla:   Produces output like that  of GMLthesi,  with the exceptions        
 that the layout of footnotes, new paragraphs,  and long quotations are        
 in the style  preferred by the Modern Language  Association of America        
 [3].                                                                          


 Additional Tags for the Front Material of a Thesis                            

 The following tags exist ONLY for use  with layouts in the thesis cat-        
 egory.                                                                        

 THESIS:  If the document is being submitted as a thesis in fulfillment        
 of degree requirements, the THESIS tag should appear immediately after        
 the AUTHOR tag (or after the eADDRESS  tag,  if ADDRESS and ALINE have        
 been used).  It is of the form                                                

      :THESIS.Name of Degree, in full                                          

 and should be followed on the next input  line by the name of the dis-        
 cipline in  which the degree is  being granted.   For example,   for a        
 Bachelor of Thesis Writing in  the discipline of Document Composition,        
 you would specify                                                             

      :THESIS.Bachelor of Thesis Writing                                       
      Document Composition                                                     
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 49        
         


 COURSE:   For a  document being submitted as  an essay or paper  for a        
 specific course, use the COURSE tag instead of the THESIS tag:                

      :COURSE.course code, Title of Course                                     

 followed on the next input line(s) by any additional relevant informa-        
 tion you must supply about the course.                                        

 DECLARE:   Most theses  must have an author's  declaration page.   The        
 DECLARE tag will generate such a  page,  with the appropriate words on        
 it.                                                                           

 BORROW:  Most theses must have a borrowers' page.  The BORROW tag will        
 generate this page, with the appropriate words on it.                         
                                                                               

 page 50                               Waterloo SCRIPT GML User's Guide        
         


                               Appendix B                                      

                  LAYOUTS FOR THE NON-STANDARD TAGSETS                         


                                                                               
 Most of  the layouts described  below do not  support all of  the tags        
 supported by the standard tagset,  and  most of them have special tags        
 that are not supported by the standard tagset.  In the examples, items        
 enclosed in <>s represent optional specifications;  the <>s themselves        
 should never be specified.                                                    


 GMLgroup                                                                      

 GMLgroup is a layout for producing a single document that is a collec-        
 tion of other documents,   each of which is in itself  a complete GML-        
 encoded document using the standard tagset (such as a paper, for exam-        
 ple).    You  may  find  GMLgroup   useful  for  producing  a  journal        
 publication, the proceedings of a conference,  etc.   It is not neces-        
 sary to  make any modifications  to the individual  documents;  simply        
 INCLUDE them "as  is",  between two special tags  BODYGROUP and eBODY-        
 GROUP, as shown below.                                                        

      .im GMLgroup                                                             
      :GDOC                                                                    
      :FRONTM                                                                  
      :TITLEP                                                                  
      :TITLE.heading text                                                      
      <other tags for the title page>                                          
      :eTITLEP                                                                 
      <:ABSTRACT>                                                              
      <:PREFACE.heading text>                                                  
      <text followed by AUTHOR and ADDRESS/ALINE/eADDRESS>                     
      <:TOC>                                                                   
      :eFRONTM                                                                 
      :BODYGROUP                                                               
      :INCLUDE FILE=document1                                                  
      :INCLUDE FILE=document2                                                  
           etc                                                                 
      :eBODYGROUP                                                              
      <tags and text for APPENDIX and BACKM, if any>                           
      :eGDOC                                                                   


 GMLlet                                                                        

 GMLlet is a layout for business letters; it is used as shown below.           

      .im GMLlet                                                               
      :GDOC                                                                    
      :DATE< ALIGN=margin DEPTH=n><.date substitute>                           
      <:DOCNUM.document number>                                                
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 51        
         


      :TO< DEPTH=n>.Name of Recipient                                          
      First Line of Recipient's Address                                        
               ...                                                             
      Last Line of Recipient's Address                                         
      <:ATTN< DEPTH=n>.Attention Name>                                         
      <:SUBJECT< DEPTH=n>.Heading Text>                                        
      :OPEN< DEPTH=n>.Opening Salutation                                       
      tags and text comprising body of letter                                  
      :CLOSE< DEPTH=n>.Closing salutation                                      
      Author's Name                                                            
      Author's title and/or                                                    
      Author's address, etc                                                    
      :eCLOSE<.ABC/xyz>                                                        
      :eGDOC                                                                   

    GMLlet is designed  for the University of  Waterloo's standard let-        
 terhead paper.  With other letterheads, it may be necessary to specify        
 the DEPTH= attribute of the DATE tag in order to control the number of        
 lines that should  be left blank at the  top of the page  (to get past        
 the pre-printed letterhead);   otherwise,  DATE will behave  as though        
 DEPTH=15 had been specified.                                                  

    If the ALIGN= attribute of the DATE  tag is omitted,  the date will        
 be aligned  to the right margin  and the contents of  the CLOSE/eCLOSE        
 block  will  be  aligned  to the  middle  of  the  page.    Specifying        
 ALIGN=LEFT causes both  of these to be  aligned to the left  margin of        
 the page.   Specifying ALIGN=RIGHT causes both  of these to be aligned        
 to the right margin of the page.                                              

    If the letter is  being addressed to a company instead  of an indi-        
 vidual, the TO tag should be specified as                                     

      :TO.Company Name                                                         

 and the ATTN  tag may be used  to specify the text  for an "Attention"        
 line, so that a specific individual may be indicated.                         

    The DEPTH= attribute may be specified with the CLOSE tag to control        
 the number of lines left blank for the author's signature.  If a DEPTH        
 value is omitted,  CLOSE will behave as though DEPTH=6 had been speci-        
 fied.                                                                         

    The DEPTH= attributes shown for the  other tags above may be speci-        
 fied to alter the default number  of blank lines produced before those        
 blocks of text, in situations where precise control over the position-        
 ing of those blocks of text must be achieved.                                 

    The author's (ABC) and text-entry operator's (xyz)  initials may be        
 specified as tagtext with the eCLOSE tag.                                     

    If the letter  is to include lists of copies  distributed to others        
 and/or additional materials enclosed,  the following tags and text are        
 specified on lines following the eCLOSE tag:                                  
                                                                               

 page 52                               Waterloo SCRIPT GML User's Guide        
         


      :DISTRIB                                                                 
      :DIST.copies                                                             
      Recipients' names, one per line                                          
      :DIST.enclosures                                                         
      items included, one per line                                             
      :eDISTRIB                                                                

 The DIST tag may be used to identify additional items, as well.               

    Note:  For personal business letters, the address of the author may        
 be specified by placing the following lines                                   

      :FROM                                                                    
      first address line                                                       
         ...                                                                   
      last address line                                                        

 before the :DATE tag.   The address lines will be right-aligned at the        
 top of the page, in place of a pre-printed letterhead.                        


 GMLmemo                                                                       

 GMLmemo is a layout for memos.  It is used as follows:                        

      .im GMLmemo                                                              
      :GDOC                                                                    
      :DATE< ALIGN=margin><.date substitute>                                   
      :DISTRIB <COLUMNS=n TSIZE=n>                                             
      :DIST.To                                                                 
      list of intended recipients, one per line                                
      :DIST.From                                                               
      name of originator(s), one per line                                      
      :DIST.Copies                                                             
      list of additional recipients, one per line                              
      :eDISTRIB                                                                
      :SUBJECT< MODE=BLOCK NAME='subject'>.Heading Text                        
      <additional heading text, if BLOCK mode>                                 
      :eSUBJECT                                                                
      tags and text for memo                                                   
      :eGDOC                                                                   

 The DATE tag  is required (for a description of  the ALIGN= attribute,        
 see GMLlet).   The SUBJECT tag is required, but the tagtext is option-        
 al.   If the tagtext is too long for a single input line, then specify        
 the MODE=BLOCK attribute;  any additional  text lines will become part        
 of the tagtext, until the eSUBJECT tag.                                       

    In the output document,  the SUBJECT tagtext will be annotated with        
 the word  "Subject".   If some other  word is desired,  use  the NAME=        
 attribute to specify it.                                                      
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 53        
         


    The DISTRIB  and eDISTRIB tags  identify the  start and end  of the        
 distribution list.    The people to  whom the  memo is being  sent are        
 listed one per line after the                                                 

      :DIST.To                                                                 

 The DIST tag  may be used as  many times as is  required to categorize        
 the distribution list.   The tagtext must be  a single word that is to        
 be used  as the category label.    Each component of  the distribution        
 list will be printed in two-column format on output.  If you want one-        
 column format instead, specify the DISTRIB tag as                             

      :DISTRIB COLUMNS=1                                                       

 The TSIZE= attribute can be used to override the size of the window in        
 which the tagtext is to be printed.                                           

    You can specify the COLUMNS= attribute on the DIST tag, to obtain a        
 different format for that DIST than was specified with (or assumed by)        
 the DISTRIB tag.   A DEPTH= attribute also exists for the DIST tag, so        
 that you can  override the default of  one line of white  space before        
 the start of that list item.                                                  

    The material from DISTRIB through the tags and text for memo may be        
 preceded by the FRONTM tag and followed by the eFRONTM tag, and/or may        
 be followed by the BODY tag and as many of the body-related and basic-        
 component GML tags as are required.                                           

    A memo does not usually have a formal closure.   However, if one is        
 required,  you can create it by  including the following tags and text        
 lines at whatever location is appropriate:                                    

      :CLOSE<.ABC/xyz>                                                         
      name of author                                                           
      etc                                                                      
      :eCLOSE                                                                  

 where ABC and xyz are the author's and text-entry operator's initials,        
 respectively.                                                                 


 GMLmins                                                                       

 GMLmins is a  layout for minutes of  meetings.   It is intended  to be        
 used as follows:                                                              

      .im GMLmins                                                              
      :GDOC                                                                    
      :TITLE.Name of Corporation                                               
      :TITLE.(repeat as many times as necessary)                               
      :TITLE.Name of Group holding meeting                                     
      :DATE.date of meeting                                                    
      :DISTRIB <COLUMNS=n TSIZE=n>                                             
                                                                               

 page 54                               Waterloo SCRIPT GML User's Guide        
         


      :DIST.Present                                                            
      voting individuals, one per line                                         
      :DIST                                                                    
      non-voting individuals, one per line                                     
      :DIST.Absent                                                             
      individuals absent, one per line                                         
      :DIST.Copies                                                             
      additional individuals,one per line                                     
      :eDISTRIB                                                                
      :BODY                                                                    
      :OL                                                                      
      :LIHD.Approval of Minutes                                                
      Details of discussion, etc.                                              
      :LIHD.Business Arising from the Minutes                                  
      Details of items, discussion, etc.                                       
      :LIHD.Next Item of Business                                              
      Details of discussion, etc.                                              
      :LIHD.(and so on ...)                                                    
      :LIHD.Next Meeting                                                       
      Date/time/location of next meeting.                                      
      :eOL                                                                     
      The meeting adjourned at (time).                                         
      :CLOSE< DEPTH=n>                                                         
      :TYPIST.ABC/xyz                                                          
      :RECORDER.Name of Secretary                                              
      Secretary's Title                                                        
      etc                                                                      
      :eCLOSE                                                                  
      :eGDOC                                                                   

 The TITLE tag is used as many times as necessary to precisely identify        
 the corporate organizational  structure.   The last occurrence  of the        
 TITLE tag  identifies the group  or committee or  other organizational        
 unit holding the meeting;  the name of this group will also be used as        
 a top-of-page running title on the second and subsequent pages of out-        
 put, together with the date of the meeting.                                   

    The DISTRIB  and eDISTRIB tags  identify the  start and end  of the        
 distribution list.    The voting  members present  at the  meeting are        
 listed one per line after the                                                 

      :DIST.Present                                                            

 The DIST tag  may be used as  many times as is  required to categorize        
 the distribution list.   The tagtext may be omitted,  as was done with        
 the list of non-voting individuals present above,  or it may be a sin-        
 gle word that is to be used as the category label.                            

    Each component  of the  distribution list will  be printed  in two-        
 column format on output.  If you want one-column format instead, spec-        
 ify the DISTRIB tag as                                                        

      :DISTRIB COLUMNS=1                                                       
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 55        
         


 The TSIZE= attribute can be used to override the size of the window in        
 which the tagtext is to be printed.                                           

    You can specify the COLUMNS= attribute on the DIST tag, to obtain a        
 different format for that DIST than was specified with (or assumed by)        
 the DISTRIB tag.   A DEPTH= attribute also exists for the DIST tag, so        
 that you can  override the default of  one line of white  space before        
 the start of that list item.                                                  

    Any lines  of text that appear  between the eDISTRIB and  BODY tags        
 will appear  in the  document exactly  as entered  in the  input file.        
 This enables you to add appropriate  footnote-like comments at the end        
 of the distribution list.                                                     

    The items  discussed at the meeting  are constructed as  an ordered        
 list.   In the example shown above,   each item is identified with the        
 LIHD tag.   Whether you  use LIHD or LI tags depends  on the style you        
 wish to achieve.   Items that must  be subdivided should be identified        
 with additional levels of ordered lists.   The ordered-list-item anno-        
 tation style  provided by the  GMLmins layout is  the one used  by the        
 University of Waterloo's Office of  the University Secretary.   If you        
 require something  different,  see the discussion  of the SET  tag for        
 controlling the annotation style of ordered lists.                            

    Note:   It is not essential that  you use ordered lists to identify        
 the  meeting items.    If you  choose  to use  the heading-level  tags        
 instead of lists,  the headings will be produced in a style and layout        
 identical to that used by the GMLgdoc layout for headings.                    

    The text of a motion introduced at the meeting should be encoded as        
 a long quotation, by using the LQ and eLQ tags.                               

    The CLOSE tag indicates the start  of the signature block.   If the        
 DEPTH= attribute is not specified,  6  lines will be left blank before        
 the start of the signature block.   The ABC/xyz initials of the typist        
 and the secretary will appear in the document on the left-hand side of        
 the page,  with  today's date below that.   The Name  of Secretary and        
 following lines  of text  will appear  on the  right-hand side  of the        
 page.                                                                         

 Confidential Minutes, Drafts, Etc:   If the minutes of the meeting are        
 confidential, this can be indicated by using the SEC= attribute of the        
 GDOC tag:                                                                     

      :GDOC SEC='Confidential'                                                 

 Whatever text is specified as the value  of SEC will appear at the top        
 of the first page and will be included in the running top-title infor-        
 mation on subsequent pages.                                                   
                                                                               

 page 56                               Waterloo SCRIPT GML User's Guide        
         


 Meeting Agendas:    The GMLmins layout can  also be used to  prepare a        
 meeting agenda, by specifying                                                 

      :DATE TYPE=AGENDA.date of meeting                                        

 Presumably,  the distribution list for  a meeting agenda might consist        
 of                                                                            

      :DIST.To                                                                 
      and                                                                      
      :DIST.Copies                                                             


 GMLagree                                                                      

 GMLagree is a layout for agreements and other legal documents.   It is        
 intended to be used as follows:                                               

      .im GMLagree                                                             
      :GDOC                                                                    
      :TITLE.First Title Line                                                  
      :TITLE.Last Title Line                                                   
      :PARTY.full Name of First Party                                          
      information further qualifying First Party                               
      :HEREIN.short Name of First Party                                        
      :PARTY.full Name of Next Party                                           
      information further qualifying Next Party                                
      :HEREIN.short Name of Next Party                                         
      :BODY                                                                    
      tags and text for the body of                                            
          the agreement                                                        
      :SIGNED BY=number WITNESS=number                                         
      :eGDOC                                                                   

 The tagtext specified with  the PARTY tag is the full  name of a party        
 to the agreement.    With the HEREIN tag,  the tagtext  is the shorter        
 name by which that party will be  referenced in the body of the agree-        
 ment.   The ID= attribute may be used with the HEREIN tag to define an        
 identifier name.   This identifier name may  then be used with the REF        
 tag, in the form                                                              

      :REF REFID=idname<.continued text>                                       

 to generate a reference to that  party.   Using this technique,  it is        
 possible to prepare agreements that can be constant with the exception        
 of the names of the parties involved.                                         

    The body of  the agreement can be prepared using  the same approach        
 as is described for the GMLmins layout.                                       

    The SIGNED  tag generates  dotted lines for  the signatures  of the        
 parties to the agreement and any witnesses, plus a dotted line for the        
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 57        
         


 date.   The BY= and WITNESS= attributes  of the SIGNED tag specify how        
 many dotted  lines are to  be generated  for signatures.   If  the BY=        
 attribute is not specified, one dotted line will be generated per par-        
 ty to the agreement.   If the WITNESS= attribute is not specified,  no        
 dotted lines will  be generated for the signatures  of witnesses.   If        
 the dotted line for the date is not required,  it can be suppressed by        
 specifying DATE=0 as an additional attribute.                                 


 GMLpp                                                                         

 GMLpp is  a layout for policies/procedures  documents in the  style of        
 the Secretariat of the University of  Waterloo.   It is intended to be        
 used as follows:                                                              

      .im GMLpp                                                                
      :GDOC                                                                    
      :TITLE.Name of Corporation <Policy> <Procedure>                          
      :DOCNUM.policy or procedure number                                       
      :DATE.date of issue                                                      
      :REVISION.revision text                                                  
      :SUBJECT< MODE=BLOCK>.Heading Text                                       
      <additional heading text, if BLOCK mode>                                 
      :eSUBJECT                                                                
      :BODY                                                                    
      body, prepared as in GMLmemo                                             
      :eBODY                                                                   
      :eGDOC                                                                   

 The revision text should be the  word "New" if the document represents        
 a new policy or procedure,  or other  words such as "Replaces xxxx" or        
 "Cancels xxxx", as appropriate.                                               

    If the SUBJECT tagtext  is too long for a single  input line,  then        
 specify  the MODE=BLOCK  attribute;  any  additional  text lines  will        
 become part of the tagtext, until the eSUBJECT tag.                           

 Using GMLpp for Job-Description documents:  By using using two special        
 tags JOBTITLE  and INCUMBENT instead of  the tags DOCNUM  and SUBJECT,        
 the GMLpp layout can be used to produce a job-description document:           

      :JOBTITLE.Job Title                                                      
      :INCUMBENT.Person's Name                                                 
                                                                               

 page 58                               Waterloo SCRIPT GML User's Guide        
         


                               Appendix C                                      

                              THE SET TAG                                      


                                                                               
 The SET tag sets a global parameter for the document.  You can specify        
 as many SET tags as you wish,  before the GDOC tag;  any SET that fol-        
 lows the GDOC will be ignored.                                                

    In the following descriptions of the  SET tag,  things in uppercase        
 must  be specified  exactly as  shown;   things in  lowercase must  be        
 replaced by a value of your choosing.                                         


 Number of Heading Levels                                                      

 Some publishing  bodies demand that  different heading styles  be used        
 for the  same heading levels,   depending on  the number of  levels of        
 headings contained in the document; this can be specified by                  

      :SET ITEM=HEADLEVEL VALUE=number                                         


 Page Settings                                                                 

 The following settings alter the size of  the output paper for which a        
 layout was designed,   or alter the positioning of the  output on that        
 paper.                                                                        

      :SET ITEM=item VALUE=number                                              
      or                                                                       
      :SET ITEM=item VALUE='inches'                                            

 The "inches" is  a measurement such as '6.5i' (six  and one-half inch-        
 es), and the items are those below.                                           

 PAGE      the number of lines that can fit on the page (number)               

 HOR       the horizontal width of the paper (inches)                          

 PAGE and  HOR must only  be used if you  are producing your  output on        
 paper that is  different in size than  the paper for which  the layout        
 was designed; the items below alter the placement of the output on the        
 paper.                                                                        

 LEFT      the width of the left margin (inches)                               

 LINE      the width of the output line (inches)                               

 COLS      the number of columns of text per page (number)                     
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 59        
         


 Line-Spacing Modes                                                            

 Some of  the layouts produce  single-spaced output and  others produce        
 double-spaced output.   You can force a particular spacing by specify-        
 ing:                                                                          

      :SET ITEM=LS VALUE=number                                                
      :SET ITEM=SS VALUE=number                                                

 The LS value defines  the number of blank lines that  will be produced        
 between output lines in the normal line-spacing mode, and the SS value        
 defines the number of blank lines that will be produced between output        
 lines in  single-spacing mode.   A  value of 0  implies single-spacing        
 mode (no extra blank lines between output lines).  For example, if you        
 were using a  layout that double-spaced text  and single-spaced compo-        
 nents such as XMP blocks, specifying                                          

      :SET ITEM=LS VALUE=2                                                     
      :SET ITEM=SS VALUE=1                                                     

 would result in triple-spacing for text that would otherwise have been        
 double-spaced,  and double-spacing for text  that would otherwise have        
 been single-spaced.                                                           

    The spacing  of footnote and endnote  text can be  controlled sepa-        
 rately.   If you do nothing,  then footnote text is produced using the        
 global SS value and endnote text is  produced using the global LS val-        
 ue.   Either of these default conditions can be overridden by specify-        
 ing                                                                           

      :SET TAG=EN ITEM=LS VALUE=n                                              
      :SET TAG=FN ITEM=LS VALUE=n                                              


 Font Selections for Special Output Devices                                    

 If the document source file is processed with any of the IP300, I3820,        
 LASERJET,  PHOTO,  POSTS,  QMSlaser,  X2700,   or X3700 options of the        
 SCRIPT command,  default  font selections will be made  for you.   GML        
 automatically defines three font-identifier names and their associated        
 type styles and point sizes.                                                  

 HEAD      the font identifier for  the family of proportionally-spaced        
           fonts  that  will  be  used for  all  heading  text  (H0-H6,        
           ABSTRACT, PREFACE, and TITLE tagtext)                               

 MONO      the font identifier for the  family of mono-width fonts that        
           will be used  for the text in the body  of figures,  tables,        
           and examples                                                        

 TEXT      the font identifier for  the family of proportionally-spaced        
           fonts that will be used for all other text                          
                                                                               

 page 60                               Waterloo SCRIPT GML User's Guide        
         


 The default assignment of the MONO font for the example, figure,  and/        
 or table  blocks can be  changed to use the  TEXT font --  include the        
 process-specific-code block shown below, with those SET tags for which        
 you want the TEXT font used instead of the MONO font:                         

      :PSC PROC='PHOTO X2700'                                                  
      :SET TAG=FIG ITEM=FONT VALUE=TEXT                                        
      :SET TAG=TAB ITEM=FONT VALUE=TEXT                                        
      :SET TAG=XMP ITEM=FONT VALUE=TEXT                                        
      :ePSC                                                                    
      :GDOC                                                                    
           ...                                                                 


 Relative Numbering                                                            

 Relative numbering  of various  components with  respect to  level-one        
 headings in the body and appendix  material can be requested by speci-        
 fying VALUE=RELATIVE for any of the following:                                

 pages                                                                         
    :SET ITEM=NUMB VALUE=RELATIVE                                              

 figures                                                                       
    :SET TAG=FIG ITEM=NUMB VALUE=RELATIVE                                      

 footnotes                                                                     
    :SET TAG=FN ITEM=NUMB VALUE=RELATIVE                                       

 formulae                                                                      
    :SET TAG=DF ITEM=NUMB VALUE=RELATIVE                                       

 tables                                                                        
    :SET TAG=TAB ITEM=NUMB VALUE=RELATIVE                                      

    When relative numbering is in effect for a document component,  the        
 numbering of each occurence of that component in the BODY and APPENDIX        
 will be of the  form "h.n" where "h" is the  current level-one heading        
 number and  "n" will start at  1 within each level-one  heading.   For        
 example,  the  first two  figures within  the third  level-one heading        
 would be numbered "3.1" and "3.2".                                            

    With layouts for which relative numbering is not possible,  a warn-        
 ing message will result if any such SET tag is used.  With layouts for        
 which relative  numbering is the  default,  absolute numbering  can be        
 achieved by specifying the corresponding SET tag with VALUE=ABSOLUTE.         
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 61        
         


 Bibliography-List Styles                                                      

 The annotation style for items in the bibliography list and for refer-        
 ences to them can be set by specifying                                        

      :SET TAG=BIB ITEM=STYLE VALUE='style'                                    

 The possible values are:                                                      

 NUMBER    The items in the bibliography  list will be numbered.   This        
           is the default  for all of the  general-purpose GML layouts,        
           and for a few others.                                               

 LABEL     Some manuals of style suggest labelling the items instead of        
           numbering them,  with  a label of the  form CCCCCyya,  where        
           CCCCC  is the  first five  characters of  the author's  last        
           name, "yy" is the last two digits of the year of publication        
           of the work (optional,  used  if the bibliography cites more        
           than one work  by the same author),  and "a"  is an alphabe-        
           tized sequence  (optional,  used  if the  bibliography cites        
           more than one work by the same author in the same year).  If        
           you wish  to use  this style,   then you  must also  use the        
           CCCCCyya label as the value of  the ID attribute of each BIB        
           tag in the bibliography list.                                       

 NONE      It is possible to have the  items in the bibliography listed        
           without a number or label.   If you do this, you do not need        
           to specify  an ID  attribute with  the BIB  tag,  and  it is        
           impossible to  make reference to  items in  the bibliography        
           list using the BIBREF tag.                                          

 IEEE      This is the style used by the GMLieee and GMLwmcs layouts.          


 Figure and Table Names                                                        

 For example, if you want to have Examples instead of Tables and Illus-        
 trations instead of Figures,  then in  your SCRIPT input file,  before        
 the GDOC tag, specify                                                         

      :SET TAG=FIG ITEM=NAME VALUE='Illustration'                              
      :SET TAG=TAB ITEM=NAME VALUE='Example'                                   

 Note that you must still use the figure and table tags to define these        
 Examples and Illustrations.                                                   
                                                                               

 page 62                               Waterloo SCRIPT GML User's Guide        
         


 Figure and Table Printing                                                     

 Each of  the layouts controls  the level  to which headings  cause any        
 generated-but-not-yet-printed figures and tables to be printed.   With        
 some layouts, only H0 causes this, so that a figure defined within one        
 H1 might  not print until  after the start  of the next  H1 component.        
 With other layouts, all heading levels cause previously-generated fig-        
 ures and tables  to print.   You can  set the level to  which headings        
 will cause figures and tables to print.   For example, to set this for        
 H0, H1, and H2 only,                                                          

      :SET ITEM=FTLEV VALUE=2                                                  


 Heading-Level Names                                                           

 With several of the layouts, each level-zero heading is referred to as        
 a Part and each  level-one heading is referred to as  a Chapter in the        
 output document.   If you are using one of the layouts that does this,        
 and the names  Part and Chapter are not appropriate,   you can specify        
 names of  your choosing for them.    For example,  you can  cause each        
 level-one heading to be referred to as a Section by specifying                

      :SET TAG=H1 ITEM=NAME VALUE='Section'                                    


 Heading-Level Numbering Styles                                                

 It is possible to override the default head-level numbering styles for        
 the H0 and H1 tags by specifying SETs of the form                             

      :SET TAG=BODY     ITEM=H0NUMBER VALUE=A|N|R                              
      :SET TAG=BODY     ITEM=H1NUMBER VALUE=A|N|R                              
      :SET TAG=APPENDIX ITEM=H1NUMBER VALUE=A|N|R                              

 VALUE=A  produces  "alphabetic"  numbering   of  the  form   A,B,C,...        
 VALUE=N produces  "arabic numeral" numbering  of  the  form  1,2,3,...        
 VALUE=R produces  "roman numeral" numbering  of the  form I,II,III,...        
 These SETs will be  ignored by layouts that do not  "number" the H0 or        
 H1 headings.                                                                  


 Heading Levels in the Table of Contents                                       

 For those layouts that produce tables  of contents,  the tagtext of H0        
 through H4  will be included  in the  table of contents.    You cannot        
 extend this to H5 and H6, but you can confine it to less than H4.  For        
 example,  if you  wanted to exclude H3  and H4 from the  table of con-        
 tents, then specify                                                           

      :SET TAG=TOC ITEM=LEVEL VALUE=2                                          
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 63        
         


 Any attempt to set  a VALUE less than 1 will be  treated as though you        
 had specified 1;  as a result,  H2  and lower will be omitted from the        
 table of contents.                                                            


 Notes                                                                         

 You can specify the word to be generated instead of Note, by                  

      :SET TAG=NOTE ITEM=NAME VALUE='name for notes'                           


 Ordered-List Annotation Styles                                                

 The items in  an ordered list can be annotated  using arabic numerals,        
 uppercase or lowercase  alphabetics,  or uppercase or  lowercase roman        
 numerals.   If the default annotation  styles and delimiter characters        
 are not appropriate for your document,   you can establish your own by        
 specifying (for example)                                                      

      :SET TAG=OL ITEM=STYLE VALUE='n. a. i. n) a) i)'                         

 The definition of  VALUE above shows the default  annotation style and        
 delimiter characters for the six levels  of ordered lists.   The style        
 character can be any of "n"  (arabic numerals),  "a" or "A" (lowercase        
 or uppercase  alphabetics),  and  "i" or  "I" (lowercase  or uppercase        
 roman numerals).   The delimiter can be any single character after the        
 style character,  or you can specify both a left and a right delimiter        
 character on either side of the style character, such as "(a)".               


 Indentation for Basic Document Components                                     

 The number of character spaces  that certain basic document components        
 will be indented throughout the document can be SET by                        

      :SET TAG=tagname ITEM=IN VALUE=number                                    

 The indentation can be set for any tag, including P, LQ, XMP,  and the        
 start-of-list tags.   For example, the indentation for definition-list        
 terms can be set by                                                           

      :SET TAG=DL ITEM=IN VALUE=number                                         

 If the tagname you specify does not have such a setting, an error mes-        
 sage will be produced.                                                        
                                                                               

 page 64                               Waterloo SCRIPT GML User's Guide        
         


 Vertical Spacing for Document Components                                      

 The number of blank lines before (and in appropriate cases,  after)  a        
 document component can be SET by                                              

      :SET TAG=tagname ITEM=SK VALUE=number                                    

 If the tagname you specify does not have such a setting, an error mes-        
 sage will be produced.                                                        


 Numbering All Display-Mode Formulae                                           

 By default, only those display-mode formulae defined with                     

      :DF ID=idname                                                            

 will be numbered.   You can force all display-mode formulae to be num-        
 bered by specifying                                                           

      :SET TAG=DF ITEM=NUMBER VALUE=ALL                                        
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 65        
         


                               Appendix D                                      

        SUMMARY OF TAGS, ATTRIBUTES, AND VALUES FOR THE STANDARD               
                                 TAGSET                                        


                                                                               
 The following  is a  reference summary  of the  tags supported  by the        
 "standard tag  set" layouts,  including  their attributes  and values.        
 The information is organized in  alphabetical order by tagname.   Tags        
 with corresponding  end-of tags  are shown  as TAGNAME/eTAGNAME,   and        
 unless otherwise  specified,  the attributes  pertain to  the start-of        
 tag.   If  shown as TAGNAME/<eTAGNAME>,   the end-of tag  is optional.        
 Values that are described as "default"  are the default values for the        
 standard-tagset layouts that are of a general-purpose nature.  Layouts        
 designed for particular publishing bodies  will have defaults peculiar        
 to those bodies' style requirements.                                          

 :ABSTRACT<.Heading Text>/<eABSTRACT>                                          
    STITLE='Short Title'                                                       

 :ADDRESS/eADDRESS                                                             

 :ALINE.one line of author address                                             

 :APPENDIX/<eAPPENDIX>                                                         

 :AUTHOR.Author's Name                                                         
    BYLINE='byline string'                                                     

 :BACKM/<eBACKM>                                                               

 :BIB                                                                          
    ID=idname                                                                  

 :BIBID                                                                        
    REFID=idname --  required                                                  

 :BIBREF                                                                       
    REFID='idname(s)' --  required                                             
    PP='page reference'  --  do not  use if  REFID specifies a  list or        
       range                                                                   

 :BL/eBL  see OL                                                               

 :BODY/<eBODY>                                                                 

 :BORROW  for thesis-category layouts only!                                    

 :BOX/eBOX                                                                     

 :CIT<.text>/eCIT<.continued text>                                             
                                                                               

 page 66                               Waterloo SCRIPT GML User's Guide        
         


 :COPYRIGHT<.text>                                                             
    SYMBOL='string' --  characters to be used as the copyright symbol          

 :COPYNOTE<.text>/eCOPYNOTE                                                    

 :COURSE  for thesis-category layouts only!                                    
    DOC='type of document' --  default is 'report'                             

 :DATE<.date substitute>                                                       

 :DECLARE  for thesis-category layouts only!                                   

 :DF/eDF  display-mode formula                                                 
    ALIGN=                                                                     
       LEFT --  (default) formula will be left-aligned on output               
       BLOCK --  formatting mode for the document will also be used for        
          the formula                                                          
       CENTER --  formula will be centered on output                           
       LINE --  formula will left-aligned                                      
       RIGHT --  formula will be right-aligned                                 
    FONT=fontid--  TEXT (default)   or MONO;  the font  in which normal        
       text within the  formula is to be printed;   ignored for devices        
       that do not support fonts                                               
    FRAME=                                                                     
       BOX --  formula will be enclosed in a box                               
       NONE --  (default) no frame will be used                                
       RULE --  a horizontal rule will be used both before and after           
       'string' --   the specified characters  will be  repeated across        
          the top and bottom                                                   
    ID=idname--  if not  specified,  this formula will  not be numbered        
       and cannot be referenced by DFREF                                       
    IN=n--  indentation from the left margin for the equation                  
    ITALIC,NOITALIC--   letters in  the formula  are set  in italic  by        
       default; NOITALIC will use roman instead                                

 :DFREF  reference to a display-mode formula                                   
    REFID=idname --  required                                                  

 :DL/eDL                                                                       
    BREAK --  forces the definition description  to start on the output        
       line below the definition term (see also TSIZE below)                   
    TERMHI=n --  (default 2) the highlighted-phrase level for the defi-        
       nition term                                                             
    TSIZE=n --   (default 10)   the number  of character  spaces to  be        
       reserved for  definition-term text;  if  a term is  longer,  the        
       description will start on the next output line                          
    see also OL                                                                

 :DOCNUM.document number                                                       

 :DT.definition term                                                           

 :DD.definition description                                                    
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 67        
         


 :DTHD.definition term heading                                                 

 :DDHD.definition description heading                                          

 :EN<.text>/eEN<.continued text>                                               
    ID=idname --  if not specified,   this endnote cannot be referenced        
       by ENREF                                                                

 :ENDNOTES                                                                     

 :ENREF                                                                        
    REFID=idname --  required                                                  

 :F/eF  in-line formula                                                        

 :FIG/eFIG                                                                     
    ID=idname --  if not specified,  the table or figure number will be        
       generated without your having any way in which to reference it          
    DEPTH=n --  the  number of blank lines  to be left for  the body of        
       the table or figure; useful when the body is to be pasted in            
    FONT=fontid --  MONO (default) or TEXT;  the font in which the body        
       of the table  or figure is to be produced;   ignored for devices        
       that do not support fonts                                               
    PLACE=                                                                     
       FLOAT --  (default)  if the table or  figure will not fit in the        
          current output column,  it will appear at the top of the next        
          column and the remainder of the current column will be filled        
          with the text that follows the eFIG or eTAB tag                      
       ANY --  no attempt will be made to ensure that the table or fig-        
          ure will fit in the current output column; if it does not, it        
          will be split across a column or page boundary                       
       INLINE --  if  the table or figure  will not fit in  the current        
          output column,  the rest of the column will be left blank and        
          the table or figure will be positioned at the top of the next        
          column                                                               
       PAGE --  enough blank  lines will be added to the  bottom of the        
          table or figure (after the frame, if there is one)  to ensure        
          that it completely fills the output column                           
       TOP --  the  remainder of the current column will  be left blank        
          and the table or figure will be  positioned at the top of the        
          next column                                                          
       The following is not yet implemented.   You can specify it,  but        
       you will get the result of FLOAT instead.                               
       BOTTOM --  the table or figure will  be floated to the bottom of        
          the current output column if there is room for it,  or to the        
          top of the  next output column if not;  the  remainder of the        
          current output column will be filled  with the text that fol-        
          lows the eFIG or eTAB tag                                            
    FRAME=                                                                     
       BOX --  (default) figure or table will be enclosed in a box             
       NONE --  no frame will be used                                          
       RULE --  a horizontal rule will be used both before and after           
                                                                               

 page 68                               Waterloo SCRIPT GML User's Guide        
         


       'string' --   the specified characters  will be  repeated across        
          the top and bottom                                                   
    CAP=                                                                       
       LONG --  (default for figures) the figure caption will be block-        
          indented to the right of the figure number;  if specified for        
          a table,  the table number and table caption will be centered        
          on separate lines                                                    
       SHORT --  (default for tables) the table number and caption will        
          be centered  if they both will  fit on the same  output line,        
          otherwise they will  be handled in the  block-indented manner        
          described above for figures;  if  specified for figures,  the        
          figure number and caption will be centered on the same line          

 :FIGCAP<.Heading Text>                                                        
    STITLE='Heading Text'  --  if specified,   the STITLE  heading text        
       will be used in the FIGLIST instead of the FIGCAP heading text          

 :FIGDESC<.text>/<eFIGDESC>                                                    

 :FIGID                                                                        
    REFID=idname --  required                                                  

 :FIGLIST<.Heading Text>  see TOC                                              

 :FIGREF                                                                       
    REFID=idname --  required                                                  
    PAGE= --  (see description under HDREF)                                    

 :FN<.text>/eFN<.continued text>                                               
    ID=idname                                                                  
    FONT=fontid --  default is TEXT                                            
    SYMBOL=                                                                    
       NONE --  this footnote will not have an annotation symbol               
       'string' --  the specified character string  will be used as the        
          annotation symbol                                                    
       if not specified,  the next number in the footnote sequence will        
       be used as the annotation symbol                                        

 :FNREF                                                                        
    REFID=idname --  required                                                  

 :FRONTM/<eFRONTM>                                                             

 :GDOC/eGDOC  required                                                         
    SEC='text' --  the document's security classification                      
    HY= --  the text hyphenation mode to be used                               
       ON --  an attempt will be made to hyphenate any word that is too        
          long to fit in the space remaining on an output line                 
       OFF --  no hyphenation will be performed                                
       USER --  only words that contain  hyphens will be candidates for        
          hyphenation                                                          
    JU=--  the text justification mode to be used                              
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 69        
         


       ON --  extra white space will be added between words so that all        
          output lines will be completely  filled (ignored for the last        
          output line in a paragraph)                                          
       HALF --  only half the effect  of ON;  produces semi-ragged line        
          endings                                                              
       OFF --  no extra white space  will be added;  produces extremely        
          ragged line endings                                                  

 :GL/eGL  see OL                                                               

 :GT.glossary term                                                             

 :GD.glossary description                                                      

 :H0,1,2,3,4,5,6                                                               
    ID=idname --  heading-identifier name, for use by HDREF                    
    FNID=idname --   footnote-identifier name,   H1 only,   for use  in        
       subsequent FN tag                                                       
    N='symbol' --  to specify heading number,  H1 only,  and ignored if        
       the layout does not number them.    If the value is numeric,  it        
       will be  used to  number this  level-one heading  and subsequent        
       level-one headings  will continue in sequence  (unless specified        
       with another N=).   If the value is not numeric, it will be used        
       to number this level-one heading, but subsequent level-one head-        
       ings will continue  from the numbering sequence  of the previous        
       level-one heading.                                                      
    STITLE='Short Title' --  (H0,1,2 only)                                     

 :H1SUB  may  only be used immediately  after a H1 (or  equivalent)  or        
    another H1SUB tag                                                          

 :HDREF                                                                        
    REFID=idname --  required;  if the heading and the reference are on        
       different pages,  the reference will include the words "on page"        
       and the number of the page on which the heading occurs                  
    PAGE= --  NO prevents the generation of "on page" and the page num-        
       ber; YES causes them to be generated even if the heading and the        
       reference are on the same page                                          

 :HP0,1,2,3<.text>/eHP0,1,2,3<.continued text>                                 

 :INCLUDE                                                                      
    FILE=filename --  required                                                 

 :I1,2,3.text, :IH1,2,3.text  Any combination of ID, REFID,  and IX can        
    be specified together.   No more than one of PG, SEE,  or SEEID may        
    be specified together.   Several additional constraints are defined        
    below.                                                                     
    PG= --  if not specified,  the current  page number will be used as        
       the page-reference text                                                 
       MAJOR --  the  current page number will be placed  at the begin-        
          ning of the list of page references, to indicate that this is        
          the major reference for this index term                              
                                                                               

 page 70                               Waterloo SCRIPT GML User's Guide        
         


       START --  specifies that the current page number is the start of        
          a range of pages within which this index term occurs                 
       END --  specifies that  the current page number is the  end of a        
          range of pages within which this index term occurs                   
       The intended  function of START and  END is to generate  a page-        
       range reference of  the form "n-m" where  n is the start  of the        
       range and m is the end.   As currently implemented, they have no        
       effect other than to add the current  page number to the list of        
       page references.                                                        
       'text' --  can  be anything other than MAJOR,   START,  and END.        
          The text  between the  apostrophes will be  used as  the page        
          reference,  instead of the current page number.   If the text        
          is a single blank,  the index term will be added to the index        
          without a page reference.                                            
    SEE='text'--  the text to be used as  a "see item" in the reference        
       list, instead of the current page number                                
    ID=idname--  index-identifier name; may contain up to seven letters        
       and/or digits,  and  cannot be specified as the  ID attribute of        
       any other index-related tag                                             
    REFID=idname--  must have already been defined as the ID value of a        
       previous I1,2,3 or  IH1,2,3 tag.   The index term  will be added        
       under the higher-level term(s) of the named index-id, instead of        
       under the  most recent  higher-level index  term(s).   REFID  is        
       invalid with the I1 tag.                                                
    SEEID=idname--  must have already been defined as the ID value of a        
       previous I1,2,3 or IH1,2,3 tag.  The index term(s) of the speci-        
       fied index-identifier name will be used as the text of the "see"        
       reference.                                                              
    IX=n--  an index number,  from 1 to 9;  if omitted,  the index term        
       will be added to index number 1                                         

 :INDEX<.Heading Text>                                                         
    IX=n --   specifies which index is  to be printed (a  numeric value        
       between 1 and 9); if omitted, index number 1 is printed                 
    COLUMNS=n --   the number of  columns in which  the index is  to be        
       printed (a numeric  value between 1 and 9).    With layouts that        
       produce the document in multiple-columns mode, this attribute is        
       ignored.   With  layouts that  produce the  document in  single-        
       column mode, a value of 2 will be used if the attribute is omit-        
       ted.                                                                    

 :IREF                                                                         
    REFID=idname --  required                                                  

 :LI<.text>  for ordered, unordered, and simple lists                          
    ID=idname --  for use with LIREF (do not use with simple lists)            

 :LIHD.Heading Text  for ordered, unordered, and simple lists                  
    ID=idname --  for use with LIREF                                           

 :LIREF  generates  reference to  list item (see  HDREF tag  for attri-        
    butes)                                                                     
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 71        
         


 :LP<.text>                                                                    

 :LQ<.text>/eLQ                                                                

 :NOTE<.text>/<eNOTE>                                                          
    NAME='text' --  will be used instead of the word Note                      

 :OL/eOL                                                                       
    COMPACT<=n>                                                                
       0 --  no compaction; there will be a blank line before the first        
          list item,  between each list item,   and after the last list        
          item                                                                 
       1 --  with  a layout that  produces its output  in single-spaced        
          mode,  will eliminate the blank line between items within the        
          list; with a layout that produces its output in double-spaced        
          mode,  causes  the text of the  list items to be  produced in        
          single-spaced mode,  but with a  blank line between each list        
          item                                                                 
       2 --  a single-spaced list with no blank lines before,  between,        
          or after list items                                                  
    JUSTIFY=--  ON, YES, OFF, NO,  HALF;  right-margin justification of        
       list-item text                                                          

 :P<.text>                                                                     

 :PC<.text>  -- the  "Paragraph Continue" tag is  provided for compati-        
    bility with other implementations of GML                                   

 :PREFACE<.Heading Text>/<ePREFACE>                                            
    STITLE='Short Title'                                                       

 :PSC/ePSC                                                                     
    PROC='list of output devices' --  if the output device to which the        
       document is being produced is not  one of those specified in the        
       list, or if no list is specified, the contents of the block will        
       be ignored                                                              

 :Q<.text>/eQ<.continued text>                                                 

 :SL/eSL  see OL                                                               

 :TAB/eTAB  for these and TABCAP, TABDESC/eTABDESC, TABID,  and TABREF,        
    see the corresponding tags for figures                                     

 :TABLIST<.Heading Text>  see TOC                                              

 :THESIS  for thesis-category layouts only!                                    
    DOC='type of document' --  default is 'thesis'                             

 :TITLE.Document Title                                                         
    FNID=idname --  footnote-identifier name,  for use in subsequent FN        
       tag                                                                     
                                                                               

 page 72                               Waterloo SCRIPT GML User's Guide        
         


    STITLE='Short Title'                                                       

 :TITLEP/eTITLEP                                                               
    ALIGN=                                                                     
       CENTER --  (default  for most layouts)  the  title-page material        
          will be centered                                                     
       LEFT --  the title-page material will be left-aligned                   
       RIGHT --  the title-page material will be right-aligned (default        
          for GMLss)                                                           

 :TOC<.Heading Text>                                                           
    PLACE=                                                                     
       TOP --   the resulting output  will begin at  the top of  a page        
          (default for TOC)                                                    
       INLINE --  the resulting output will start a few lines below the        
          previous  output  (default  for  FIGLIST  and  TABLIST);   if        
          PLACE=INLINE  is  specified  with TOC  and  the  document  is        
          SCRIPTed in single-pass mode, PLACE=TOP will be assumed              

 :UL/eUL  see OL                                                               

 :XMP/eXMP                                                                     
    ALIGN=                                                                     
       LEFT --  (default)  each input line will be left-aligned on out-        
          put;  any  line that is too  long will be output  as multiple        
          left-aligned lines                                                   
       BLOCK --  the formatting mode for the document will also be used        
          for the  lines of the example;   the result will be  block of        
          text                                                                 
       CENTER --  each input line will  be centered on output,  and any        
          line that  is too  long will be  output as  multiple centered        
          lines                                                                
       LINE --  each  input line will be output exactly  as it appeared        
          in the input                                                         
       RIGHT --  each input line will  be right-aligned on output,  and        
          any line that  is too long will be output  as multiple right-        
          aligned lines                                                        
    DEPTH=n--  the number of blank lines to be left for the body of the        
       example; useful when the body is to be pasted in                        
    FONT=fontid--  MONO (default)  or TEXT;  the font in which the body        
       of the example  is to be produced;  ignored for  devices that do        
       not support fonts                                                       
    IN=n--  indentation value for the example block                            
    PLACE=                                                                     
       INLINE --  (default) the example block will be kept together; if        
          it cannot  fit in the current  column,  a new column  will be        
          started and the example block will  appear at the top of this        
          new column                                                           
       ANY --  the example block may be split across columns or pages          
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 73        
         


                               Appendix E                                      

                      MULTIPLE-FONT OUTPUT DEVICES                             


                                                                               
 For output devices including:   IP300, I3820, LASERJET, PHOTO,  POSTS,        
 QMSlaser and X2700, a default set of font families are defined by font        
 identifiers HEAD, TEXT, and MONO.   You can override the default defi-        
 nitions for  one or more  of these  by placing the  appropriate SCRIPT        
 control words in  a PSC/ePSC block prior  to the GDOC tag.    The font        
 family defined by the  HEAD font identifier will be used  for the tag-        
 text of heading  levels H0 through H6,  for TITLE,   and for ABSTRACT,        
 PREFACE, and INDEX (which are treated as level-one headings).  You can        
 define  your own  font  families for  font  identifiers HEAD0  through        
 HEAD6,  to override the  use of the HEAD fonts;  for  example,  if you        
 define a HEAD1 font  family,  then those fonts will be  used for TITLE        
 and all level-one  (or equivalent)  heading tagtext,   and the default        
 HEAD fonts will be used for heading  levels two through six.   You can        
 also define a TITLE font family to be used for the title-page document        
 title;  the  order of  font-identifier selection  for this  tagtext is        
 TITLE if it exists, else HEAD1 if it exists, else HEAD.                       
                                                                               

 page 74                               Waterloo SCRIPT GML User's Guide        
         


                               Appendix F                                      

                              USING SCRIPT                                     


                                                                               
 This implementation of GML relies on  Waterloo SCRIPT for the underly-        
 ing processing  actions.   It is  therefore necessary that  you become        
 familiar with the SCRIPT command and some of its options.                     


 Output Devices and Output-Page Margins                                        

 If you SCRIPT your GML-encoded document to  an output device such as a        
 high-speed line printer,  the output  will be positioned appropriately        
 for an 8.5x11 page.   The leftmost printing position for the output is        
 dependent on the manner  in which the printer and its  paper have been        
 aligned by the computing facility's printer operator.  In most comput-        
 ing installations,  this alignment is  such that the leftmost printing        
 position is 0.5 inches to the right of  the left edge of the paper (or        
 its left-edge perforated pin-feed strip).    This is not something the        
 GML user can control via the SET tag's ITEM=LEFT attribute;  the user-        
 specified VALUE= controls only the  printing displacement to the right        
 of that alignment.                                                            

    Therefore,  if you are using a  hard-copy terminal for your output,        
 you should position the paper in the terminal so that the left edge is        
 0.5 inches to the left of the  "at rest" position of the printing ele-        
 ment.                                                                         


 SCRIPT Options                                                                

 Waterloo SCRIPT provides a number of options that allow you to specify        
 the output device for which the document is to be composed,  and other        
 options to  control various  processing actions.    These options  are        
 specified with the SCRIPT command, in the form                                

      SCript filename (options                                                 

 Some of the options most relevant to the GML user are shown below.            

 DUPLEX    The output will be composed with even- and odd-numbered pag-        
           es offset for printing on both sides of the page.                   

 LAYout GMLxxxxx                                                               
           specifies the  GML layout that  is to  be used by  SCRIPT to        
           process your SCRIPT input file.    If your SCRIPT input file        
           already imbeds a GML layout,   the layout specified with the        
           LAYout option will be used instead.                                 
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 75        
         


 PASses 2  If the PASses option is  not specified,  SCRIPT will perform        
           one-pass processing of the SCRIPT  input file.   If two-pass        
           processing is desired,  specify the "PASses 2" option.   You        
           will   need  this,    for   example,    if  you   want   the        
           TOC/FIGLIST/TABLIST  output to  be generated  at its  proper        
           location at the end of the FRONTM,  and if you have used any        
           of  the  component-referencing  tags (those  that  have  the        
           REFID=  attribute)  to  make forward  references.   In  some        
           (extreme)  cases,  you  may find it necessary  to SCRIPT the        
           input file with 3 passes instead of 2.                              

 PRinter   the composed output file will be sent to the system printer         

 DISK      the composed output  file will be written to your  disk as a        
           "listing" file                                                      

 POSTS     the output file  will be composed for a  "page printer" that        
           accepts the PostScript  page-descriptor datastream language;        
           the GML layout automatically defines  the selection of fonts        
           that will be used.   SCRIPT writes  the output to your disk,        
           as a  POSTS file,   and you  must use  the POSTS  command to        
           invoke  the additional  post-processing  that transmits  the        
           resulting datastream to the PostScript device.                      

 IP300     the output file  will be composed for  the 300-dots-per-inch        
           IMAGEN 24/300  page printer;   the GML  layout automatically        
           defines the selection  of fonts that will  be used.   SCRIPT        
           writes the output to your disk,   as an IP300 file,  and you        
           must use  the IP300 command  to invoke the  additional post-        
           processing that  merges the  character images  and generates        
           the native IMPRESS interface language  for the IMAGEN print-        
           er.                                                                 

 PHOTO     SCRIPT writes the composed output to  your disk,  as a PHOTO        
           file;  the GML layout automatically defines the selection of        
           fonts that will be used.    Please contact the user-services        
           support group for further information about typesetting your        
           GML output,   since discussion of the  additional considera-        
           tions  and  the  administrative  arrangements  required  are        
           beyond the intended scope of this document.                         


 Specifying Your Own Fonts                                                     

 If you  are SCRIPTing a  document to  a device that  supports multiple        
 fonts, the GML layouts provide a default selection for TEXT, HEAD, and        
 MONO font identifiers.   You can specify your own TEXT,  HEAD,  and/or        
 MONO font(s)   if you do  not like  the default font  selections.   By        
 default,  the HEAD fonts are used for the tagtext of heading levels H0        
 through H6, ABSTRACT, PREFACE, INDEX,  and TITLE (whose fonts are han-        
 dled as level-one headings).   You  can define HEAD0..HEAD6 fonts that        
 will be  used instead  of HEAD for  the corresponding  heading levels.        
                                                                               

 page 76                               Waterloo SCRIPT GML User's Guide        
         


 You can also  define a TITLE font  to be used for  the document title;        
 otherwise, the HEAD1 font will be used if it exists, otherwise HEAD.          

    In the  following example,  a document  is to be SCRIPTed  with the        
 option;  the default  11-point Times font families are to  be used for        
 HEAD for heading levels two through six,   and for TEXT and MONO,  but        
 14-point Times is desired for level-one headings and 16-point Times is        
 desired for the title on the titlepage:                                       

 :PSC PROC='POSTS'                                                             
 .im POSTS font HEAD1 Time 14 TimeI 14 TimeB 14 TimeBI 14                      
 .im POSTS font TITLE Time 16 TimeI 16 TimeB 16 TimeBI 16                      
 :ePSC                                                                         
 :GDOC                                                                         
      ...                                                                      

 A description of SCRIPT font definitions  is beyond the intended scope        
 of this document; for details, please consult the Waterloo SCRIPT doc-        
 umentation for the appropriate output device.                                 


 Beware!                                                                       

 While this implementation  of GML is built on top  of Waterloo SCRIPT,        
 it is not intended that you use SCRIPT control words.  The implementa-        
 tion of the processing function for each GML tag alters the underlying        
 SCRIPT environment in  various manners,  and there are  only a limited        
 number of places where you can safely use SCRIPT control words:               

 1.    inside a  PSC/ePSC block that  contains no  output-producing GML        
       tags                                                                    

 2.    within the range of an XMP/eXMP or in the body of a FIG or TAB          

 The effect of any SCRIPT control words  within such a block may not be        
 preserved beyond the end  of the block,  and/or may be  un-done by any        
 GML tag that you use within the block.                                        

    The SCRIPT definitions  to support GML define a  number of special-        
 purpose characters and depend on you  not to alter them.   In particu-        
 lar,                                                                          

 1.    do  not  alter  the following  DC  special-characters  operands:        
       CONT, CW, GML, LI                                                       

 2.    do  not  define any  of  the  following characters  as  special:        
       ampersand <&>, apostrophe <'>,  asterisk <*>,  at <@>,  brackets        
       <[]>, braces <>, colon <:>, double quote <">, equal <=>, hori-        
       zontal <>, minus <->, parentheses <()>, percent <%>,  plus <+>,        
       slash </>                                                               
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 77        
         


 3.    do not define a  Set Symbol or Macro whose name  contains an "@"        
       or is the same  name as any of the GML tags or  the same name as        
       any of the attributes of any of the GML tags                            

 If you violate the foregoing, one or more immensely cryptic error con-        
 ditions will  arise when you try  to SCRIPT your document.    For more        
 information,  see  the Waterloo  SCRIPT Reference  Manual [7]  and the        
 Waterloo SCRIPT User's Guide [8].                                             
                                                                               

 page 78                               Waterloo SCRIPT GML User's Guide        
         
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 79        
         


                                 INDEX                                         

 * ... 4                              GT, GD ... 32                            

 ABSTRACT/eABSTRACT ... 7, 65         HDREF ... 12, 69                         
 ADDRESS/eADDRESS ... 6               HP0,1,2,3/eHP0,1,2,3 ... 26              
 ALINE ... 6                          H0,1,2,3,4,5,6 ... 11, 69                
 APPENDIX/eAPPENDIX ... 15              footnote to ... see "FN"               
 AUTHOR ... 6                         H1SUB ... 12, 69                         

 BACKM/eBACKM ... 17                  IH1,2,3 ... 42, 69                       
 BIB ... 17, 65                       INCLUDE ... 4, 69                        
 BIBID ... 18, 65                     INDEX ... 17, 42, 70                     
 BIBREF ... 18, 65                    IREF ... 41, 70                          
 BL/eBL ... 17, 65                    I1,2,3 ... 39, 69                        
 BODY/eBODY ... 11                                                             
 BORROW ... 49                        layouts ... 45                           
 BOX/eBOX ... 27                        non-standard ... 50                    
                                        standard ... 45                        
 CIT/eCIT ... 18, 25                  LI ... 27                                
 COPYNOTE/eCOPYNOTE ... 7             LIHD ... 29                              
 COPYRIGHT ... 7, 66                  LIREF ... 31                             
 COURSE ... 49, 66                    LP ... 33                                
                                      LQ/eLQ ... 25                            
 DATE ... 7                                                                    
 DECLARE ... 49                       NOTE/eNOTE ... 21, 71                    
 DF ... 64                                                                     
 DF/eDF ... 38, 66                    OL/eOL ... 27, 71                        
 DFREF ... 39, 66                                                              
 DL/eDL ... 31-32, 66                 P ... 21                                 
 DOCNUM ... 7                         PREFACE/ePREFACE ... 8, 71               
 DT, DD ... 31                        PSC/ePSC ... 39                          
 DTHD, DDHD ... 32                                                             
                                      Q/eQ ... 25                              
 EN ... 59                                                                     
 EN/eEN ... 23, 67                    SCRIPT considerations ... 74             
 ENDNOTES ... 24, 67                  SET ... 58                               
 ENREF ... 24, 67                     SL/eSL ... 29, 71                        

 F/eF ... 38, 67                      TAB/eTAB ... 35, 67                      
 FIG/eFIG ... 34, 67                  TABCAP ... 35                            
 FIGCAP ... 34                        TABDESC/eTABDESC ... 35                  
 FIGDESC/eFIGDESC ... 34              TABID ... 37, 68                         
 FIGID ... 37, 68                     TABLIST ... 8, 72                        
 FIGLIST ... 8, 72                    TABREF ... 35, 68                        
 FIGREF ... 34, 68                    THESIS ... 48, 71                        
 FN ... 59                            TITLE ... 5, 71                          
 FN/eFN ... 22, 68                      footnote to ... see "FN"               
 FNREF ... 22, 68                     TITLEP/eTITLEP ... 5, 72                 
 FRONTM/eFRONTM ... 5                 TOC ... 8, 72                            

 GDOC/eGDOC ... iii, 68               UL/eUL ... 29, 72                        
 GL/eGL ... 32, 69                                                             
                                                                               

 page 80                               Waterloo SCRIPT GML User's Guide        
         


 XMP/eXMP ... 26, 72                                                           
                                                                               

 Waterloo SCRIPT GML User's Guide                               page 81        
         


                              BIBLIOGRAPHY                                     

 The following list of publications have been particularly instrumental        
 in guiding the results produced by  the various GML layouts.   In par-        
 ticular,  Turabian  [12] has been used  for those situations  in which        
 there were no compelling contrary considerations as to style.                 

 1.   AIP Style Manual, 3rd ed.  New York:  American Institute of Phys-        
      ics, 1978.  AIP publication R-283.                                       

 2.   Document Composition Facility Generalized Mark-up Language:              
      Starter Set Reference, SH20-9187-0.  IBM Corporation, 1980.              

 3.   MLA Handbook for Writers of Research Papers, Theses, and Disser-         
      tations; Student Edition.  Joseph Gibaldi and Walter S. Achtert.         
      New York:  Modern Language Association of America, 1980.                 

 4.   Preparation of Papers in Two-Column Format For IEEE Photo-Offset         
      Publications.  New York:  Editorial Department, Institute of             
      Electrical and Electronics Engineers, 1979.                              

 5.   McGregor and Werner, Inc. (Conference Services division); 6411           
      Chillum Place N.W., Washington DC, USA 20012, (202) 722-2200.            

 6.   Publication Manual of the American Psychological Association, 2nd        
      ed.  American Psychological Association, 1974.                           

 7.   Waterloo SCRIPT Reference Manual for Waterloo SCRIPT - Version           
      88.1 (87DEC11).  Waterloo:  Department of Computing Services,            
      University of Waterloo.                                                  

 8.   Waterloo SCRIPT User's Guide for Waterloo SCRIPT - Version 88.1          
      (87DEC11).  Waterloo:  Department of Computing Services, Univer-         
      sity of Waterloo.                                                        

 9.   GML Reference Summary and SCRIPT Reference Summary for Waterloo          
      SCRIPT - Version 88.1 (87DEC11).  Waterloo:  Department of Com-          
      puting Services, University of Waterloo.                                 

 10.  Thesis Regulations and Guide.  Waterloo:  Graduate Studies               
      Office, University of Waterloo, 1977.                                    

 11.  Guidelines for Writing Your Work-Term Report.  Waterloo:  Depart-        
      ment of Co-ordination and Placement, University of Waterloo,             
      December 1982.                                                           

 12.  Turabian, Kate L.  A Manual for Writers of Term Papers, Theses,          
      and Dissertations, 4th ed.  Chicago:  University of Chicago              
      Press, 1973.                                                             

 13.  Wiles, Roy McKeen.  Scholarly Reporting in the Humanities, 4th           
      ed. revised.  Toronto:  University of Toronto Press, 1972.               
                                                                               

 page 82                               Waterloo SCRIPT GML User's Guide        
         
