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

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



NAME
     psdit - convert ditroff intermediate format to POSTSCRIPT
     format

SYNOPSIS
     psdit [ -F_f_o_n_t_d_i_r ] [ -p_p_r_o_l_o_g_u_e ] [ -o_l_i_s_t ] [ _f_i_l_e ]

DESCRIPTION
     _p_s_d_i_t translates a _f_i_l_e created by device-independent
     [_d_i]_t_r_o_f_f(1) to POSTSCRIPT format for printing on a
     POSTSCRIPT printer.  If no _f_i_l_e is mentioned, the standard
     input is used.  The POSTSCRIPT file is sent to the standard
     output.  The options are:

     -F _f_o_n_t_d_i_r
          take font information from _f_o_n_t_d_i_r instead of the
          default (see below).

     -p _p_r_o_l_o_g_u_e
          use the contents of _p_r_o_l_o_g_u_e instead of the default
          POSTSCRIPT prologue (see below).

     -o _l_i_s_t
          prints pages whose numbers are given in the comma-
          separated _l_i_s_t.  The list contains single numbers _N and
          ranges _N_1-_N_2.  A missing _N_1 means the lowest-numbered
          page, a missing _N_2 means the highest.

     Note: the input for _p_s_d_i_t should be prepared with the
     corresponding -Tpsc option of [_d_i]_t_r_o_f_f, _p_i_c, etc.
     _e_q_n should be run with the flags -r576 and -m2 to produce
     suitable output.
     _p_i_c should be run with the -D flag.  With DWB _p_i_c, use -T576
     to set the correct resolution.

     _p_s_d_i_t allows for users to cause _t_r_o_f_f to include arbitrary
     POSTSCRIPT code in the generated POSTSCRIPT file.  _p_s_d_i_t
     recognizes the heretofore undefined ``%'' command in the
     ditroff intermediate file format to signal the start of raw
     POSTSCRIPT to be placed _a_s _i_s in the the output file.
     Everthing between (but not including) the percent sign and a
     line containing a single period (``.'') will be placed in
     the generated POSTSCRIPT output.  This POSTSCRIPT is not
     insulated from the _d_i_t_r_o_f_f coordinate system or the state of
     the generated POSTSCRIPT. However, two functions are defined
     in the prologue so that user's may insulate themselves if
     they so desire.  The PB function (for _p_i_c_t_u_r_e _b_e_g_i_n) will
     perform a POSTSCRIPT save operation, translate the
     POSTSCRIPT coordinate system to _d_i_t_r_o_f_f'_s idea of the
     current position on the page, and change the scale and orie-
     nation of the coordinate system axes to be the standard
     POSTSCRIPT 72 units per inch.  The PE macro (for _p_i_c_t_u_r_e



Printed 1/10/87            12 Nov 1985                          1






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



     _e_n_d) will end this protected environment.

     Several methods may be employed to incorporated such
     included POSTSCRIPT into the ditroff intermediate file.  The
     ``.cf'' ``.sy'' and ``\!'' _t_r_o_f_f commands may be useful.
     For example, the following sequence may appear in _t_r_o_f_f
     input:
          (usual troff input)
          \!%PB
          .cf mypic.ps
          \!PE
          \!.
          (more regular troff input)
     to include _m_y_p_i_c._p_s as an illustration.  This facility is
     both powerful and useful, but indiscriminate inclusion of
     badly-behaving POSTSCRIPT code may be dangerous to your
     document's health.

ENVIRONMENT
     PSLIBDIR
          path name of a directory to use instead of
          /usr/misc/lib/ps for psdit prologue.

FILES
     /usr/misc/lib/font/devpsc/*
                           _d_i_t_r_o_f_f default description files for
                           POSTSCRIPT virtual device.

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

SEE ALSO
     psroff(1).
     4.2bsd: ditroff(1), lpr(1).
     System V: troff(1), lp(1).
     _A _T_y_p_e_s_e_t_t_e_r-_i_n_d_e_p_e_n_d_e_n_t _T_R_O_F_F Brian W. Kernighan, Bell
     Laboratories 1982
     _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
     The versions of _e_q_n and _p_i_c distributed with ditroff (from
     AT&T) have the device names compiled in (so much for device
     independence!).  They should just read the device descrip-
     tion file for the information they need.  You must be care-
     ful to know which version of _e_q_n you are running or you will
     get undesirable results.
     The B-splines generated by _d_i_t_r_o_f_f are drawn with an approx-
     imation.  The functions D~ and D~~ in the prologue need a
     little work.



Printed 1/10/87            12 Nov 1985                          2






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



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




















































Printed 1/10/87            12 Nov 1985                          3