V4/usr/man/man1/roff.1
.th ROFF I 6/12/72
.sh NAME
roff \*- format text
.sh SYNOPSIS
.bd roff
[ \fB+\fIn\fR ] [ \fB\*-\fIn\fR ] [
.bd \*-s
] [
.bd \*-h
] file ...
.sh DESCRIPTION
.it Roff
formats text according to control lines embedded
in the text in the given files.
Encountering a nonexistent file terminates printing.
Incoming interconsole messages are turned off during printing.
The optional flag arguments mean:
.s3
.lp +5 5
\fB+\fIn\fR Start printing at the first page with number \fIn\fR.
.s3
.lp +5 5
\fB\*-\fIn\fR Stop printing at the first page numbered higher
than \fIn\fR.
.s3
.lp +5 5
\fB\*-s\fR Stop before each page (including the first)
to allow paper manipulation;
resume on receipt of an interrupt signal.
.s3
.lp +5 5
\fB\*-h\fR Insert tabs in the output stream to replace
spaces whenever appropriate.
.s3
.i0
A Request Summary is attached.
.sh FILES
/usr/lib/suftab suffix hyphenation tables
.br
/tmp/rtm? temporary
.br
.sh "SEE ALSO"
nroff (I), troff (I)
.sh BUGS
.it Roff
is the simplest of the runoff
programs, but is virtually
undocumented.
.bp
.tc |
.tr |
.in 0
.ce
REQUEST SUMMARY
.s3
.ul
.if t .ta .75i 1.5i 2.25i
.if n .ta 8 16 24 32
Request Break Initial Meaning
.if t .in2.25i
.if n .in24
.na
.ti 0
.li
.ad yes yes Begin adjusting right margins.
.ti 0
.li
.ar no arabic Arabic page numbers.
.ti 0
.li
.br yes - Causes a line break \*- the filling of
the current line is stopped.
.ti 0
.li
.bl|n yes - Insert of n blank lines, on new page if necessary.
.ti 0
.li
.bp|+n yes n=1 Begin new page and number it n; no n means `+1'.
.ti 0
.li
.cc|c no c=. Control character becomes `c'.
.ti 0
.li
.ce|n yes - Center the next n input lines,
without filling.
.ti 0
.li
.de|xx no - Define macro named `xx'
(definition ends on line beginning `\fB..\fR').
.ti 0
.li
.ds yes no Double space; same as `.ls 2'.
.ti 0
.li
.ef|t no t=\*a\*a\*a\*a Even foot title becomes t.
.ti 0
.li
.eh|t no t=\*a\*a\*a\*a Even head title becomes t.
.ti 0
.li
.fi yes yes Begin filling output lines.
.ti 0
.li
.fo no t=\*a\*a\*a\*a All foot titles are t.
.ti 0
.li
.hc|c no none Hyphenation character set to `c'.
.ti 0
.li
.he|t no t=\*a\*a\*a\*a All head titles are t.
.ti 0
.li
.hx no - Title lines are suppressed.
.ti 0
.li
.hy|n no n=1 Hyphenation is done, if n=1;
and is not done, if n=0.
.ti 0
.li
.ig no - Ignore input lines through
a line beginning with `\fB..\fR'.
.ti 0
.li
.in|+n yes - Indent n spaces from left margin.
.ti 0
.li
.ix +n no - Same as `.in' but without break.
.ti 0
.li
.li|n no - Literal, treat next n lines as text.
.ti 0
.li
.ll|+n no n=65 Line length including indent is n characters.
.ti 0
.li
.ls|+n yes n=1 Line spacing set to n lines per output line.
.ti 0
.li
.m1|n no n=2 Put n blank lines between the top
of page and head title.
.ti 0
.li
.m2|n no n=2 n blank lines put between head title
and beginning of text on page.
.ti 0
.li
.m3|n no n=1 n blank lines put between end of
text and foot title.
.ti 0
.li
.m4|n no n=3 n blank lines put between the foot title
and the bottom of page.
.ti 0
.li
.na yes no Stop adjusting the right margin.
.ti 0
.li
.ne|n no - Begin new page, if n output lines
cannot fit on present page.
.ti 0
.li
.nn|+n no - The next n output lines are not numbered.
.ti 0
.li
.n1 no no Number output lines; start with 1 each page
.ti 0
.li
.n2|n no no Number output lines; stop numbering if n=0.
.ti 0
.li
.ni|+n no n=0 Line numbers are indented n.
.ti 0
.li
.nf yes no Stop filling output lines.
.ti 0
.li
.nx|filename - Change to input file `filename'.
.ti 0
.li
.of|t no t=\*a\*a\*a\*a Odd foot title becomes t.
.ti 0
.li
.oh|t no t=\*a\*a\*a\*a Odd head title becomes t.
.ti 0
.li
.pa|+n yes n=1 Same as `.bp'.
.ti 0
.li
.pl|+n no n=66 Total paper length taken to be n lines.
.ti 0
.li
.po|+n no n=0 Page offset.
All lines are preceded by N spaces.
.ti 0
.li
.ro no arabic Roman page numbers.
.ti 0
.li
.sk|n no - Produce n blank pages starting next page.
.ti 0
.li
.sp|n yes - Insert block of n blank lines.
.ti 0
.li
.ss yes yes Single space output lines,
equivalent to `.ls 1'.
.ti 0
.li
.ta|N|M|... - Pseudotab settings.
Initial tab settings are columns 9,17,25,...
.ti 0
.li
.tc|c no c=`|' Tab replacement character becomes `c'.
.ti 0
.li
.ti|+n yes - Temporarily indent next output
line n space.
.ti0
.li
.tr|abcd.. no - Translate a into b, c into d, etc.
.ti0
.li
.ul|n no - Underline the letters and numbers
in the next n input lines.