troff Command
  
  
  Purpose
  
  Formats text for printing on typesetting devices.
  
   Syntax
  
  troff [  -a ] [  -i ] [  -q ] [  -z ] [  -F Directory ] [  -n
   Number ] [   -o
   List ] [  -r ANumber ] [  -s Number ] [  -T
   Name ] [  -mm |  -me
  |  -mptx |  -ms |  -man |  -mv ] [ File ...  |  - ]
  
  Description
  
  The troff command reads one or more files and formats the text
  for printing on a phototypesetter or comparable device.   A post-
  processor  is  then  required to post process the output  of  the
  troff command to the target device.  See the accompanying  exam-
  ple.
  
  If no file is specified or the - (minus) flag is not the last
  parameter, standard input is read by default.
  
  For the 3812, 3816, and Hewlett-Packard LaserJet Series II
  printer, the default fonts are the native fonts  for the printer.
  However, additional fonts are available for these printers, which
  may be loaded through the use of the troff .fp directive.  These
  fonts    are    stored    on    the   host   in   the   directory
  /usr/lib/font/devprinter/bitmaps, and downloaded to the printer
  as necessary.
  
  Note:	The fonts in this set are based on the Computer Modern
  letter  forms  developed  by  Donald  E  Knuth.  (Refer to Knuth,
  Donald: Computer Modern Typefaces.  Addison-Wesley, 1986.)
  
  Three different typefaces are provided in four styles.  The fol-
  lowing chart shows the relationship between  typeface, style, and
  the name that the troff command uses to access the font.
  
  typeface	regular	italic	bold	italic
  
  Roman	cr	cR	Cr	CR
  
  Sans Serif	cs	cS	Cs	CS
  
  Typewriter	ct	cT	Ct	CT
  
  troff special	sp
  
  These fonts are all provided in the standard 15 troff sizes: 6,
  7, 8, 9, 10, 11, 12, 14, 16, 28, 20, 22, 24, 28, and 36 points.
  
  For example, .fp 1 Cr loads the Roman bold font into position 1.
  
  Note:	The  .tl request cannot be used before the first break-
  producing request in the input to the troff command.
  
  Flags
  
  -a	Sends a printable ASCII approximation of the results to stan-
  dard output.
  
  -i	Reads standard input after there are no more files.
  
  -q	Calls the simultaneous input and output mode of the  .rd re-
  quest.
  
  -z	Prints only messages generated by  .tm (workstation message)
  requests.
  
  -nNumber	Numbers the first printed page with the value specified
  by the Number variable.
  
  -oList	Prints only pages specified by the List variable, which
  consists of a comma-separated list of page numbers and ranges:
  
  *	A range of Start-Stop means print pages Start through Stop.
  For example: 9-15 prints pages 9 through 15.
  
  *	An initial -Stop means print from the beginning to page Stop.
  
  *	A final Start- means print from page Start to the end.
  
  *	A combination of page numbers and ranges prints the specified
  pages.  For example: -3,6-8,10,12- prints from the beginning
  through page 3, pages 6 through 8, page 10, and  page  12  to the
  end.
  
  Note:	When this flag is used in a pipeline (for example, with one
  or more of the pic, eqn, or tbl commands), you may receive a
  broken pipe message if the last page in the document is not
  specified in the List variable.  This broken pipe message is not
  an indication of any problem and can be ignored.
  
  -rANumber	Sets the register specified by the A variable to the
  specified number. The A variable value must have a one-character
  ASCII name.
  
  -sNumber	Generates output to make the typesetter stop every
  specified number of pages.
  
  -FDirectory	Accesses font information from the Directory/devName
  directory instead of the default /usr/lib/font/devName (where
  Name is given by the -T flag).
  
  -TName	Prepares the output for the specified printing device.  
  "Terminal Names for Phototypesetter or Comparable Devices" in AIX
  Version 3.2 Text Formatting Reference provides possible Name var-
  iables.  The default is ibm3816.
  
  Note:	You get a bad point size message if your device does not
  support the point size that you specified.  The troff command
  uses the closest valid point size to continue formatting.
  
  -man	Selects the  man macro processing package.
  
  -me	Selects the  me macro processing package.
  
  -mm	Selects the  mm macro processing package.
  
  -mptx	Selects the  mptx macro processing package.
  
  -ms	Selects the  ms macro processing package.
  
  -mv	Selects the  mv macro processing package.
  
  -	Forces input to be read from standard input.
  
  Environment Variables
  
  TYPESETTER	Contains information about a particular printing dev-
  ice.
  
  Examples
  
  The following is an example of the troff command:
  
  troff -Tibm3812 File | ibm3812 | qprt
  
  Implementation Specifics
  
  This command is part of Formatting Tools in the Text Formatting
  System.
  
  Files
  
  /usr/share/lib/tmac/tmac.*	Contains the pointers to standard mac-
  ro files.
  
  /usr/share/lib/macros/*	Denotes standard macro files.
  
  /usr/lib/font/dev*/*	Contains the font width tables.
  
  /var/tmp/trtmp*		Denotes a temporary file.
  
  Related Information
  
  The  eqn command,  grap command,  hplj command,  ibm3812 command,
   ibm3816 command,  mmt command,  nroff command,  pic command, 
  tbl command,  tc command,  xpreview command.
  
  The  man macro package,  me macro package,  mm macro package, 
  mptx macro package,  ms macro package,  mv macro package.
  
  The  nroff request,  troff request.
  
  The  nroff and troff Input file format,  troff file format, 
  troff font file format.
  
   Terminal Names for Phototypesetter or Comparable Devices in AIX
  Version 3.2 Text Formatting Reference provides the names of sup-
  ported devices.