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

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



NAME
     pscat - convert C/A/T files to POSTSCRIPT format

SYNOPSIS
     pscat [ -F_f_o_n_t_t_a_b_l_e ] [ -i_p_r_o_l_o_g_u_e_f_i_l_e ] [ -l_p_a_p_e_r_l_e_n_g_t_h ] [
     -x_x_o_f_f_s_e_t ] [ -y_y_o_f_f_s_e_t ] [ _f_i_l_e ]

DESCRIPTION
     _p_s_c_a_t converts C/A/T format _f_i_l_e (i.e., as produced by the
     original [_o]_t_r_o_f_f(1)), to POSTSCRIPT format on the standard
     output.  If no _f_i_l_e argument is given, the standard input is
     used.  The average user will probably be happy using
     _p_t_r_o_f_f(1), but explicit use of _p_s_c_a_t gives more control.
     Page offset distances and the page length are specified by
     giving a fixed-point real number optionally followed by a
     units measure.  For example, 1in means one inch, 15mm means
     fifteen millimeters.  If no units are indicated, points (72
     to the inch) are used.  The options are:

     -F _f_o_n_t_t_a_b_l_e
          specifies a font correspondence table for use by the
          converter.  (The default is usually _T_i_m_e_s._c_t where the
          mounted fonts are: R=Times-Roman, I=Times-Italic,
          B=Times-Bold, and S=Symbol.  Note that _t_r_o_f_f should be
          invoked with an appropriate -F switch and explicit
          ``.fp'' commands.)

     -i _p_r_o_l_o_g_u_e_f_i_l_e
          specifies a file to be incorporated as the POSTSCRIPT
          prologue, otherwise the default prologue will be used
          (see below).

     -l _p_a_g_e_l_e_n_g_t_h
          specifies the page length to use when splitting the
          C/A/T file into POSTSCRIPT pages.  The default is 11in.

     -x _x_o_f_f_s_e_t
          moves the output _x_o_f_f_s_e_t to the right on the paper.
          The default is 0.

     -y _y_o_f_f_s_e_t
          moves the output _y_o_f_f_s_e_t downward on the paper.  The
          default is 0.  Different versions of _t_r_o_f_f seem to have
          different notions of where the top edge of the paper
          really is, so careful setting of the -y switch may be
          necessary.

ENVIRONMENT
     PSLIBDIR
          path name of a directory to use instead of
          /usr/misc/lib/ps for pscat prologue and font metric
          files.



Printed 1/10/87            12 Oct 1985                          1






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



FILES
     /usr/misc/lib/ps/troff.font/*.ct
                           character correspondence tables (built
                           by _p_s_c_a_t_m_a_p(8)) mapping C/A/T codes to
                           POSTSCRIPT fonts and characters or
                           other actions.

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

SEE ALSO
     ptroff(1), pscatmap(8).
     4.2bsd: troff(1).
     System V: otroff(1), _D_o_c_u_m_e_n_t_e_r'_s _W_o_r_k_b_e_n_c_h.

AUTHOR
     Adobe Systems Incorporated

BUGS
     Because of the character mapping tables used, arbitrary use
     of the ``.fp'' troff directive in will usually produce the
     wrong results.  The _f_a_m_i_l_y._h_e_a_d files which _p_t_r_o_f_f feeds to
     _t_r_o_f_f contain ``.fp'' commands appropriate for a given font
     family.  Users must build and reference correct tables with
     _p_s_c_a_t_m_a_p(8) for non-standard ``.fp'' combinations to work.

     Distance computations are not checked for overflow.

     The mapping from the default troff fonts to Adobe's Times-
     Roman will not look good.  POSTSCRIPT font width tables (and
     ``.fp'' commands) should be used explicitly in troff.

     _p_s_c_a_t determines where page breaks occur by assuming that
     each page is exactly the specified length.  There is no
     indication of page boundaries in the C/A/T file, so improper
     use of the -l option will lead to undesirable results.  Some
     _t_r_o_f_f macro packages generate cut-marks at logical edges of
     the page which may or may not get imaged on a POSTSCRIPT
     device.  Careful use of the -x and -y options may help.

NOTES
     POSTSCRIPT is a trademark of Adobe Systems Incorporated.
     Times is a registered trademark of Allied Corporation.
     Documenter's Workbench is a trademark of AT&T Technologies.











Printed 1/10/87            12 Oct 1985                          2