Research V4 development
[unix-history] / man / man1 / nroff.1
.tc |
.tr |
.de x
.in \\n(inu
.if t .ta \\$2
.if n .ta \\$2+1
.in \\$1
.ti -\\$2
\fB\\$3\fP\t\\
..
.th NROFF I 1/15/73
.sh NAME
nroff \*- format text
.sh SYNOPSIS
.bd nroff
[
\fB+\fIn\fR
] [
\fB\*-\fIn\fR
] [
.bd \*-s
] [
.bd \*-h
] [
.bd \*-q
] [
.bd \*-i
] files
.sh DESCRIPTION
.it Nroff
formats text according to control lines embedded
in the text files.
.it Nroff
will read the standard input if
no file
arguments are given.
The non-file option arguments are interpreted as follows:
.s3
.lp +4 4
\fB+\fIn\fR Output will commence at the first page whose page
number is
.it n
or larger
.s3
.lp +4 4
\fB\*-\fIn\fR will
cause printing to stop after page
.it n.
.s3
.lp +4 4
\fB\*-s\fR Stop prior to
each page to permit paper
loading.
Printing is restarted by
typing a `newline' character.
.s3
.lp +4 4
\fB\*-h\fR Spaces
are replaced where possible
with
tabs to speed up output (or reduce
the size of the output file).
.s3
.lp +4 4
\fB\*-q\fR Prompt
names for insertions are not printed
and the bell character is sent instead;
the insertion is not echoed.
.s3
.lp +4 4
\fB\*-i\fR Causes the
standard input to be read after the files.
.s3
.i0
.it Nroff
is more completely described
in [1].
A condensed Request Summary is included here.
.sh FILES
.dt
/usr/lib/suftab suffix hyphenation tables
.br
/tmp/rtm? temporary
.br
.sh "SEE ALSO"
[1] NROFF User's Manual,
internal memorandum.
.sh BUGS
.in 0
.bp
.nf
.tr &.
.if t .ta .75i 1.5i 2.25i 2.75i
.if n 10 18 28 34
.ce
REQUEST REFERENCE AND INDEX
.s3
Request Initial If no Cause
Form Value Argument Break Explanation
.s3
I. Page Control
.s3
&pl +N N=66 N=66 no Page Length.
&bp +N N=1 - yes Begin Page.
&pn +N N=1 ignored no Page Number.
&po +N N=0 N=prev no Page Offset.
&ne N - N=1 no NEed N lines.
.s3
II. Text Filling, Adjusting, and Centering
.s3
&br - - yes BReak.
&fi fill - yes FIll output lines.
&nf fill - yes NoFill.
&ad c adj,norm adjust no ADjust mode on.
&na adjust - no NoAdjust.
&ce N off N=1 yes CEnter N input text lines.
.s3
III. Line Spacing and Blank Lines
.s3
&ls +N N=1 N=prev no Line Spacing.
&sp N - N=1 yes SPace N lines
&lv N - N=1 no LeaVe N lines
&sv N - N=1 no SaVe N lines.
&os - - no Output Saved lines.
&ns space - no No-Space mode on.
&rs - - no Restore Spacing.
&xh off - no EXtra-Half-line mode on.
.s3
IV. Line Length and Indenting
.s3
&ll +N N=65 N=prev no Line Length.
&in +N N=0 N=prev yes INdent.
&ti +N - N=1 yes Temporary Indent.
.s3
V. Macros, Diversion, and Line Traps
.s3
&de xx - ignored no DEfine or redefine a macro.
&ds xx - ignored no Define or redefine String.
&rm xx - - no ReMove macro name.
&di xx - end no DIvert output to macro "xx".
&wh -N xx - - no WHen; set a line trap.
&ch xx y - - no CHange trap line.
&ch -N -M - - no "
&ch xx -M - - no "
&ch -N y - - no "
.s3
VI. Number Registers
.s3
&nr ab +N -M - no Number Register.
&nr a +N -M - no "
&nc c \\n \\n no Number Character.
&ar arabic - no Arabic numbers.
&ro arabic - no Roman numbers.
&RO arabic - no ROMAN numbers.
.s3
VII. Input and Output Conventions and Character Translations
.s3
&ta N,M,... - none no PseudoTAbs setting.
&tc c space space no Tab replacement Character.
&lc c . . no Leader replacement Character.
&ul N - N=1 no UNderline input text lines.
&cc c \fB.\fR \fB.\fR no Basic Control Character.
.if t .tr '\(fm
&c2 c ' ' no Nobreak control character.
&ec c - \\ no Escape Character.
&li N - N=1 no Accept input lines LIterally.
&tr abcd.... - - no TRanslate on output.
.s3
VIII. Hyphenation.
.s3
&nh on - no No Hyphen.
&hy on - no HYphenate.
&hc c none none no Hyphenation indicator Character.
.s3
IX. Three Part Titles.
.s3
&tl 'left'center'right' - no TitLe.
&lt N N=65 N=prev no Length of Title.
.s3
X. Output Line Numbering.
.s3
&nm +N M S I off no Number Mode on or off, set parameters.
&np M S I - reset no Number Parameters set or reset.
.s3
XI. Conditional Input Line Acceptance
.s3
&if !N anything - no IF true accept line of "anything".
&if c anything - no "
&if !c anything - no "
&if N anything - no "
.s3
XII. Environment Switching.
.s3
&ev N N=0 N=prev no EnVironment switched.
.s3
XIII. Insertions from the Standard Input Stream
.s3
&rd prompt - bell no ReaD insert.
&ex - - no EXit.
.s3
XIV. Input File Switching
.s3
&so filename - - no Switch SOurce file (push down).
&nx filename - no NeXt file.
.s3
XV. Miscellaneous
.s3
&tm mesg - - no Typewriter Message
&ig - - no IGnore.
&fl - - no FLush output buffer.
&ab - - no ABort.
.fi
.tr &&