.TH Scribe
.CM 4
.SH "NAME"
Scribe \-      [ Copyright (C) 1988, Scribe Systems Inc.  ]

The help library to the "Scribe" Document Production System contains
basic information about commonly-used Scribe facilities and constructs
used in Scribe Version 6 and above.  More detailed information can be
found in the "Scribe User Manual", "Scribe Advanced User Manual" and
"Scribe Fonts and Drivers".


.nf
    The command to invoke Scribe is: "scribe".
    The character to specify command-line options is: "-".
.fi

In order for Scribe to recognize the command-line option, it must follow
the filename. [Note: more than one option is permitted.]  (See the
"CommandLine_Options" entry for a complete list)

.SH "EXAMPLES"
On most systems, you type "scribe".  Scribe responds by typing its
sign-on message and then printing an asterisk to wait for you to type
the filename:

.nf
         scribe
         Scribe 7(1700) Copyright (C) 1988, Scribe Systems Inc.
         *
.fi

In response to the prompt, type the name of the manuscript file that is
to be processed.

.nf
         * XXX.mss
.fi

Scribe begins processing the file when you press the RETURN key.

The user can type the filename on the same line, without waiting for the
asterisk prompt:

.nf
         scribe XXX.mss
.fi

The user can eliminate the ".MSS extension" when invoking Scribe:

.nf
         scribe XXX
.fi

This command is equivalent to "scribe XXX.mss".

Here are examples using some of the command-line options. (Note the
command-line character "-" is used in these examples.):

     scribe XXX -dev:pagedfile -draft:3

     scribe XXX -vocab -nochangebars -wordcount

.SH "BIBLIOGRAPHIES"
Scribe contains a mechanism for automatically assembling a Bibliography
for a document by selecting entries from a larger bibliographic
database.  Scribe expects to find the information for Bibliography
entries in a bibliography database file (.BIB) in a specific data
format.  Each entry in an .BIB file must have the structure:

          @classification(codeword, list-of-fields)

The list of valid "classifications" appears in the "Classes" subtopic.
The list of valid "fields" appears in the "Fields" subtopic.
The formatting of the cited bibliographic reference is controlled by the
reference format chosen via the @Style command.  Available formats can
be found in the "Reference_Formats" subtopic.

.B \ CLASSES
Scribe's bibliography classifications are listed below.  Not all
classifications are used with each reference format.  Refer to the
"Scribe User Manual" or the "Scribe Advanced User Manual" for details on
which classifications are required and optional for each reference
format.

.I \ ARTICLE
An article from an academic journal or a magazine.

.I \ BOOK
Something published on its own, usually by a publishing house that is
not the same as the author.
.I \ BOOKLET
Something published and bound, but having neither an explicitly-named
publisher nor a sponsoring institution.

.I \ CONFERENCE
The conference name.

.I \ INBOOK
For a reference to a part of a book rather than to the entire book.

.I \ INCOLLECTION
Something composed of papers or chapters previously published elsewhere.

.I \ INPROCEEDINGS
A reference to a paper in a conference proceedings or the like.

.I \ MANUAL
An instruction manual or piece of technical documentation.

.I \ MASTERSTHESIS
A Masters' thesis.

.I \ MISC
Any category not mentioned in this list.

.I \ PHDTHESIS
A Ph.D. thesis.

.I \ PROCEEDINGS
The proceedings of a conference or some similar document.  The
identifying characteristics of the classification are that its publisher
and author are identical, and often no editor's name appears.

.I \ TECHREPORT
A technical report.  Similar to a book, except that it is published by a
research institution instead of by a publisher and that it usually has
an assigned "report number".

.I \ UNPUBLISHED
Some paper that is in preparation or that has been printed but not
published.

.B \ FIELDS
The following field names are used in defining bibliography database
entries.  All take a delimited string or an abbreviation code as a
value.  Not all field names apply to each classification; some are
required while others are not.  Check the "Scribe User Manual" and
"Scribe Advanced User Manual" for details.

.I \ ADDRESS
The address of the publisher or printer or organization.

.I \ AUTHOR
The name(s) of the author or authors, in the format in which they should
be printed.

.I \ ANNOTE
Any annotation text.  Not actually printed in most bibliography formats.

.I \ BOOKTITLE
The title of a book or proceedings of which this reference is a chapter
or paper or article.

.I \ CHAPTER
If a reference is being made to part of a book and not the entire book,
specify either chapter or pages.

.I \ EDITION
Manuals often have an edition name or number that is not part of the
actual title of the manual.

.I \ EDITOR
The name of the editor.  If more than one, use Editors.

.I \ EDITORS
The name of the editors.  If only one, use Editor.

.I \ FULLAUTHOR
The full name of the author or authors, written out without commas.

