4.3BSD-UWisc/man/catl/ptroff.l

PTROFF(1)           UNIX Programmer's Manual            PTROFF(1)



NAME
     ptroff - troff to a POSTSCRIPT printer

SYNOPSIS
     ptroff [ -t ] [ -F_f_a_m_i_l_y ] [ _t_r_o_f_f _o_p_t_i_o_n_s ] [ _s_p_o_o_l _o_p_t_i_o_n_s
     ] [ _f_i_l_e_s ]

DESCRIPTION
     _p_t_r_o_f_f is a shell script that runs [_o]_t_r_o_f_f(1) in an
     environment to produce output on a POSTSCRIPT printer.  It
     uses _p_s_c_a_t to convert _t_r_o_f_f C/A/T output to a POSTSCRIPT
     print file, and spools this for printing.  If no _f_i_l_e_s are
     specified, the standard input is used.

     In addition to the standard [_o]_t_r_o_f_f options, the following
     options are understood by _p_t_r_o_f_f.

     -t   sends the POSTSCRIPT output to the standard output,
          rather than spooling it to a printer.  Note that this
          overrides the meaning of the _t_r_o_f_f -t option; if you
          want the C/A/T file, run [_o]_t_r_o_f_f directly.

     -F _f_o_n_t_f_a_m_i_l_y
          names a font family to load into [_o]_t_r_o_f_f and _p_s_c_a_t.
          _F_o_n_t_f_a_m_i_l_y is used to name both a *._h_e_a_d file contain-
          ing _t_r_o_f_f ``fp'' commands, and a *._c_t file containing a
          character mapping for _p_s_c_a_t.  Fontfamilies ``Times''
          and ``Helvetica'' are probably defined at your site,
          others may be available.

     In 4.2bsd UNIX systems, the following spooler options are
     passed on to _l_p_r.

     -P_p_r_i_n_t_e_r
          causes the output to be sent to the named printer.

     -#_n  causes _n copies of the output to be produced.  The
          default is one.

     -h   suppress the printing of the job burst page.

     -C _c_l_a_s_s
          set the job classification for use on the burst page.

     -J _n_a_m_e
          set the job name for use on the burst page.  Otherwise,
          the name of the first input file will be used.

     -m   send mail after files have been printed.

     In System V UNIX systems, the following spooler options are
     passed on to _l_p.



Printed 1/10/87            12 Nov 1985                          1






PTROFF(1)           UNIX Programmer's Manual            PTROFF(1)



     -d_d_e_s_t
          causes the output to be sent to the named destination.

     -n_n  causes _n copies of the output to be produced.  The
          default is one.

     -h   suppress the printing of the job burst page.

     -r   don't page-reverse the output.

     -s   suppress messages from _l_p.

     -m   send mail after files have been printed.

     -w   write to user's terminal after files have been printed.

ENVIRONMENT
     PRINTER (4.2bsd)
          the name of a printer (as in the -P option) for _l_p_r to
          use.  If no -P option is specified, _l_p_r will use this
          printer.  If neither -P nor PRINTER is set, _p_t_r_o_f_f will
          spool to a printer named ``PostScript''.

     LPDEST (System V)
          the name of a printer (as in the -d option) for _l_p to
          use.  If no -d option is specified, _l_p will use this
          printer.  If neither -d nor LPDEST is set, _p_t_r_o_f_f will
          spool to a printer class named ``PostScript''.

FILES
     /usr/misc/lib/ps/troff.font/*.ct
                           character correspondence tables for
                           _p_s_c_a_t.

     /usr/misc/lib/ps/troff.font/*.head
                           _t_r_o_f_f headers containing ``.fp'' com-
                           mands.

     /usr/misc/lib/ps/troff.font/ftXX
                           font width files for _t_r_o_f_f.

     /usr/misc/lib/ps/pscat.pro
                           default POSTSCRIPT prologue for _p_s_c_a_t.

SEE ALSO
     pscat(1), pscatmap(8).
     4.2bsd: troff(1).
     System V: otroff(1).
     J. F. Ossanna, _N_r_o_f_f/_T_r_o_f_f _u_s_e_r'_s _m_a_n_u_a_l
     _D_o_c_u_m_e_n_t_e_r'_s _W_o_r_k_b_e_n_c_h





Printed 1/10/87            12 Nov 1985                          2






PTROFF(1)           UNIX Programmer's Manual            PTROFF(1)



AUTHOR
     Adobe Systems Incorporated

BUGS
     Because of the character mapping tables used, explicit use
     of the ``.fp'' troff directive will usually produce the
     wrong result.  Users must build and reference correct tables
     with _c_a_t_m_a_p(8) for non-standard ``.fp'' combinations to
     work.

     More flexibility is allowed by using _t_r_o_f_f, _p_s_c_a_t, and the
     spooler separately.

NOTES
     POSTSCRIPT is a trademark of Adobe Systems Incorporated.
     Times and Helvetica are registered trademark of Allied Cor-
     poration.
     Documenter's Workbench is a trademark of AT&T Technologies.





































Printed 1/10/87            12 Nov 1985                          3