IPB
>  Man Pages > Unix > Solaris 10 11/06 > Section 1 > troff man page

troff man page

Section 1 - Solaris 10 11/06 Man Pages

Other operating system man pages available here


Advanced Search

Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!





User Commands                                            troff(1)



NAME
     troff - typeset or format documents

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

DESCRIPTION
     troff formats text in the filenames for typesetting or laser
     printing.  Input  to  troff  is  expected to consist of text
     interspersed with formatting  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).

OPTIONS
     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 output.  (Note: a rough
                     ASCII version can also  be  printed  out  on
                     ordinary  terminals  with  an old and rarely
                     used command, /usr/bin/ta.)



     -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  ter-
                     minal  tables  instead of the system default
                     directory.



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



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



SunOS 5.10          Last change: 22 Jul 1998                    1






User Commands                                            troff(1)



                     reside  in /usr/share/lib/tmac/an. The macro
                     directory can  be  changed  by  setting  the
                     TROFFMACS environment variable to a specific
                     path. Be certain to include the trailing '/'
                     (slash) at the end of the path.



     -nN             Number the first generated page N.



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



     -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 pressing
                     the typesetter's start button.



     -Tdest          Prepare output for typesetter dest. The fol-
                     lowing 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  out-
                              put.




                     aps      Autologic APS-5.




SunOS 5.10          Last change: 22 Jul 1998                    2






User Commands                                            troff(1)



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



OPERANDS
     The following operand is supported:

     filename        The file containing text to be processed  by
                     troff.



EXAMPLES
     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)  preprocessors 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


FILES
     /tmp/trtmp                      temporary file



     /usr/share/lib/tmac/*           standard macro files



     /usr/lib/font/*                 font width tables for alter-
                                     nate mounted troff fonts



     /usr/share/lib/nterm/*          terminal driving tables  for
                                     nroff






SunOS 5.10          Last change: 22 Jul 1998                    3






User Commands                                            troff(1)



ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWdoc                     |
    |_____________________________|_____________________________|


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

NOTES
     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 avail-
     able  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.10          Last change: 22 Jul 1998                    4





Man(1) output converted with man2html and wrapped by fishsponge

This page was generated on Wed Sep 12 11:25:34 GMT 2007

Your favourite pages:

No pages logged yet.
Trying to save cookie...

Top 10 most popular pages:

sqlite3 man page (4766 hits)
(openSUSE 10.2)

adv_cap_autoneg man page (4617 hits)
(Solaris 10 11_06)

CPAN man page (4352 hits)
(Suse Linux 10.1)

ssh man page (4196 hits)
(Suse Linux 10.1)

svn man page (3410 hits)
(FreeBSD 6.2)

startproc man page (1957 hits)
(Suse Linux 10.1)

pprosetup man page (1745 hits)
(Solaris 10 11_06)

netcat man page (1697 hits)
(Suse Linux 10.1)

signal man page (1686 hits)
(Suse Linux 10.1)

ssh-socks5-proxy-connect man page (1661 hits)
(Solaris 10 11_06)

Useful Links

Go Back

Visitor Statistics


Valid XHTML 1.0 Transitional     Valid CSS!

Partners: Cambridge Plus :: Pyrenees Area :: Prototype Electronic Assembly :: <Link Available>
Unix Man Pages / Linux Man Pages :: HiFi Forum :: SIP VoIP Phone & Provider Reviews :: UNIX/Linux Forum Archives

More info on advertising on Unix/Linux Forum