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.
SunOS 5.11 Last change: 1 Nov 2007 1
User Commands nroff(1)
-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 termi-
nal without half-line capabil-
ity.
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.
SunOS 5.11 Last change: 1 Nov 2007 2
User Commands nroff(1)
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.guide
ENVIRONMENT VARIABLES
See environ(5) for descriptions of the following environment
variables that affect the execution of nroff: LCTYPE,
LCMESAGES, 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
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
SunOS 5.11 Last change: 1 Nov 2007 3
User Commands nroff(1)
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWdoc
CSI Enabled
SEE ALSO
checknr(1), col(1), eqn(1), man(1), tbl(1), troff(1), attri-
butes(5), environ(5), me(5), ms(5), term(5)
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 \} \}
SunOS 5.11 Last change: 1 Nov 2007 4
|
