PSDIT(1)PSDIT(1)NAMEpsdit - convert ditroff intermediate format to POSTSCRIPT format
SYNOPSISpsdit [ -Ffontdir ] [ -pprologue ] [ -olist ] [ file ]
DESCRIPTIONpsdit translates a file created by device-independent [di]troff(1) to
POSTSCRIPT format for printing on a POSTSCRIPT printer. If no file is
mentioned, the standard input is used. The POSTSCRIPT file is sent to
the standard output. The options are:
-F fontdir
take font information from fontdir instead of the default (see
below).
-p prologue
use the contents of prologue instead of the default POSTSCRIPT
prologue (see below).
-o list
prints pages whose numbers are given in the comma-separated
list. The list contains single numbers N and ranges N1-N2. A
missing N1 means the lowest-numbered page, a missing N2 means
the highest.
Note: the input for psdit should be prepared with the corresponding
-Tpsc option of [di]troff, pic, etc.
eqn should be run with the flags -r576 and -m2 to produce suitable
output.
pic should be run with the -D flag. With DWB pic, use -T576 to set the
correct resolution.
psdit allows for users to cause troff to include arbitrary POSTSCRIPT
code in the generated POSTSCRIPT file. psdit recognizes the undefined
``%'' command in the ditroff intermediate file format to signal the
start of raw POSTSCRIPT to be placed as is 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 ditroff
coordinate system or the state of the generated POSTSCRIPT. However,
two functions are defined in the prologue so that users may insulate
themselves if they so desire. The PB function (for picture begin) will
perform a POSTSCRIPT save operation, translate the POSTSCRIPT
coordinate system to ditroff's idea of the current position on the
page, and change the scale and orienation of the coordinate system axes
to be the standard POSTSCRIPT 72 units per inch. The PE macro (for
picture end) will end this protected environment.
Several methods may be employed to incorporate such included POSTSCRIPT
into the ditroff intermediate file. The ``.sy'', ``\!'' and ``.cf''
troff commands may be useful. For example, the following sequence
could be used to include the POSTSCRIPT language description of a
completely separate, printable document. Note that the "showpage"
operator is redefined.
(usual troff input)
\&
.fl
\!%PB
\!/showpage{}def
.fl
.sy cat mypic.ps
\!PE
\!.
(more regular troff input)
to include mypic.ps as an illustration. This facility is both powerful
and useful. Indiscriminate inclusion of badly-behaving POSTSCRIPT code
may be dangerous to your document's health.
psdit also supports the \X feature of DWB 2.0 and has support for the
psfig package.
ENVIRONMENT
PSLIBDIR
path name of a directory to use instead of /usr/lib/transcript
for psdit prologue.
FILES
/usr/lib/transcript/ditroff.font/devpsc/*
ditroff default description files for POSTSCRIPT
virtual device.
/usr/lib/transcript/psdit.pro
default POSTSCRIPT prologue.
SEE ALSOtranscript(1), psroff(1), psfonts(1).
4.3bsd: ditroff(1), lpr(1).
System V: troff(1), lp(1).
A Typesetter-independent TROFF Brian W. Kernighan, Bell Laboratories
1982
Documenter's Workbench
AUTHOR
Adobe Systems Incorporated
BUGS
The versions of eqn and pic distributed with ditroff (from AT&T) have
the device names compiled in (so much for device independence!). They
should just read the device description file for the information they
need. You must be careful to know which version of eqn you are running
or you will get undesirable results.
The B-splines generated by ditroff are drawn with an approximation.
The functions D~ and D~~ in the prologue need a little work.
NOTES
POSTSCRIPT is a registered trademark of Adobe Systems Incorporated.
Documenter's Workbench is a trademark of AT&T Technologies.
Adobe Systems 5 March 1991 PSDIT(1)