troff(1) [v7 man page]
TROFF(1) General Commands Manual TROFF(1) NAME
troff, nroff - text formatting and typesetting SYNOPSIS
troff [ option ] ... [ file ] ... nroff [ option ] ... [ file ] ... DESCRIPTION
Troff formats text in the named files for printing on a Graphic Systems C/A/T phototypesetter; nroff for typewriter-like devices. Their capabilities are described in the Nroff/Troff user's manual. If no file argument is present, the standard input is read. An argument consisting of a single minus (-) is taken to be a file name corre- sponding to the standard input. The options, which may appear in any order so long as they appear before the files, are: -olist 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. -nN Number first generated page 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. Troff will stop the phototypesetter every N pages, produce a trailer to allow changing cassettes, and resume when the typesetter's start button is pressed. -mname Prepend the macro file /usr/lib/tmac/tmac.name to the input files. -raN Set register a (one-character) to N. -i Read standard input after the input files are exhausted. -q Invoke the simultaneous input-output mode of the rd request. Nroff only -Tname Prepare output for specified terminal. Known names are 37 for the (default) Teletype Corporation Model 37 terminal, tn300 for the GE TermiNet 300 (or any terminal without half-line capability), 300S for the DASI-300S, 300 for the DASI-300, and 450 for the DASI-450 (Diablo Hyterm). -e Produce equally-spaced words in adjusted lines, using full terminal resolution. -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. Troff only -t Direct output to the standard output instead of the phototypesetter. -f Refrain from feeding out paper and stopping phototypesetter at the end of the run. -w Wait until phototypesetter is available, if currently busy. -b Report whether the phototypesetter is busy or available. No text processing is done. -a Send a printable ASCII approximation of the results to the standard output. -pN Print all characters in point size N while retaining all prescribed spacings and motions, to reduce phototypesetter elasped time. -g Prepare output for a GCOS phototypesetter and direct it to the standard output (see gcat(1)). If the file /usr/adm/tracct is writable, troff keeps phototypesetter accounting records there. The integrity of that file may be secured by making troff a `set user-id' program. FILES
/usr/lib/suftab suffix hyphenation tables /tmp/ta* temporary file /usr/lib/tmac/tmac.* standard macro files /usr/lib/term/* terminal driving tables for nroff /usr/lib/font/* font width tables for troff /dev/cat phototypesetter /usr/adm/tracct accounting statistics for /dev/cat SEE ALSO
J. F. Ossanna, Nroff/Troff user's manual B. W. Kernighan, A TROFF Tutorial eqn(1), tbl(1) col(1), tk(1) (nroff only) tc(1), gcat(1) (troff only) TROFF(1)
Check Out this Related Man Page
nroff(1) 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 correspond- ing 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. -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 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. -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. 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 attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWdoc | +-----------------------------+-----------------------------+ |CSI |Enabled | +-----------------------------+-----------------------------+ SEE ALSO
checknr(1), col(1), eqn(1), man(1), tbl(1), troff(1), attributes(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 (yr<100 .ds yy (yr .el { ." else, subtract 100 from yr, store in ny .nr ny (yr-100 .ie (ny>9 { ." use ny if it is two digits .ds yy (ny ." remove temporary number register ny .rr ny } .el {.ds yy 0 ." if ny is one digit, append it to 0 .as yy (ny .rr ny } } SunOS 5.11 1 Nov 2007 nroff(1)