./_Man_Solaris_2.6_html/html1/nroff.1.html

Manual page for nroff(1)

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

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

The following command:

: example% nroff -s4 -me users.guide

formats users.guide using the -me macro package, and stopping every 4 pages.

ENVIRONMENT

See environ.5 for descriptions of the following environment variables that affect the execution of nroff: LC_CTYPE, LC_MESSAGES, and NLSPATH.

FILES

/var/tmp/trtmp*: temporary file
/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         |
+---------------+-----------------+