.;	Chapter 6
.;	RUNOFF Text Formatting Command Descriptions.
.;	
.;	02-Jan-79 H.R. Tumblin
.;
.;	Edits
.;	
.;	Date	By	No.	Reason
.;   ---------	------	-----	--------------------------------------------
.;   03-Jul-80	BCW	1	Fixed typographical errors
.;   14-Jul-80  JB	2	Correct errors and match ROCKWELL 
.;				metacharacters
.;   21-Sep-81	JB	3	Change the DA and DAT commands
.;
.ch;Text Formatting Commands
.in RNOCHAINI
.ix <runoff commands
.;
.pp
The following commands will be recognized if they are at the beginning
of a line started with a period. Any line in the source file beginning
with a period is assumed to be one of these commands. If it is not, an
error diagnostic will be typed and the line will be ignored. Some
commands take one or more decimal number arguments. These are
separated from the command by a space. More than one command may be
entered on a single line by separating the commands with a semicolon
(;) or a period (.).
.pp
Multi-word commands may appear in any form.  Thus,
<.no header and <.noheader are both legal.
.pp
Many commands may be abbreviated. Standard abbreviations are given
below each command.
.;
.ix Formatting
.ix Commands, formatting
.ix Text Formatting
.PP
Text Formatting commands are a class of RUNOFF commands that allow the
user to affect the appearance of the text on a page. Blank lines,
line breaks, comments, and text centering.
.pg
.lm 60.NF
__________
|        |
|        |
|   .BL  |
|        |
|________|
.FI.lm 8
.hl 1;BLANK command
.ix BL
.ix BLANK
.ix B
The BLANK command generates a specified number of blank output lines.
.s.lm 15.NF
_______________________________________________
|         |                                   |
|   .BL   |     [ n ]                         |
|         |                                   |
|_________|___________________________________|
.FI.lm 8.s
BLANK is exactly like SKIP, except that "n" (rather than n*(line spacing))
lines are specified. Blank is used where space is to be left independent
of the line spacing, whereas SKIP is used where the space should
be relative to the size of the line space.
.s 2
Defaults:
.s;.lm 15
This command does create a break when encountered and if the operand is
omitted, then ^&n=1\& will be assumed.
.s 2;.lm 8
Command Synonyms:
.s;.lm 15
 .BLANK , .B, .BL
.s 2;.lm 8
Notes:
.s;.lm 15
The .BL command within footnotes causes blank lines to be generated within
the printout of the footnote at the bottom of the page.
.pg
.lm 60
.nf
__________
|        |
|        |
|   .BL  |
|        |
|________|
.fi.lm 8.s 2
Examples:
.s.lm 15;.NF
 Dear Sirs,
 .BL 2
  In regards to the new fleet of trucks that you have   supplied us
  with, my service manager informs me that ... 
.s 2.lm 8.fill
Produces:
.s.lm 15
Dear Sirs:
.blank 2 
In regards to the new fleet of trucks that you have
supplied us with, my service manager informs me that ...
.s 2.lm 8
.pg
.lm 60.NF
__________
|        |
|        |
|   .BR  |
|        |
|________|
.FI.lm 8
.hl 1;BREAK command
.IX <BREAK
.ix BR
BREAK causes the immediately previous line to be typed without
filling in with words from the next line.
.s.lm 15.NF
_______________________________________________
|         |                                   |
|   .BR   |                                   |
|         |                                   |
|_________|___________________________________|
.FI
.lm 8
.s
BREAK is used to prevent concatenation of lines such as paragraph headings
or the last line of a paragraph. It causes the preceding line to be typed
as a short line if it is shorter than the current line length.
.s
Defaults:
.s;.lm 15
This command does create a break. That is its only function.
.s.lm 8
Command Synonyms:
.s.LM 15
 .BREAK, .BR
.s 2;.lm 8
Notes:
.s;.lm 15
Many of the other commands act as a BREAK. No BREAK is necessary when one 
of these is present. The description of each command states, in the section
titled ^&Defaults\&, whether that control word acts as a break or not.
.br
If NO FILL is in effect, then all lines appear to be followed by a break.
.PG
.lm 60.NF
__________
|        |
|        |
|   .BR  |
|        |
|________|
.FI.lm 8.s 2
Examples:
.s.lm 20
#Heading:
.BR
#.br
#First line of paragraph ...
.s
.lm 8
This example would be printed as:
.lm 15
.s
Heading:
.br
First line of paragraph ...
.lm 8
.s
Without the BREAK, it would be printed:
.s
.lm 15
Heading: First line of paragraph ...
.pg
.lm 60.NF
__________
|        |
|        |
|   .CE  |
|        |
|________|
.FI.lm 8
.hl 1;CENTER command
.IX ^RELATIVE ARGUMENTS
.ix CENTER
.ix CENTRE
.ix CE
.ix C
The line following the CENTER command will be centered between the 
two margins.
.s.lm 15.NF
_______________________________________________
|         |                                   |
|   .CE   |      [ n ]                        |
|         |                                   |
|_________|___________________________________|
.FI.lm 8.s
This command causes a break after which it centers the next line following
in the source file. The centering is over column "n"/2, independent of
the setting of the left and right margins. If "n" is missing, then
"n" is assumed to be the paper width, which is initially 60. For
more information on the paper size, see the PAPER SIZE command
elsewhere in this document.
.s 2;.lm 8
Defaults:
.s 2;.lm 15
Centering is performed over the paper width, which is initially set to 
60. This command does perform a BREAK.
.s 2;.lm 8
Command Synonyms:
.s;.lm 15
 .CENTER, .CENTRE , .C, .CE
