Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
troff(1)			 User Commands			      troff(1)

       troff - typeset or format documents

       troff  [-a]  [-f]  [-Fdir]  [-i]	 [-mname]  [-nN] [-olist] [-raN] [-sN]
       [-Tdest]	[-uN] [-z] [filename...]

       troff formats text in the filenames for typesetting or laser  printing.
       Input to	troff is expected to consist of	text interspersed with format-
       ting requests and macros. If no filename	 argument  is  present,	 troff
       reads  standard	input.	A  minus sign (-) as a filename	indicates that
       standard	input should be	read at	that point in the list of input	files.

       The output of troff is usually  piped  through  dpost(1)	 to  create  a
       printable postscript file (see EXAMPLES).

       The  following options are supported. They may appear in	any order, but
       all must	appear before the first	filename.

       -a    Send an ASCII approximation of formatted output to	standard  out-
	     put.  (Note: a rough ASCII	version	can also be printed out	on or-
	     dinary  terminals	with  an  old	and   rarely   used   command,

       -f    Do	 not  print  a trailer after the final page of output or cause
	     the postprocessor to relinquish control of	the device.

       -Fdir Search directory dir for font width or terminal tables instead of
	     the system	default	directory.

       -i    Read standard input after all input files are exhausted.

	     Prepend  the  macro  file	/usr/share/lib/tmac/name  to the input
	     filenames.	Note: most references to macro	packages  include  the
	     leading m as part of the name; for	example, the man(5) macros re-
	     side  in  /usr/share/lib/tmac/an.	The  macro  directory  can  be
	     changed  by  setting the TROFFMACS	environment variable to	a spe-
	     cific path. Be certain to include the trailing '/'	(slash)	at the
	     end of the	path.

       -nN   Number the	first generated	page N.

	     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.

       -q    Quiet mode	in nroff; ignored in troff.

       -raN  Set register a (one-character names only) to N.

       -sN   Stop the phototypesetter every N pages. On	 some  devices,	 troff
	     produces  a trailer so you	can change cassettes; resume by	press-
	     ing the typesetter's start	button.

	     Prepare output for	typesetter dest. The following values  can  be
	     supplied for dest:

	     post  A PostScript	printer; this is the default value. The	output
		   of the -T option must go through dpost(1) before it is sent
		   to a	PostScript printer to obtain the proper	output.

	     aps   Autologic APS-5.

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

       -z    Suppress formatted	output.	Only diagnostic	messages and  messages
	     output using the .tm request are output.

       The following operand is	supported:

	     The file containing text to be processed by troff.

       Example 1: Using	troff

       The  following  example	shows  how to print an input text file mytext,
       coded with formatting requests and  macros.  The	 input	file  contains
       equations  and  tables  and  must go through the	tbl(1) and eqn(1) pre-
       processors before it is formatted by troff with ms macros, processed by
       dpost(1), and printed by	lp(1):

       tbl mytext | eqn	| troff	-ms | dpost | lp

	     temporary file

	     standard macro files

	     font width	tables for alternate mounted troff fonts

	     terminal driving tables for nroff

       See attributes(5) for descriptions of the following attributes:

       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       |Availability		     |SUNWdoc			   |

       checknr(1), col(1), dpost(1), eqn(1), lp(1), man(1), nroff( 1), tbl(1),
       attributes(5), man(5), me(5), ms(5)

       troff is	not 8-bit clean	because	it is by design	based on 7-bit ASCII.

       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 may be included in a document	and subsequently  used
       to display a two-digit year. Note that any other	available one- or two-
       character register name may 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.9			  22 Jul 1998			      troff(1)


Want to link to this manual page? Use this URL:

home | help