nroff(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | ENVIRONMENT VARIABLES | FILES | ATTRIBUTES | SEE ALSO | NOTES

NAME

nroff- format documents for display or line-printer

SYNOPSIS

nroff [-ehiq] [-mname] [-nN] [-opagelist] [-raN] [-sN] [-Tname]

DESCRIPTION

nroff formats text in the named files for typewriter-like devices. See also troff(1).

If no file 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 may appear in any order so long as they appear before the files.

-e

Produce equally-spaced words in adjusted lines, using full terminal resolution.

-h

Use output TAB characters during horizontal spacing to speed output and reduce output character count. TAB settings are assumed to be every 8 nominal character widths.

-i

Read the standard input after the input files are exhausted.

-q

Invoke the simultaneous input-output mode of the rd(9F) request.

-mname

Prepend the macro file /usr/share/lib/tmac/tmac.name to the input files.

-nN

Number first generated page N.

-opagelist

Print 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

Set register a (one-character) to N.

-sN

Stop every N pages. nroff will halt prior to every N pages (default N=1) to allow paper loading or changing, and will resume upon receipt of a NEWLINE.

-Tname

Prepare 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.

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: 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(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWdoc
CSI	Enabled

SEE ALSO

checknr(1), col(1), eqn(1), man(1), tbl(1), troff(1), attributes(5), environ(5), me(5), ms(5), term(5), rd(9F)

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 may be included in a document and subsequently used to display a two-digit year. Note that any other available one- or two-character register name may 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.8  Last Revised 22 Jul 1998

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | ENVIRONMENT VARIABLES | FILES | ATTRIBUTES | SEE ALSO | NOTES