.s 2;.lm 8
Notes:
.s 2;.lm 15
CENTER, RIGHT MARGIN, LEFT MARGIN, PAGE SIZE, AND STANDARD
take both relative and absolute values. Relative values are
expressed as "+n" or "-n", while absolute values are unsigned.
.pg
.lm 60
.NF
__________
|        |
|        |
|   .CE  |
|        |
|________|
.FI
.lm 8
.s 2
Another form of the CENTER command is :
.s
.indent 5
#.CE [n]; text ..... text
.s
This form allows the concatenation of the text to be centered with the
command itself, thus allowing flexibility in the use of this command.
.s 2;.lm 8
Examples:
.s;.lm 15
.nf
 .CE 60 ; Figure 6.3  Absolute Memory Diagram
.s
.lm 8
Produces:
.C 60; Figure 6.3 Absolute Memory Diagram
.F
.;
.pg
.lm 60.NF
__________
|        |
|        |
|   .CO  |
|        |
|________|
.FI.lm 8
.hl 1;COMMENT command
.IX COMMENT
.ix CO
.ix .;
COMMENT causes the remainder of the current line to be ignored.
.s.lm 15.NF
_______________________________________________
|         |                                   |
|   .CO   |      text                         |
|         |                                   |
|_________|___________________________________|
.FI.lm 8.s
COMMENT causes the remainder of the current line to be ignored. The text
is not printed, but rather is used as a comment line in the source
text.
.s 2;.lm 8
Defaults:
.s;.lm 15
This command is only used to insert lines of internal documentation
into the text. There is no other function that this command performs.
.s 2;.lm 8
Command Synonyms:
.s;.lm 15
  .;, .COMMENT, .CO
.s 2;.lm 8
Notes:
.s;.lm 15
This command can be concatenated with other commands by using a semi-colon(;).
It is usually a good idea to place some sort of identification or version
number internal to a document for the maintainer of the document and also
to keep track of any edits to the document.
.pg
.lm 60.nf
__________
|        |
|        |
|   .CO  |
|        |
|________|
.fill.lm 8
.s2
Examples:
.s;.lm 15
 .CO       Letter to all users of DEC equipment in New England
.BR
 .;	Edited on 24-Aug-78 to allow salesmen 
.BR
 .;       end of internal documentation.
.BR
.pg
.lm 60.NF
__________
|        |
|        |
|   .DA  |
|        |
|________|
.FILL.lm 8.s
.index DA
.hl 1;Date command
Insert date string in lower right corner of page if numbering pages at
the bottom.  Insert date string in upper right corner of page under
the page number if numbering pages at the top right.
.s.lm 15.nf
_______________________________________________
|         |                                   |
|   .DA   |     [ ; ][ text ]                 |
|         |                                   |
|_________|___________________________________|
.FI.lm 8.s
The DAte command will print up to sixteen characters of "text"
in the bottom right hand corner of the current page or top right hand
corner of the page.  The semicolon is not required if text is input.
If the semicolon and the text are omitted, the
current system date is used.  If the text is omitted, the date field
is cleared and no date is printed.
.s 2.lm 8
Defaults:
.s.lm 15
The date string is empty by default (the date command has not been
encountered).
.s 2.lm 8
Command Synonyms:
.s.lm 15
 .DA
.s 2.lm 8
Notes:
.s.lm 15
Page numbering must be enabled for this feature to work. This command
may be given as many times as required. Usually the date is given, but
any sixteen characters may be used.
.s 2.lm 8
Examples:
.s.lm 15
 .DA
.s 1
puts the current system date at the lower right of the page for pages numbered
at the bottom and the upper right of the page for pages numbered at the top.
.pg
.lm 60.NF
__________
|        |
|        |
|   .DAT |
|        |
|________|
.FILL.lm 8.s
.ix DAT
.hl 1;Table of Contents Date command
Insert date string in lower right corner of the TOC page.
.s.lm 15.nf
_______________________________________________
|         |                                   |
|   .DAT  |     [ ; ][ text ]                 |
|         |                                   |
|_________|___________________________________|
.FI.lm 8.s
The DATe command will print up to sixteen characters of "text"
in the bottom right hand corner of the current Table of Contents page.
The semicolon is not required if text is input.  If the semicolon and
the text are omitted, the current system date is used. If just the text is
omitted, the date string is cleared.
.s 2.lm 8
Defaults:
.s.lm 15
The date string is empty by default (the date command has not yet been
encountered).
.s 2.lm 8
Command Synonyms:
.s.lm 15
 .DAT
.s 2.lm 8
Notes:
.s.lm 15
This command has no effect on the .DA command. Usually the date is
given, but any sixteen characters may be used.
.s 2.lm 8
Examples:
.s.lm 15
 .DAT Edit 010203
.s 1
puts "Edit 010203" in the bottom right corner of the Table of Contents
pages for pages numbered at the bottom and the upper right for pages
numbered at the top.
.pg
.lm 60.NF
__________
|        |
|        |
|   .ELS |
|        |
|________|
.FI.lm 8
.hl 1;END LIST command
.IX END LIST
.ix ELS
.ix ENDLIST
The END LIST command terminates the effect of a previous
LIST command.
.s.lm 15.NF
_______________________________________________
|         |                                   |
|   .ELS  |                                   |
|         |                                   |
|_________|___________________________________|
.FI.lm 8.s
END LIST terminates the list command and returns to the the settings before
the last LIST Command.
.s 2;.lm 8
Defaults:
.s 2;.lm 15
This command does perform a break. The starting column of further
LIST-ELEMENTS will be 5 positions to the left of the current list. The
LIST-ELEMENT-NUMBER of further LIST-ELEMENTS will continue where it
left off, due to the effect of the previous list command.
.s 2;.lm 8
Command Synonyms:
.s 2;.lm 15
 .ELS, .END LIST, .ENDLIST
