Manual Pages for UNIX Operating System command usage for man nroff

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







SunOS 5.11           Last change: 1 Nov 2007                    3






User Commands                                            nroff(1)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | text/doctools               |
    |_____________________________|_____________________________|
    | 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