NROFF(1) User Commands NROFF(1)
NAME
nroff - format documents for display or line-printer
SYNOPSIS
nroff [
-ehiq] [
-mname] [
-nN] [
-opagelist] [
-raN] [
-sN]
[
-Tname] [
-uN] [
filename...]
DESCRIPTION
The
nroff utility formats text in the named
filename for typewriter-
like devices. See also
troff(1).
If no
filename argument is present,
nroff reads the standard input.
An argument consisting of a `
-' is taken to be a file name
corresponding to the standard input.
OPTIONS
The following options are supported. Options can appear in any order
so long as they appear
before the files.
-e Produces equally-spaced words in adjusted lines, using
full terminal resolution.
-h Uses output
TAB characters during horizontal spacing to
speed output and reduces output character count.
TAB settings are assumed to be every 8 nominal character
widths.
-i Reads the standard input after the input files are
exhausted.
-q Does not print output that was read from an
.rd request.
-mname Prepends the macro file
/usr/share/lib/tmac/name to the
input files.
-nN Numbers first generated page
N.
-opagelist Prints only pages whose page numbers appear in the
comma-separated
list of numbers and ranges. A range
N-M means pages
N through
M; an initial
-N means from the
beginning to page
N; and a final
N- means from
N to the
end.
-raN Sets register
a (one-character) to
N.
-sN Stops every
N pages.
nroff halts prior to every
N pages
(default
N=1) to allow paper loading or changing, and
resumes upon receipt of a
NEWLINE.
-Tname Prepares output for a device of the specified
name.
Known
names are:
37 Teletype Corporation Model 37 terminal --
this is the default.
lp |
tn300 GE -- any line printer or terminal
without half-line capability.
300 DASI-300.
300-12 DASI-300 -- 12-pitch.
300S DASI-300S.
300S-12 DASI-300S.
382 DASI-382 (fancy
DTC 382).
450 DASI-450 (Diablo Hyterm).
450-12 DASI-450 (Diablo Hyterm) -- 12-pitch.
832 AJ 832.
-uN Set the emboldening factor for the font mounted in
position
3 to
N. If
N is missing, then set the
emboldening factor to
0.
OPERANDS
The following operand is supported:
filename The file containing text to be processed by
nroff.
EXAMPLES
Example 1: Formatting with a macro package
The following command formats
users.guide using the
-me macro
package, and stopping every 4 pages:
example%
nroff -s4 -me users.guideENVIRONMENT VARIABLES
See
environ(7) for descriptions of the following environment
variables that affect the execution of
nroff:
LC_CTYPE,
LC_MESSAGES,
and
NLSPATH.
FILES
/usr/tmp/trtmp* temporary file (see NOTES)
/usr/share/lib/tmac/tmac.* standard macro files
/usr/share/lib/nterm/* terminal driving tables for
nroff /usr/share/lib/nterm/README index to terminal description files
ATTRIBUTES
See
attributes(7) for descriptions of the following attributes:
+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|CSI | Enabled |
+---------------+-----------------+
SEE ALSO
checknr(1),
col(1),
eqn(1),
man(1),
tbl(1),
troff(1),
attributes(7),
environ(7),
me(7),
ms(7),
term(7)NOTES
/usr/tmp is currently a symbolic link to
/var/tmp.
Previous documentation incorrectly described the numeric register
yr as being the
Last two digits of current year.
yr is in actuality the
number of years since 1900. To correctly obtain the last two digits
of the current year through the year 2099, the definition given below
of string register
yy can be included in a document and subsequently
used to display a two-digit year. Notice that any other available
one- or two-character register name can be substituted for
yy.
.\" definition of new string register yy--last two digits of year
.\" use yr (# of years since 1900) if it is < 100
.ie \n(yr<100 .ds yy \n(yr
.el \{ .\" else, subtract 100 from yr, store in ny
.nr ny \n(yr-100
.ie \n(ny>9 \{ .\" use ny if it is two digits
.ds yy \n(ny
.\" remove temporary number register ny
.rr ny \}
.el \{.ds yy 0
.\" if ny is one digit, append it to 0
.as yy \n(ny
.rr ny \} \}
November 1, 2007 NROFF(1)