.s 2;.lm 8
Notes:
.s 2;.lm 15
An END-LIST command with no previous matching LIST command is considered
an error. Currently, LIST/END-LIST command pairs may only be nested
to a depth of three. A list command that exceeds this level will
be reported as an ILLEGAL command. 
.pg.lm 60.NF
__________
|        |
|        |
|   .ELS |
|        |
|________|
.FI.s 2;.lm 8
Examples:
.s 2;.lm 15
.NF
       An Interesting list of books may be 
 .LS
 .LE ; Introduction to Horticulture.
 .LE ; Call me when you find America - A Doonesbury book. 
 .LE ; SPSS Users Manual.
 .ELS
.FILL
.s 2;.lm 8
Produces:
.S;.lm 15
.indent 5; An Interesting list of books may be
.LS
.LE ; Introduction to Horticulture.
.LE ; Call me when you find America - A Doonesbury book.
.le ; SPSS Users Manual.
.ELS
.s 2;.lm 8
.pg
.LM 60.NF
__________
|        |
|        |
|   .EN  |
|        |
|________|
.FI.lm 8
.hl 1;END NOTE command
.IX EN
.ix END NOTE
.IX ENDNOTE
This command terminates the NOTE Command.
.s.lm 15.NF
_______________________________________________
|         |                                   |
|   .EN   |                                   |
|         |                                   |
|_________|___________________________________|
.FI.s 2.lm 8
The END NOTE command terminates the NOTE command.
.s 2
Defaults:
.s.lm 15
This command
BLANKS 2, and reverts the margins
and spacing modes to their settings before the last NOTE command,
then resumes normal character processing.
.s 2.lm 8
Command Synonyms:
.s.lm 15
 .EN, .END NOTE, .ENDNOTE
.s 2.lm 8
Notes:
.s.lm 15
Note processing checks for a reasonable amount of room on the page,
but if the note is long, one should do a TEST-PAGE-N command, where
N is the expected line size plus 5.
.pg.lm 60.NF
__________
|        |
|        |
|   .EN  |
|        |
|________|
.FI.lm 8.s 2
Examples:
.s.lm 15.NF
 .NT
 This situation only arises during high utilization
 periods, or during a breakdown.
 .EN
.FILL
.S 2.lm 8
Produces:
.s.lm 15
.NT
This situation only occurs during high utilization periods,
or during a breakdown.
.en
.s 2.lm 8
.pg
.lm 60.NF
__________
|        |
|        |
|   .FG  |
|        |
|________|
.FI.lm 8
.IX FG
.hl 1;FIGURE command
Skip one page for a figure.
.s.lm 15.NF
_______________________________________________
|         |                                   |
|   .FG   |                                   |
|         |                                   |
|_________|___________________________________|
.FI.lm 8.s
This command will leave one blank page for a figure following the
current page.  If numbering pages at the bottom, multiple figure
commands will only print one blank page with all of the figure page
numbers printed on it.
.s 2.lm 8
Defaults:
.s.lm 15
This command does not a break.
.s 2.lm 8
Command Synonyms:
.s.lm 15
 .FG
.page.lm 60.nf
__________
|        |
|        |
|   .FG  |
|        |
|________|
.fill
.s 2.lm 8
Examples:
.s.lm 15
.pg
.lm 60.NF
__________
|        |
|        |
|   .FGD |
|        |
|________|
.FI.lm 8
.IX FGD
.IX FIGURE
.hl 1;Old FIGURE command
FIGURE is used where room for a figure to be drawn is needed.
.s.lm 15.NF
_______________________________________________
|         |                                   |
|   .FGD  |      [ n ]                        |
|         |                                   |
|_________|___________________________________|
.FI.lm 8.s
Like BLANK, FIGURE leaves blank lines on the page, except that if less
than "n" lines remain on the current page, the page will be advanced,
and "n" blank lines will be left at the top of the new page. This command
is principally used where it is desired to leave room for a figure to be
drawn in manually on a page.
.s 2.lm 8
Defaults:
.s.lm 15
This command will cause a break.
.s 2.lm 8
Command Synonyms:
.s.lm 15
 .FIGURE, .FGD
.pg
.lm 60.nf
__________
|        |
|        |
|   .FGD |
|        |
|________|
.f
.s 2.lm 8
Examples:
.s.lm 15
 line of text
.br
 .FGD 15
.BR
 another line of text
.s2
Produces:
.s.lm 15
line of text
.fgD 15
another line of text
.s 2;.lm 8
.pg
.lm 60.NF
__________
|        |
|        |
|   .FN  |
|        |
|________|
.FI.lm 8
.hl 1;FOOTNOTE command
.IX FOOTNOTE
.IX FN
FOOTNOTE is used to generate footnotes at the bottom of the
current page.
.s.lm 15.NF
_______________________________________________
|         |                                   |
|   .FN   |      [ n ]                        |
|         |                                   |
|_________|___________________________________|
.FI.lm 8.s
The FOOTNOTE command saves "n"*(line spacing)
lines at the bottom of the current page for
a footnote. The "n" is multiplied by the number of spaces set with the 
SPACING command. If insufficient room remains on the current page, then
space is allocated on the bottom of the following page.
The footnote is terminated with a line beginning with an exclamation
point (the remainder of which is ignored).
The lines delimited by this line and the FOOTNOTE command are put into
a buffer to be processed when the output moves to within the stated distance
to the bottom of the page.
.s 2.lm 8
Defaults:
.s.lm 15
This command does not cause a break. An operand must be provided
as none will be assumed. 
.s 2.lm 8
Command Synonyms:
.s.lm 15
 .FOOTNOTE, .FN