.I \ HOWPUBLISHED
For unusual manuscripts; how it came into your possession ("personal
note", etc.).

.I \ INSTITUTION
The organization or institution backing or publishing a technical report
or a proceedings.

.I \ JOURNAL
The title of the journal.

.I \ KEY
The sort key.  This field is used for alphabetization.

.I \ MONTH
January, February, etc.

.I \ NOTE
Any comment, usually used to clarify the reference or to suggest
alternate sources.  Differs from Annote in that Note will always be
printed, but Annote will be printed only in those bibliography types
that specify annotation.

.I \ NUMBER
Issue number of a journal or series number in a book series or serial
number of a technical report.

.I \ ORGANIZATION
The name of the organization holding a conference that published a
proceedings.

.I \ PAGES
The page numbers within a journal, proceedings, or book that contain the
material actually cited.
.I \ PUBLISHER
The name of the publishing company.

.I \ SCHOOL
For theses, the name of the school granting the degree.

.I \ SERIES
When books are published in a series, the series has a name.

.I \ TITLE
The title of the book, article, thesis, or other document that is being
cited.  Do not italicize or underline; that detail will be handled by
the selected reference format.

.I \ TYPE
Some technical reports are called by other names, such as "Research
Report", etc.  If this is not a "Technical Report", put its true name in
this field.

.I \ VOLUME
The volume number of a journal or a series book.

.I \ YEAR
The year of publication; four digits:  1979.

.B \ REFERENCE_FORMATS
Bibliography format definitions in the Database are used to control the
style and sequencing of the list of references and the citations.
Select one with the References @Style parameter.

.I \ 1APA
Similiar to the APA format except that it contains an Annote field that
is treated as a Comment.

.I \ 1APADRAFT
Similiar to the 1APA format except that it is double-spaced.

.I \ ANNAPA
Similiar to the 1APA format except that the Annote field is treated as
text.

.I \ ANNAPADRAFT
Similiar to the 1APADraft format except that the Annote field is treated
as text.

.I \ ANNOTEDSTDALPHABETIC
Same as StdAlphabetic, but includes annotations and has filled lines.

.I \ ANNOTEDSTDIDENTIFIER
Similiar to the STDIdentifier format except it includes annotations and
has filled lines.

.I \ ANNOTEDSTDNUMERIC
  Same as STDNumeric, but includes annotations (i.e. the contents of the
Annote field) in the Bibliography and has filled lines.

.I \ ANNSTDALPHABETIC
Similiar to the STDAlphabetic format except it includes annotations and
has unfilled lines.

.I \ ANNSTDNUMERIC
Similiar to the STDNumeric format except it includes annotations and has
unfilled lines.

.I \ APA
(American Psychological Association).  Spelled-out citations
(Knuth, 1978), outdented closed reference list, alphabetical ordering of
references.
.I \ APADRAFT
Draft version of APA format.  Same as regular version, but triple-spaces
the Bibliography.

.I \ CACM
Numeric citations [5], closed format, alphabetical ordering of
references.

.I \ CLOSEDALPHABETIC
Similiar to the STDAlphabetic format.

.I \ CLOSEDNUMERIC
Similiar to the STDNumeric format.

.I \ IEEE
                               5
Superscripted numeric citations , closed format, citation sequence
ordering of references.

.I \ IPL
(Information Processing Letters).  The format required by IPL.  This
format is incomplete; it does not have all standard Scribe types yet
(April 1984) and is being included for convenience only.

.I \ NEWAPA
(American Psychological Association).  The new APA format with the Year
following the Author.  Spelled-out citations (Knuth, 1978), outdented
closed reference list, alphabetical ordering of references.

.I \ SIAM
(Society for Industrial and Applied Mathematics).  The format required
by SIAM journals.  This format is incomplete; it does not have all
standard Scribe types yet (April 1984) and is being included for
convenience only.

.I \ STDALPHABETIC
Alphabetic citations [Knuth 78], open format, alphabetical ordering of
references.

.I \ STDIDENTIFIER
Open format, reference identifier for citations rather that a generated
label.

.I \ STDNUMERIC
Numeric citations [5], open format, alphabetical ordering of references.
.SH "BOXES"
To draw a box around text, use the Box environment and enclose the text
to be boxed in its delimiters.  The space between text characters and
the lines of the box is controlled by four box margin attributes:
"BoxTM" (top margin), "BoxLM" (left margin), "BoxBM" (bottom margin),
and "BoxRM" (right margin).  For devices that can draw continuous lines,
the box drawn by @Box has default margins of four points on all sides.
For other devices, the default margins are one character on the left and
right sides and one line on the top and bottom.  To change one or more
of these margins, specify the appropriate box margin attribute and its
value when defining, modifying or beginning an environment.

.SH "EXAMPLES"

.nf
    1. @Box(Warning)

              -----------
              |         |
      Result: | Warning |
              |         |
              -----------
    2. @Begin(Box, BoxTM 2 lines, BoxBM 2 lines,
            BoxLM 2 char, BoxRM 2 char)
        Warning
       @End(Box)

              -------------
              |           |
              |           |
      Result: |  Warning  |
              |           |
              |           |
              -------------

.fi


.SH "CHANGE_BARS"
This list summarizes the commands and parameters that can be used to
specify change bars.

.B \ CB
Environment generates a change bar for all text within its delimiters.
.B \ CBON
Command to turn on change bars.  A user-defined change bar can be
created and specified as the parameter for the @CBon and @CBoff
commands.  See your DBA for details.

.B \ CBOFF
Command to turn off change bars.  A user-defined change bar can be
created and specified as the parameter for the @CBon and @CBoff
commands.  See your DBA for details.

.B \ CHANGEBARLOCATION
Style parameter specifies the margin in which the bar appears.  Values:
Left, Right, Inside (right margin of even-numbered pages and the left
margin of odd-numbered pages) and Outside (left margin of even-numbered
pages and the right margin of odd-numbered pages).  Default:  Outside.

.B \ CHANGEBAROFFSET
Style parameter specifies how far out the bar is drawn from the
appropriate margin.

.B \ CHANGEBARS
Style parameter generates or suppresses change bars throughout the
document.  Takes a boolean value.

.B \ NOCHANGEBARS
Command-line switch suppresses change bars during a particular Scribe
compilation.

.SH "EXAMPLES"

.nf
    1.  MSS input:

        Refer to Publication No. @CB(2547-A).

        Output:

        Refer to Publication No. 2547-A.                 |


    2. MSS input:

       This sentence is not to be changed.
       @CBon()
       This sentence is to be added to the paragraph.
       This second sentence is to be added.
       @CBoff()
       This sentence doesn't change, either.


       Output:

       This sentence is not to be changed. This sentence is to be    |
       added to the paragraph. This second sentence is to be added.  |
       This sentence doesn't change, either.

.fi


.SH "COMMANDLINE_OPTIONS"
Valid command-line options and any synonym abbreviations are listed
below.  More than one option is permitted but only one form of any
option should be used.

.B \ CHANGE_BARS
Print change bars.

.B \ DEFINE
Identical in function to an @String command.  The parameters supplied
after the Define switch must be enclosed in delimiters.

Define:string-name=value - Defines "string-name" to "value".


.B \ DIABLO
Use output device Diablo.

Abbreviation: D

.B \ DEVICE
Use output device "name".

.nf
          Format: Device:name


    Abbreviation: Dev:
.fi


.B \ DOCUMENT
Produce output file "name".
.nf
          Format: Document:name


    Abbreviation: Doc:
.fi


.B \ DOVER
Use output device Dover.

.B \ DRAFT
Sets "Draft" string to "1".

Draft:value - Sets "Draft" string to "value".


.B \ ERRORLIMIT
Specifies the maximum number of errors that will be processed before
Scribe aborts the run.

Errorlimit:value

.B \ FILE
Use output device File.

Abbreviation: F

.B \ HYPVOCAB
Create a lexicon showing the hyphenation of each word in the document.

Abbreviation: Hv

.B \ HYD
Create a lexicon showing each hyphenation decision.

.B \ IMPRINT10
Use output device Imprint10.

Abbreviations: Imp, Imprint

.B \ KEEPFILES
Do not delete Scribe temporary files.

Abbreviation: Keep

.B \ LOCAL
Write the output file to the working directory.

.B \ LPT
Use output device LPT.

Abbreviation: L

.B \ NOCHANGEBARS
Suppress change bars.

.B \ PAGEDFILE
Use output device PagedFile.

.B \ QUIET
Don't print any error messages on the terminal.

Abbreviation: Q

.B \ REMOTE
Write the output file to the directory that contains the file being
processed.

.B \ VOCABULARY
Generate sorted word listing (.LEX file).

Abbreviations: V, Voc, Vocab

.B \ WORDCOUNT
Count the number of words in the document.

Abbreviations:  W, Words

.B \ X9700
Use output device X9700.

Abbreviations:  X

.SH "COMMANDS"
These commands may be used for all devices and document types.  This
list is basic rather than exhaustive.  Please consult the "Scribe User
Manual" and the "Scribe Advanced User Manual" for more details.

.B \ ABORT
Terminates a Scribe compilation prior to normal completion.  Most useful
in an @Case statement; allows the user to terminate a compilation when
certain conditions are met.  The command causes Scribe to display the
message "Exit" and then return to the operating system.

.nf
       Format:

         @Abort
.fi


.B \ BACKPLACE
Inserts the generated portion into the document at the point where the
@BackPlace command is specified.  The portion is taken from the previous
Scribe run, and as a result, documents that contain this command should
be run through Scribe twice to ensure that the contents of the generated
portion are up-to-date.

.nf
       Format:

         @BackPlace(portion-name)
.fi

.B \ BAR
Draws a horizontal line from the global left margin to the global right
margin.

.nf
       Format:

         @Bar()
.fi


.B \ BEGIN
Marks the beginning of the specified environment.  See also @End.

.nf
       Format:

         @Begin(Environment, attribute-value-list)
.fi


.SH "EXAMPLES"
.nf
      1. @Begin(Enumerate, NumberFrom 7)

         This command begins the Enumerate environment with the first
         item in the list to start at the number 7.

      2. @Begin(Description, Leftmargin +25chars, Indent -25chars)

         This command begins the Description environment and widens the
         left margin so that the description of the header is further
         from the outdented header word.
.fi


.B \ BIBFORM
Defines a Bibliography classification, such as "Book", for a particular
Bibliography reference format.  May only be used in .REF files and the
.LIB files that are called by the .REF files.  (See the "Classes"
subtopic in the "Bibliographies" entry for available bibliography
classifications.)

.nf
       Format:

         @Bibform(Classification=delimited-definition-string)
.fi


.SH "EXAMPLES"

.nf
      1. @BibForm(UnPublished=<
              @begin(BibEntry)
              @parm(tag).@\@parm(Author), @~
              "@parm(Title)"@~
              @Imbed(Note,def ', @Parm(Note)', undef '.')
              @end(BibEntry)
                >)

         (Note: Taken from the IEEE.Ref database file.)

      2. @BibForm(Misc=<
             @begin(BibEntry)
             @l1{[@parm(tag)]@\@imbed(Author,def '@parm(Author).')}
             @imbed(Title,def '@l2{@parm(Title).}')
             @imbed(HowPublished,def '@l2{@parm(HowPublished).}')
             @imbed(Year, def '@l2{@imbed"Month, def {@Parm(Month), }"@~
                     @parm(Year)}')
             @imbed(Note,def '@l2{@parm(Note).}')
             @end(BibEntry)
             >)

         (Note: Taken from the Standa.Lib database file.)
.fi


.B \ BIBLIOGRAPHY
Inserts the bibliography at a particular point in the document.
Otherwise, Scribe automatically puts it at the end.  Use of this command
requires placement of a heading in front of it and may result in an
incomplete bibliography.

.nf
       Format:

         @Bibliography()
.fi
.B \ BLANKPAGE
Inserts "n" number of specified pages into the document.  The default
value of "n" is 1.  See also @NewPage.

.nf
       Format:

         @BlankPage(n)
.fi


.SH "EXAMPLES"

.nf
      1. @BlankPage(2)

         This command will insert 2 blank pages when the next page
         break occurs.

      2. @BlankPage()

         This command will insert 1 blank page at the next page break.
.fi

.B \ BLANKSPACE
Inserts the specified vertical blank space, usually for a figure.  (See
the "Syntax_Summary" entry for units of measure listed in
"Numbers_and_Distances")

.nf
       Format:

         @BlankSpace(vertical-distance)
.fi


.B \ CBON
Begins a change bar of the specified bar-style.  The optional bar-style
is a name defined in an @DefineChangeBar command.  Empty or no
delimiters produce the standard change bar for the output device.  (See
the "Change_Bars" entry for more information.)

.nf
       Format:

         @CBon()
      or
         @CBon(optional-bar-style)
.fi


.B \ CBOFF
Ends a change bar of the specified bar-style.  (See the "Change_Bars"
entry for more information.)

.nf
       Format:

         @CBoff()
      or
         @CBoff(optional-bar-style)
.fi


.B \ CAPTION
Specifies the caption for a figure or table.  Any @Tag commands for the
figure or table must come after the caption.  Used in sectioned document
types only.
.nf
       Format:

         @Caption(text-of-caption)
.fi


.B \ CASE
Includes delimited-text1 in the document if "selector" is equal to key1,
delimited-text2 if "selector" equals key2, etc.  "Selector" may be
Draft, any user-defined string or pre-defined string. Special key values
of Null and Else are permitted.  Only one result string from a given
@Case is ever included in a document.

.nf
       Format:

         @Case(selector, key1 "delimited-text1",
                         key2 "delimited-text2",
                         Null "...",
                         Else "...")
.fi

.SH "EXAMPLES"

.nf
      1. @Case(Draft, 1="@Pageheading(Center=`DRAFT')",
                   Null="@PageHeading(Center=`@value(page)')")

         This command will include the word DRAFT in the center
         field of the pageheading command if the draft command-line
         option is set equal to 1; if draft is null, then the page
         number will be included in the pageheading.

      2. @String(TeacherEdition="True")
         ...
         @Case(TeacherEdition,true="@include[Answer.Mss]",
                              Else="")

         This command will include the the file "Answer.Mss" if the
         string "TeacherEdition" is defined to be "true" earlier in
         the file.
.fi
.B \ CHANGETABLECOLUMNS
Provides a new set of columns partway through a table.  "Rowformat-name"
is the name assigned to an @DefineRowFormat command.
@ChangeTableColumns changes the table columns from the row format
specified with the TableColumns attribute in the beginning of a tabular
environment to the new row format.  The change is effective at the point
in the table where the @ChangeTableColumns command is specified.

.nf
       Format:

         @ChangeTableColumns(rowformat-name)
.fi

(Advanced command.)

.B \ CITE
Generates a bibliographic citation to the reference entry identified by
parameter, puts the citation in the document in place of the @Cite
command, and causes that bibliography entry to be included in the
document's Bibliography. More than one "parameter" may be given,
separated by commas.  Any delimited string that follows a "parameter" is
included in the citation.
.nf
       Format:

         @Cite(parameter{delimited-string})
.fi


.B \ CITEMARK
Causes the bibliography entry identified by "parameter" to be included
in this document's Bibliography. No actual citation is placed in the
text.

.nf
       Format:

         @CiteMark(parameter)
.fi


.B \ COMMANDSTRING
Defines a sequence of commands under a single "name".  The invocation of
this new command does not require any delimiters or arguments.  (See the
"Names" subtopic of the "Syntax_Summary" entry for proper syntax)
.nf
       Format:

         @CommandString(name=delimited-value)
.fi


.SH "EXAMPLE"

.nf
       @Commandstring[quad="@Hsp(1 quad)"]
       @Commandstring[um="Scribe User Manual"]

       The command @Quad would produce a horizontal space of 1 quad.
       The command @Um would produce the text: "Scribe User Manual"
.fi


.B \ COMMENT
Produces no output.  Provides a means of inserting comments in the .MSS
file without that text being printed in the output. Also masquerades as
an environment: @Begin(Comment) commented text @End(Comment) It is the
ONLY command having this property!
.nf
       Format:

         @Comment(text)
      or
         @Begin(Comment) text @End(Comment)
.fi


.B \ COUNTER
Defines "name" as a counter.  (See the "Names" subtopic of the
"Syntax_Summary" entry for proper syntax)

.nf
       Format:

         @Counter(name, list-of-attributes-and-values)
.fi


.B \ DECLARE
Defines device characteristics that will be examined later by a device
driver.  Allowed in Database files only.
.nf
       Format:

         @Declare(parameter=value)
.fi

(Advanced command.)

.B \ DEFINE
Defines "newname" to be a Scribe environment, with the specified
attributes and values.  If the "=oldname" optional field is present, the
new environment is the same as the old one except for the changes
specified by the attribute and value list.  (See the "Names" subtopic of
the "Syntax_Summary" entry for proper syntax)
NOTE: oldname must be a defined environment.

.nf
       Format:

         @Define(newname=oldname, list-of-attributes-and-values)
.fi
.I \ DEFINEBOX
Defines a box named "box-name".  "Parameter" refers to one or more
of the four sides and "line-type" to a line defined with an
@DefineLineType command.

.nf
       Format:

         @DefineBox(box-name, parameter=line-type,...)
.fi


.I \ DEFINECHANGEBAR
Defines a change bar named "bar-name".  Can use a line defined with
an @DefineLineType command or a text string specified by "Text".
Change bars can be suppressed by specifying the optional parameter
"Obsolete".

.nf
       Format:

         @DefineChangeBar(bar-name, LineType=line-type, Text=string,
                        Obsolete)
.fi


.I \ DEFINEFONT
Sets up a correspondence between single-letter FaceCodes and
TypeCase or RawFont names within a given Font.

.nf
       Format:

         @DefineFont(font-name, list-of-facecode-descriptors)
.fi

(Advanced command.)

.I \ DEFINEFONTMAPPING
Specifies a mapping from fonts used in the PostScript graphics file
to fonts used in the document.  The "font-name" must be the name
used in the Location parameter of the Rawfont file.  Available for
PostScript devices only.

.nf
       Format:

         @DefineFontMapping(map-name,
                entry <Font "font-name", MapsTo "font-name">,
                ... )
.fi

(Advanced command.)

.SH "EXAMPLES"

.nf
    1.
    @DefineFontMapping(ToHelvetica,
     entry <Font "Times-Roman",     MapsTo "Helvetica">,
     entry <Font "Times-Bold",      MapsTo "Helvetica-Bold">,
     entry <Font "Times-Italic",    MapsTo "Helvetica-Oblique">,
     entry <Font "BookMan-Light",   MapsTo "Helvetica">,
     entry <Font "BookMan-Demi",    MapsTo "Helvetica-Bold">,
     entry <Font "BookMan-LightItalic", MapsTo "Helvetica-Oblique">)


    The above defines a font-mapping called "ToHelvetica" that when
    used in the @Graphic command:

               @Graphic(FontMapping=ToHelvetica, Height=...)

    will cause all TimesRoman and BookMan text in the graphics file
    to be printed in Helvetica; all TimesItalic and BookManItalic
    text to be printed in Helvetica-Oblique (italic); and all
    TimesBold and BookManBold text to be printed in HelveticaBold.

    2.
      @DefineFontMapping(ToItalics,
         entry <Font "Times-Roman", MapsTo "Times-Italic">,
         entry <Font "Times-Bold", MapsTo "Times-Italic">,
         entry <Font "Helvetica", MapsTo "Helvetica-Oblique">,
         entry <Font "Helvetica-Bold", MapsTo "Helvetica-Oblique">)

      The above defines a font-mapping called "ToItalics" that when
      used in the @Graphic command:

               @Graphic(FontMapping=ToItalics, Height=...)

      will cause all TimesRoman, TimesBold and Helvetica,
      HelveticaBold text in the graphics file to be printed in
      TimesItalics and HelveticaOblique (italics), respectively.
.fi


.I \ DEFINEHYPHENATIONDICTIONARY
Defines a dictionary to be used with one of the dictionary
hyphenation methods.
Synonym:  @DefineHyphenationDictionaries.

.nf
       Format:

         @DefineHyphenationDictionary(dictionary-name=
                        delimited-word-list)
.fi


.I \ DEFINELINETYPE
Defines a line named "line-type" The actual format is different for
individual devices listed separately.

.B \ All_Other_Devices
Defines a line named "line-type". "Delimited-string" is the
character(s) which will be used to draw the line, and "rawfont-name"
(optional) is the name of the RawFont from which the character(s)
will be taken.  If the RawFont parameter is not mentioned, the
character(s) will be taken from the RawFont in effect at the time
the box is drawn.

.nf
       Format:

         @DefineLineType(line-type, Character="delimited-string",
              RawFont=rawfont-name")
.fi


.SH "EXAMPLES"

.nf
    1. @DefineLineType(StandardVert, Character="|",
                           RawFont "BoldPSLow")

       This command defines a linetype called StandardVert that uses
       the | character from the Diablo rawfont BoldPSLow.

    2. @DefineLineType(StandardHoriz, Character="-",
                           Rawfont "StanfordASCII")

       This command defines a linetype called StandardHoriz that
       uses the - character from the LPT rawfont StanfordASCII.
.fi


.B \ Imagens_Dover_LN01_LN03_X2700_X2700II
Defines a line named "line-type".  "Thickness" is its weight (or
width) in rasters.

.nf
       Format:

         @DefineLineType(line-type, Weight="thickness")
.fi


.SH "EXAMPLE"

.nf
      @DefineLineType(Standardline, Weight 3)
      This command defines a simple line type called Standardline
      with a weight of 3 rasters
.fi


.B \ LG1200_and_Talaris
Defines a line named "line-type".  "Thickness" is its weight (or
width) in rasters, and "hexnumber" (optional) is the hexidecimal
number of a built-in halftone pattern.  (See the QUIC manual for
details on halftone patterns.)

.nf
       Format:

         @DefineLineType(line-type, Weight="thickness",
              Halftone="hexnumber")
.fi


.SH "EXAMPLES"

.nf
      1. @DefineLineType(Standardline, Weight 3)

      This command defines a line type called Standardline with a
      weight of 3 rasters.

      2. @DefineLineType(Pattern4, Weight 30, Halftone=4F)

      This command defines a line type called Pattern4 with a
      thicker weight of 30 rasters using the built-in halftone
      pattern 4F.
.fi


.B \ PostScript_and_MacPostScript
Defines a line named "line-type".  "Thickness" is its weight (or
width) in rasters, and "center-thickness" (optional) is the weight
in rasters of a white line drawn in the center of the line to make
it seem double.

.nf
       Format:

         @DefineLineType(line-type, Weight="thickness",
              Groove="center-thickness")
.fi


.SH "EXAMPLES"

.nf
    1. @DefineLineType(Standardline, Weight 50)

       This command defines a linetype called Standardline that
       has a weight of 50 rasters.

    2. @DefineLineType(StandardDoubleline, Weight 150, Groove 50)

       This command defines a linetype called StandardDoubleLine
       that has a weight of 150 rasters and a white line groove of
       50 rasters that is drawn in the middle of the 150 rasters.
.fi


.I \ DEFINERAWFONT
Defines characters in a raw font and their associated widths.

.nf
       Format:

         @DefineRawFont(RawFont-name,list-of-character-definitions)
.fi

(Advanced command.)

.I \ DEFINEROWFORMAT
Defines the format for a table row named "format-name".  The
"Columns" parameter must be followed by a list of
"Column=environment-name" pairs, one for each column in the table.

.nf
       Format:

         @DefineRowFormat(format-name, parameter,...,
      Columns=[Column=environment-name,Column=environment-name,...])
.fi

(Advanced command.)

.I \ DEFINESECURITY
For establishing security classifications.  Defines a "name" which
may be used as a value for the environment attribute Security.  The
"number" sets a priority for the classification and is used when
Scribe determines the highest classification on a page.  "Title" is
the full name of the classification (for instance, "Top Secret").
"Abbreviation-for-title" is the short version of the classification
(such as "T" for "Top Secret").  "Title" and "abbreviation-for-
title" are printed by using the @Value command and one of the
following parameters:  Security, PageSecurity, or SheetSecurity.

.nf
       Format:

         @DefineSecurity(name, Level=number, FullName=title,
            Abbreviation="abbreviation-for-title")
.fi

(Advanced command.)

.I \ DEFINETYPECASE
Defines what characters are included in the TypeCase and in which
RawFont each is found.

.nf
       Format:

         @DefineTypeCase(TypeCase-name,
            list-of-character-definitions)
.fi

(Advanced command.)

.B \ DEVICE
Specifies the printing device for the output.  (See the "Devices" entry
for a list of available devices)

.nf
       Format:

         @Device(device-name)
.fi


.B \ DISABLE
Disables the sending of text to the indicated generated portion.

.nf
       Format:

         @Disable(portion-name)
.fi


.SH "EXAMPLES"

.nf
      1. @Disable(Contents)

         This command will suppress the processing of the Table
         of Contents.

      2. @Disable(Index)

         This command will suppress the processing of the Index.
.fi


.B \ END
Marks the end of the specified environment.  See also @Begin.
.nf
       Format:

         @End(Environment)
.fi


.B \ EQUATE
Specifies a synonym "NewName" for an existing Scribe command or
environment named "OldName".  "Equate" is not allowed as "NewName".

.nf
       Format:

         @Equate(NewName=OldName)
.fi


.B \ ERROR
Prints "delimited-text" on your terminal when Scribe processes the
@Error command.  The error message also appears in the error log (.ERR)
file.  Carriage returns must be included explicitly.  In case
statements, @Error can be used in conjunction with @Abort to end Scribe
runs gracefully.

.nf
       Format:

         @Error(delimited-text)
.fi


.B \ EXPAND
The string "text" is evaluated so that parameter substitution can be
performed.  The evaluated text then replaces the @Expand command in the
macro body, where it will be evaluated again when the macro is expanded.
Use in macro templates only.

.nf
       Format:

         @Expand(text)
.fi


.B \ FIRSTREF
If the specified "counter" has the Recompute attribute, and there are
several instances of "counter" on a page, @FirstRef prints the number of
the first counter on that page.  Otherwise, @FirstRef is identical to
@Ref.  Useful when creating dictionary-style headers and footers.  See
@FirstTitle.
(See the Page_Headings subtopic for details.)

.nf
       Format:

         @FirstRef(counter-name)
.fi

(Advanced command.)

.B \ FIRSTTITLE
If the specified "counter" has the Recompute attribute, and there are
several instances of "counter" on a page, @FirstTitle prints the title
of the first counter on that page.  Otherwise, @FirstTitle is identical
to @Title.  Useful when creating dictionary-style headers and footers.
See @FirstRef.
(See the Page_Headings subtopic for details.)
.nf
       Format:

         @FirstTitle(counter-name)
.fi

(Advanced command.)

.B \ FONTFAMILY
Requests the use of a particular set of fonts for this document.  Use in
Database files only.

.nf
       Format:

         @FontFamily(FontFamily-name)
.fi

(Advanced command.)

.B \ FOOT
Places the text in a footnote, numbers it, and inserts an appropriate
footnote number in the text.
.nf
       Format:

         @Foot(text-of-footnote)
.fi


.B \ FORM
Defines a macro "name" with any number of parameters.  (See the "Names"
subtopic of the "Syntax_Summary" entry for proper syntax)

.nf
       Format:

         @Form(name=delimited-definition-string)
.fi


.SH "EXAMPLE"

.nf
       @Form[ByLine="@Begin(Flushright)
                      Today's Story: @Parm(NewsTitle)
                      by
                      @Parm(Author)
                      @End(Flushright)
             "]

        The command: @Byline[newstitle="A Better Economy?",
                              author="J. Burton"]
        will produce:

                           Today's Story: A Better Economy
                                                        by
                                                 J. Burton
.fi


.B \ GENERATE
Sets up the generated portion "portion-name" with an optional file
extension, to receive text with subsequent @Send and @SendEnd commands.

.nf
       Format:

         @Generate(portion-name=delimited-extension)
.fi

(Advanced command.)

.B \ GOTO
Repositions the text cursor to be the given distance from the global
left margin.  If this new position is to the left of the current cursor
position, a new line is started.

.nf
       Format:

         @GoTo(horizontal-distance)
.fi

(Advanced command.)

.B \ GRAPHIC
Used to place a graphic of the specified "height" and "width" within the
text of a document.  Does not cause line or paragraph breaks.  "Device1"
through "deviceN" are device names.  If any of them match the current
device, the corresponding "delimited filename" is used, which is the
file containing the picture.  "Else" is an optional parameter that
specifies the graphics file to use if none of the "deviceN's" are
matched.  (See the "Graphics" entry for more information.)

.nf
       Format:

         @Graphic(Height=height,Width=width, device1=delimited-filename,
         device2=delimited-filename,..., deviceN=delimited-filename,
         Else=delimited-filename)
.fi


.I \ FOR_POSTSCRIPT_DEVICES
There are six additional parameters available for use within the
@Graphic command for PostScript devices only:

.nf

    BoundingBox   Specifies precise positioning of the graphic image
                  relative to the space provided for it. Used when
                  "ScaleToFit" is specified. If "Height" and "Width"
                  are omitted, Scribe will try to determine them from
                  the BoundingBox specification. Takes a value from
                  the set:          {Bottom, File, Top}
                  or can take two or four user-specified-coordinates.

                  Bottom: Tells Scribe the graphic image is in the
                          lower left-hand corner of the graphic page.
                  File:   Scribe uses the BoundingBox declared in the
                          PostScript graphics file.
                  Top:    Tells Scribe the graphic image is in the
                          upper left-hand corner of the graphic page.

    Clip          Instructs Scribe to cut a designated portion of the
                  graphics picture specified by the values for "Height"
                  and "Width".

    FontMapping   Takes as a value the "name" of a font-mapping defined
                  by the @DefineFontMapping command.  Allows the user
                  to specify a particular mapping from fonts used in the
                  graphics file to fonts used in the document.

    Magnify       Specifies a factor of magnificaton. Values greater
                  than one indicate enlargement, values less than one
                  indicate reduction.  Values for "Height" and "Width"
                  must change accordingly by the magnification factor.

    Rotate        Specifies rotation of graphics file.  Positive values
                  indicate clockwise rotation, negative values indicate
                  counter-clockwise rotation. Values must be specified
                  in multiples of 90. Values for "Height" and "Width"
                  may need changed if graphic is rotated to a position
                  where the values have become switched.

    ScaleToFit    Instructs Scribe to scale the graphic to fit in a
                  frame specified by the "Height" and "Width".
                  BoundingBox must be used to specify the size of the
                  original graphics file.
.fi


.B \ HINGE
Marks those positions in a grouped environment where Scribe is permitted
to start a new page.

.nf
       Format:

         @Hinge()
.fi


.B \ HPOS
Causes the text cursor to be repositioned at the given distance from the
global left margin, even if this causes the current line to be
overprinted.  Used in Database files only.

.nf
       Format:

         @Hpos(horizontal-distance)
.fi

(Advanced command.)

.B \ HSP
Causes a blank space of the requested width to be placed in the document
file at that point. Intended for use only within Database files.  (See
the "Syntax_Summary" entry for units of measure listed in
"Numbers_and_Distances")

.nf
       Format:

         @Hsp(horizontal-distance)
.fi


.B \ IMBED
If "parameter-name" is present in this invocation of the Form, then
@Imbed evaluates to "delimited-defined-text".  If "parameter-name" is
not used and therefore is undefined, @Imbed evaluates to
"delimited-undefined-text".  Use in macro templates only.

.nf
       Format:

         @Imbed(parameter-name, Def=delimited-defined-text,
                  Undef=delimited-undefined-text)
.fi


.B \ INCLUDE
Includes the contents of another file in a manuscript file at this
point.
.nf
       Format:

         @Include(name-of-a-file)
.fi


.B \ INDEX
Makes an entry in the Index when the command appears in a document that
allows indexing; otherwise the @Index command is ignored.

.nf
       Format:

         @Index(text-to-be-indexed)
.fi


.B \ INDEXENTRY
Makes an entry in the Index that will be alphabetized under
"delimited-sort-key", but which will have entry text "delimited-text-of-
entry".  If the optional "Number" parameter is present, then
"delimited-number" will be used as the page reference number.  If the
"Number" parameter is present, but no "delimited-number" is provided,
Scribe will use the current page number.  If the "Number" parameter is
not provided, no page number will be printed in the index.

.nf
       Format:

         @IndexEntry(Key=delimited-sort-key,
              Entry=delimited-text-of-entry, Number=delimited-number)
.fi


.SH "EXAMPLES"

.nf
    1. @Indexentry(Key="Help Facilities",
                    Entry="Scribe Help File")

       This command will produce the underlined index entry
       "Scribe Help File" alphabetized under "Help Facilities"
       with no page number.

    2. @Indexentry(Key="Misleading Entries",
                    Entry="Fancy Indexing",
                    Number)

       This command will produce the index entry "Fancy Indexing"
       alphabetized under "Misleading Entries" with the current
       page number.

    3. @Indexentry(Key="Joy of Cooking",
                    Entry="@i[Joy of Cooking]",
                    Number=37)

       This command will produce the italicized index entry
       "Joy of Cooking" alphabetized under "Joy of Cooking"
       with page number 37 (regardless of the current page number).
.fi


.B \ INDEXSECONDARY
Produces a two-level index entry, with the secondary term indented under
the primary term.  The secondary term is numbered, but the primary term
is not.  Available only when an @LibraryFile(MultiLevelIndex) command
has been included in a document.
.nf
       Format:

         @IndexSecondary(Primary=delimited-primary-index-term,
         Secondary=delimited-secondary-index-term)
.fi


.B \ ITAG
Identical to @Tag(codeword), except that it does not ever print the tag
in the document.

.nf
       Format:

         @Itag(codeword)
.fi


.B \ LABEL
Defines "codeword" as a cross reference representing the current place
in the document.  See @Ref and @PageRef.  (See the "Tags_and_Labels"
subtopic in the "Syntax_Summary" entry for proper syntax.)
.nf
       Format:

         @Label(codeword)
.fi


.B \ LIBRARYFILE
Causes the Database to be searched for a library file, which is read in
at the point of the command.  Use @Include inside manuscript files; for
the most part, @LibraryFile is intended for use within Database files
only.

.nf
       Format:

         @LibraryFile(name-of-library-entry)
.fi


.B \ LOCALSTRING
Defines "name" as a text string with the contents equal to the delimited
string "delimited-value" for the duration of the current environment.
The definition disappears when the environment is exited.  See @Value
and @String.  (See the "Names" subtopic of the "Syntax_Summary" entry
for proper syntax)

.nf
       Format:

         @LocalString(name=delimited-value)
.fi


.B \ MAKE
Specifies the document type definition to use.  (See the
"Document_Types" entry for a complete list.)

.nf
       Format:

         @Make(document-type)
.fi


.B \ MARKBASELINE
Sets the baseline for the unit of text.  Takes an argument from the set
{Baseline, Below, Above}.  Baseline sets the baseline at the current
line's base.  Below sets the baseline between the current line's base
and the next line of text.  Above sets the baseline between the current
line's base and the previous line.  Baseline is the default when no
argument is specified.

.nf
       Format:

         @Markbaseline()
.fi

(Advanced command.)

.B \ MARKER
Identifies and separates Database entries.  May never appear in a
manuscript file.  Use in Database files only.

.nf
       Format:

         @Marker(file-type, entry-name, device-qualification)
.fi

(Advanced command.)

.B \ MATHBAR
Draws a horizontal line equal in width to the width of the MathemArea.

.nf
       Format:

         @MathBar()
.fi

(Advanced command.)

.B \ MESSAGE
Prints the message on the user's terminal at that particular point in a
Scribe compilation.

.nf
       Format:

         @Message(text-of-message)
.fi


.B \ MODIFY
Redefines or adds attributes to the environment or counter "Name" for
the duration of the current environment.

.nf
       Format:

         @Modify(name, list-of-attributes-and-values)
.fi


.B \ NEWCOLUMN
Breaks the current column and starts at the top of a new one.  In
single-column text, this command is equivalent to @NewPage.

.nf
       Format:

         @NewColumn()
.fi

.B \ NEWPAGE
Breaks the current line and starts at the top of a new page (unless it
is already at the top of a fresh page, in which case nothing further
happens) if "n" is zero or not specified.  Leaves "n" blank pages and
starts at the top of a new page if "n" is specified.  @NewPage is
immediate.  It does not fill the previous page.  See also @BlankPage.

.nf
       Format:

         @NewPage(n)
.fi


.B \ NEXTENTRY
Begins the next entry of a row in a table.  (See the "Standard_Tables"
entry for more information)

.nf
       Format:

         @NextEntry
.fi


.B \ NOTE
Like @Foot, but produces an endnote in the Notes portion of the
document.

.nf
       Format:

         @Note(text-of-endnote)
.fi


.B \ OVP
Outputs "text" to be overprinted and positions the formatting cursor at
the beginning of the text.

.nf
       Format:

         @Ovp(text)
.fi

.SH "EXAMPLES"

.nf
    1. @Ovp(O)/    will overprint the capital "O" with /.

    2. @Ovp(S)|    will overprint the capital "S" with |.

    NOTE:  The Ovp command is not designed to automatically center
           the overprinting text.
.fi


.B \ PAGEFOOTING
Specifies a footing to be put at the bottom of each page, beginning with
the next page.  "Immediate" specifies that the footing take effect on
the current page.  "Odd" or "Even" specifies the footing for odd- and
even-numbered pages in a doublesided document.  "Line" indicates text
for second (and subsequent) lines of a multiline footing.  (See the
"Page_Headings" entry for more information.)

.nf
       Format:

         @Pagefooting(Left=delimited-text, Right=delimited-text,
              Center=delimited-text, Immediate, Even, Odd,
              Line=delimited-text-line)
.fi


.B \ PAGEHEADING
Specifies a footing to be put at the bottom of each page, beginning with
the next page.  "Immediate" specifies that the footing take effect on
the current page.  "Odd" or "Even" specifies the footing for odd- and
even-numbered pages in a doublesided document.  "Line" indicates text
for second (and subsequent) lines of a multiline footing.  (See the
"Page_Headings" entry for more information.)

.nf
       Format:

         @Pageheading(Left=delimited-text, Right=delimited-text,
              Center=delimited-text, Immediate, Even, Odd,
              Line=delimited-text-line)
.fi

.B \ PAGEREF
Puts into the text the number of the page on which "codeword" was
defined by an @Label or @Tag command.

.nf
       Format:

         @PageRef(codeword)
.fi


.B \ PARM
This command is replaced by the value of the parameter "name" when the
Form is expanded.  TextForms have only a single unnamed parameter which
can be referenced with @Parm(Text).  Use in macro templates only.

.nf
       Format:

         @Parm(name)
.fi

.I \ PARMQUOTE
Like @Parm, except that the argument delimiters are put on the named
parameter.  Use in macro templates only.

.nf
       Format:

         @ParmQuote(codeword)
.fi


.I \ PARMREF
Like @Ref, except that it is evaluated when the macro is expanded.
Use in macro templates only.

.nf
       Format:

         @ParmRef(codeword)
.fi
.I \ PARMSET
Like @Set except that the setting of the counter takes place when
the macro is expanded, not when the command is initially read.  Use
in macro templates only.

.nf
       Format:

         @ParmSet(counter-name=value)
.fi


.I \ PARMVALUE
Like @Value, except that the evaluation takes place when the macro
is expanded, not when the command is read.  Use in macro templates
only.

.nf
       Format:

         @ParmValue(name)
.fi

.B \ PART
Indicates that a manuscript file is part of a multiple part document.
Must be the first command in a part file.

.nf
       Format:

         @Part(part-name, Root=delimited-root-file-spec)
.fi


.B \ PICTURE
Used to place a digitized picture into the document with paragraph
breaks before and after.  "Device1" through "deviceN" are device names.
If any of them match the current device, the corresponding "delimited
filename" is used, which is the file containing the picture.  "Else" is
an optional parameter that specifies the graphics file to use if none of
the "deviceN's" are matched.  (See the "Graphics" entry for more
information.)

.nf
       Format:

         @Picture(Height=height, device1=delimited-filename,
         device2=delimited-filename,..., deviceN=delimited-filename,
         Else=delimited-filename)
.fi


.B \ PLACE
Causes the text of the named portion that has been assembled so far to
be placed in the document at this point.

.nf
       Format:

         @Place(portion-name)
.fi


.B \ PROCESS
@Process(Bibliography) causes the Bibliography entries to be processed
and inserted into the document at this point.  @Process(PageHeadings)
causes both the page headings and footings to be re-evaluated as if the
Immediate parameter had been used in the @PageHeading and @PageFooting
commands.

.nf
       Format:

         @Process(parameter)
.fi


.B \ QUOTE
@Quote evaluates to the string "text", even if "text" contains embedded
parameter substitutions (which are therefore not made).  Use in macro
templates only.

.nf
       Format:

         @Quote(text)
.fi

(Advanced command.)

.B \ RAWFONTDIRECTORY
Names an .RFD file for Scribe to search for the directory specification
of font files.  Use in Database files only.

.nf
       Format:

         @RawFontDirectory(RawFont-directory-name)
.fi

(Advanced command.)

.B \ RAWFONTLOCATION
Lists RawFont names that were used in .FON and .TYP files and the name
and location of the corresponding font.

.nf
       Format:

         @RawFontLocation(RawFont-name=complete-raster-font-filename)
.fi

(Advanced command.)
.B \ REF
Retrieves the value of the cross-reference marker "codeword" (defined
with an @Label or @Tag command) and places it in the document at that
point.

.nf
       Format:

         @Ref(codeword)
.fi


.B \ RFSTR
Places "text" flushed "right" against the "global" right margin.
Intended for Database use only.

.nf
       Format:

         @Rfstr(text)
.fi

(Advanced command.)

.B \ RMSTR
Places "text" flushed "left" against the prevailing "right" margin.
Intended for Database use only.

.nf
       Format:

         @Rmstr(text)
.fi

(Advanced command.)

.B \ SEEALSO
Produces a two- or three-level index entry with the "Other" term
prefaced with the phrase "See also".  (The number of levels depends on
whether or not the same primary term is references with an
@IndexSecondary command.  Neither term receives a number.  Valid only
when an "@LibraryFile(MultiLevelIndex)" command has been included in a
document.

.nf
       Format:

         @SeeAlso(Primary=primary-index-term, Other=reference-term)
.fi


.B \ SEND
Sends the text of "delimited-string" to the named generated portion
(e.g. ``Contents'' or ``Outline'').  An end-of-line character is always
appended to the end.  Intended for Database use only.

.nf
       Format:

         @Send(Portion=delimited-string)
.fi

(Advanced command.)

.B \ SENDEND
Sends the text of delimited-string to the end of the named generated
portion.  Intended for Database use only.

.nf
       Format:

         @SendEnd(Portion=delimited-string)
.fi

(Advanced command.)

.B \ SET
Sets the specified counter to the "value" or changes the counter by the
designated value if signed.

.nf
       Format:

         @Set(counter-name=value)
.fi


.SH "EXAMPLES"

.nf
    1. @Set(Chapter=4)
       This command sets the current value of Chapter to 4.  The
       next invocation of the @Chapter command will produce 5.

    2. @Set(Page=3)

       This command sets the current page to 3; the page number
       in the pageheading or pagefooting will not be affected
       unless the @Process(Pageheadings) command is issued.
       The next page break will produce page 4 in the page heading
       or footing (no @Process command is needed).
.fi

Site Defines values for two strings available via the @Value command,
specifies the device support available and anti-theft information,
informs Scribe where to look for Database files and user files, tells
Scribe where confidential font information for the Xerox Dover printer
is located, specifies the message that appears when Scribe is invoked,
and supplies several default values used if no valid value is specified
in a Database file or in the .MSS file.  Use only in the Site file.

.nf
       Format:
         @Site(SiteCode=delimited-string, SiteName=delimited-string,
              SiteIdent=delimited-string,
              DatabaseFileTemplate=delimited-string,
              UserFileTemplate=delimited-string,
              FontWidthsFile=delimited-string,
              SignonMessage=delimited-string,
              DefaultFont=delimited-string,
              DefaultDevice=delimited-string,
              DefaultDocType=delimited-string,
              DefaultRefFmt=delimited-string)
.fi

(Advanced command.)

.B \ SPECIALFONT
Declares the "n'th" special font.  Meaningful only for devices capable
of changing fonts.

.nf
       Format:

         @SpecialFont(Fn=delimited-file-spec)
.fi

.SH "EXAMPLES"

.nf
    1. @SpecialFont[F0="Helvetica"]

       Usage:  @F0[This text will be printed in Helvetica]


    2. @SpecialFont[F1="Courier"]

       Usage:  @Begin[F1]
               This text will be printed
               in the fixed-width font called Courier
               @End[F1]
.fi


.B \ SPECTRUM
Specifies the spectrum to use for the document.

.nf
       Format:

         @Spectrum(spectrum-name)
.fi

(Advanced command.)

.B \ STANDARDTABLE
Defines a standard table named "text" with the number of columns
specified by "Columns".  "Parameters" are optional and control text
positioning, headings, column widths, horizontal alignment, and lines
within and around the table.  (See the "Standard_Tables" entry for more
information.)

.nf
       Format:

         @StandardTable(Name=text,Columns=number-of-columns,
              parameter1, parameter2, ...)
.fi


.B \ STARTOVERFLOW
Signals the beginning of an overflow region for a counter (for instance,
the beginning of a set of change pages).  "Counter-name" is the name of
a counter that has been modified to contain an Overflow attribute.  If
"qualifier" is Immediate, the overflow counter is used the next time
"counter-name" is incremented.  If "qualifier" is Odd, the overflow
counter is used the next time the value of "counter-name" is an odd
number.  If "qualifier" is Even, the overflow counter is used the next
time the value of "counter-name" is an even number.  Finally, if
"qualifier" is an arbitrary number, the overflow counter is used the
next time the value of "counter-name" matches that number.  See
@StopOverflow.

.nf
       Format:

         @StartOverflow(counter-name qualifier)
.fi

(Advanced command).

.B \ STOPFOOTING
Causes Scribe to stop printing a table footing that has the Continued
attribute.  "Name" is the value assigned to the Name parameter of an
@TableFooting command.
.nf
       Format:

         @StopFooting(name)
.fi


.B \ STOPHEADING
Causes Scribe to stop printing a table heading that has the Continued
attribute.  "Name" is the value assigned to the Name parameter of an
@TableHeading command.

.nf
       Format:

         @StopHeading(name)
.fi


.B \ STOPOVERFLOW
Signals the end of an overflow region.  "Counter-name" is the name of
the counter specified in an @StartOverflow command.  If "qualifier" is
Immediate, the overflow counter is discontinued the next time that
counter is incremented.  If "qualifier" is Odd, the overflow counter is
discontinued the next time its value is an odd number.  If "qualifier"
is Even, the overflow counter is discontinued the next time its value is
an even number.  Finally, if "qualifier" is an arbitrary number, the
overflow counter is discontinued the next time its value matches that
number.  See @StartOverflow.

.nf
       Format:

         @StopOverflow(counter-name qualifier)
.fi

(Advanced command.)

.B \ STRADDLE
"Erases" a line above a cell in a table, a line below the cell, or the
lines above and below the cell.  "Parameter" may be one of the
following: {Above, Below, or Around}.  Cells above and below a straddled
cell must contain "complementary" @Straddle commands.  For instance, if
a cell contains an @Straddle(Below) command, the cell below it must
contain an @Straddle(Above) or @Straddle(Around) command.
.nf
       Format:

         @Straddle(parameter)
.fi

(Advanced command.)

.B \ STRING
Defines "name" as a text string with the contents equal to
"delimited-value".  See @Value and @LocalString.  (See the "Names"
subtopic of the "Syntax_Summary" entry for proper syntax)

.nf
       Format:

         @String(name=delimited-value)
.fi


.B \ STYLE
Sets the @Style parameter named "parameter" equal to "value".  (See the
"Style_Parameters" entry for a complete list of available parameters.)
.nf
       Format:

         @Style(parameter=value)
.fi


.B \ TABCLEAR
Clears all tab stops.

.nf
       Format:

         @TabClear()
.fi


.B \ TABDIVIDE
Sets tabs to divide the text body into "n" columns.

.nf
       Format:
         @TabDivide(n)
.fi


.B \ TABLECAPTION
Places "delimited-text" in a caption on the first page of a standard or
user-defined table, on all pages of the table, or on all but the first
page of the table (if both Immediate and Continued are specified).
Above places the caption(s) at the top of the table; Below places the
captions(s) at the bottom.  Scribe does not support Immediate and Above
in one @TableCaption command.  ContentsOnce generates one entry in the
Table of Contents; ContentsAll generates an entry for each caption
printed.  Count increments the caption on successive pages using the
default table counter; Counter increments the caption on successive
pages using "counter-name".

.nf
       Format:

         @TableCaption(Immediate,Continued,Above,Below,
            ContentsOnce,ContentsAll,Count,Counter=counter-name,
            Line=delimited-text)
.fi

.B \ TABLEFOOTING
Places a footing at the bottom of a table. There are two forms of this
command depending upon its usage in user-defined tables or standard
tables.  Choose the appropriate topic.

.I \ STANDARD_TABLES
Form of the command for use in standard tables.  Places a footing
within a table.  The optional "Immediate" parameter sets the footing
at the bottom of the Table on the page where the command is given.
"Continued", also optional, sets the footing at the bottom of the
table when and if it continues on successive pages.  "RowFormat"
takes either one of the two standard footings, "TopHeading" or
"ColumnHeadings", with the name assigned in the @StandardTable
command as a prefix.  In the form below, the plus sign is not
actually used in the command; it appears here only to indicate that
the name of the table and the name of the footing are combined.
"Delimited-text" is the text to be set in this particular footing;
separate column entries with an @\ or @NextEntry command.  On any
page, the footings will normally appear in the order in which the
commands to specify them were given.  There is one exception to
this:  a footing specified with the "Immediate" parameter and the
"Above" parameter will appear ABOVE footings that were not so
specified, such as footings specified with the "Continued" parameter
on previous pages, or footings specified on the current page with
the "Immediate" parameter but without the "Above" parameter.

.nf
       Format:

         @TableFooting(Immediate, Continued,
              Rowformat=name+kind-of-heading,
              Line=delimited-text),Above
.fi


.I \ USER_DEFINED_TABLES
Form of the command in user-defined tables.  Places a footing within
a table.  The optional "Immediate" parameter sets the footing at the
bottom of the Table on the page where the command is given.
"Continued", also optional, sets the footing at the bottom of the
table when and if it continues on successive pages.  "Format-name"
must be defined with an @DefineRowFormat command.  "Delimited-text"
is the text to be set in this particular heading; separate column
entries with an @\ or @NextEntry command.  On any page, the footings
will normally appear in the order in which the commands to specify
them were given.  There is one exception to this:  a footing
specified with the "Immediate" parameter and the "Above" parameter
will appear ABOVE footings that were not so specified, such as
footings specified with the "Continued" parameter on previous pages,
or footings specified on the current page with the "Immediate"
parameter but without the "Above" parameter.
(See the "Standard_Tables" entry for more information.)

.nf
       Format:

         @TableFooting(Immediate, Continued, Rowformat=format-name,
               Line=delimited-text),Above
.fi


.B \ TABLEHEADING
Places a heading in a table. There are two forms of this command
depending upon its usage in user-defined tables or standard tables.
Choose the appropriate topic.

.I \ STANDARD_TABLES
Form of the command for use in standard tables.  Places a heading
within a table.  The optional "Immediate" parameter sets the heading
where the @TableHeading command appears.  "Continued", also
optional, sets the heading at the top of the table when and if it
starts on successive pages.  "RowFormat" takes either one of the two
standard headings, "TopHeading" or "ColumnHeadings", with the name
assigned in the @StandardTable command as a prefix.  The plus sign
is not actually used in the command; it appears here only to
indicate that the name of the table and the name of the heading are
combined.  "Delimited-text" is the text to be set in this particular
heading; separate column entries with an @\ or @NextEntry command.

.nf
       Format:

         @TableHeading(Immediate, Continued,
              Rowformat=name+kind-of-heading,
              Line=delimited-text)
.fi


.I \ USER_DEFINED_TABLES
Form of the command in user-defined tables.  Places a heading within
a table.  The optional "Immediate" parameter sets the heading where
the @TableHeading command appears.  "Continued", also optional, sets
the heading at the top of the table when and if it starts on
successive pages.  "Format-name" must be defined with an
@DefineRowFormat command.  "Delimited-text" is the text to be set in
this particular heading; separate column entries with an @\ or
@NextEntry command.  (See the "Standard_Tables" entry for more
information.)

.nf
       Format:

         @TableHeading(Immediate, Continued, Rowformat=format-name,
               Line=delimited-text)
.fi


.B \ TABLEID
Gives the table the "name" in the .AUX file.  Used to calculate column
widths during Scribe processing.  (See the "Standard_Tables" entry for
more information.)

.nf
       Format:

         @TableID(name)
.fi


.B \ TABSET
Sets a tab at the horizontal positions indicated.  Multiple tabs may be
specified in one @TabSet command, with "tab-stop-positions" separated by
commas.  Distances are computed with respect to the prevailing left
margin.  Existing tabs are not erased.  When the stop value is signed
(for example, + 1inch), the new stop is set relative to the preceding
stop in the list (or to the left margin in the case where the first
value in the list is signed).

.nf
       Format:

         @TabSet(tab-stop-positions)
.fi


.SH "EXAMPLES"
.nf
    1. @Tabset[1in, 2in, 3in]

       This command will set tab stops at 1 inch, 2 inches and 3 inches
       from the prevailing left margin.

    2. @Tabset[1in, 2in, +1.5in]

       This command will set tab stops at 1 and 2 inches from the left
       margin of the current environment and a third tab 1.5 inches
       from the second tab setting (making the third tab setting
       3.5 inches from the prevailing left margin).

.fi


.B \ TAG
Defines "codeword" as a cross-reference label representing the position
and number of an equation, theorem, figure, or table.  For use with
@Ref.  (See the "Tags_and_Labels" subtopic in the "Syntax_Summary" entry
for proper syntax.)

.nf
       Format:

         @Tag(codeword)
.fi


.B \ TEXTFORM
Defines a text form called "name" with one argument, @Parm(Text), which
must be included in the "delimited-definition-string".  (See the "Names"
subtopic of the "Syntax_Summary" entry for proper syntax)

.nf
       Format:

         @TextForm(name=delimited-definition-string)
.fi


.SH "EXAMPLE"

.nf
      @Textform[IIT="@i<@Parm(text)>
                      @Index<@Parm(text)>"]

      The textform call @IIT[Scribe Help Facility] will
      italicize the words "Scribe Help Facility" and also
      create an index entry for "Scribe Help Facility".
.fi


.B \ TITLE
Inserts into the text the title currently associated with
"counter-name", which could be a any sectioning counter like Chapter or
Section.

.nf
       Format:

         @Title(counter-name)
.fi


.B \ USE
Tells Scribe to look in "delimited-file-spec" for the desired component.
Component names are AuxFile, Bibliography, Database, and HyphenDic.  The
"delimited-file-spec" parameter for Database is actually a directory
specification and not a file specification.  More than one @Use
specification is permitted for Bibliographies consisting of multiple
files.

.nf
       Format:

         @Use(component=delimited-file-spec)
.fi


.B \ VALUE
Inserts the value currently associated with the string "name".  Scribe
provides some predefined strings (see the "Predefined_Strings" entry for
a complete list); the user can define "name" with an @String command.

.nf
       Format:

         @Value(name)
.fi
.B \ VERTICALSPACE
If the @Style command has the parameter VerticalJustification
Controlled, Scribe attempts vertical justification of a page or column
by adding blank space where the @VerticalSpace command is specified.

.nf
       Format:

         @VerticalSpace
.fi


.SH "DEVICES"
The terms on the left are used with an @Device command to select an
output device.  This command must be placed at the beginning of an .MSS
file.

.nf
      Agile              Agile A1 Series Data Terminal
      AJxxx              See the "AJxxx" entry for supported models
      CAT4               GSI CAT-4 Photocomposer
      CG8600             Compugraphic 8600
      CRT                CRT Display
      Diablo             See the "Diablo" entry for supported models
      Dover              Xerox Dover Printer
      Facit              Facit 4560 printer
      File               Simple on-line documentation file
      Gigi               DEC VK100 (GIGI) Terminal
      GP300              Philips GP 300
      GSI                GSI CAT-8 Photocomposer
      Imagen             See the "Imagen" entry for supported models
      LA36               DECwriter II
      LaserJet           Hewlett-Packard LaserJet
      LaserJetPlus       Hewlett-Packard LaserJet+
      LG1200             QMS Lasergrafix 800, 1200, & 2400
      LGP1               Symbolics LGP-1
      LN0x               See the "LN0x" entry for supported models
      LPT                Line Printer
      Omnitech           Mergenthaler Omnitech/2000
      PagedFile          "File" but with page marks
      PostScript         See the "PostScript" entry for supported models
      Printronix         Printronix Printer
      Santec             See the "Santec" entry for supported models
      SpinWriter         NEC SpinWriter Terminal
      Talaris            Talaris 800, 1200, & 2400
      TIxxx              See the "TIxxx" entry for supported models
      VIP                Mergenthaler Linotype VIP
      X2700              See the "X2700" entry for supported models
      X9700              Xerox 8700, 9700


      "Agile, DEC, Diablo, HPLaserJet, Imagen, Imprint-10, PostScript,
      QMS, Symbolics, Talaris  and  Xerox" are trademarks of organi-
      zations other than Scribe Systems Inc.  Please refer to the
      "Scribe User Manual" for full details.

.fi


.B \ AJXXX

.nf
      AJ832              Anderson-Jacobsen 832
      AJ833              Anderson-Jacobsen 833
.fi


.B \ DIABLO
.nf
      Diablo             Diablo 1620 HyTyper Terminal
      Diablo1640         Diablo 1640 HyTyper Terminal
      Diablo1650         Diablo 1650 HyTyper Terminal
.fi


.B \ IMAGEN

.nf
      Imagen300          Imagen 8/300
      Imagen12-300       Imagen 12/300
      Imagen480          Imagen 5/480
      Imprint10          Imagen Imprint-10
.fi


.B \ LN0X

.nf
      LN01               DEC LN01, LN01S
      LN03               DEC LN03
.fi

.B \ POSTSCRIPT

.nf
      MacPostScript      PostScript with Macintosh graphics created with
                         LaserPrep 2.9 and earlier installed on the Mac.
      Mac31PostScript    PostScript with Macintosh graphics created with
                         LaserPrep 3.1 installed on the Mac.
      Mac40PostScript    PostScript with Macintosh graphics created with
                         LaserPrep 4.0 or 5.0 installed on the Mac.
      Mac52PostScript    PostScript with Macintosh graphics created with
                         LaserPrep 5.2 installed on the Mac.
      PostScript         All PostScript devices.
.fi


.B \ SANTEC

.nf
      Santec             Santec S700 Variflex
      SantecESL          Santec S700 Variflex with
                                  Escape Sequence Language
.fi

.B \ TIXXX

.nf
      TI700              TI Silent 700
      TI725              TI Silent 725
.fi


.B \ X2700

.nf
      X2700              Xerox 2700
      X2700II            Xerox 2700 Model II
.fi



.SH "DOCUMENT_TYPES"
To select a document type, use an @Make command, with the name of the
desired document type as a value, in the .MSS file before the first
text.  For example,

          @Make(Report)

Some document types have variant forms.  To use those forms, follow the
syntax of this example:

          @Make(Article,Form 1)

After a short description of each document type, any specific
environments, forms, and counters defined for the document type that a
user might include in a .MSS are listed.  (Only a few of the document
types do not define specific environments.)  The lists do not include
the basic environments available for all document types and documented
in the "Scribe User Manual".  (See the "Environments" subtopic in the
"Sectioned_Documents" entry for a list of environments available in all
sectioned document types.)

.B \ ARTICLE
Simplest sectioned document.  Produces numbered Sections, SubSections,
Paragraphs, and Appendixes.  Figures and Tables are numbered within
Sections.  Has a Title Page and a Table of Contents, but no Index.

.nf
                Appendix                 Sec
                AppendixSection          Section
                Chapter                  SubSec
                Para                     SubSection
                Paragraph                UnNumbered
                PrefaceSection
.fi


.B \ ARTICLE_FORM1
Variation of Article with Sections that are not numbered.

.nf
                Appendix                 Section
                Chapter                  SubSec
                Paragraph                SubSection
                PrefaceSection           UnNumbered
                Sec
.fi


.B \ BIBLIOGRAPHY
Bibliography only.  All other document types can produce a Bibliography,
but this document type provides a Bibliography without the accompanying
document.  Along with @Style(BibSelect Complete), produces a full
bibliography listing.

.B \ BROCHURE
Open, informal layout with generous white space.  Provides numbered
Chapters, Sections, SubSections, Paragraphs, Appendixes, and
AppendixSections.  Has a Title Page and a Table of Contents, but no
Index.  Suitable for producing booklets.

.nf
                BibList                  PrefaceSection
                Chap                     Sec
                Chapter                  Section
                MajorPart                SubSec
                Para                     SubSection
                Paragraph                UnNumbered
.fi

.B \ GUIDE
Similar to Brochure but designed to be printed in a handbook-size
format.

.nf
                Appendix                 PrefaceSection
                AppendixSection          Sec
                Chap                     Section
                Chapter                  SubSec
                Para                     SubSection
                Paragraph                UnNumbered
.fi


.B \ LETTER
Produces a business letter to be printed or copied on letterhead
stationary.

.nf
                Address                  Notations
                Body                     PostScript
                Closings                 PostScripts
                Ends                     PS
                Greeting                 ReturnAddress
                Initials                 Signature
.fi


.B \ LETTERHEAD
Produces a business letter and provides for the letterhead to be drawn.
If the device cannot draw the letterhead, Scribe issues an error message
requesting use of the Letter document type.

.nf
                Address                  Notations
                Body                     PostScript
                Closings                 PostScripts
                Ends                     PS
                Greeting                 ReturnAddress
                Initials                 Signature
.fi


.B \ MANUAL
Sectioned document providing numbered Chapters, Sections, SubSections,
Paragraphs, Appendixes, and AppendixSections.  Has a Title Page, Table
of Contents, and an Index.

.nf
                Appendix                 Paragraph
                AppendixSection          PrefaceSection
                AppendixSubSection       Sec
                Chap                     Section
                Chapter                  SubSec
                MajorPart                SubSection
                Para                     UnNumbered
.fi


.B \ MANUAL_FORM1
Variation of Manual with numbered Chapters but unnumbered Sections and
SubSections.

.nf
                Appendix                 Paragraph
                AppendixSection          PrefaceSection
                AppendixSubSection       Sec
                Chap                     Section
                Chapter                  SubSec
                MajorPart                SubSection
                Para                     UnNumbered
.fi


.B \ MILSTD837A
Produces a document that conforms to the Military Standard document
837A.

.nf
                Appendix                 Sub1Sec
                Chapter                  Sub2Sec
                PrefaceSection           Sub3Sec
                Sec                      Sub4Sec
                Section                  Sub5Sec
                SubSec                   UnNumbered
.fi


.B \ MIL38784B
Produces a document that conforms to the Military Standard document
Mil-M-38784B.
.nf
               Appendix                 Sub1Para
               AppendixSection          Sub1Paragraph
               AppendixSec              Sub2Para
               AppendixSubSec           Sub2Paragraph
               AppendixSubSection       Sub3Para
               Chap                     Sub3Paragraph
               Chapter                  Sub4Para
               Paragraph                Sub4Paragraph
               Part                     Sub5Para
               PrefaceSection           Sub5Paragraph
               Sec                      UnNumbered
               Section
.fi


.B \ REFERENCECARD
Used for printing pocket reference guides and cards.

.nf
                BB                       ShortDescription
.fi

.B \ REPORT
Sectioned document providing numbered Chapters, Sections, SubSections,
Paragraphs, Appendixes, and AppendixSections.  Has a Title Page and
Table of Contents. No Index.

.nf
                Appendix                 PrefaceSection
                AppendixSection          Sec
                Chap                     Section
                Chapter                  SubSec
                MajorPart                SubSection
                Para                     UnNumbered
                Paragraph
.fi


.B \ REPORT_FORM1
Variation of Report with only its Chapters numbered; Sections and
SubSections are not numbered.

.nf
                Appendix                 PrefaceSection
                AppendixSection          Sec
                Chap                     Section
                Chapter                  SubSec
                MajorPart                SubSection
                Para                     UnNumbered
                Paragraph
.fi


.B \ SLIDES
Makes overhead projector slides.  Font sizes and spacings have been
selected to make the slides maximally visible at normal projection
distances.  Using a device without font sizes large enough for this type
of slide or a device that cannot scale results in a warning message and
proof copies only.

.B \ SLIDES_FORM1
Variation of Slides with small- and medium-sized characters in addition
to the large-sized characters.

.nf
                Big                      Small
                Normal                   Up
.fi


.B \ TEXT
Default document type as Scribe is distributed.  Unindented, justified
paragraphs on numbered pages.  No Table of Contents or Index.
NOTE: Consult with your DBA to see whether or not this document type is
the default document type for your site.

.B \ TEXT_FORM1
Variation of Text with indented paragraphs and double spacing.  Actual
format: @Make(Text,Form 1)

.B \ THESIS
Satisfies the format requirements for a thesis at the local institution.

.nf
                Appendix                 PrefaceSection
                AppendixSection          Sec
                Chap                     Section
                Chapter                  SubSec
                MajorPart                SubSection
                Para                     UnNumbered
                Paragraph
.fi

.SH "ENVIRONMENTS"
The following environments are available in all document types for all
devices.  Additional environments exist, primarily for use in sectioned
documents; see the "Environments" subtopic in the "Sectioned_Documents"
entry for details.

.B \ B
Requests "boldface" printing.

.B \ BOX
Draws a box around all text within it.

.B \ C
Requests "small capital" printing.

.B \ CB
Draws a change bar in the appropriate margin next to all text enclosed
in its delimiters.

.B \ CENTER
Centers each manuscript line in the body of the environment between the
global margins.

.B \ DESCRIPTION
Provides paragraphs with header words in a widened left margin.  Use a
tab command (@\) to separate the header word(s) from the rest of each
paragraph.

.SH "EXAMPLE"

.nf
    Input:

    @Begin(Description)
    Segment@\One of the parts into which something naturally separates
    or is divided; a division, portion, or section.

    Section@\@Multiple[A part that is cut off or separated; a distinct
    part or subdivision of anything, as an object, country, or class.

    The act of subdividing some object into its distinct parts.]
    @End(Description)

    Output:
      Segment         One of the parts into which something naturally
                      separates or is divided; a division, portion, or
                      section.

      Section         A part that is cut off or separated; a distinct
                      part or subdivision of anything, as an object,
                      country, or class.

                      The act of subdividing some object into its
                      distinct parts.
.fi


.B \ DISPLAY
Displays each manuscript line that is inside the body of the
environment.  Output line breaks correspond to manuscript-file line
breaks.  Left margin widened.

.B \ ENUMERATE
Numbers each paragraph within the body.  Sets list off from rest of text
with spacing and wider margins.

.B \ EXAMPLE
For examples of computer input and output.  Uses fixed-width typeface.
Breaks lines as in manuscript file.  Sets example off with spacing and
wider margins.

.B \ FILEEXAMPLE
Provides environment for showing examples of computer file contents.
Breaks lines as in manuscript file but does not truncate long lines.

.B \ FLUSHLEFT
Aligns the first character in each manuscript line with the global left
margin.

.B \ FLUSHRIGHT
Aligns the last character in each manuscript line with the global right
margin.

.B \ FORMAT
For manual tabular formatting.  Uses variable-width font.  Breaks lines
as in manuscript file.  Sets body off with spacing.  Does not adjust
margins.

.B \ G
Requests "Greek" printing.  (See the "Greek" entry for a list of
available characters.)  Defined to be a no-op command for devices that
cannot print greek characters.

.B \ GROUP
Delimits text in which page breaks are prohibited.

.B \ HEADING
Places its body as an unnumbered heading.  Breaks lines as in manuscript
file.

.B \ I
Requests "italic" printing.  Is converted to underlining on printing
devices which cannot italicize.

.B \ INPUTEXAMPLE
Used to print examples of computer input.  Much like Example, but the
text is indented more and long lines are wrapped (as they are in the
Verse environment).

.B \ ITEMIZE
Flags each paragraph in the margin with a special character.  Sets list
off from the rest of text with spacing and wider margins.

.B \ MAJORHEADING
Places its body as a top-level unnumbered heading.  Breaks lines as in
manuscript file.

.B \ MATH
Produces mathematical formulas in running text.  Available only when an
@LibraryFile(Mathematics n) command has been included in a document.
(See the "Mathematics" entry for more information.)

.B \ MATHDISPLAY
Produces mathematical formulas in examples and displays.  Available only
when an @LibraryFile(Mathematics n) command has been included in a
document.  (See the "Mathematics" entry for more information.)

.B \ MULTIPLE
Delimits multiple paragraphs in the .MSS file so that they are treated
as a single paragraph by other environments like Enumerate and
Description.

.SH "EXAMPLE"

.nf
    Input:
       @Begin(Itemize)
       The bullets in an Itemize environment are filled in by Scribe.
       Some styles use hyphens or asterisks instead of bullets.

       @Begin(Multiple)Normally, each blank line starts a new item
       because each paragraph is a new item.

       When you need more than one paragraph in an item, use
       the @@Multiple command or @@Begin(Multiple) and
       @@End(Multiple).
       @End(Multiple)

       In an enumerated list, Scribe generates the numbers
       automatically.  Some document styles might use roman numerals
       or letters instead of numbers.
       @End(Itemize)

      Output:

         - The bullets in an Itemize environment are supplied by Scribe.
           Some styles use hyphens or asterisks instead of bullets.

         - Normally, each blank line starts a new item because each
           paragraph is a new item.

           When you need more than one paragraph in an item, use the
           @Multiple command or @Begin(Multiple) and @End(Multiple).

         - In an enumerated list, Scribe generates the numbers
           automatically.  Some document styles might use roman numerals
           or letters instead of numbers.
.fi


.B \ OUTPUTEXAMPLE
Used for printing examples of computer output.  Much like the Verbatim
environment, but with a slightly larger indent.

.B \ P
Requests "bold italic" printing.  The italicizing is converted to
underlining on printing devices which cannot italicize.

.B \ PROGRAMEXAMPLE
For examples of computer programs.  Uses an appropriate font; breaks
lines as in manuscript file.
.B \ QUOTATION
Insets quotation as running text with wider margins and space above and
below.

.B \ R
Requests ordinary roman type style.  Intended for use inside @i or @b or
@g where a few ordinary characters are needed.

.B \ SUBHEADING
Places its body as a subordinate heading.  Breaks lines as in manuscript
file.

.B \ T
Requests "typewriter" font.

.B \ TABLENUMBER
Aligns a column of figures by their decimal points.  For use in standard
tables.  (See the "Standard_Tables" entry for more information.)

.B \ TEXT
Provides plain, running text.  All formatting is normally inside the
environment Text unless specified otherwise.
.B \ U
Requests "underlined" printing.  All nonblank characters will be
underlined.

.B \ UN
Like @u, but underlines only letters and digits.

.B \ UX
Like @u, but underlines all characters, including spaces.

.B \ VERBATIM
Like Format, but uses a fixed-width font.  Breaks lines as in manuscript
file.  Sets off body with spacing.  Does not adjust margins.

.SH "ERRORLISTING"
This help system contains several alphabetical listings of each error
message and a short explanation of its meaning.  The header of each
listing gives the first character of the error message.  For example, an
error messages beginning with "Portion name ..." or "Root file ..."
would be in the entry "P_R_S".

Some phrases in the messages are inside angle bracket delimiters, for
example, <filename>.  These indicate places where Scribe fills in the
message with whatever phrase applies to your particular problem.  For
example, it would replace <filename> with whatever file it was
processing when it found the problem.

.B \ ARGUMENTS

"<parameter1>" and "<parameter2>" may not both be specified in a
<command-name> command.  "<parameter2>" ignored.
    Some commands allow only one of two parameters specified.  Check
    to see if you specified both.

"<defined-name>",a <wrong-type>, is used where <right-type> is needed.
    You have provided a name of the incorrect type as a parameter
    argument.  Types include Counters, Environments, Commands and
    Integers.

"<undefined-name-for-parameter>" is used where <particular-kind-of-
parameter> is needed.
    Some environment attributes, such as Use, Counter, and Within
    must refer to an existing defined name.  This message is printed
    when you have not provided a valid previously defined name as a
    value to that parameter or when you have provided a name of the
    wrong type.
"<unknown-name>" is not a recognized unit of measure.  Use something
like CHARS.
    You have specified an invalid unit of measure.  Check spelling.

<integer> label(s) referenced but never defined.  See error log file.
    You have made cross references with @Ref to labels that you were
    supposed to define with @Label or @Tag, but no definitions were
    found.  The error log gives you a list of the label names and
    where you referenced them; check their spelling.  You can look
    in the .OTL file for a list of all @Label and @Tag codewords
    that were defined.  The .ERR file contains a list of the label
    names that are not defined.

<name1> and <name2> have the same security levels.  Using <name1>.
    In your @DefineSecurity command, you have specified the same
    value of level for two different security classifications.

<color-name> is not a recognized color description.
    You have specified a color that is not in the spectrum.  Check
    the color that you specified.

<unknown-name> is not a recognized command keyword.
    You used an invalid parameter for a particular command.  Check
    the spelling or consult the manual for a list of available
    parameters.

<unknown-name> is undefined; the <environment-parameter> keyword must
refer to <operand type>.
    You used an invalid parameter for a particular command.  Check
    the spelling or consult the manual for a list of available
    parameters.


.B \ AT-SIGN

@<name> must be followed by an opening delimiter. You have put
"<some-character>" instead.
    Exactly what it says.  You have typed something like
    "@Begin-Quotation" or "@End)Enumerate", failing to use
    appropriate delimiters.

@CBON command not allowed when a change bar is already on.
    You have begun another set of change bars before ending the
    first set.

@StartOverFlow<name> does not have a matching @StopOverFlow.
    Just what it says.  You started an overflow counter and did not
    stop it.

@VerticalSpace is not permitted here.
    You have put the @VerticalSpace command in an invalid position.
    Exactly what it says.  An invalid position, for example, may be
    in the middle of a paragraph.


.B \ A_B

A <type> named <defined-name> already exists.  You may not define
another one with the same name.
    You have defined a counter, environment or textform that already
    exists.  Use a new name.

A line together with its footnotes is bigger than the page!
    A page can hold a certain number of text lines.  Scribe always
    puts the text for a footnote on the same page as the line
    referencing that footnote.  If a line has too many footnotes, or
    if one footnote is too big, then the line together with its
    footnotes cannot fit on one page.  Scribe puts as much of the
    footnote text as it can on the page with the footnoted line.  If
    you don't think that your footnote text is too big and are
    puzzled by this message, check for a missing delimiter at the
    end of an @Foot command.

A tab sequence @\ used, but the cursor has already passed the last tab
stop.
    The tab request is ignored.  You might have set too few tab
    stops, or your text might have carried you past one of them
    already.  Change your tab settings or make your text lines
    shorter.

A table entry is wider than it is allowed to be.
    In the specifications of the column widths in a table, a text
    entry is wider than the column.  Most likely the text has
    violated the MaxWidth parameter.

A word is wider than the output line.  It will extend beyond the right
margin.
    A warning to let you know the text output will extend into the
    right margin.

An environment that has multiple columns may not have a boxtype.
    You have specified a boxtype for your multiple column
    environment.  It is illegal to try to draw a box around a
    multi-columned environment.

BackPlaced portion <portion-name> has changed. Run the file through
Scribe again to correct the portion.
    The generated portion that you are backplacing has been changed.
    To get the most up-to-date version of that portion, run the file
    through Scribe again.

Box type <defined-boxtype> is not suitable for use in a row format.
    You have specified a boxtype with a linetype for the top but no
    linetype for the bottom or vice versa.  Both the top and bottom
    parameters of a boxtype command must have linetypes for use in a
    row format.


.B \ C_D

Change bar name <name> does not match current change bar <current-name>.
    You have ended a changebar with a name different from the one
    you used at the start of the changebar.

Column <integer> of the table begun at <file-location> has an entry that
is wider than its proportional width allows.
    During the computation of the column widths of a proportional
    table, there is still an entry in your table that is too wide.
    Check the file location to find the entry.

Commands or Environments are nested too deeply.
    You have imbedded commands deeper than the maximum of 32.  (ie.
    @a[@b<@c{...)

Conflicting straddling requirements above this table entry.
    You probably specified straddling for some row but forgot to
    specify it for the row above (or below).

Counter <name> has a missing or invalid WITHIN attribute.  Overflow
counting may be wrong.
    You have omitted or not used a proper counter-name to the WITHIN
    parameter of your overflow counter.  If A overflows to B, then B
    must be "within" A. Check the spelling or make sure WITHIN is
    properly specified.

Counter <name> has no overflow counter.
    You have used @StartOverflow on a counter that doesn't have an
    overflow counter.
Counter <name1> was advanced while counter <name2> was still
overflowing.  Counter values for <counter-name1> will be wrong.
    If you started an overflow counter in a lower-level sectioning
    environment (like section), and started a new higher level
    sectioning environment (like chapter), the overflow counter will
    be wrong.  You must stop the overflow counter currently running
    in the lower-level environment.

Counter <name> was never overflowed.
    Scribe detected an @StopOverflow(name) command and you never
    used an @StartOverflow(name) command.

Cross references to <integer> label(s) are wrong.  Run the file through
Scribe again if you need to be sure they are right to correct the
references.
    This message means that some forward references might be wrong.
    Read the section about forward references in the "Scribe User
    Manual" to find out what this term means.  If you run the
    manuscript file through Scribe a second time, the problem will
    be cured, but if this copy is not your final draft of the
    document, there's no point in doing that.

Current font <name> does not contain a <some-character> character.
    Not all fonts available on all printing devices contain all 127
    ASCII characters.  Your text contains a request for a character
    that is not present in the font that you are using.  Contact
    your DBA if you cannot fix the problem yourself.

Database entry <name> missing for device <device-name>.
    Scribe cannot continue without the required Database entry.
    This error often indicates some problem with the Scribe Database
    at your site unless you have defined your own database files.
    You may have forgotten an @Use(Database=...) command.  (See the
    Scribe_Commands entry for syntax of the @Use command.)

Default database entry missing for <entry-name> on <device-name>.
    The Database Administrator at each Scribe site decides what the
    defaults are for various formats when you have not explicitly
    requested one.  Scribe is looking for a Database entry for
    something that is supposed to be the default, but cannot find
    that entry in its Database.  Contact your Scribe DBA.

Definition file for device <name>: format error 1.
    Indicates that @Declare(FinalName="...") is missing from the
    device file mentioned.  Scribe needs to know the FinalName in
    order to write the output file.  This is an error in the
    database, consult your DBA.

Definition file for document type <name>:  no FaceCode clause in level-1
@Begin.
    This problem is an error in the document type definition in the
    Database, not an error in your manuscript file.  It probably
    means that the document type that you are using has not been
    defined correctly by the person who made it.  The @Begin
    statement in the .MAK file must contain a "Facecode="clause.
    Contact your DBA.

Definition file for document type <name>:  no Font clause in level-1
@Begin.
    This problem is an error in the document type definition in the
    Database, not an error in your manuscript file.  It probably
    means that the document type that you are using has not been
    defined correctly by the person who made it.  The @Begin
    statement in the .MAK file must contain a "Font="clause.
    Contact your DBA.

Device <device-name> cannot overprint characters.
    Overprint may occur: (1) Due to @Ovp; (2) Accidentally due to
    incorrectly positioned page headings, etc.; (3) Due to @Hsp,
    etc.; (4) When a table is changed with different column widths,
    before the .AUX file is up-to-date.  This is a warning that the
    device (usually File or PagedFile) in use cannot overprint
    characters and the output will not be what you expect.

Device <device-name> not known.
    Scribe will not continue.  This error message means that Scribe
    was unable to find in its Database a definition file for the
    device that you have asked for with the @Device command.  Check
    the spelling or consult your DBA.

Different rotations on the same page.  Using <rotation-style>.
    On the current page, you used two different styles of rotation.
    For example, you may have set the PageHeading to rotate Left
    while the PageFooting rotates Right.


.B \ E_F_I

Environment <name> cannot be rotated because the surrounding text is
grouped or floated.
    Scribe cannot rotate a grouped or floated environment.  The
    environment you are trying to rotate has one of these
    attributes.  Use the environment attribute FREE to turn off
    Group or Float.

Environment <name>, begun at <file-location>, which has a Column Height,
continues to the next page.
    Warning you that the multiple-columned environment in use has
    the ColumnHeight keyword and you used an @Newpage() or
    @NewColumn() command that caused a pagebreak.

Error in definition or use of <environment-name>:  the BREAK attribute
must be used with GROUP.
    The named environment has been defined incorrectly.  Scribe has
    detected this error at a time that makes it impossible to
    recover gracefully.

Error in font definition for face code <facecode-character>: No opening
delimiter.
    There is an error in the @DefineFont command where a delimiter
    is missing in a facecode definition.

Figure or table cannot be placed at the <bottom/top> of the current
page.
    Scribe is warning you that the figure or table that you
    specified to float will not fit on the current page and will be
    placed on the next page.

Figure or table cannot be placed at the <bottom/top> of the current page
because the <environment-name> environment does not have the
COLUMNBALANCE attribute.
    When floating "wide" tables or figures (ie. ones that occupy
    several columns) to the top or bottom inside a multiple-columned
    environment, you must have ColumnBalance=On in the definition or
    in the @Begin statement of the columned environment.

Font <font-name> does not include <facecode-name>.  Using R instead.
    You have begun an environment that is requesting the named
    FaceCode in the named Font.  That Font as defined in the
    Database does not include that FaceCode.  Scribe proceeds as if
    the environment had asked for FaceCode R, which is the Regular
    or Roman FaceCode.  This omission might be an error in the Font
    definition, or it might be an error in the environment
    definition, but it is probably not your fault, unless you have
    been using your own FontFamily files.

FOOTNOTEPOSITION=PAGE requires either COLUMNHEIGHT or COLUMNBALANCE.
Using FOOTNOTEPOSITION=COLUMN.
    You have used the Style parameter FootNotePosition (also an
    environment attribute) but have not specified either
    ColumnHeight or ColumnBalance in your multi-column definition.
    Scribe continues processing using FootNotePosition=Column as the
    default.

Format error while searching for an @MARKER at <file-location>.  Line
ignored.
    In a database file, the @Marker command may be missing an open
    delimiter.  Check the format of the @Marker command.  This
    should only occur if you created a new database file and have
    been making the changes.

Incorrect delimiters in a table heading or footing.
    Delimiters are wrong.  Check the format of your @TableHeading or
    @TableFooting command.

Invalid or misplaced column or line type designator <name>.
    You have used the linetype attribute in the @DefineRowformat
    command in the wrong place.  The attribute must appear no more
    than once between two "column=environment-name" specifications.
    It cannot appear at the beginning or end of the
    "column=environment-name" list.

.B \ L_M_N

Line too wide; lost "<string-of-characters>".
    Unfilled environments normally chop the lines to fit within the
    margins.  This line was too long and had to be chopped.  Perhaps
    you should use an environment like Verse that wraps long lines
    or perhaps the margins settings are wrong.

Line type <name> cannot be used with device <name>.
    Definitions of linetypes are device-specific.  You may have used
    one device's specific features for another's linetype. For
    example, you may have specified a WEIGHT for a linetype that
    will be used for LPT.

More than one <rawfont/typecase-parameter> specified.  Using first
occurrence.
    This is caused by using the same parameter twice in the
    @DefineRawFont command.  Check your definitions closely.

Multiple-column environment <name> must have BOXED or FIXED attribute.
    You have neglected to put one of the two required attributes in
    your definition of a multi-columned environment.
No <device-name> named <font-name>; the default will be used.
    The font that you have asked for with @Style(FontFamily), or
    perhaps the font that the document type designer has asked for
    with a @Style(FontFamily) inside the document type definition,
    is not available.  Scribe uses the default font instead of the
    one requested.

No <device-name> <database-item-type> named <database-entry-name> was
found in the data base.
    Pieces of the Database are missing; contact your DBA.

No definition found in the database for document type <name> on device
<name>.
    The document type that you have requested with the @Make command
    cannot be found in the Database for the device you specified
    with the @Device command.  Scribe cannot continue and must stop
    without creating a document file.  Verify that you have
    requested a valid device in the @Device command and a valid
    document type in the @Make command.  If you have, then contact
    your DBA.

No HyphenationDictionary specified for use with
@STYLE(HYPHENATION=DICTIONARY).
    You have chosen the method of hyphenation to be dictionary
    look-up (either Exact or Folded) but you did not specify which
    dictionary to use via the
            @Style(HyphenationDictionary="dictionary-name")


.B \ O

One should not specify all three of LineWidth, LeftMargin, and
RightMargin.
    No more than two of the @Style parameters LineWidth, LeftMargin,
    and RightMargin can be specified in a given @Begin.  Sometimes,
    the document type designer has specified one or more of them in
    the document type definition file, in which case your selection
    has clashed with the selection in the document type.

Only <integer> fields are needed in the <command-name> command at
<file-location>.  The rest are being ignored.
    You have provided more fields to a command than the command was
    expecting.  If this error is not just a typing error, then you
    probably don't understand the syntax of the command.

Only Bibliography commands are permitted in a BIB file.  <name> is not a
bibliography command.
    The offending command is actually executed but peculiar things
    might happen, since the .BIB file is sorted before it is
    processed and the command may not be read at the time you expect
    to see it.

Only rotations of multiples of 90 degrees are supported.  Using
<integer> degrees.
    You have specified a rotation in a degree measurement other than
    signed values of 90, 180, 270 or 360.

Orphan line.
    You have specified either @Style(OrphanAction Warn) or
    @Style(OrphanAction ForceWarn) requesting that you be warned
    about orphan lines.  This message is your warning; it printed
    for each orphan line.

Output device <name> cannot achieve <special-effect>. Ignored.
    This problem is usually an error in a definition of a new or
    modification of an existing environment by the user, but it is
    not detected until the first attempt to use the incorrectly-
    defined environment.  The output device does not have the
    ability to perform some function like underlining or boldfacing,
    yet the definition of this environment is asking for that
    effect.  The request is ignored.


.B \ P_R_S

Page security classifications have changed.  Run the file through Scribe
again to correct the classifications.
    This message means that some security classifications might be
    wrong.  If you run the manuscript file through Scribe a second
    time, the problem will be cured, but if this copy is not your
    final draft of the document, there's no point in doing that.

Portion <name> cannot be backplaced.
    You have use the @BackPlace(portion-name) command but did not
    declare a filename with the @Generate(portion-name=".extension")
    command.

Root file <name> is missing.
    You are doing part-file compilation.  The part-file specified
    when running Scribe contains an @Part command, but Scribe cannot
    find the "Root" file specified in that command.
Rotations are nested too deeply (maximum 15).
    You have nested rotated environments beyond the limit of 15.
    This limit is rather high for this feature.  Maybe check to be
    sure that you closed all nested environments properly.

Row format <name>, in <command-name> command, is incompatible with
current table.
    When defining an environment with the TableColumns attribute, a
    rowformat is specified.  The definition of this rowformat gives
    the number of columns available in that table.  The error
    message occurs when you have used another rowformat (for example
    in a TableHeading or TableFooting command), that does not
    account for the same number of columns.

ScaleToFit requires that you specify "BoundingBox=File" or
BoundingBox="<four numeric values>" and at least one of Height or Width.
ScaleToFit ignored.
    In the @Graphic command, you have omitted some information.  Any
    graphic command specifying "ScaleToFit" must also specify
    "BoundingBox" and either "Height" or "Width".  If it is the case
    that you have specified "BoundingBox=File" and Height or Width,
    check the graphic file to see if the %%BoundingBox comment is
    valid.  Most MacGraphic files have "? ? ? ?" for the boundingbox
    values which, of course, is invalid.  In this case, you must
    supply values instead of "file" for BoundingBox.

Scribe cannot balance the <environment-name> begun at <file-location>.
    In your multi-columned definition of <environment-name>, you
    requested that Scribe balance the columns via the ColumnBalance
    environment attribute.  In some cases, it will be impossible for
    Scribe to balance the columns.  When this happens, Scribe will
    notify the user via this warning message.

Scribe is not licensed to run on this computer.
    Scribe is designed to check the ID of the computer it is running
    on.  If this ID does not match the one that is configured in the
    Scribe license, Scribe will not run.  Contact your DBA.

Sequencing error in database files: <string> is text.  No text can be
output until after the first @Begin in a MAK file.
    The .MAK file you are using contains text before the
    "@Begin(Text,...)"  statement in this file.  Perhaps it is a
    typo or stray character.  Check the .MAK file or contact your
    DBA.

Straddled cells broken across page boundary.
    Just a warning that straddled cells have broken across the page.
    If you want the straddled cells to stay together, then use
    @Style(WidowAction=Force).

Straddled cells extend into the bottom margin.
    You have set WidowAction=Force in your document.  Straddled
    cells are "grouped" together because of this setting.  The
    straddled cells will extend into the bottom margin.  To allow a
    pagebreak in the straddled cell, use @Style(WidowAction=Off) or
    use an @NewPage() command to break the table.

String begun at <file-location> was never terminated with "@End<name>".
    You have begun a long-form environment invocation but never
    ended it.  The entire remainder of your file, beginning at the
    mentioned file location, has been ignored.


.B \ T

Tables may have columns of the wrong width.  Run the file through Scribe
again to correct the tables.
    In order to calculate the widths of the columns in a table,
    Scribe needs to process the file twice (or three times if the
    table has proportional-width columns).  This message is
    reminding you to do so.

The <some-character> character that is supposed to be the end of the
<name> command at <file-location> is missing.
    Scribe was unable to find the end of a footnote, chapter
    heading, or other command encompassing text.  If the delimiter
    is really there, then try increasing the Stringmax @Style value
    (see Style_Parameters).

The <environment-name> begun at <file-location> is too big vertically to
fit on one page.
    Figures, tables, equations, and similar environments usually
    must fit on one page.  This one doesn't.  You may want to reduce
    the size of the environment or use the "Free" environment
    attribute.

The <command-name> command is allowed only in <restricted-location>.
    The command is restricted to Database files, as indicated, but
    you have used it somewhere else.

The <command-name> command is allowed only in an environment with the
TableColumns attribute.
    The command is restricted to use in environments with the
    TableColumn attribute, but you have used it somewhere else.

The <@Caption/@TableCaption> command is meaningful only inside a figure
or table.  It is being ignored.
    You have tried to give a caption to something that isn't a table
    or a figure or another Database environment for which captions
    are valid.  Check your delimiters to make sure you haven't
    accidentally put it in the wrong place.

The <name> command may not appear in a bordered environment.
    You have used a command like @NewColumn() in an environment that
    has a border.

The <name> command must specify either IMMEDIATE or CONTINUED.  Using
IMMEDIATE.
    Exactly what it says. The command specified is missing the
    IMMEDIATE or CONTINUED attribute.

The <parameter-name> keyword is not meaningful in the <command-name>
command.
    You have used a counter attribute in an environment or an
    environment attribute in a @Style command, or something like
    that.

The <parameter-name> keyword to the <command-name> command needs a
delimited string.
    Commands such as @Pageheading, in which you provide a series of
    text fields, insist that the values of those fields be
    delimited.  Thus, you must say @Pageheading(Left="Book") rather
    than @Pageheading(Left=Book).

The <style-parameter> style keyword must be specified at the beginning
of the document, before the first text.
    Some Style parameters are restricted to appear only at the
    beginning of the document.  This one, for example, is so
    restricted.  If you think that it is at the beginning of the
    document and Scribe thinks it isn't, carefully check for extra
    closing delimiters and other spurious text.  The "beginning" of
    a document is defined to be that part of it up to but not
    including the first text or the first command that, if
    processed, might cause text to be generated.

The @<name> command is obsolete and will not be supported in future
releases.  Please use the @<new-name> command instead.
    Some command names change with new releases and it would be
    "good" practice for you to use the new name.

The @<environment-name> environment begun at <file-location> was never
closed.
    You forgot the closing delimiter of a short-form environment.
    The file location listed is the location of the beginning of
    that environment; it's up to you to decide where the end should
    have been.

The @Marker command is permitted only in database files.
    This command is for use in database files only.  If you have
    used it in your .MSS file, delete it and read about proper usage
    in the "Advanced User Manual".

The @/ command is not meaningful unless the return marker is defined.
It is being ignored.
    The @/ command means "move the cursor to the return marker."
    The return marker is not set.  You may have meant to use the @\
    command, which means "tab to the next tab stop."

The @Begin<name> at <file-location> was never closed.
    You forgot the @End at the end of a long-form environment entry.
    The file location given is the location of the @Begin.
The AUX file <name> is missing.  Page numbering will start at 1.
    You are compiling a part file, but there is no .AUX file for the
    main document (or root file).  The processing continues, but the
    pages, chapters, and other counters will be numbered within the
    part beginning at 1.

The AUX file for this document shows no record of a part named <name>.
Page numbering will start at 1.
    You are compiling a part file, but the .AUX file shows no record
    of it ever having been part of this document.  Processing will
    continue with the page, chapter, and other counter numbers in
    the part beginning at 1.

The bibliography tag "<codeword>" has already been defined at
<file-location>.  This one will not be included in your complete
bibliography.
    You have asked for the entire bibliography file to be included
    by specifying @Style(BibSelect Complete).  Scribe has found a
    bibliography entry whose codeword duplicates a codeword found
    earlier in this or a previous .BIB file.  This later entry will
    not be included in the bibliography listing in your document.

The Binding Margin exceeds twice the Global Left Margin.
    When you specify the binding margin, Scribe divides that amount
    by 2 and subtracts the dividend from the left margin on even
    numbered pages.  If the binding margin exceeds twice the global
    left margin, then the left margin will be negative on even
    numbered pages.  Go back and recompute the binding margin.

The character "<some-character>" is invalid as used in the template
"<template>".
    Numbering templates are used in counters, like Chapter and
    Section, and numbered environments, like Enumerate and Theorem.
    Errors in templates are detected when they are first used, not
    when they are defined.  The current command references a
    template with an invalid code.  (See the Numbering_Templates
    help file entry for a complete list.)

The characters "<string-of-characters>" are invalid here and are being
ignored.  Probable cause: missing close-delimiter earlier in the file.
    In Scribe commands that take parameters, the parameters or
    parameter/value pairs are separated by commas.  This message is
    printed when Scribe finds text after a parameter or
    parameter/value pair but before a comma or closing delimiter.
    The most common cause of this error condition is failing to put
    a closing delimiter on a parameter's value earlier in the
    command or a missing comma to separate parameters, which
    disrupts the delimiter balance for the rest of the command.

The command <command-name> is allowed only at the beginning of a
manuscript.
    Some commands may appear only at the beginning of the document.
    If you think the command in question is at the beginning of the
    document and Scribe thinks it isn't, carefully check for extra
    closing delimiters and other spurious text.  The "beginning" of
    a document is defined to be that part of it up to but not
    including the first text or the first command that, if
    processed, might cause text to be generated.

The Counter <name> does not have a title.
    You have used a counter as a command, but the counter has
    neither a TitleEnv nor a TitleForm attribute.

The delimited string beginning at <file-location> was never terminated
by a closing <some-character>.
    When a parameter requires a delimited string for an argument, as
    in some command like
                     @Begin(Quotation,AfterEntry="
                               QUOTATION

    )
    Scribe becomes unhappy when the closing delimiter (like the
    double-quote) is missing.  If the delimiter is not really
    missing, then you need to increase the value of the StringMax
    @Style parameter.

The keyword <@Make-parameter-name> is not part of document type
<document-type>.  It is being ignored.
    @Make commands can take parameters to modify the document type,
    but the parameter that you have provided in this @Make command
    is not correct for this document type.  Contact your DBA.

The label <codeword> has already been defined at <file-location>.  This
redefinition is being ignored.
    @Label and @Tag codewords must be unique.  You have used one
    twice.

The last <integer> tab stops set by this command were past the right
margin.
    You can't set tabs past the current right margin.
The left and right margins overlap; this leaves no room for any text.
    The margins that you have specified are so big that the sum of
    the left margin and the right margin is greater than the paper
    width.  Remember that the right margin value is measured from
    the right edge of the paper, and the left margin value is
    measured from the left edge of the paper.

The name <name> in the <command-name> command must be followed by a
comma or closing delimiter.
    There is a syntax error in a command.  General syntax of
    commands are command-name followed by an open-delimiter,
    followed by any number of parameter=value pairs separated by
    commas with the last pair followed by a closing delimiter.
    Check the syntax.

The name <name> is used in the @Value command, but it has not been
defined with @String.
    The Predefined_Strings help file entry contains a list of
    predefined strings.  Any name not in that list must be defined
    with @String before it can be used in an @Value command.  If you
    have received this error message due to an @Case command, be
    sure that this command was placed after the first text of a
    document (otherwise, Scribe will not have pricessed the
    @String).

The name <undefined-name> should be defined but is not!
    Either you used some name such as for the value of the Boxtype
    or TableColumns attibute of an environment, without having
    defined that name earlier, or Scribe has tried to use some name
    (such as "Fnenv", the name of the footnote environment) that was
    not correctly defined in the database.  In the latter case, the
    problem is not your fault and you should contact your DBA; in
    the former case, check the spelling.

The name @<name> is not defined in document type <name>.
    Similar to error message above.

The sequence "@<some-character>" is illegal in a hyphenation dictionary.
One can use "@@" to represent the character "@".
    You have used some other character other than period, @_
    (at-underscore), hyphen, @@ (at-at), @. (at-period) or
    @ (at-space) in your hyphenation dictionary.

The sequence "@<some-character>" is not meaningful.  It will be treated
as text.
    You have put an "@" character in your manuscript file and
    followed it by some punctuation symbol that Scribe does not
    recognize.  If you really meant to have an @-sign appear in the
    document, use two in a row.  (See the help file entry
    Punctuation_Commands for a complete list.)

The symbol <name>, <typename>, cannot be redefined as <different-type-
name> at block level 0.  This statement must go at block level 1.
    This situation is an error in the document type (.MAK) file from
    Scribe's Database.  It means that lines in the Database file are
    in the wrong order.  Contact your DBA.

The table name <name> has been used earlier in this document.  It was
first used at <file-location>.
    The tableid name must be a unique name and cannot be used more
    than once.

There may be <integer> extra citation(s) in the bibliography.  Run the
file through Scribe again if you need to be sure it is right.
    You had citations AFTER the bibliography was generated and the
    .AUX file contained information about these citations.  You
    deleted these "extra" citations, so the .AUX file, still
    containing the citation information, is out of date.  You may
    wish to run Scribe again to correct the citations.
This @End does not have a matching @Begin.
    You have more @End commands than @Begin commands or have them
    improperly nested.

This @Part command is missing a ROOT keyword.  Subcompilation mode is
being turned off.
    If you want to use subcompilation mode, you have to provide the
    name of the root file in the @Part command.

This copy of Scribe has been configured without a driver for device
<device-name>.
    The copy of Scribe that you are running does not contain the
    necessary program code to process text for the device that you
    have selected.  Contact your DBA to find out why.

This table entry has more than one @STRADDLE command.
    A single row entry in a table cannot have more than one
    @Straddle command.  Check the entry closely.

This table has no @TABLEID command.
    Each table configured with either the StandardTable command or
    an environment with the TableColumns attribute must contain an
    @TableId command.  The argument for this command is a unique
    name by which the column widths can be identified.

Too <many/few> columns in a row of a table.
    Your table definition has a designated number of columns.  This
    error occurs when you have too many or too few entries in a
    particular row separated by the @\ or @NextEntry command.


.B \ U_V_W

Unable to hyphenate <integer> word(s); see the error log.
    Scribe gives a listing in the error log file of the words it
    could not hyphenate using the hyphenation method you chose.

Unmatched names: @Begin<name1> [at <file-location>
    closed with @End<name2>.]
    The names in @Begin and @End commands have to match; you can't
    say @Begin(Display) and @End(Center), for example.  This might
    mean that you have some @End commands in the wrong order.

Vertical justification could not find any break points
    Warning you that there were no points in the page that Scribe
    could use to insert extra space for vertical justification.  The
    page will remain unjustified.

Vertical justification would violate <parameter>.  This page will remain
unjustified.
    Warning you that if Scribe attempted to vertically justify that
    page, the LargestSpacing or LargestVerticalGap specification
    would be exceeded.

Widow line.
    You have specified either @Style(WidowAction Warn) or
    @Style(WidowAction ForceWarn) requesting that you be warned
    about widow lines.  This message is your warning; it printed for
    each widow line.


.B \ Y

You are trying to use @F<some-character>, but you haven't defined
special font <some-character>.
    Before you can use @F1, @F2, ... @F9 special-font environments,
    you must define them with the @SpecialFont command.

You can't define a string named <name> because it's already defined as
<type>.
    Names that you define with @String cannot duplicate other names
    that you define with other commands, like @Textform or @Define.
    This name does duplicate one.

You can't EQUATE something to the undefined name <name>.
    You have attempted to equate a name to something that is not
    currently defined.  Check your spelling and make sure that the
    @Equate command comes after the definition of the thing being
    equated to.

You can't EQUATE the name <name>, because it's already defined as
<some-type>.
    You have attempted to equate a name to something that is already
    defined. Pick a new name.

You have already defined part <part-name> at <file-location>.  The new
definition is being ignored.
    The names in @Part commands must be unique; you have used one of
    them twice.  Scribe keeps the first one it sees and ignores all
    others with the same name.

You have provided the wrong number of arguments to the BoundingBox
keyword.
    The BoundingBox keyword takes four (4) coordinates in the
    order:]
    (llx,lly,urx,ury)]
    where llx is the lower-left x, lly is the lower-left y, urx is
    the upper-right x, and ury is the upper-right y.

You may not start a new paragraph while still inside a subscript or
superscript.
    If Scribe encounters a paragraph break while in a subscript or
    superscript, it closes the scripting.  If you really mean to
    start a new paragraph inside the script, close the script and
    reopen it in the new paragraph.

You may not start an overflow on an overflow counter.
@StartOverFlow<name> ignored.
    Overflow counters are used within counters.  You used an
    overflow counter name in the @StartOverflow command instead of
    the top-level counter name.

You must provide arguments to the @<name> command.
    You have not provided any of the required arguments to the
    command specified above.  If this error is not just a typing
    error, then you probably don't understand the syntax of the
    command.  See the Scribe_Commands entry for a complete list.

You must specify "BoundingBox=File" or BoundingBox="<four numeric
values>" or both "Height" and "Width".
    In the @Graphic command, you have omitted some information.  Any
    graphic command must indicate the size of the graphic, by
    specifying a "Boundingbox" or specifying "Height" and "Width".
    If it is the case that you have specified "BoundingBox=File" and
    Height or Width, check the graphic file to see if the
    %%BoundingBox comment is valid.  Most Macintoch graphic files
    have "? ? ? ?" for the boundingbox values which, of course, is
    invalid, so you must specify actual values for BoundingBox
    instead of the "File" argument.


.SH "GRAPHICS"
Scribe can merge graphics and text in a document via the @Picture and
@Graphic commands.  The @Picture command leaves a specified amount of
space and automatically includes an image that has been produced with a
graphics package (not included with Scribe):

.nf
         @Picture(Height=1 inch, Talaris="picture.lg1200")
.fi

The @Graphic command is very similar to @Picture, except that @Graphic
does not force a new paragraph and thus can be used to place a graphic
in running text:

.nf
         Press the @Graphic(Height .30inches, Width 1inch,
         Postscript "button.ps") key when ready.
.fi

Refer to the "Commands" entry for syntax of @Graphic and @Picture.  Note
that these commands are implemented only for devices that have the
ability to print graphic images.  Contact your DBA for details.

.B \ POSTSCRIPT_GRAPHICS
There are six additional parameters available for use within the
@Graphic command for PostScript devices only:

.nf

    BoundingBox   Specifies precise positioning of the graphic image
                  relative to the space provided for it. Used when
                  "ScaleToFit" is specified. If "Height" and "Width"
                  are omitted, Scribe will try to determine them from
                  the BoundingBox specification. Takes a value from
                  the set:          {Bottom, File, Top}
                  or can take two or four user-specified-coordinates.

                  Bottom: Tells Scribe the graphic image is in the
                          lower left-hand corner of the graphic page.
                  File:   Scribe uses the BoundingBox declared in the
                          PostScript graphics file.
                  Top:    Tells Scribe the graphic image is in the
                          upper left-hand corner of the graphic page.

    Clip          Instructs Scribe to cut a designated portion of the
                  graphics picture specified by the values for "Height"
                  and "Width".

    FontMapping   Takes as a value the "name" of a font-mapping defined
                  by the @DefineFontMapping command.  Allows the user
                  to specify a particular mapping from fonts used in the
                  graphics file to fonts used in the document.  See the
                  "Commands" entry for proper syntax.

    Magnify       Specifies a factor of magnificaton. Values greater
                  than one indicate enlargement, values less than one
                  indicate reduction.  Values for "Height" and "Width"
                  must change accordingly by the magnification factor.

    Rotate        Specifies rotation of graphics file.  Positive values
                  indicate clockwise rotation, negative values indicate
                  counter-clockwise rotation. Values must be specified
                  in multiples of 90. Values for "Height" and "Width"
                  may need to be changed if graphic is rotated to a
                  position where the values have become switched.

    ScaleToFit    Instructs Scribe to scale the graphic to fit in a
                  frame specified by the "Height" and "Width".
                  BoundingBox must be used to specify the size of the
                  original graphics file.
.fi


.B \ SPANNING_COLUMNS
Users can now include tables or graphics wider than a single column in
multiple-column text by adding the "LineWidth=n Columns" attribute/value
pair to the @Begin(Figure) or @Begin(Table) environment invocation.  The
value of "n" is equivalent to the number of columns in the
multiple-column environment.
Table or Figure environments that specify the "LineWidth" attribute must
be floated.  If a graphic only occupies the first two columns of a three
column environment, no text will be placed in the third column next to
the graphic.  This restriction will be removed in a future release.

.SH "EXAMPLES"

.nf
    1. This example shoes how to place figure across the width of the
       page in a two column environment.

    @Define(2Col, Columns=2, ColumnMargin=.25inch, Boxed)
    @Begin(2Col)
    @Begin(Figure, LineWidth=2 Columns)
    @Graphic(...)
    @End(Figure)
    @End(2Col)

    2. The following example shows a wide table placed in multiple
       column environment.  This example above relies on the implicit
       FLOAT of the Table environment.

    @Define(3Col, Columns=3, ColumnMargin=.25inch, Boxed)
    @Begin(3Col)
    text
    @Begin(Table, Linewidth=3 Columns)
    @StandardTable(...)
    @End(Table)
    text
    @End(3Col)
.fi


.SH "GREEK"
ASCII/Greek correspondence for use in the @G environment.

.nf
      Alpha          A                        Nu             N
      Beta           B                        Xi             X
      Gamma          G                        Omicron        O
      Delta          D                        Pi             P
      Epsilon        E                        Rho            R
      Zeta           Z                        Sigma          S
      Eta            H                        Tau            T
      Theta          Q                        Upsilon        U
      Iota           I                        Phi            F
      Kappa          K                        Chi            C
      Lambda         L                        Psi            Y
      Mu             M                        Omega          W
.fi


.SH "LEADERS"
The @& punctuation command repeats the characters between & and the next
command from the current position until the next tab setting or up to
flushed-right text.

.B \ TO_TEXT
The @& punctuation command repeats the character between the & and the
next command from the current position up to flushed-right text by
default.

.nf
    Manuscript Form:

    @Begin(Format)
    Materials@&.@>4.95
    Labor@&.@>97.00
    Total@&.@>101.95
    @End(Format)

          Document Result:


          Materials...........................................4.95
          Labor..............................................97.00
          Total.............................................101.95
.fi


.B \ TO_TABSTOP
Leaders can also extend to a tab stop.  This effect requires the setting
of the Style parameter Leaders to "Old" and the setting of two tab
stops:  one to which the leaders extend and a second against which the
post-leader text is set.

.nf
    Manuscript Form:
    @Style(Leaders Old)
    @Begin(Format)
    @TabClear
    @TabSet(+40, +8)
    Materials@&.@\@>4.95@\
    Labor@&.@\@>97.00@\
    Total@&.@\@>101.95@\
    @End(Format)


      Document Result:


      Materials..............................     4.95
      Labor..................................    97.00
      Total..................................   101.95
.fi


.SH "MATHEMATICS"
The Scribe mathematical facility makes it easy to specify complicated
mathematical equations and formulas.  Only some of the facility's
details are documented in this publication.  For more information, refer
to the "Scribe User Manual" or contact your DBA.
Scribe's mathematical capabilities are not included in the standard
document type definitions.  To use them, the following command must be
included at the beginning of an .MSS file:

.nf
            @LibraryFile[Mathematics n]
.fi

where "n" represents the point size of the document's running text.
Normally, "n" may take the value 10 or 12.  Check with your DBA to find
out which values are available at your site.

.B \ ENVIRONMENTS
One of two environments, Math and MathDisplay, must be used for
mathematical output:

.nf
    Math: mathematical output in running text where there are
          size constraints.

    MathDisplay: produces mathematical output in examples and
                 figures where there are no size constraints.

    Other environments for use with the mathematics facility are:

    SR: Spaced Roman.  Used for short phrases (such as "if" and
        "and") within an equation.  Ensures correct spacing and font.

    Up: Used for superscripting mathematical text.  Preferable to
        using @+ because certain special characters require different
        sizes depending on whether or not they are scripted; @Up
        produces an appropriately sized character.

    Down: Used for subscripting mathematical text.  Preferable to
          using @-; see description of "Up" environment.
.fi


.B \ COMMON_MATH_TEXT
For the sake of convenience, Scribe provides forms that produce common
mathematical text in normal (Roman) type rather than the italics in
which mathematical symbols appear:

.nf
      Command       Result                  Command        Result
      -------       ------                  -------        ------
      @Arctg        arctg                   @Mod           mod
      @Atan         atan                    @Sin           sin
      @Cos          cos                     @Sup           sup
      @Cot          cot                     @Tan           tan
      @Csc          csc                     @Tg            tg
      @Deg          deg                     @Trace         trace
      @Det          det                     @BigO(text)    O(text)
      @Inf          inf                     @Omega(text)   omega(text)
      @Lg           lg                      @Theta(text)   theta(text)
      @Lim          lim                     @Detrm(text)   det(text)
      @Liminf       liminf                  @Exp(text)     exp(text)
      @Limsup       limsup                  @Gcd(text)     gcd(text)
      @Ln           ln2                     @Floor(text)   floor(text)
      @Log          log                     @Ceiling(text) ceiling(text)
      @Log2         log2                    @Abs(text)     |text|
      @Max          max                     @Norm(text)    ||text||
      @Min          min                                     _____
                                             @Sqrt(text)    Vtext
.fi


.B \ SPECIAL_CHARACTERS
This list illustrates the commands that produce special characters
through the Scribe mathematical facility.  Characters may vary on each
output device, either printing differently or not at all, depending on
the fonts available for the device.  For definite information about
output and availability for a particular device, refer to Appendix G of
the "Scribe User Manual" or consult your DBA.

.nf
      @Add              @Exists          @Nabla            @QSet
      @Aleph            @ForAll          @Neq              @RAngle
      @And              @Gt              @NEqv             @RightArr
      @Angle            @GtE             @Not              @RSet
      @Approx           @GtLt            @NotIn            @Sim
      @Ast              @HBar            @NSet             @Similar
      @Bot              @In              @ODiv             @SqInt
      @Bullet           @Infty           @ODot             @SqUnion
      @Circ             @Inter           @Ominus           @S
      @CSet             @LAngle          @Op               @Subset
      @Degr             @LeftArrow       @OPlus            @Sups
      @Delta            @Lt              @Or               @Top
      @Div              @LtE             @OTimes           @Uni
      @DownArrow        @LtGt            @Partial          @UpArrow
      @DVBar            @Mp              @Pm               @UPlus
      @EmptySet         @MuchGt          @PrSubset         @VBar
      @Eq               @MuchLt          @PrSupset         @ZSet
      @Eqv              @Mult            @Qed
.fi


.B \ MULTILINE_FORMULAS
The mathematical facility also provides forms for constructing
multi-line formulas such as summations, integrals, fractions, and
binomial coefficients.  The syntax of each form is listed:

.nf
    @Sum[From="delimited-value", To="delimited-value"]

    @Prod[From="delimited-value", To="delimited-value"]

    @Int[From="delimited-value", To="delimited-value"]

    @Over[Num="delimited-value", Denom="delimited-value"]

    @Choose[From="delimited-value", Chosen="delimited-value"]

    @Brace[Top="delimited-value", Bot="delimited-value"]

    @Limit[As="delimited-value"]

    @Ss[Sub="delimited-value", Super="delimited-value"]

    @SmallFraction[Num="delimited-value", Denom="delimited-value"]
.fi


.B \ MISCELLANEOUS
The following forms are also available in the Mathematical facility:

.nf
    Command    Result      Description
    -------    ------      -----------
    @Get        :=         assignment operator, common in computer
                           programs

    @LDots     ...         ellipsis or series of three dots produced on
                           the baseline

    @CDots     ...         ellipsis or series of three dots raised to
                           align with plus-signs and minus-signs.

                   ->
    @Vec(x)        x       produces a small vector arrow above a lower-
                           case "x".  Can only be used with lower-case
                           letters.
                      _
    @Overline(x)      x    produces a small horizontal line above a
                           lower-case "x".  (Lower-case only)
                      _
    @Overlinecap(X)   X    produces a small horizontal line above an
                           upper-case "X".  (Upper-case letters or
                           digits)
.fi


.SH "MULTIPLE_COLUMNS"
Multiple column output can be achieved by using these environment
attributes when creating a new or modifying an existing environment:

.nf
    Boxed         Required for all multiple-column environments unless
                  "Fixed" is used. Specifies that the environment is to
                  be separated vertically from any text before or after
                  it.

    ColumnBalance Instructs Scribe to balance the columns of the
                  multiple-column environment so that the last page of
                  the columned output contains the specified number of
                  columns at equal heights.

    ColumnHeight  Specifies the maximum height of each column in the
                  multiple-column environment.  Any of the usual Scribe
                  distance units may be used.

    ColumnMargin   Specifies the amount of space between columns.

    Columns        Required.  Specifies the number of columns in which
                   the environment will be set.

    ColumnWidth    The sum of the ColumnMargin and LineWidth attributes.

    FootNotePosition
                   Specifies the location of the footnote. Takes a value
                   from the set {Column, Page}.  The value "column"
                   causes the footnotes to be placed at the bottom of
                   the column only; "page" causes the footnotes to
                   appear across the bottom of the entire page.  Default
                   is "Column".  ColumnHeight or ColumnBalance must be
                   specified.

    LineWidth      Specifies the width of an individual column, not of
                   the entire line.
.fi


.SH "EXAMPLES"

.nf
    1. @Modify(Enumerate, Columns 2, ColumnMargins .25inches, Boxed)

    This command modifies the Enumerate environment to produce
    two-column output with a quarter-inch margin between columns.

    2. @Define(Cols3, Columns 3, LineWidth 2.5inch, Boxed,
           ColumnBalance, FootnotePosition Column)

    This command defines a new environment "Cols3" to produce text
    in three columns, each two-and-a-half inches wide.  The columns
    are balanced on the last page of the environment and footnotes
    appear at the bottom of each column.
.fi


.B \ SPANNING_COLUMNS
Users can now include tables or graphics wider than a single column in
multiple-column text by adding the "LineWidth=n Columns" attribute/value
pair to the @Begin(Figure) or @Begin(Table) environment invocation.  The
value of "n" is equivalent to the number of columns in the
multiple-column environment.
Table or Figure environments that specify the "LineWidth" attribute must
be floated.  If a graphic only occupies the first two columns of a three
column environment, no text will be placed in the third column next to
the graphic.  This restriction will be removed in a future release.

.SH "EXAMPLES"

.nf
    1. This example shoes how to place figure across the width of the
       page in a two column environment.

    @Define(2Col, Columns=2, ColumnMargin=.25inch, Boxed)
    @Begin(2Col)
    @Begin(Figure, LineWidth=2 Columns)
    @Graphic(...)
    @End(Figure)
    @End(2Col)

    2. The following example shows a wide table placed in  a multiple
       columned environment.  This example above relies on the implicit
       FLOAT of the Table environment.

    @Define(3Col, Columns=3, ColumnMargin=.25inch, Boxed)
    @Begin(3Col)
    text
    @Begin(Table, Linewidth=3 Columns)
    @StandardTable(...)
    @End(Table)
    text
    @End(3Col)
.fi


.SH "NUMBERING_TEMPLATES"
Template codes govern how Scribe prints numbers that are automatically
generated, such as page and footnote numbers.  These codes are used in
counter and environment definitions and @Style parameters.
Capitalization DOES matter in the template definitions, ie. @F is very
different from @f.  All characters not prefixed with an @-sign are
literals.

.B \ AT-1
Prints arabic cardinal numbers (1, 2, 3, ...) starting from 1.
Syntax: @1

.B \ AT-2
Actual templates available: @2, @3, ... through @9.
Prints the specified number of arabic cardinal numbers starting from 1
with leading zeros, if necessary, to fill out the number to the required
length.  For example, @4 produces the numbers (0001, 0002, 0003, ...).
Syntax: @2

.B \ AT-'
Prints abbreviations for ordinals (1st, 2nd, 3rd, ...) starting from
1st.
Syntax: @'

.B \ AT-A
Prints capitalized alphabetical sequence (A, B, C, ..., AA, BB, CC, ...)
starting from A.
Syntax: @A

.B \ AT-a
Prints lowercase alphabetical sequence (a, b, c, ..., aa, bb, cc, ...)
starting from a.
Syntax: @a

.B \ AT-B
Prints capitalized alphabetical sequence (A, B, C, ..., AA, AB, AC, ...)
starting from A.
Syntax: @B

.B \ AT-b
Prints lowercase alphabetical sequence (a, b, c, ..., aa, ab, ac, ...)
starting from a.
Syntax: @b

.B \ AT-F
Prints ordinal numbers with the first letter capitalized (First, Second,
Third, ...) starting from First.
Syntax: @F
.B \ AT-f
Prints lowercase ordinal numbers (first, second, third, ...)  starting
from first.
Syntax: @f

.B \ AT-I
Prints "capitalized" Roman numerals (I, II, III, ...)  starting from I.
Syntax: @I

.B \ AT-i
Prints "lowercase" Roman numerals (i, ii, iii, ...)  starting from i.
Syntax: @i

.B \ AT-O
Prints cardinal numbers with the first letter capitalized (One, Two,
Three, ...) starting from One.
Syntax: @O

.B \ AT-o
Prints lowercase cardinal numbers (one, two, three, ...)  starting from
one.
Syntax: @o
.B \ AT-AST
(@*) Prints a sequence of asterisks (*, **, ***, ...) starting from * up
to a maximum of 10.
Syntax: @*

.B \ AT-#
Prints the value of the parent counter (specified by the Within
attribute in a counter definition) for this counter.  The number printed
by this code is the value of the Referenced rather than Numbered
attribute.
Syntax: @#

.B \ AT-:
Prints "character" when a parent counter exists and has a nonnull value.
Syntax: @:character

.B \ AT-;
Prints "character" when no parent counter exists.
Syntax: @;character

.B \ AT-,
Separates templates in a list.  With a list of values, Scribe changes to
the next template in the list each time the environment is nested within
itself.  Used in the Itemize and Enumerate environment definitions.
Syntax: @,

.B \ CHARACTER
Prints "character" literally.  Any character not prefixed by an @-sign
is a literal and will be copied directly into the output string without
interpretation.

.B \ AT-@
Specifies that a Scribe command is being executed.  For example, the
Footnote counter is normally defined as "@@+[@1]".  The two at-signs
result in the superscripting of the appropriate footnote number.
Syntax: @@

.B \ AT-@@@
Produces a literal at-sign in the output.
Syntax: @@@@

.SH "PAGE_HEADINGS"
By default, Scribe puts a page number centered at the top of all pages
after the first.  Other page headings and footings can be declared at
any point in the .MSS file with @Pageheading and @Pagefooting commands.
(See the "Commands" entry for correct syntax.)

.B \ DICTIONARY_STYLE
This section describes Scribe's facilities for defining dictionary-style
page headings and footings.
Scribe can print the titles and numbers of the counters in a page
heading or footing by specifying the @Ref and @Title commands within the
Left, Right, Center, and Line parameters to @PageHeading and
@PageFooting, and supplying the name of a counter such as Chapter or
Section as an argument to @Ref and @Title.  (See details in the "Scribe
User Manual")
Even if you do not want dictionary-style page headings or footings,
Scribe's default evaluation of counters may not be desirable.  In many
cases, you may want to print a counter title in the page heading or
footing of the current page.  To do this, you must modify the counter to
be used in the page heading or footing by assigning the Recompute
attribute to it.
                      @Modify(Section, Recompute)
The Recompute attribute forces Scribe to evaluate the page heading or
footing every time an instance of the specified counter is found on the
page.  When a counter that contains the Recompute attribute is specified
in an @PageHeading or @PageFooting command, Scribe prints the title of
the last counter on the current page in the page heading or footing.
You can also use this modification to produce dictionary-style headings
and footings.  You use the modified counter as an argument for the
commands @Ref, @Title, @FirstRef, and @FirstTitle within an @PageHeading
and @PageFooting command.
A dictionary-style page heading or footing shows the titles of both the
first counter specified on a page and the last counter on that page.  To
print the title of the first counter on a page in the page heading or
footing, you use the @FirstRef and @FirstTitle commands which, as with
@Ref and @Title, are used as arguments to the Left, Right, Center, or
Line parameter of an @PageHeading or @PageFooting command.  The
@FirstRef and @FirstTitle commands take as an argument the name of a
counter that is used as a command, such as Chapter or Section.  This
counter must be modified to contain the Recompute attribute.  The
@FirstRef command prints the number of the first counter on the page and
@FirstTitle prints the title of the first counter on the page.

.SH "EXAMPLES"

.nf
    1. The following example shows the definition of a dictionary-
       style page heading that would be suitable for use in a
       single-sided manual:

       @Modify(Section, Recompute)
       @Pageheading(Center="@Value[Page]",
                       Left="@FirstRef[Section] @FirstTitle[Section]",
                      Right="@Ref[Section] @Title[Section]")

       If there are several @Section commands on a page, the
       definition shown above will print the first section's number and
       title on the left-hand side of the page heading.  The number and
       title of the last section on the page will be printed on the
       right-hand side of the page heading.
.fi


.B \ FIELDS
The following field names specify the position of various fields in a
heading or footing:

.nf
     Center    The middle field of the first line; centered between
               global margins.

     Left      The left field of the first line; flushed against the
               left global margin.
     Line      The field containing second or subsequent lines of a
               heading or footing (Left, Center, and Right field names
               only apply to the first line of a heading or footing).
               Contents must contain tabbing commands to position text.
               and clear any tab settings for
               the duration of the heading or footing; tabbing commands
               will work as expected.

     Right     The right field of the first line; flushed against the
               global right margin.
.fi

The text for these fields can contain any manuscript-file text,
including Scribe commands (like @Value and @Title).

.B \ PARAMETERS
The following parameters are optional; they control when a page heading
or footing applies:

.nf
     Even        Specifies the heading/footing to be used on even pages.

     Immediate   Normally, when Scribe sees an @Pageheading or
                 @Pagefooting command, it completes the current page and
                 produces the new heading or footing on the next output
                 page.  This parameter changes the heading or footing on
                 the current page.

     Odd         Specifies the heading/footing to be used on odd pages.
.fi

For the Odd and Even parameters to work properly, the document must be
doublesided.  If even and odd headings or footings are defined but the
document is singlesided, odd headings/footings are used throughout.

.SH "EXAMPLES"

.nf
    1. @Pageheading(Odd,Left "@Title[Chapter]",Right "@Value[Page]")

    This @Pageheading command places the name of the current chapter
    in the left field and  the current page number in the right
    field on odd-number pages:

    2. @Pageheading(Immediate, Odd)
       @Pageheading(Immediate, Even)

    If a field name is not specified, Scribe assumes that no text is
    to appear in that area of the heading or footing.  To suppress
    headings for an entire document, let all field names default:
.fi


.SH "PREDEFINED_STRINGS"
The @Value command retrieves the current contents of strings, which can
be user-defined with the @String command or predefined by Scribe.
Commonly-used predefined strings are listed below.

.B \ DATE
Day, month, and year of the current date.  The format is controlled by
@Style(Date).
(See the "Style_Parameters" entry for proper syntax.)

.B \ DAY
Day of the month.

.B \ DEVICE
The output device for this run.  Taken from the @Device command in the
.MSS file, the "Device" command-line option, or supplied by default from
SCRIBE.SIT.

.B \ ENVIRONMENT
The name of the current environment.

.B \ FILEDATE
The date and time when the manuscript file was created.  The format is
controlled by @Style(FileDate).
(See the "Style_Parameters" entry for proper syntax.)

.B \ FONTFAMILY
The name of the current FontFamily.

.B \ FULLMANUSCRIPT
The full file specification of the manuscript (root) file being
processed.

.B \ FULLPARTFILENAME
The full file specification of the part file being processed.

.B \ MANUSCRIPT
The name of the manuscript (root) file being processed.
.B \ MONTH
The name of the current month.

.B \ PAGE
The current page number in the document.

.B \ PAGESECURITY
If one or more of the environments on a page have been assigned a
security classification (via the Security attribute), the predefined
string PageSecurity prints the full name of the highest classification
on the page.  The full name is taken from the FullName parameter of an
@DefineSecurity command.

.B \ PARTFILEDATE
The date and time when the part file was created.  The format is
controlled by @Style(FileDate).
(See the "Style_Parameters" entry for proper syntax.)

.B \ PARTFILELINE
The name and line number of the part file currently being processed.

.B \ PARTFILENAME
The name of the part file being processed.

.B \ PARTIAL
Indicates whether a part file is being run through Scribe alone or the
root file is being processed.  Produces a value from the set {True,
False}.  True means that only the part file is being run through Scribe;
False indicates that the root file is being run.

.B \ ROOTFILEDATE
If multiple files are in use (via @Include), RootFileDate is the date
and time of last update of the root file.  The format is controlled by
@Style(FileDate).
(See the "Style_Parameters" entry for proper syntax.)

.B \ SCRIBEVERSION
The version of Scribe currently processing the file.

.B \ SECTIONNUMBER
The section number from the last sectioning command (null in an
unnumbered document).  (See the "Commands" subtopic in the
"Sectioned_Documents" entry for the list of sectioning commands.)

.B \ SECTIONTITLE
The section title specified by the last sectioning command (null in an
unsectioned document).  (See the "Commands" subtopic in the
"Sectioned_Documents" entry for the list of sectioning commands.)

.B \ SECURITY
If the current environment has been assigned a security classification
(via the Security attribute), the predefined string Security prints the
abbreviation for the classification.  The abbreviation is taken from the
Abbreviation parameter of an @DefineSecurity command.

.B \ SHEETSECURITY
If one or more of the environments on a double-sided sheet of paper have
been assigned a security classification (via the Security attribute),
the predefined string SheetSecurity prints the full name of the highest
classification found on the sheet.  The full name is taken from the
FullName parameter of an @DefineSecurity command.

.B \ SIDES
The pagination for the document.  The value is "single" for single-sided
documents and "double" for double-sided ones.

.B \ SITE
The abbreviation for the site name.  Taken from the site code field in
SCRIBE.SIT.

.B \ SITENAME
The name of the site.  Taken from the site name field in SCRIBE.SIT.

.B \ SOURCEFILE
The name and line number of the file currently being processed. If used
in a part (included) file, the value returned will be the name and
number of the part file, not the root file.  If used in a Database file,
the Database filename and number will be the returned value.

.B \ TIME
The time when the current Scribe run began.  The format is controlled by
@Style(Time).
(See the "Style_Parameters" entry for proper syntax.)

.B \ TIMESTAMP
The date and time when the current Scribe run began.  The format is
controlled by @Style(TimeStamp).
(See the "Style_Parameters" entry for proper syntax.)

.B \ USERNAME
The name of the user running the program, according to data provided by
the operating system.

.B \ WEEKDAY
The name of the current day of the week.

.B \ YEAR
The current year.

.SH "PUNCTUATION_COMMANDS"
A "punctuation-character" command is one that consists of an @-sign
followed by a single punctuation character.  Except for @+ and @-, these
commands are complete in themselves and take no arguments.

.nf
    @@    Produces a literal "@" character in the document.

    @-space   The command character followed by a space requests
              a literal space; it treats the space as a character
              (part of a word) rather than as a word separator.

    @!   Sets the return marker to the current horizontal position.

    @+   Prints the "text" as a superscript at the current cursor
         position.  Syntax: @+(text)

    @-   Prints the "text" as a subscript at the current
         cursor position.  Syntax: @-(text)

    @/   Moves the cursor to the return marker position.
         (See also @!.)

    @=   Marks the left end of text to be centered.  Do not use in
         a filled environment.  See also @\.

    @>   Marks the left end of text to be flushed right.  Do not use
         in a filled environment.  See also @\.

    @\   Tab command.  Moves the cursor to the next tab stop or marks
         the end of text being centered or flushed right.  Do not use
         in a filled environment.  Also separates column entries in a
         row of a table.

    @^   Sets a tab at the current cursor position.

    @&   Repeats the characters between & and the next command from
         the current position until the next tab setting or up to
         flushed-right text.

    @)   Like @&, but the replicated patterns are synchronized in
         fixed columns from one line to the next.

    @;   No-operation.  Scribe takes no action and outputs no text
         when it encounters an @; command in the input file.

    @~   Causes Scribe to ignore everything in the manuscript file
         between it and the next printing character.  Used for putting
         non-significant line breaks in environments where end-of-line
         normally matters.

    @#   Leaves a quad space for a special character and creates an
         entry in the .ERR file so the user can return to the proper
         place and draw in the character.

    @]   Positions the cursor at the prevailing left margin.

    @_   Conditional hyphen.  Allows Scribe to break a word across a
         line boundary at the indicated point.  If the word is broken, a
         hyphen will be inserted; if the word is not broken, no hyphen
         will appear.  Functions when Hyphenation is turned on or off.
.fi

.SH "SECTIONED_DOCUMENTS"
Sectioned documents such as Article, Report and Thesis, have a unique
set of commands that produce a particular numbering scheme for the
sectioned titles.  These commands are summarized in the "Commands"
subtopic of this entry.  For a complete list of commands available in
each document type, see the "Document_Types" entry.
In addition, sectioned documents have an additional set of environments
defined for that particular style.  These environments are summarized in
the "Environments" subtopic of this entry.

.B \ COMMANDS
These commands are used in document types Article, Manual, Report,
Thesis and their variations for the purpose of recording sections and
their titles.  Usage syntax is uniform:

.nf
    @Chapter(Title For This Chapter)
    @Section(Title for This Section)

                 Usual                               Manual,
    Level      Numbering       Article           Report, Thesis
    -----      ---------       -------           ---------------
    1                      @PrefaceSection       @PrefaceSection
    1          1.          @Section              @Chapter
    2          1.1         @Subsection           @Section
    3          1.1.1       @Paragraph            @Subsection
    4          1.1.1.1                           @Paragraph

    1          A.          @Appendix             @Appendix
    2          A.1         @AppendixSection      @AppendixSection

    1                      @UnNumbered           @UnNumbered

.fi

@UnNumbered appears in the Table of Contents; @PrefaceSection does not.

.B \ ENVIRONMENTS
These environments are available in all sectioned document types:
Article, Brochure, Guide, Manual, MilStd837A, Mil38784B, Report, Thesis
and their variants (unless noted otherwise).

.I \ COPYRIGHT
Produces a copyright statement on the title page.  Must be followed by a
date and name.  Nested within the TitlePage environment.  (Not available
in Brochure, Guide and MilStd837a).

.nf
                    @Copyright[1988 Scribe Systems Inc.]
    will produce
                     Copyright (C) 1988 Scribe Systems Inc.
.fi


.I \ COPYRIGHTNOTICE
Produces a copyright notice with year on the title page.  Must be
followed by the name of the copyright owner.  Nested within the
TitlePage environment.  (Not available MilStd837A).

.nf
                    @CopyrightNotice[Scribe Systems Inc.]
    will produce
                     Copyright (C) 1988 Scribe Systems Inc.
.fi


.I \ FIGURE
A floating figure.  If it contains an @Caption command, it will be
assigned a number and listed in the List of Figures.

.I \ FULLPAGEFIGURE
A full-page floating figure.  It will be printed at the close of the
page on which the FullPageFigure environment is begun.  If it contains
an @Caption command, it will be assigned a number and listed in the List
of Figures.

.I \ FULLPAGETABLE
A full-page floating table.  It will be printed at the close of the page
on which the FullPageTable environment is begun.  If it contains an
@Caption command, it will be assigned a number and listed in the List of
Tables.  (Not available in Brochure and Guide).

.I \ RESEARCHCREDIT
Places text, justified and single-spaced, at the bottom of the title
page, below the copyright notice.  Must be nested within the TitlePage
environment.  (Not available in MilStd837A)

.I \ TABLE
A floating table.  If it contains an @Caption command, it will be
assigned a number and listed in the List of Tables.  (Not available in
Brochure and Guide).

.I \ TITLEBOX
Prints text on the title page in the spot defined as the title box.
Must be nested within the TitlePage environment.  (Not available in
MilStd837A).

.I \ TITLEPAGE
Produces the title page.  Other environments are used within it to print
text on the title page.  (Not available in MilStd837A).

.SH "EXAMPLE"

.nf
    Input:

    @Begin(Titlepage)
    @Titlebox[Scribe Pocket Reference]
    @CopyrightNotice[Scribe Systems Inc.  All rights reserved.]
    @ResearchCredit["Scribe" is a registered
                      trademark of Scribe Systems Inc.]
    @End(Titlepage)

    Output:

                         Scribe Pocket Reference


        Copyright (C) 1988 Scribe Systems Inc.  All rights reserved.





         "Scribe" is a registered trademark of Scribe Systems Inc.
.fi


.SH "STANDARD_TABLES"
The standard table facility is designed to assist the user in creating a
table.  This facility is not designed for every type of table format.
There are more advanced, "non-standard", features available.  Please
consult the "Scribe Advanced User Manual" for more information.

Scribe's standard table facilities are not defined in standard document
types.  To use them, the following command must be included in the .MSS
file:
.nf
           @LibraryFile(Stable)
.fi

This list summarizes the commands, parameters, attributes and values
that are available within Scribe's standard table facility:

.B \ AT-\
Command separates each column entry in a row. (Same as @NextEntry)
Syntax: @\

.B \ BEGIN
Command used to enter a tabular environment.  Parameters when used for
the purpose of placing a table in a document:

   - BoxBM, BoxTM, BoxLM, and BoxRM determine space between text
     and lines in and around the table.

Syntax: @Begin(standardtable-name,...)

.B \ NEXTENTRY
Command separates each column entry in a row. (Same as @\)
Syntax: @Nextentry

.B \ STANDARDTABLE
Command that formats a Scribe standard table.  Parameters listed below:

.nf
    AllColumns, FirstColumn, and OtherColumns:
                  Specify the environment used for one or more columns.
                  Default environment if not specified: FlushLeft.

    Boxed:        Draws all possible lines in and around a table.

    ColumnLined:  Draws lines between columns.

    ColumnWidth, FirstcolumnWidth, OthercolumnWidth:
                  Specify the width of one or more columns.  Must
                  be used for columns with filled and justified text.

    FlushBottom:  Aligns entries by their bottommost lines. (Default)

    FlushTop:     Aligns entries by their topmost lines.

    HeadingBoxed: Draws a box around the TopHeading and around the
                  entries in ColumnHeadings.

    RowLined:     Draws lines between rows.

    TableNumber:  An environment used as a value for AllColumns,
                  FirstColumn or OtherColumns.  Aligns numbers by their
                  decimal points.

    TopHeading, ColumnHeadings:
                  Specify the environment used for the two standard
                  headings.  Default environment if not specified:
                  Center.
.fi


.B \ STOPFOOTING
Command causes Scribe to stop printing a table FOOTING that has the
Continued attribute.  Uses one parameter: "Name".  "Name" is the value
assigned to the Name parameter of an @TableFooting command.

.B \ STOPHEADING
Command causes Scribe to stop printing a table HEADING that has the
Continued attribute.  Uses one parameter: "Name".  "Name" is the value
assigned to the Name parameter of an @TableHeading command.

.B \ TABLECAPTION
Scribe allows you to print a caption on every page of a multi-page
table.  As with a caption for a single-page table, you must enclose the
table in the Figure or Table environment.  To permit a table that is
more than one page long, you must specify the Free attribute within the
"@Begin" statement for the table: @Begin(Table, Free)
To print a caption on each page of a table, you use the command
@TableCaption.  You must specify this command after beginning the Figure
or Table environment and after beginning the standard-table environment.
The syntax is shown below:

.nf
    @TableCaption({Immediate}|{Continued},{Above}|{Below},
            {ContentsOnce}|{ContentsAll}, Line=delimited-text)
.fi

Parameters:

.nf
    Line:         Required.  Specifies the text for the caption.

    Immediate:    Prints the caption on the page where the @TableCaption
                  command is located.

    Continued:    Prints the caption on subsequent pages of the table.

    Above:        Places captions at the top of the table, provided that
                  the IMMEDIATE parameter has not been specified.

    Below:        Places captions at the bottom of the table. (Default)
                  Above and Below are mutually exclusive; only one may
                  be specified.

    ContentsOnce: Creates an entry in the List of Tables for the FIRST
                  caption in the table.   (Default)

    ContentsAll:  Creates an entry in the List of Tables for EVERY
                  caption in the table.
.fi


.B \ TABLEFOOTING
Command places a footing at the bottom of a table. Parameters:

.nf
    Above:      Specifies that this tablefooting will appear above
                other footings that were not so specified.  (Must be
                used with Immediate.)

    Continued:  Specifies that the footing will appear at the bottom
                of the table if it continues on successive pages.

    Immediate:  Sets a footing at the bottom of the page where the
                @TableFooting command appears. The footing will not
                be placed on successive pages if the table is continued.

    Line:       Specifies the text to be placed in the footing.

    RowFormat:  Required.  Takes as a value either "TopHeading" or
                "ColumnHeadings" with the table name assigned by the
                @StandardTable command as a prefix.
.fi


.B \ TABLEHEADING
Command places a heading in a table. Parameters:

.nf
    Continued:   Specifies that the heading will appear at the top of
                 the table if it continues on successive pages.

    Immediate:   Sets a heading where the @TableHeading command appears.
                 The heading will not be placed on successive pages if 
                 the table is continued.

    Line:        Specifies the text to be placed in the heading.

    RowFormat:   Required.  Takes as a value either "TopHeading" or
                 "ColumnHeadings" with the table name assigned by the
                 @StandardTable command as a prefix.
.fi


.B \ TABLEHEADINGWIDTH
Optional STYLE parameter that controls whether column headings will be
taken into account when the widths of table columns are determined.
Takes a boolean value.  If On, the widths of the headings are taken into
account.  If Off, Scribe ignores the column headings when formatting the
columns.
Default value:  On
(Beginning only).

.B \ TABLEID
This command is required.  Has one parameter, "name".  Must appear after
the @Begin command that starts a table and before the first heading or
row entry.  Assigns an identifier to the column width calculations that
Scribe performs.
Syntax: @TableId(name)

.SH "EXAMPLES"

.nf
    Input:

    1. @LibraryFile(Stable)
       ...
       @StandardTable(Name Poker, Columns 3,
         OtherColumns FlushRight, HeadingBoxed)
       @Begin(Poker)
       @TableID(Poker)

       @TableHeading(Immediate, RowFormat PokerTopHeading,
         Line [Poker Hands])
       @TableHeading(Immediate, RowFormat PokerColumnHeadings,
         Line [Hand@\Number
         Possible@\Odds
         Against])

       Royal flush@\4@\649,739 to 1

       Other straight flush@\36@\72,192 to 1

       Four of a kind@\624@\4,164 to 1

       Full house@\3,744@\693 to 1

       Flush@\5,108@\508 to 1

       Straight@\10,200@\254 to 1

       Three of a kind@\54,912@\46 to 1

       Two pairs@\123,552@\20 to 1

       One pair@\1,098,240@\4 to 3

       Nothing@\1,302,540@\1 to 1

       Total@\2,598,960@\

       @End(Poker)


      Output:

                 -------------------------------------------------
                 |                  Poker Hands                  |
                 |-----------------------------------------------|
                 |                      |  Number  |     Odds    |
                 |         Hand         | Possible |   Against   |
                 |-----------------------------------------------|
                 | Royal flush                   4  649,739 to 1 |
                 | Other straight flush         36   72,192 to 1 |
                 | Four of a kind              624    4,164 to 1 |
                 | Full house                3,744      693 to 1 |
                 | Flush                     5,108      508 to 1 |
                 | Straight                 10,200      254 to 1 |
                 | Three of a kind          54,912       46 to 1 |
                 | Two pairs               123,552       20 to 1 |
                 | One pair              1,098,240        4 to 3 |
                 | Nothing               1,302,540        1 to 1 |
                 | Total                 2,598,960               |
                 -------------------------------------------------
.fi

.nf
    Input:

    2. @Libraryfile(Stable)
       ...
       @StandardTable(Name Calendar, Columns 3, Boxed, FlushTop)
       @begin(Calendar)
       @tableid(Calendar)

       @tableheading(immediate,rowformat calendartopheading,
         Line="Dates For May")

       @tableheading(Immediate,rowformat calendarcolumnheadings,
         Line="When@\What@\Where")

       @tablefooting(Immediate,rowformat calendartopheading,
         Line="Dates For May")
       May 5@\Lunch with Ronnie@\White House

       May 7@\Cubs Game@\Wrigley Field,
       Chicago

       May 13@\Fall Showing@\Parsons School of Design,
       New York, New York

       May 19@\Symphony Gala@\London

       May 26@\Memorial Day
       Sailboat Races@\Newport, Rhode Island

       @end(calendar)

      Output:

             ----------------------------------------------------------
             |                     Dates For May                      |
             |--------------------------------------------------------|
             |  When  |       What        |           Where           |
             |--------------------------------------------------------|
             | May 5  | Lunch with Ronnie | White House               |
             |--------------------------------------------------------|
             | May 7  | Cubs Game         | Wrigley Field,            |
             |        |                   | Chicago                   |
             |--------------------------------------------------------|
             | May 13 | Fall Showing      | Parsons School of Design, |
             |        |                   | New York, New York        |
             |--------------------------------------------------------|
             | May 19 | Symphony Gala     | London                    |
             |--------------------------------------------------------|
             | May 26 | Memorial Day      | Newport, Rhode Island     |
             |        | Sailboat Races    |                           |
             |--------------------------------------------------------|
             |                     Dates For May                      |
             ----------------------------------------------------------
.fi


.SH "STYLE_PARAMETERS"
Some @Style parameters expect numeric values (like 1.3 inches), some
expect word values (like Yes or No), and others expect delimited strings
(like "8 March 1952").  Do not use delimiters on word or numeric values;
that is, don't put quotes around Yes.
.B \ BIBSELECT
Specifies whether the document's bibliography is to contain all
references from the .BIB file or just those that were cited with @Cite.
Takes a value from the set {Cited, Complete}.
Default value:  Cited.

.B \ BIBSEQUENCE
Specifies the sequence to be used for sorting the Bibliography.  Takes a
value from the set {Alphabetic, Citation, Numeric}.  If Alphabetic, the
sort will be by Key field and year.  If Citation or Numeric, the
Bibliography will appear in the order in which entries were cited in the
text.
Default value:  Alphabetic.

.B \ BINDINGMARGIN
Horizontal distance for binding doublesided documents.  Its value should
be twice the amount of paper that is expected to be covered by the
staple or binding.  (See the "Syntax_Summary" entry for units of measure
listed in "Numbers_and_Distances")

.B \ BOTTOMMARGIN
Vertical distance between the last line of text and the bottom of page.
(See the "Syntax_Summary" entry for units of measure listed in
"Numbers_and_Distances")
(Beginning only)

.B \ CHANGEBARLOCATION
Specifies the margin in which change bars appear.  Takes a value from
the set {Left, Right, Inside, Outside}.
Default value:  Outside.
(Beginning only)

.B \ CHANGEBAROFFSET
Specifies the distance from the appropriate margin to the center of the
change bar.  (See the "Syntax_Summary" entry for units of measure listed
in "Numbers_and_Distances")
(Beginning only)

.B \ CHANGEBARS
Prints or suppresses change bars.  Takes a boolean value.
Default value:  On.
(Beginning only)

.B \ CITATION
Integer from 1 to 5 that specifies the citation format to be used.
Synonym: Citations.
.nf
    1 = numeric citation, the first work cited is
        numbered 1, etc.

    2 = the key field and the last two digits of the year,
        separated by a space.

    3 = first "CitationLength" letters of the key, followed
        immediately by the last two digits of the year.

    4 = your own key is used for the citation.

    5 = full key field and full year, separated
        by a comma.
.fi


.I \ CITATIONLENGTH
Used when @Style[Citations 3] (portion of author's last name plus last
two digits of year) is in effect.  Specifies how many letters of the
author's name are to be used.
Default value:  3.
.I \ CITATIONSEPARATOR
String to be used to separate multiple citations.
Default value:  Comma.

.I \ CITATIONTYPE
Specifies how citations are to appear in the text.  Takes a value from
the set {Brackets, Parentheses, Period, Plain, Superscripts}.
Default value:  Brackets.

.B \ DATE
Template specifying the style for printing dates.  Must be some
representation of the date Saturday, March 8, 1952.  Month names may be
in English, Spanish, French, or German; numbers may be ordinal,
cardinal, roman, or English.

.B \ DOUBLESIDED
Takes a boolean value.  Yes allows the insertion of extra blank pages to
force major headings onto odd pages if this effect is specified in the
document type.

.B \ EXCEPTIONDICTIONARY
Specifies the dictionary or dictionaries to be used to supplement the
hyphenation algorithm.
Synonym:  ExceptionDictionaries.

.B \ FILEDATE
Date template that specifies the style for printing file dates.  See
entry for Date.

.B \ FONTFAMILY
Name of the FontFamily to use for this document.
(Beginning only)

.B \ FONTSCALE
Basic body type size in which this document will appear.  Meaningful
only for devices that can change type sizes automatically.
Synonym: Size
(Beginning only)

.B \ FOOTNOTES
Counter template for controlling style of footnote numbering.  (See the
"Numbering_Templates" entry for available templates.)
(Beginning only)

.SH "EXAMPLES"
.nf
    1. @Style(Footnotes="@+[@1]")

       This is the current template used by footnotes.

    2. @Style(Footnotes="[@1]")

       This command will put the footnote number in brackets [].
.fi


.B \ FOONOTESABOVEFIGURES
Controls placement of footnotes relative to figures and tables.  Takes a
boolean value.  If On, footnotes are placed above figures and tables
that have the Float Bottom attribute (unless the footnote is specified
in a multiple-column environment that has the FootNotePosition Page
attribute).

.B \ HYPHENATION
Specifies what method of hyphenation is to be used for the document.
Takes a value from the list {AutomaticExact, AutomaticFolded,
DictionaryExact, DictionaryFolded, Off, False, No, On, Yes, True, Warn}.
.B \ HYPHENATIONDICTIONARY
Specifies the dictionary or dictionaries to be used to supplement a
dictionary hyphenation method.
Synonym:  HyphenationDictionaries.

.B \ HYPHENBREAK
Specifies whether a hyphen in the input text can be treated as a line
break if necessary.  Takes a boolean value.  This parameter is
independent of the value of Hyphenation.

.B \ HYPHENSTRING
Specifies the hyphen string to be used for hyphenation.

.B \ INDENT
Horizontal distance indicating amount of indenting for each paragraph,
relative to its left margin.  (See the "Syntax_Summary" entry for units
of measure listed in "Numbers_and_Distances")
Synonym:  Indentation.
(Beginning only)

.B \ JUSTIFICATION
Specifies whether text is to be justified against the right margin.
Takes a boolean value.  Yes means permit those environments that
normally justify to their right margins to do so.  No means never
justify to the right margin.  Once Justification is turned off at the
beginning of a document via @Style, it cannot be turned on.
(Beginning only)

.B \ JUSTIFYLASTPAGE
Controls vertical justification of the last page of a document, a page
ended by an @NewPage command, or a column ended by an @NewColumn
command.  Takes a boolean value.  If On, vertical justification is
attempted at the points mentioned above.  If Off, vertical justification
is not attempted (see the VerticalJustification @Style parameter).

.B \ LARGESTSPACING
Specifies the largest amount of vertical white space that can be
inserted between lines when vertical justification is permitted.  Takes
a numeric value which represents an inter-line distance.  If Scribe must
exceed this value to achieve vertical justification of a page or column,
the page or column will remain unjustified (see the
VerticalJustification @Style parameter).

.B \ LARGESTVERTICALGAP
Specifies the largest amount of vertical white space that can be
inserted due to vertical justification.  Takes a numeric value which
represents a vertical distance.  If Scribe must exceed this value to
achieve vertical justification of a page or column, the page or column
will remain unjustified (see the VerticalJustification @Style
parameter).

.B \ LEADERS
Specifies leadering to a tab stop or to text.  Takes a value from the
set {Old, New}.  New produces leadering to text; Old produces leadering
to a tab stop.
Default value:  New.

.B \ LEFTMARGIN
Horizontal distance of the global left margin from the physical left
margin of the page.  (See the "Syntax_Summary" entry for units of
measure listed in "Numbers_and_Distances")
(Beginning only)

.B \ LINEWIDTH
Horizontal distance from the global left margin to the end of the line.
(See the "Syntax_Summary" entry for units of measure listed in
"Numbers_and_Distances")
(Beginning only)
.B \ MULTIPLEBIBLIOGRAPHY
Specifies whether more than one Bibliography file needs to be processed.
Takes a boolean value.

.B \ NOTES
Specifies where to place footnotes.  Takes a value from the set
{Footnotes, Endnotes, Inline}.
(Beginning only)

.B \ ORPHANACTION
Controls the processing of orphan lines.  Takes a value from the set
{Force, ForceWarn, Ignore, Warn}.
Default value:  Ignore.

.B \ PAGENUMBER
Counter template specifying the style of page numbering.  (See the
"Numbering_Templates" entry for available templates.)

.SH "EXAMPLES"

.nf
    1. @Style(Pagenumber=<@i>)
       This command will produce the page numbers in lower-case
       roman numerals.

    2. @Style(Pagenumber=<Page @1>)

       This command will produce page numbers of the form:
       Page 1,  Page 2, ...
.fi


.B \ REFERENCES
Name of entry in the bibliography database specifying which reference
and citation styles to use. (See the "Reference_Format" subtopic in the
"Bibliographies" entry for a complete list of available reference
types.)
Synonym:  ReferenceFormat.

.B \ RIGHTMARGIN
Horizontal distance between the end of the text line and the physical
right margin of the page.  (See the "Syntax_Summary" entry for units of
measure listed in "Numbers_and_Distances")
(Beginning only)
.B \ SINGLESIDED
Turns off DoubleSided.  Takes no value.

.B \ SIZE
Basic body type size in which this document will appear.  Meaningful
only for devices that can change type sizes automatically.
Synonym: FontScale
(Beginning only)

.B \ SPACES
Sets the value of the Spaces attribute for the document.  Takes a value
from the set {Kept, Compact, Ignore, Tab, Null, Ignored, Normalize,
Normalized, NoBreak}.

.B \ SPACING
Vertical distance from base of one line to text of the next.  (See the
"Syntax_Summary" entry for units of measure listed in
"Numbers_and_Distances")
(Beginning only)

.B \ SPREAD
Vertical distance added to Spacing to specify the vertical spacing
between paragraphs.  (See the "Syntax_Summary" entry for units of
measure listed in "Numbers_and_Distances")
(Beginning only)

.B \ TABLECONTINUATION
Specifies whether or not bottom and top borders will be printed when a
standard table continues across pages.  (See the "Standard_Tables" entry
for more information).  Takes a value from the set {Open, Closed}.
Default value:  Closed.

.B \ TABLEHEADINGWIDTH
Controls whether column headings will be taken into account when the
widths of table columns are determined.  Takes a boolean value.  If On,
the widths of the headings are taken into account.  The width of a
column heading will never exceed a MaxWidth specification if one has
been provided.  If Off, Scribe ignores the column headings when
formatting the columns.
Default value:  On
(Beginning only).

.B \ TIME
Template specifying the format in which @Value(Time) will be printed.
Similar to Date; must be some representation of the time 4:30 p.m.
.B \ TIMESTAMP
Like Time, but specifies the format in which @Value(TimeStamp) is
printed.  Must be some representation of the date Saturday, March 8,
1952 and of the time 4:30 p.m.

.B \ TOPMARGIN
Vertical distance from the top of the paper to the baseline of the first
text line on the page.  (See the "Syntax_Summary" entry for units of
measure listed in "Numbers_and_Distances")
(Beginning only)

.B \ VERTICALJUSTIFICATION
Controls vertical justification.  Takes a value from the set {Breaks,
Controlled, EveryLine, Off, On}.  If the Breaks or the On parameter is
specified, vertical justification is achieved by adding space around
paragraphs, section headings, floated and grouped environments,
environments with the Break attribute, and @BlankSpace commands.  If
EveryLine, space is added between lines of text.  If Controlled, space
is added where the command @VerticalSpace is specified.  If Off, no
vertical justification is attempted.  Default value when mentioned:  On.
Default value when not mentioned:  Off.

.B \ WIDESTBLANK
Horizontal distance giving the maximum amount of white space that will
be tolerated in a line before hyphenation will be attempted.

.B \ WIDOWACTION
Controls the processing of widow lines.  Takes a value from the set
{Force, Warn, ForceWarn, Ignore}.
Default value: Ignore.

.SH "SYNTAX_SUMMARY"
By "syntax" we mean the rules for what characters are allowed in what
positions.  Can a cross-reference name contain a hyphen?  Can you put
spaces after the commas in a @PageHeading command?  This covers the
general rules that apply to all the commands and environments in Scribe.

Capitalizing

Capitalizing only matters in the numbering templates listed in the entry
"Numbering_Templates".  For every other Scribe term, command,
environment, or attribute, it does not matter.  For example, @BEGIN is
as good as @begin or @BeGiN.  We usually use mixed case because we find
it easier to read.  As you can see from any of the examples, anything
goes.
Delimiters

Scribe recognizes seven pairs of delimiters.  Any of the pairs is valid
anytime.  The only restriction is that you use the closing delimiter
that matches the opening one.

.nf
    { }      [ ]      < >      ( )      " "      ` '      ' '
.fi


.B \ CARRIAGE_RETURN
Whether a carriage return is part of a command or part of the manuscript
text depends on where the @ sign for the command is.  When the @ sign is
the first character on a line, then the end-of-line following it is part
of the command, not part of the text.  When the @ sign is anywhere else
on the line, then an end-of-line following it is part of the manuscript
text.

.B \ NAMES
There are some restrictions on the "name" a user choses for a string or
environment definition or even a codeword to an @Tag or @Label command.
Be sure to check the appropriate list of characters restricted from this
usage.

.I \ STRINGS_AND_ENVIRONMENTS
Names for strings and environments (defined with @String and
@Define) can be any length you want.  They too can contain any
number or letter, but the set of special characters not permitted in
strings is more restricted than for labels.  Only three special
characters are permitted:

.nf
      #    pound sign
      &    ampersand
      %    percent sign
.fi


.I \ TAGS_AND_LABELS
Code names that you define with @Tag and @Label can be as long or
short as you want.  They can contain any number or letter and any of
the following special characters.

.nf
      #    pound sign
      .    period
      -    hyphen
      &    ampersand
      %    percent sign
.fi

The following special characters are not allowed in code names
because they have special meanings in Scribe:

.nf
      /    slash
      ,    comma
      ;    semicolon
      _    underscore
      =    equal sign
           any of the delimiter characters
.fi


.B \ NUMBERS_AND_DISTANCES
Numbers representing distances can be carried to 4 significant figures.
For example, @Style(Spacing=0.884cm) actually attempts to set the final
printing device to the requested line spacing of 0.884 centimeters.  Of
course, if the printing device is not capable of the resolution you
request, Scribe will give you the positioning closest to the requested
value.
Numbers whose meaning depends on the size of the current font (values
for lines, characters, spacing, and so on) are carried only to the
nearest tenth of a line or tenth of a character, meaning that
@Style(Spacing=1.634) is treated as @Style(Spacing=1.6).
In specifying distance, you can use any of the following units.  All
units in the same row are equivalent.

.nf

Table of Distance Units

    in, inch, inches, "
    cm, centimeters
    mm, millimeters
    pt, pts, point, points
    pica, picas
    em, ems, quad, quads
    char, chars, character, characters, en, ens
    line, lines
.fi

.B \ PARAMETERS
Some commands, such as @Style and @Pageheading, contain a list of
parameters and values.  Sometimes the values are delimited strings.
(See the entries for "Style_Parameters" and "Page_Headings".)  It is
good practice to always put delimiters around parameter values, but as
the general rule is that if the value contains a Scribe delimiter,
spaces, or a comma, it should be delimited.

.nf
    @Style(parameter1=value1, parameter2 "value2", parameter3 [value3])
.fi

Parameters and values come in pairs.  You need to separate pairs from
each other with commas.  Both the separators and the commas can have any
number of spaces surrounding them.  That is, the following command means
exactly the same as the one above.

.nf
    @Style(
            Parameter1      value1,
            Parameter2   =    "value2"
            ,Parameter3=    [Value3]
    )
.fi

As you can see, you need some way of separating a parameter from its
value. Three characters are valid separators:

.nf
      =    equal sign
      /    slash
           a space
.fi

Delimited values cannot contain any instances of the closing delimiter,
even if it is paired with its opening delimiter.  For example, the
characters in "value2" above could not contain a double-quote, and the
characters in "value3" could not contain a closing square bracket "]".

.B \ SPACES
Where can a space go in a Scribe command or environment?  A command
starts with an "@" character.  The command or environment name must
immediately follow the "@" sign.  (This restriction is necessary because
@ followed by a space is actually a command for a significant blank.)
You can put a space between a command or environment name and its
opening delimiter, but that practice is very poor stylistically.

Poor Style:

.nf
    @Begin [Display]
    @Heading  [How I Spent My Summer Vacation]
.fi

Proper Style:

.nf
    @Value[Date]
    @Chapter[Introduction]
.fi


.B \ USE_OF_DELIMITERS

Environments

Environments can appear in either a long form (with @Begin/@End) or a
short form (with just the name).  For environments, @Begin and @End used
with the environment name act themselves as delimiters.  For example,
"@Begin(Description)" would be equivalent to "@Description[" (or to
@Description with any opening delimiter); @End(Description) would be
equivalent to "]" (or to whichever closing delimiter matches the opening
delimiter).

Commands

For commands, you can never use @Begin and @End as delimiters; that is,
you must always use the short form with one of the delimiter pairs.  For
example

.nf
    @PageHeading<left "@Value(Page)",right "@value(Sitename)">
.fi

Another way of saying this is that commands have only a short form.
