.ds dQ /usr/lib/postscript
.TH POSTPRINT 1 "DWB 3.2"
.SH NAME
.B postprint
\- PostScript translator for text files
.SH SYNOPSIS
\*(mBpostprint\f1
.OP "" options []
.OP "" files []
.SH DESCRIPTION
.B postprint
translates text
.I files
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 \-f name
Print
.I files
using font
.IR name .
Any PostScript font can be used,
although the best results will only be
obtained with constant width fonts.
The default font is Courier.
.TP 
.OP \-l num
Set the length of a page to
.I num
lines.
By default
.I num
is 66.
Setting
.I num
to 0 is allowed, and will cause
.B postprint
to guess a value, based on the point size that is being used.
.TP 
.OP \-m num
Magnify each logical page by the factor
.IR num .
Pages are scaled uniformly about the origin,
which is located near the upper left corner of
each page.
The default magnification is 1.0.
.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
.IR mode .
Only the first character of
.I mode
is significant.
The default
.I mode
is \*(mBportrait\fP.
.TP 
.OP \-r num
Selects carriage return behavior.
Carriage returns are ignored if
.I num
is 0,
cause a return to column 1 if
.I num
is 1,
and generate a newline if
.I num
is 2.
The default
.I num
is 0.
.TP 
.OP \-s num
Print
.I files
using point size
.IR num .
When printing in landscape mode
.I num
is scaled by a factor that depends on the
imaging area of the device.
The default size for portrait mode is 10.
.TP 
.OP \-t num
Assume tabs are set every
.I num
columns, starting with the first column.
By default tabs are set every 8 columns.
.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.25 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.25 inches.
.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.
The default selects file
.MR \*(dQ/Default.enc .
.TP 
.OP \-L file
Use
.I file
as the PostScript prologue.
.br
The default is
.MR \*(dQ/postprint.ps .
.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
A new logical page is started after 66 lines have been printed
on the current page, or whenever an
.SM ASCII
form feed character is read.
The number of lines per page can be changed using the
.OP \-l
option.
Unprintable
.SM ASCII
characters are ignored,
and lines that are too long are silently truncated
by the printer.
.SH EXAMPLES
.PP
Print
.I file1
and
.I file2
in landscape mode:
.EX
postprint -pland \f2file1 file2
.EE
Print three logical pages on each physical page in portrait mode:
.EX
postprint -n3 \f2file
.EE
.SH DIAGNOSTICS
A 0 exit status is returned if
.I files
were successfully processed.
.SH FILES
.MW \*(dQ/postprint.ps
.br
.MW \*(dQ/forms.ps
.br
.MW \*(dQ/ps.requests
.SH SEE ALSO
.BR dpost (1),
.BR postdaisy(1),
.BR postdmd(1),
.BR postio(1),
.BR postmd(1),
.BR postreverse(1),
.BR posttek(1),
.BR psencoding (1)