.s 2.lm 8
.pg.lm 60.NF
__________
|        |
|        |
|   .FN  |
|        |
|________|
.S 2.LM 8.FI
Notes:
.s.lm 15
The text of a footnote should begin on the line following the FOOTNOTE
command. Indentation, case lock, justify, margins, spacing, and fill
are preserved around footnotes. However, commands that affect page
formatting are illegal within a footnote. Therefore, a footnote may
contain commands which change these parameters, and the effect will be
limited to the footnote text. Tab stops are illegal because they are
not preserved. A footnote within a footnote is also illegal. The
actual space taken by a footnote page can be more or less than
specified by "n". The "n" merely allocates space and should be the
user's best guess. If it is considerably off, the footnote line may
overflow the page, or extra space may be left at the bottom. If
necessary, adjust "n" after examining a draft printout.
.S
The last line of any footnote must be a line containing an
exclamation mark. Any text on the line after the exclamation mark
will be ignored.
.s
If a page has multiple footnotes, the allocated space is the sum of 
the allocations for all footnotes assigned to this page. The user
must include their choice of footnote-designating symbols within
the text.
.pg.lm 60.NF
__________
|        |
|        |
|   .FN  |
|        |
|________|
.FI.lm 8.s 2
Examples:
.s;.lm 15;.nf
 .IN -4
 (a) As Anderson -1- 
 .FN 5
 .lm 8;.rm 80
 .C;--------------------
 .IN -5;-1- Anderson, D.A.,
 %^%&Grundlagen_der_Madchenjadgt%\%&,
 MIT Press, August 1932.
 ! end of current footnote
 has noted, this phenomenon is indigenous to ...
.s 2;.lm 8;.fill
Produces:
.s;.lm 15
.INDENT -4
(a) As Anderson -1-
.FN 5
.lm 8.rm 80.FILL
.C;--------------------
-1- Anderson, D.A.,
^&Grundlagen_der_Madchenjadgt\&, 
MIT Press, August 1932.
!
has noted, this phenomenon is indigenous to ...
.s 2;.lm 8
.pg
.lm 60.NF
__________
|        |
|        |
|   .ID  |
|        |
|________|
.FI.lm 8
.hl 1;INDENT command
.ix ID
.ix I
.IX INDENT
INDENT forces a break and causes the next output line to start a specified
number of columns from the current input column.
.s.lm 15.NF
_______________________________________________
|         |                                   |
|   .ID   |      [ +n|-n ][ ;text ]           |
|         |                                   |
|_________|___________________________________|
.FI.S.lm 8
The INDENT command causes a BREAK and sets the next line to begin "n"
spaces to the right of the left margin. "n" may have a negative value
to allow the line to begin to the left of the left margin. This is
rather useful for numbered paragraphs.
.s 2.lm 8
Defaults:
.s.lm 15
The indent is performed to the right of the left margin. There is
no default value for "n", and an error message will be generated
if "n" is not specified. This command does cause a break.
.s 2.lm 8
Command Synonyms:
.s.lm 15
 .INDENT, .ID, .I 
.s 2.lm 8
Notes:
.s.lm 15
INDENT will perform a relative movement from the existing
margins. Text can be specified on the same line as the
INDENT command by using the concatenation character, ";".
.pg.lm 60.NF
__________
|        |
|        |
|   .ID  |
|        |
|________|
.FI.lm 8.s 2
Examples:
.s;.lm 15
.nofill
 Line 1
 .ID -4;Line 2
 .ID 4;Line 3
 .BR
  Line 4
.FILL.s 2.lm 8
Produces:
.nf
.s1
    |Line|1
Line|2   |
    |    |Line 3
    |Line|4
.pg
.lm 60.NF
__________
|        |
|        |
|   .IHL |
|        |
|________|
.FILL.lm 8.s
.ix Increment Header Level
.ix IHL
.hl 1;Increment Header Level
Increment header level.
.s.lm 15.nf
_______________________________________________
|         |                                   |
|   .IHL  |      n                            |
|         |                                   |
|_________|___________________________________|
.FI.lm 8.s
The IHL command increments header level "n" by 1.
.s 2.lm 8
Defaults:
.s.lm 15
This command does not cause a break.
.s 2.lm 8
Command Synonyms:
.s.lm 15
 .IHL
.s 2.lm 8
Notes:
.s.lm 15

.s 2.lm 8
Examples:
.s.lm 15
 .IHL 3
.pg
.lm 60.NF
__________
|        |
|        |
|   .IO  |
|        |
|________|
.FILL.lm 8.s
.ix Index Offset command
.ix INDEX OFFSET
.IX IO
.IX INDEXOFFSET
.hl 1;Index Offset Command
Set index offset.
.s.lm 15.nf
_______________________________________________
|         |                                   |
|   .IO   |     n                             |
|         |                                   |
|_________|___________________________________|
.FI.lm 8.s
The Index Offset command allows the centering of chapter
and page numbers in the index to change. The "n" specifies the
number of spaces to move the index to the right.
.s 2.lm 8
Defaults:
.s.lm 15
 The default Index Offset is zero.
.s 2.lm 8
Command Synonyms:
.s.lm 15
 .IO, .INDEX OFFSET, .INDEXOFFSET
.s 2.lm 8
Notes:
.s.lm 15
With n equal to zero, the spacing is not changed from the normal index
command.
.pg
.lm 60.NF
__________
|        |
|        |
|   .IO  |
|        |
|________|
.FILL.lm 8.s
.s 2.lm 8
Examples:
.s.lm 15
 .IO 10
