Annotation of lucent/sys/man/1/troff, revision 1.1.1.1

1.1       root        1: .TH TROFF 1
                      2: .SH NAME
                      3: troff, nroff \- text formatting and typesetting
                      4: .SH SYNOPSIS
                      5: .B troff
                      6: [
                      7: .I option ...
                      8: ]
                      9: [
                     10: .I file ...
                     11: ]
                     12: .PP
                     13: .B nroff
                     14: [
                     15: .I option ...
                     16: ]
                     17: [
                     18: .I file ...
                     19: ]
                     20: .SH DESCRIPTION
                     21: .I Troff
                     22: formats text in the named
                     23: .I files
                     24: for
                     25: printing on a typesetter.
                     26: .I Nroff
                     27: does the same, but produces output suitable
                     28: for typewriter-like devices.
                     29: .PP
                     30: If no
                     31: .I file
                     32: argument is present, the standard input is read.
                     33: An argument consisting of a single minus
                     34: .RB ( - )
                     35: is taken to be
                     36: a file name corresponding to the standard input.
                     37: The options are:
                     38: .nr xx \w'\fL-m\f2name\ \ '
                     39: .TP \n(xxu
                     40: .BI -o list
                     41: Print pages in the comma-separated
                     42: .I list
                     43: of numbers and ranges.
                     44: A range
                     45: .IB N - M
                     46: means 
                     47: .I N
                     48: through
                     49: .IR M ;
                     50: initial
                     51: .BI - M
                     52: means up to
                     53: .IR M ;
                     54: final
                     55: .IB N -
                     56: means from
                     57: .I N
                     58: to the end.
                     59: .TP
                     60: .BI -n N
                     61: Number first generated page
                     62: .IR N .
                     63: .TP
                     64: .BI -m name
                     65: Process the macro file
                     66: .BI /sys/lib/tmac/tmac. name
                     67: before the input
                     68: .IR files .
                     69: .TP
                     70: .BI -r aN
                     71: Set register
                     72: .I a
                     73: (one character name) to
                     74: .IR N .
                     75: .TP
                     76: .B -i
                     77: Read standard input after the input files are exhausted.
                     78: .TP
                     79: .B -q
                     80: Invoke the simultaneous input-output mode of the
                     81: .B rd
                     82: request.
                     83: .TP
                     84: .B -N
                     85: Produce output suitable for typewriter-like devices.
                     86: .SS Typesetter devices (not \fL-N\fP) only
                     87: .TP \n(xxu
                     88: .B -a
                     89: Send a printable
                     90: textual
                     91: approximation
                     92: of the results to the standard output.
                     93: .TP
                     94: .BI -T dest
                     95: Prepare output for typesetter
                     96: .IR dest :
                     97: .br
                     98: .ns
                     99: .RS
                    100: .TP \w'\fL-TLatin1\ 'u
                    101: .B -Tutf
                    102: (The default.) PostScript printers with
                    103: preprocessing to handle Unicode
                    104: characters encoded in
                    105: .SM UTF
                    106: .PD0
                    107: .TP
                    108: .B -Tpost
                    109: Regular PostScript printers
                    110: .PD0
                    111: .TP
                    112: .B -T202
                    113: Mergenthaler Linotron 202 
                    114: .RE
                    115: .PD
                    116: .TP "\w'\fL-m\f2name 'u"
                    117: .BI -F dir
                    118: Take font information from directory
                    119: .IR dir .
                    120: .SS Typewriter (\fL-N\fP) output only
                    121: .TP \n(xxu
                    122: .BI -s N
                    123: Halt prior to every
                    124: .I N
                    125: pages (default
                    126: .IR N =1)
                    127: to allow paper loading or changing.
                    128: .TP
                    129: .BI -T name
                    130: Prepare output for specified terminal.
                    131: Known
                    132: .I names
                    133: include
                    134: .B utf
                    135: for the normal Plan 9
                    136: .SM UTF
                    137: encoding of the Unicode Standard character set (default),
                    138: .B 37
                    139: for the
                    140: Teletype model 37,
                    141: .B lp
                    142: (`line-printer')
                    143: for any terminal without half-line capability,
                    144: .B 450
                    145: for the \s-1DASI\s+1-450
                    146: (Diablo Hyterm),
                    147: and
                    148: .B think
                    149: (HP ThinkJet).
                    150: .TP
                    151: .B -e
                    152: Produce equally-spaced words in adjusted
                    153: lines, using full terminal resolution.
                    154: .TP
                    155: .B -h
                    156: Use output tabs during horizontal spacing
                    157: to speed output and reduce output character count.
                    158: Tab settings are assumed to be every
                    159: 8 nominal character widths.
                    160: .SH FILES
                    161: .TF /sys/lib/troff/term/*
                    162: .TP
                    163: .B /tmp/trtmp*
                    164: temporary file
                    165: .TP
                    166: .B /sys/lib/tmac/tmac.*
                    167: standard macro files
                    168: .TP
                    169: .B /sys/lib/troff/term/*
                    170: terminal driving tables for
                    171: .I nroff
                    172: .TP
                    173: .B /sys/lib/troff/font/*
                    174: font width tables for
                    175: .I troff
                    176: .SH SOURCE
                    177: .B /sys/src/cmd/troff
                    178: .SH "SEE ALSO"
                    179: .IR lp (1),
                    180: .IR proof (1),
                    181: .IR eqn (1), 
                    182: .IR tbl (1), 
                    183: .IR pic (1), 
                    184: .IR grap (1),
                    185: .IR doctype (1), 
                    186: .IR ms (6),
                    187: .IR mpm (6),
                    188: .IR bitmap (6),
                    189: .IR tex (1),
                    190: .IR deroff (1)
                    191: .br
                    192: J. F. Ossanna and B. W. Kernighan,
                    193: ``Troff User's Manual''
                    194: .br
                    195: B. W. Kernighan,
                    196: ``A TROFF Tutorial'',
                    197: .I
                    198: Unix Research System Programmer's Manual,
                    199: Tenth Edition, Volume 2.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.