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 :eTITLEP <:ABSTRACT> <:PREFACE.heading text> <:TOC> :eFRONTM :BODYGROUP :INCLUDE FILE=document1 :INCLUDE FILE=document2 etc :eBODYGROUP :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 :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 :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 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 :DOCNUM.policy or procedure number :DATE.date of issue :REVISION.revision text :SUBJECT< MODE=BLOCK>.Heading Text :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/, 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>/ STITLE='Short Title' :ADDRESS/eADDRESS :ALINE.one line of author address :APPENDIX/ :AUTHOR.Author's Name BYLINE='byline string' :BACKM/ :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/ :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>/ :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/ :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>/ 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>/ 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 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