.lm
.ifnot HLP.hl 1 MISC COMMANDS
.endif hlp
.HELPC COMMENT
.q _.COMMENT text
.qq _.; text
.qq _.! text
.p.x COMMENT 
causes the line to be ignored. The text is not printed in the output.
.ifnot small
Comments may contain useful information that you need when re-editing
the file.  For example, you might wish to add comments to a string
of _.DEFINE ESCAPE and _.DEFINE SUBSTITUTE to remind you what each
escape sequence and substitution does.
.endif small
.HELPC NO__SPACE
.q _.NO SPACE
.qq  _.NSP
.s.x NO>SPACE
joins 2 filled lines without the normal space between them.
If _.FILL is engaged and you issue _.NO SPACE after a line,
a space will not be automatically generated
in the output _.DOC file.  
.ifnot small
The end of a line may still cause a break.
This condition could be forced by ending the previous line with a break 
flag. For example,
.i5;Dis
.i5;_.NO SPACE;combobulate
.br;Will be printed as:
.i5;Discombobulate
.endif small
.HELPC  REQUIRE
.q _.REQUIRE 'filespec'
.qq  _.REQ 'filespec'
.p.x REQUIRE
allows input text to be taken from the specified file.
A _.REQUIRE command can be imbedded in files that have been required.  
.ifnot small
Required files can be nested in this fashion to a depth of
.if RT
7 input files all open at once. An attempt to require a eighth level of
.else rt
5 input files are open at once. An attempt to require a sixth level of
.endif rt
input will cause an error. The default filetype for a required file
is _.RNO. The filename can be enclosed in either single (') or
double (") quotes. If any commands follow the _.REQUIRE command on the same,
they will be ignored. 
.endif small
.i5;DEFAULT: file type=.RNO
.ifnot small
.i5;(DSR allows 10 levels of nesting)
.IF HLP
.if RSX.i5;ADDITIONAL HELP AVAILABLE: exa exb exc BINARY 
.j
.endif RSX
.HELPD EXA
.endif hlp
.s
The _.REQUIRE command allows a document to be easily broken up into
reasonable chunks.
For example, each section of a document could be put in a separate file
and a master file that requires each section in order could be used to
create the complete document.  If the order of the sections needed to be
rearranged, all that must be done is to change the order of the _.REQUIRE
statements in the master file.  Overall formatting commands such
as _.PAGE SIZE, _.DISPLAY, _.HEADER _... could also be put into a separate
that could be required at the beginning of each section.
.p
Commonly used substitutions and escape sequences can be put in a file
that is required at the beginning of any file that needs them.
.HELPD EXB
.p
The _.REQUIRE statement can be used to simplify the generation of a series
of letters with the same body but different inside addresses and
salutations.  Make a master file that contains the inside addresses and
salutations and put the line
.i5; _.REQUIRE "LETTER"
.br;after each salutation.
Create a file LETTER.RNO with the actual text of the letter.
Running the master file through RUNOFF will then produce a string of
personalized letters.  Later you can change the contents of LETTER.RNO to
get another set of personalized letters for mass mailings. 
.HELPD EXC
.p
The _.REQUIRE statement can be used to get input from a terminal.
For example,
.if rt
.i5;_.REQUIRE "TT:"
.else rt
.i5;_.REQUIRE "TI:"
.endif rt
.br;can be combined with the _.TYPE command to prompt the user for
input that RUNOFF will accept from the terminal.
The input must be terminated by CTRL-Z.
.endif small
.ifnot small
.HELPD BINARY
.endif small
.q _.REQUIRE BINARY [spacing] 'file-specification'
.qq _.REQ BIN 'file-spec'
.p.x REQUIRE>BINARY
transfers input from the specified file directly to the _.DOC output file
with no interpretation.  Before the transfer, a break is performed and
a test page is executed with the specified spacing.
.ifnot small
The _.REQUIRE BINARY is useful for inserting diagrams and other graphical
input into the text file. "Spacing" tells RUNOFF how much space to allow
for the binary input file. _.REQUIRE BINARY is illegal during a note,
footnote, or text section. It is your responsibility to make sure enough
space is available on the current page for the output by specifying the
correct spacing. If the input file contains more than a fraction of a page,
you may need to increment the current page number with _.NUMBER PAGE +n. 
.endif small
.HELPC SAVE
.ifnot HLP
.hl 1 SAVE/RESTORE Commands
.endif hlp
.br
These commands save and restore the current status of various variables.
The status is restored automatically under certain conditions, or can
be restored on demand with the RESTORE command.

.ifnot small
There are some similar commands in DSR, but they currently do not
do the same thing.
.if hlp
.IF RSX;.BR;FURTHER HELP: list APPENDIX CHAPTER HEADERS LEVEL STATUS
.ENDIF RSX
.HELPD LIST
.endif hlp
.s.c;^&List of commands saved as part of the status:\&
.nj.s.TAB PROPORTIONAL 4
_.AUTOBREAK	_.AUTOHYPHENATE	_.AUTOPARAGRAPH	_.LOWERCASE	
_.FILL	_.JUSTIFY	_.PERIOD	_.UPPERCASE
.br;_.ENABLE/DISABLE
.lm+5
.TAB PROPORTIONAL 4
.f
	BAR	CONTINUE	ESCAPE	EQUATION	FLAGS	HYPHENATION
	INDEXING	OVERSTRIKING	SUBSTITUTION	TABS	UNDERLINING
.j
.lm
.p;The options specified in the _.PERIOD and _.AUTOHYPHENATE commands are not
saved or restored.
.HELPD APPENDIX
.endif small
.q _.SAVE APPENDIX
.s.x SAVE>APPENDIX
saves the status. Restored automatically by an _.APPENDIX command.
.ifnot small
.HELPD CHAPTER
.endif small
.q _.SAVE CHAPTER
.s.x SAVE>CHAPTER
saves the status. Restored automatically by a _.CHAPTER command.
.ifnot small
.HELPD HEADERS
.endif small
.q _.SAVE HEADERS
.s.x SAVE>HEADERS
saves the status. Restored automatically whenever a page header or
page number are printed.  
.ifnot small
Normally the page header is produced using the status at the last _.TITLE,
_.SUBTITLE, or any command that automatically generates titles and subtitles.
This is useful for preventing or allowing features as underlining to appear in
the page header. 
In particular, the _.FILL mode is saved, and applies to the title, subtitle,
and page number.
.HELPD LEVELS
.endif small
.q _.SAVE LEVELS
.s.x SAVE>LEVELS
saves the status. Restored automatically by a _.HEADER LEVEL command.
.ifnot small
The status is only restored if the header level number is printed.
Non-numbered levels do not restore status.
For example, you can restore _.FILL, _.JUSTIFY etc for each section of
the document.
.HELPD STATUS
.endif small
.q _.SAVE STATUS
.s.x SAVE>STATUS
saves the status. Restored automatically by the _.RESTORE STATUS command.
.q _.RESTORE STATUS
.s.x RESTORE STATUS
immediately restores the status saved by the last SAVE STATUS command.
.HELPC SETUP
.q _.SETUP escape sequences
.p.x SETUP
sends the specified escape sequence to the output file
without interpretation before any other text.  
.ifnot small
The escape sequence
can consist of numbers and literals.  This command is designed to set up
the printer, and must precede all text.
For examples of escape sequences see _.DEFINE ESCAPE.
.i5;(Not available in DSR)
.endif small
.HELPC TRACE
.q _.TRACE
.p.x TRACE
generates an error message to aid in debugging your .RNO file.
.ifnot small
An output error message informs you whenever a footnote, note, or text
section is being formatted, if fill, justify, or lock modes are on.
The current flags characters (except for special flags) are listed.
In addition, the current margins and spacing are printed.
The page size and spacing are specified in half lines.
.i5;(Not available in DSR)
.endif small
.HELPC TYPE
.q _.TYPE text
.p.x TYPE
causes the "text" to be typed on your terminal.  
.ifnot small
The text must not be longer than 72 characters.
This command is useful in tracing the progress of RUNOFF, for
issuing a prompt before
.ifnot RT
_.REQUIRE#"TI:" for user input. 
.else rt
_.REQUIRE#"TT:" for user input. 
.endif rt
.i5;(Not available in DSR)
.endif small
.lm.rm