diff options
Diffstat (limited to 'static/unix-v10/man1/dpost.1')
| -rw-r--r-- | static/unix-v10/man1/dpost.1 | 310 |
1 files changed, 310 insertions, 0 deletions
diff --git a/static/unix-v10/man1/dpost.1 b/static/unix-v10/man1/dpost.1 new file mode 100644 index 00000000..976c2024 --- /dev/null +++ b/static/unix-v10/man1/dpost.1 @@ -0,0 +1,310 @@ +.ds dF /usr/lib/font +.ds dQ /usr/lib/postscript +.TH DPOST 1 "DWB 3.2" +.SH NAME +.B dpost +\- +.B troff +postprocessor for PostScript printers +.SH SYNOPSIS +\*(mBdpost\f1 +.OP "" options [] +.OP "" files [] +.SH DESCRIPTION +.B dpost +translates +.I files +created by +.BR troff (1) +into PostScript and writes the results on the +standard output. +If no +.I files +are specified, or if +.OP \- +is one of the input +.IR files , +the standard input is read. +The following +.I options +are understood: +.TP 0.75i +.OP \-c num +Print +.I num +copies of each page. +By default only one copy is printed. +.TP +.OP \-m num +Magnify each logical page by the factor +.IR num +(default is 1.0). +Pages are scaled uniformly about the origin, +which is located near the upper left corner of +each page. +.TP +.OP \-n num +Print +.I num +logical pages on each piece of paper, +where +.I num +can be any positive integer. +By default, +.I num +is set to 1. +.TP +.OP \-o list +Print pages whose numbers are given in the comma-separated +.IR list . +The list contains single numbers +.I N +and ranges +.IR N1\-\|N2 . +A missing +.I N1 +means the lowest numbered page, a missing +.I N2 +means the highest. +.TP +.OP \-p mode +Print +.I files +in either \*(mBportrait\fP or \*(mBlandscape\fP mode. +Only the first character of +.I mode +is significant. +The default +.I mode +is \*(mBportrait\fP. +.TP +.OP \-w num +Set the line width used to implement +.B troff +graphics commands to +.I num +points, where a point is approximately 1/72 +of an inch. +By default +.I num +is set to 0.3 points. +.TP +.OP \-x num +Translate the origin +.I num +inches along the positive x axis. +The default +coordinate system has the origin fixed near the +upper left corner of the page, with positive +x to the right and positive y down the page. +Positive +.I num +moves everything right. +The default offset is 0 inches. +.TP +.OP \-y num +Translate the origin +.I num +inches along the positive y axis. +Positive +.I num +moves text down the page. +The default offset is 0. +.TP +.OP \-B +Include +.MW %%BoundingBox +comments in the output file. +Should only be used when the comments are needed +for picture inclusion. +Output is forced onto an 8.5\(mu11-inch page. +.TP +.OP \-E name +Set the character encoding for text fonts to +.IR name . +Requesting +.I name +means include file +.MI \*(dQ/ name .enc \f1. +A nonexistent encoding file is silently ignored. +There is no default. +.TP +.OP \-F dir +Use +.I dir +as the font directory. +The default +.I dir +is +.MR \*(dF , +and +.B dpost +reads +.SM ASCII +font files from directory +.MR \*(dF/devpost . +.TP +.OP \-H dir +Use +.I dir +as the host-resident font directory. +A file in +.I dir +that matches the name of the +.B troff +font is assumed to be a host resident font program +and is included in +.B dpost +output. +There is no default. +.TP +.OP \-L \^file +Use +.I file +as the PostScript prologue. +The default is +.MR \*(dQ/dpost.ps . +.TP +.OP \-T name +Use font files for device +.I name +as the best description of available PostScript fonts. +By default, +.I name +is +\*(mBpost\fP +and +.B dpost +reads +.SM ASCII +files from +.MR \*(dF/devpost . +.br +.ne 1i +.PP +Three options allow insertion of arbitrary PostScript +at controlled points in the translation process: +.TP 0.75i +.OP \-C \^file +Copy +.I file +to the output file; +.I file +must contain legitimate PostScript. +.TP +.OP \-P string +Include +.I string +in the output file; +.I string +must be legitimate PostScript. +.TP +.OP \-R action +Requests special +.I action +(e.g., +.MR manualfeed ) +on a per page or global basis. +The +.I action +string can be given as +.IR request \|, +.IM request : page\f1\|, +or +.IM request : page : file\f1\|. +If +.I page +is omitted or given as 0 the request +applies to all pages. +If +.I file +is omitted the request +lookup is done in +.MR \*(dQ/ps.requests . +.PP +All +.I files +should be prepared by +.B troff +for the same device. +Device tables that describe real PostScript fonts that can be +used by +.B dpost +should include +.EX +PDL PostScript +.EE +in their +.SM DESC +file. +Tables that depend on a non-standard character set encoding indicate +that fact by an +.MW Encoding +entry in their +.SM DESC +file. +For example, +.EX +Encoding Latin1 +.EE +means include file +.MR \*(dQ/Latin1.enc . +The +.OP \-E +option overrides the +.SM DESC +setting. +.SH EXAMPLES +.PP +A typical command line might be: +.EX +pic \f2files\fP | tbl | eqn | troff -mm | dpost +.EE +.SH DIAGNOSTICS +A 0 exit status is returned if +.I files +were successfully translated, +while 2 often indicates a syntax error in the input +.IR files . +.SH WARNINGS +.PP +.B dpost +output does not usually conform to Adobe's file-structuring conventions. +Send the output through +.B postreverse +to produce a minimally conforming PostScript file. +.PP +Emulation is expensive and does not always produce satisfactory results. +No attempt has been made to implement the character sets or fonts available +on all devices supported by +.BR troff . +Missing characters are replaced by white space, and unrecognized +fonts default to one of the Times fonts (e.g., +.MR R , +.MR I , +.MR B , +or +.MR BI ). +.SH FILES +.MW \*(dF/devpost/* +.br +.MW \*(dF/devpost/charlib/* +.br +.MW \*(dQ/dpost.ps +.br +.MW \*(dQ/color.ps +.br +.MW \*(dQ/draw.ps +.br +.MW \*(dQ/forms.ps +.br +.MW \*(dQ/ps.requests +.SH SEE ALSO +.BR buildtables (1), +.BR postio (1), +.BR postprint (1), +.BR postreverse (1), +.BR psencoding (1), +.BR troff (1), +.BR font (5), +.BR troff (5) |