.pg
.lm 60.NF
__________
|        |
|        |
|   .IN  |
|        |
|________|
.F.lm 8.s
.ix INCLUDE command
.ix IN
.ix INCLUDE
.hl 1;Include command
Include text from a file.
.s.lm 15.nf
_______________________________________________
|         |                                   |
|   .IN   |     filespec                      |
|         |                                   |
|_________|___________________________________|
.FI.lm 8.s
The INCLUDE command allows the user to specify a file
to be inserted at the current point in the input stream.
.s 2.lm 8
Defaults:
.s.lm 15
The default file type is .RNO.
.s 2.lm 8
Command Synonyms:
.s.lm 15
 .IN, .INCLUDE
.s 2.lm 8
Notes:
.s.lm 15
The include command is usefull in specifying parameters for a
particular printer or installation in an include file. Include files
may include other include files. The only limit to the depth which
include files can be nested is the amount of dynamic memory available.
Typically, if no footnotes or index entries are used, the nesting
limit is around 1000.
.pg
.lm 60.NF
__________
|        |
|        |
|   .IN  |
|        |
|________|
.F.lm 8.s
.s 2.lm 8
Examples:
.s.lm 15
 .IN PARAMS.RNO
.pg
.lm 60.NF
__________
|        |
|        |
|   .LA  |
|        |
|________|
.FILL.lm 8.s
.ix LA
.ix List Alphabetic
.hl 1;List Alphabetic Command
Add an alphabetically numbered item to a list.
.s.lm 15.nf
_______________________________________________
|         |                                   |
|   .LA   |    test_page;text                 |
|         |                                   |
|_________|___________________________________|
.FI.lm 8.s
The LIST ALPHABETIC command adds an alphbetically numbered item
to a list started by a .LIST command. The elements are numbered
in lower case alphabetic characters.  The test_page number is used for
an implied test page command.  The number is taken as the number of
half line which must remain on the page if the list element is to be
printed on that page.  The test_page count is in effect for all
remaining list element commands of any type.
.s 2.lm 8
Defaults:
.s.lm 15
This command does cause a break.
.s 2.lm 8
Command Synonyms:
.s.lm 15
 .LA
.s 2.lm 8
Notes:
.s.lm 15
The letter is followed by a period and two spaces so that the indent will 
be by -4.
The list elements are seperated by the standard paragraph
spacing and TEST PAGE. If you want to type the text on the same line
as the command, you must separate the text from the command with any
number of intervening spaces or tabs, or (optionally) one semicolon.
.pg
.lm 60.NF
__________
|        |
|        |
|   .LA  |
|        |
|________|
.FILL.lm 8.s
.s 2.lm 8
Examples:
.s.lm 15
.pg
.lm 60.NF
__________
|        |
|        |
|   .LE  |
|        |
|________|
.FI.lm 8
.hl 1;LIST ELEMENT command
.IX LIST ELEMENT
.ix LE
.IX LISTELEMENT
The LIST ELEMENT command starts an item in a list.
.s.lm 15.NF
_______________________________________________
|         |                                   |
|   .LE   |      test_page;text               |
|         |                                   |
|_________|___________________________________|
.FI.s.lm 8
LIST ELEMENT starts an item in a list with a decimal number. This
command is used in conjunction with the LIST command. The test_page
number is used for an implied test page command. The number is taken
as the number of half line which must remain on the page if the list
element is to be printed on that page. The test_page count is in
effect for all remaining list element commands of any type.
.s 2.lm 8
Defaults:
.s.lm 15
This command does cause a break. 
The "LIST ELEMENT NUMBER" is automatically incremented by each call to
LIST-ELEMENT.
.s 2.lm 8
Command Synonyms:
.s.lm 15
 .LIST ELEMENT, .LE, .LISTELEMENT
.s 2.lm 8
Notes:
.s.lm 15
The elements of the list are numbered sequentially, and the number is
given a negative indent so that the list lines up. The number is
followed by a period and two spaces so that the indent will be by
-4. The list elements are separated by the standard paragraph 
spacing and TEST PAGE. If text is desired on the same line as
the command, then the text must be separated from the command by
a space, tab, or semi-colon. This command must be preceded
by a LIST-START command, or it will be flagged as an error.
.pg.lm 60.NF
__________
|        |
|        |
|   .LE  |
|        |
|________|
.FI.lm 8.s 2
Examples:
.s.lm 15.nf
 A possible list of Newspapers would be :
 .LS 
 .LE;In the BOSTON area:
 .LS
 .LE;The Boston Globe.
 .LE;The Boston Herald American.
 .ELS
 .LE;In the NEW YORK area:
 .LS
 .LE;The New York Times.
 .LE;The Daily News.
 .ELS
 .;.LE;On the West Coast.
 .;.LS;
 .;.LE;The San Francisco Examiner.
 .;.LE;The Los Angeles Times.
 .;.ELS
 .ELS
.s 2.lm 8.f
Produces:
.S.lm 15
A possible list of Newspapers would be :
.LS 
.LE;In the Boston area:
.LS
.LE;The Boston Globe.
.LE;The Boston Herald American.
.ELS
.LE;In the New York area:
.LS
.LE;The New York Times.
.LE;The Daily News.
.ELS
.;.LE;On the West Coast.
.;.LS;
.;.LE;The San Francisco Examiner.
.;.LE;The Los Angeles Times.
.;.ELS
.els
.s 2.lm 8
.pg
.lm 60.NF
__________
|        |
|        |
|   .LEB |
|        |
|________|
.F.lm 8.s
.ix LEB
.ix List Element with bullet
.hl 1;List Element with bullet command
Add a list element preceded by a bullet(o) to a list.
.s.lm 15.nf
_______________________________________________
|         |                                   |
|   .LEB  |     test_page;text                |
|         |                                   |
|_________|___________________________________|
.FI.lm 8.s
The List Element with bullet command will add an item to an existing
list started with a .LIST command. A bullet is a lower case o. The
test_page number is used for an implied test page command. The number
is taken as the number of half line which must remain on the page if
the list element is to be printed on that page. The test_page count is
in effect for all remaining list element commands of any type.
.s 2.lm 8
Defaults:
.s.lm 15
This command does cause a break.
.s 2.lm 8
Command Synonyms:
.s.lm 15
 .LEB
