NROFF(1)                                                              NROFF(1)


NAME
     nroff - format or typeset text

SYNOPSIS
     nroff [ option(s) ] [ file(s) ] | printer

DESCRIPTION
     Nroff formats text contained in files (standard input by default) for
     printing on typewriter-like devices and line printers.

     An argument consisting of a minus (-) is taken to be a file name
     corresponding to the standard input.  The option(s), which may appear in
     any order, but must appear before the file(s), are:

     -e        Produce equally-spaced words in adjusted lines, using the full
               resolution of the particular terminal.

     -h        Use output tabs during horizontal spacing to speed output and
               reduce output character count.  Tab settings are assumed to be
               every 8 nominal character widths.

     -i        Read standard input after file(s) are exhausted.

     -mname    Prepend to the input file(s) the macro file
               /usr/lib/tmac/tmac.name.

     -nN       Number first generated page N.

     -olist    Print only pages whose page numbers appear in the list of
               numbers and ranges, separated by commas.  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.  (See BUGS
               below.)

     -q        Invoke the simultaneous input-output mode of the .rd request.

     -raN      Set register a (which must have a one-character name) to N.

     -sN       Stop every N pages.  Nroff will halt after every N pages
               (default N=1) to allow paper loading or changing, and will
               resume upon receipt of a line-feed or new-line (new-lines do
               not work in pipelines, e.g., with mm(1)).  This option does not
               work if the output of nroff is piped through col(1).  When
               nroff halts between pages, an ASCII BEL is sent to the
               terminal.

     -Ttty_type
               Prepare output for specified terminal.  Known tty_type types
               are


               2631      Hewlett-Packard 2631 printer in regular mode

               2631-c    Hewlett-Packard 2631 printer in compressed mode

               2631-e    Hewlett Packard 2631 printer in expanded mode

               300       DASI-300 printer

               300-12    DASI-300 terminal set to 12-pitch (12 characters per
                         inch)

               300s      DASI-300s printer (300S is a synonym)

               300s-12   DASI-300s printer set to 12-pitch (12 characters per
                         inch) (300S is a synonym)

               37        Teletype Model 37 terminal

               382       DTC-382

               4000a     Trendata 4000a terminal (4000A is a synonym)

               450       DASI-450 (Diablo Hyterm) printer

               450-12    DASI-450 terminal set to 12-pitch (12 characters per
                         inch)

               832       Anderson Jacobson 832 terminal

               8510      C.ITOH printer

               lp        generic name for printers that can underline and tab.
                         (all text using reverse line feeds, such as those
                         having tables, that is sent to lp must be processed
                         with col).

               tn300     GE Terminet 300 terminal

               X         printers equipped with TX print train

     -un       Set the emboldening factor (number of character overstrikes)
               for the third font position (bold) to n, or to zero if n is
               missing.

     -z        Print only messages generated by .tm (terminal message)
               requests.

FILES
     /usr/lib/tmac/tmac.*  pointers to standard macro files
     /usr/lib/macros/*     standard macro files


     /usr/lib/nterm/*      terminal driving tables for nroff
     /usr/pub/terminals    list of supported terminals

SEE ALSO
     eqn(1), tbl(1), mm(5), col(1), greek(1), mm(1).
     "The Formatter nroff in the user's Guide"

BUGS
     Nroff believes in Eastern Standard Time; as a result, depending on the
     time of the year and on your local time zone, the date that nroff
     generates may be off by one day from your idea of what the date is.

     When nroff is used with the -olist option inside a pipeline (e.g., with
     one or more of ocw(1), eqn(1), and tbl(1)), it may cause a harmless
     ``broken pipe'' diagnostic if the last page of the document is not
     specified in list.


                                                                        Page 3