[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    nroff(1) manual page Table of Contents

Name

nroff - format documents for display or line-printer

Synopsis

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

Availability

SUNWdoc

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 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:

  • Teletype Corporation Model 37 terminal -- this is the default.
    • lp  |  tn300
    GE Any line printer or terminal without half-line capability.
  • DASI -300.
    • 300-12
    DASI -300 -- 12-pitch.
    300S
    DASI -300S.
    300S-12
    DASI -300S.
  • DASI -382 (fancy DTC 382).
  • DASI -450 (Diablo Hyterm).
    • 450-12
    DASI -450 (Diablo Hyterm) -- 12-pitch.
  • AJ 832.

    • Example

    The following command:

    example% nroff -s4 -me users.guide

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

    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

    See Also

    checknr(1) , col(1) , eqn(1) , man(1) , tbl(1) , troff(1) , term(5) , me(5) , ms(5)

    Notes

    nroff is not 8-bit clean because making nroff 8-bit clean would require rewriting the nroff internals and filters. Also, some nroff syntax is based on ASCII only and does not lend itself to 8-bit character sequences.

    Table of Contents