.s 2.lm 8
Notes:
.s.lm 15
This command outputs a "o" followed by a space. The indentation is -2.
The list elements are seperated by the standard paragraph
spacing and TEST PAGE. If you want to type the text on the same line
as the command, you must separate the text from the command with any
number of intervening spaces or tabs, or (optionally) one semicolon.
.pg
.lm 60.NF
__________
|        |
|        |
|   .LEB |
|        |
|________|
.F.lm 8.s
.s 2.lm 8
Examples:
.s.lm 15
.pg
.lm 60.NF
__________
|        |
|        |
|   .LEC |
|        |
|________|
.F.lm 8.s
.ix LEC
.ix List Element using string
.hl 1;List Element String command
Add item to list using prefix string supplied.
.s.lm 15.nf
_______________________________________________
|         |                                   |
|   .LEC  |     test_page 'string';text       |
|         |                                   |
|_________|___________________________________|
.FI.lm 8.s
The List Element with Character string command will add an item to an
existing list started with a .LIST command. The list element will be
denoted in the output with the string supplied by the user. The
character string can only be four characters and must be enclosed in
quotes.  The test_page number is
used for an implied test page command. The number is taken as the
number of half line which must remain on the page if the list element
is to be printed on that page. The test_page count is in effect for
all remaining list element commands of any type.
.s 2.lm 8
Defaults:
.s.lm 15
This command causes a break.
.s 2.lm 8
Command Synonyms:
.s.lm 15
 .LEC
.s 2.lm 8
Notes:
.s.lm 15
This command outputs the string supplied by the user followed by a
series of spaces over to the list element text.  The string should
not be greater than six characters long.  The list elements are
separated by the standard paragraph spacing and TEST PAGE.
.pg
.lm 60.NF
__________
|        |
|        |
|   .LEC |
|        |
|________|
.F.lm 8.s
.s 2.lm 8
Examples:
.s.lm 15
.pg
.lm 60.NF
__________
|        |
|        |
|   .LEN |
|        |
|________|
.FILL.lm 8.s
.ix LEN
.ix List Element Without Numbering
.hl 1;List Element Without Numbering command
Add item to list without using any numbering.
.s.lm 15.nf
_______________________________________________
|         |                                   |
|   .LEN  |     test_page;text                |
|         |                                   |
|_________|___________________________________|
.FI.lm 8.s
The LIST ELEMENT WITHOUT NUMBERING command allows the user to specify
a list element without numbering it. The list element is indented the
normal amount, but no numbering occurrs. The spacing between list
elements is identical to that for paragraphs. The test_page number is
used for an implied test page command. The number is taken as the
number of half line which must remain on the page if the list element
is to be printed on that page. The test_page count is in effect for
all remaining list element commands of any type.
.s 2.lm 8
Defaults:
.s.lm 15
This command causes a break.
.s 2.lm 8
Command Synonyms:
.s.lm 15
 .LEN
.s 2.lm 8
Notes:
.s.lm 15
.s 2.lm 8
Examples:
.s.lm 15
.pg
.lm 60.NF
__________
|        |
|        |
|   .LEL |
|        |
|________|
.FILL.lm 8.s
.ix LEL
.ix List Element With Indenting
.hl 1;List Element With Indenting
Add item to list without using any numbering.
.s.lm 15.nf
_______________________________________________
|         |                                   |
|   .LEL  |     test_page;text                |
|         |                                   |
|_________|___________________________________|
.FI.lm 8.s
The LIST ELEMENT WITH INDENTING command allows the user to specify a
list element without numbering it. The first line of the list element
is not indented, but subsequent lines of the list element are indented
the normal amount for list elements. No numbering occurrs. The
test_page number is used for an implied test page command. The number
is taken as the number of half line which must remain on the page if
the list element is to be printed on that page. The test_page count is
in effect for all remaining list element commands of any type.
.s 2.lm 8
Defaults:
.s.lm 15
This command causes a break.
.s 2.lm 8
Command Synonyms:
.s.lm 15
 .LEL
.s 2.lm 8
Notes:
.s.lm 15
.s 2.lm 8
Examples:
.s.lm 15
.pg
.lm 60.NF
__________
|        |
|        |
|   .LER |
|        |
|________|
.F.lm 8.s
.ix LER
.ix List Element using Roman numeral
.hl 1;List Element Roman Numeral command
Add item to list using Roman numerals to number the item.
.s.lm 15.nf
_______________________________________________
|         |                                   |
|   .LER  |     test_page;text                |
|         |                                   |
|_________|___________________________________|
.FI.lm 8.s
The List Element with Roman numeral command will add an item to
an existing list started with a .LIST command.  The list element will
be denoted in the output with the Roman numeral corresponding to the
number of the list element. The test_page
number is used for an implied test page command. The number is taken
as the number of half line which must remain on the page if the list
element is to be printed on that page. The test_page count is in
effect for all remaining list element commands of any type.
.s 2.lm 8
Defaults:
.s.lm 15
This command causes a break.
.s 2.lm 8
Command Synonyms:
.s.lm 15
 .LER
.s 2.lm 8
Notes:
.s.lm 15
This command outputs the current list element number in Roman numerals
followed by a
series of spaces over to the list element text.
The current list number is then incremented for the next list element.
The list elements are
separated by the standard paragraph spacing and TEST PAGE.
.pg
.lm 60.NF
__________
|        |
|        |
|   .LER |
|        |
|________|
.F.lm 8.s
.s 2.lm 8
Examples:
.s.lm 15
.pg
.lm 60.NF
__________
|        |
|        |
|   .LS  |
|        |
|________|
.FI.lm 8
.IX LIST
.ix LIST START
.ix LS
.hl 1;LIST START command
This command starts an indented list with "n" spacing.
.s.lm 15.NF
_______________________________________________
|         |                                   |
|   .LS   |      [ n ]                        |
|         |                                   |
|_________|___________________________________|
.FI.s.lm 8
The LIST command starts an indented list with "n" spacing.
.s 2.lm 8
Defaults:
.s.lm 15
This command does cause a break. 
If spacing is not specified, then the current spacing setting will
be used.
.s 2.lm 8
Command Synonyms:
.s.lm 15
 .LIST,.LS
.s 2.lm 8
Notes:
.s.lm 15
LIST moves the left margin 9 spaces to the right for the first LIST
command, and 4 for spaces for each subsequent nested LIST. The normal
FILL and JUSTIFY modes remain in effect. Therefore, these modes must
be disengaged after the LS command if a ragged right is desired. A
current nesting level of 3 is in effect. If the nesting level becomes
greater than 3, an error message will be produced.
.page.lm 60.NF
__________
|        |
|        |
|   .LS  |
|        |
|________|
.FI.lm 8.s 2
Examples:
.s.lm 15.nf
 A list of games currently contained on the system would be:
 .ls
 .le; Games written in Basic
 .ls;
 .le; Startrek - Startrek game.
 .le; Hamrabi  - Game of Hamarabi.
 .le; Life - Conway's life program.
 .els
 .LE; Games written in other languages
 .ls
 .le; Doctor - Psychoanalysis program.
 .le; Adventure - Have a fun time gathering treasures and
      avoiding Dwarves and pirates.
 .els
 .els
.s 2.lm 8.fill
Produces:
.s.lm 15
A list of games currently contained on the system would be:
.ls
.le; Games written in Basic
.ls;
.le; Startrek - Startrek game.
.le; Hamrabi  - Game of Hamarabi.
.le; Life - Conway's life program.
.els
.LE; Games written in other languages
.ls
.le; Doctor - Psychoanalysis program.
.le; Adventure - Have a fun time gathering treasures and avoiding
 dwarves and pirates.
.els
.els
.s 2.lm 8
.pg
.lm 60.NF
__________
|        |
|        |
|   .NT  |
|        |
|________|
.FI.lm 8
.hl 1;NOTE command
.IX NOTE
.ix NT
NOTE is used to start an indented note.
.s.lm 15.NF
_______________________________________________
|         |                                   |
|   .NT   |    [ text ]                       |
|         |                                   |
|_________|___________________________________|
.FI.lm 8.s
This command starts an indented note on the current page.
.s 2.lm 8
Defaults:
.s.lm 15
This command does cause a break. 
.s 2.lm 8
Command Synonyms:
.s.lm 15
 .NOTE, .NT
.s.lm 8
Notes:
.s.lm 15
This command BLANKS 2, reduces both margins by 15, writes the "text",
or if no text is given, centers the word "NOTE" and then blanks 1.
At this point, the user can then start entering the body of the note. 
.pg
.lm 60.NF
__________
|        |
|        |
|   .NT  |
|        |
|________|
.FI.lm 8
.s 2.lm 8
Examples:
.s.lm 15.NF
 .NOTE Error Reports:
 All errors encountered must be reported via a yellow error
 report sheet. These sheets are to be turned in to the appropriate
 supervisor at the end of the day.
 .EN
.s 2.lm 8.F
Produces:
.s.lm 15
.NOTE Error Reports:
All errors encountered must be reported via a yellow error
report sheet. These sheets are to be turned in to the appropriate
supervisor at the end of the day.
.EN
.s 2.lm 8
.pg
.lm 60.NF
__________
|        |
|        |
|   .NTC |
|        |
|________|
.FI.lm 8
.hl 1;NOTE command with centering
.IX NTC
NTC is used to start an indented note with centering.
.s.lm 15.NF
_______________________________________________
|         |                                   |
|   .NTC  |    [ text ]                       |
|         |                                   |
|_________|___________________________________|
.FI.lm 8.s
This command starts an indented note on the current page.
The text is centered on the note.
.s 2.lm 8
Defaults:
.s.lm 15
This command does cause a break. 
.s 2.lm 8
Command Synonyms:
.s.lm 15
 .NTC
.s.lm 8
Notes:
.s.lm 15
This command BLANKS 2, reduces both margins by 15, centers the "text".
At this point, the user can then start entering the body of the note. 
.pg
.lm 60.NF
__________
|        |
|        |
|   .NTC |
|        |
|________|
.FI.lm 8
.s 2.lm 8
Examples:
.s.lm 15.NF
 .NTC Error Reports
 All errors encountered must be reported via a yellow error
 report sheet. These sheets are to be turned in to the appropriate
 supervisor at the end of the day.
 .EN
.s 2.lm 8.F
Produces:
.s.lm 15
.NTC Error reports
All errors encountered must be reported via a yellow error
report sheet. These sheets are to be turned in to the appropriate
supervisor at the end of the day.
.EN
.s 2.lm 8
.pg
.lm 60.NF
__________
|        |
|        |
|   .PP  |
|        |
|________|
.FI.lm 8
.hl 1;PARAGRAPH command
.ix PARAGRAPH
.ix PP
.ix P
PARAGRAPH causes a paragraph to be started and, if stated, the number
of spaces to indent before starting to print the first line of the
paragraph.
.s.lm 15.NF
_______________________________________________
|         |                                   |
|   .PP   |      [ n , v , t ]                |
|         |                                   |
|_________|___________________________________|
.FI.s.lm 8
This command performs actions typical at the start of a new paragraph.
This includes leaving a blank line and causing an indent on the
output line.
.s 2.lm 8
Defaults:
.s.lm 15
This command does cause a break.
The initial values of the above three parameters are :
.br
n -- (5) indent five spaces. (can also be negative)
.br
v -- (1) single spacing.
.br
t -- (1) single line.
.s 2.lm 8
Command Synonyms:
.s.lm 15
 .PARAGRAPH, .PP, .P
.pg
.lm 60.NF
__________
|        |
|        |
|   .PP  |
|        |
|________|
.FI.lm 8
.s 2.lm 8
Notes:
.s.lm 15
The "n" is optional and, if present, sets the number of spaces that
the paragraph is to be indented.
"v" is the vertical spacing between paragraphs. The value of "v"
can range from zero to five, where one is single spacing, two
is double spacing, etc.
"t" causes an automatic TEST PAGE to be performed. For a further
description of this option, see the TEST PAGE command elsewhere in this
document.
.s 2.lm 8
Examples:
.s.lm 15.NF
 Prior line of text.
 .PP
 New line of text...
.s 2.lm 8.fill
Produces:
.s.lm 15
Prior line of text.
.PP
New line of text...
.pg
.lm 60.NF
__________
|        |
|        |
|   .SHL |
|        |
|________|
.F.lm 8.s
.ix Set Header Level
.ix SHL
.hl 1;Set Header Level
Set header level "m" to "n".
.s.lm 15.nf
_______________________________________________
|         |                                   |
|   .SHL  |     m,n                           |
|         |                                   |
|_________|___________________________________|
.FI.lm 8.s
The Set Header Level command sets header level "m" to the value "n".
.s 2.lm 8
Defaults:
.s.lm 15
This command will cause a break.
.s 2.lm 8
Command Synonyms:
.s.lm 15
 .SHL
.s 2.lm 8
Notes:
.s.lm 15
All higher header levels are reset to zero. The value "m" can range from
one to five. The value "n" can range from one to two-hundred-fifty-five.
The next .HL command will increment the header level to "m."
.pg
.lm 60.NF
__________
|        |
|        |
|   .SHL |
|        |
|________|
.F.lm 8.s
.s 2.lm 8
Examples:
.s.lm 15
 .SHL 3,9
.pg
.lm 60.NF
__________
|        |
|        |
|   .SK  |
|        |
|________|
.FI.lm 8
.hl 1;SKIP command
.IX SKIP
.ix SK
.ix S
The SKIP command generates a specified number of blank output lines.
.s.lm 15.NF
_______________________________________________
|         |                                   |
|   .SK   |  [ n ]                            |
|         |                                   |
|_________|___________________________________|
.FI.lm 8.s
The SKIP command causes ^&n\& times the
spacing factor blank lines to be output. If the end
of the page is reached before satisfying the request, the
remaining spaces will not be output on the next page.
.s 2.lm 8
Defaults:
.s.lm 15
This command does cause a break. If "n" is not specified, then
a default value of 1 will be assumed.
.s 2.lm 8
Command Synonyms:
.s.lm 15
 .SKIP, .SK, .S
.s 2.lm 8
Notes:
.s.lm 15
If no argument is specified, then only
a single line will be output.
The "n" can also have a negative value.
Thus, a final footnote can be set by a command such as .SKIP -5.
.pg
.lm 60.NF
__________
|        |
|        |
|   .SK  |
|        |
|________|
.FI.lm 8
.s 2.lm 8
Examples:
.s.lm 15.nf
 This next article will preclude all others.
 .s 2
 Also, any other authors may ...
.s 2.lm 8.fill
Produces:
.s.lm 15
 This next article will preclude all others.
.s 2
Also, any other authors may ...
.pg
.lm 60.NF
__________
|        |
|        |
|   .SLE |
|        |
|________|
.FI.lm 8
.hl 1;Set list element command
.IX SLE
The set list element command changes the number of the next list
element.
.s.lm 15.NF
_______________________________________________
|         |                                   |
|   .SLE  |  [ n ]                            |
|         |                                   |
|_________|___________________________________|
.FI.lm 8.s
The SLE command causes the next list element to be output for the
current level to be &n in what ever format is being output.  The &n
can be a relative number but not cause the new list element number to
be less than 0.
.s 2.lm 8
Defaults:
.s.lm 15
This command does not cause a break. If "n" is not specified, then
a default value of 1 will be assumed.
.s 2.lm 8
Command Synonyms:
.s.lm 15
.s 2.lm 8
Notes:
.s.lm 15
If no argument is specified, then the index will be incremented by
one. The "n" can also have a negative value.
.pg
.lm 60.NF
__________
|        |
|        |
|   .SLE |
|        |
|________|
.FI.lm 8
.s 2.lm 8
Examples:
.s.lm 15.nf
A possible list of Newspapers would be:
 .ls 1
 .le;The Boston Globe
 .sle+5
 .le;The Boston Herald American
 .els
.s 2.lm 8.fill
Produces:
.s.lm 15
A possible list of Newspapers would be:
.ls 1
.le;The Boston Globe
.sle+5
.le;The Boston Herald American
.els