'\"macro stdmacro
.if n .pH g1.postprint @(#)postprint	40.3 of 1/4/90
.\" Copyright 1989 AT&T
.nr X
.if \nX=0 .ds x} postprint 1 "Line Printer Spooling Utilities" "\&"
.if \nX=1 .ds x} postprint 1 "Line Printer Spooling Utilities"
.if \nX=2 .ds x} postprint 1 "" "\&"
.if \nX=3 .ds x} postprint "" "" "\&"
.TH \*(x}
.SH NAME
\f4postprint\fP \- PostScript translator for text files
.SH SYNOPSIS
\f4postprint\fP [\f2options\fP] [\f2files\fP]
.SH DESCRIPTION
The \f4postprint\fP filter translates text
.I files
into PostScript and writes the results on the
standard output.
If no
.I files
are specified, or if \f4\-\fP is one of the input
.IR files ,
the standard input is read.
The following
.I options
are understood:
.TP 1.0i
\f4-c \f2num\f1
Print
.I num
copies of each page.
By default, only one copy is printed.
.TP 1.0i
\f4-f \f2name\f1
Print
.I files
using font
.IR name .
Any PostScript font can be used,
although the best results will be
obtained only with constant width fonts.
The default font is Courier.
.TP 1.0i
\f4-l \f2num\f1
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
.I postprint
to guess a value, based on the point size that's being used.
.TP 1.0i
\f4-m \f2num\f1
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 1.0i
\f4-n \f2num\f1
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 1.0i
\f4-o \f2list\fP
Print pages whose numbers are given in the comma-separated
.IR list .
The \f2list\fP contains single numbers
.I N
and ranges
\f2N1 \fP\-\f2 N2\fP.
A missing
.I N1
means the lowest numbered page, a missing
.I N2
means the highest.
.TP 1.0i
\f4-p \f2mode\f1
Print
.I files
in either portrait or landscape
.I mode.
Only the first character of
.I mode
is significant.
The default
.I mode
is portrait.
.TP 1.0i
\f4-r \f2num\f1
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 1.0i
\f4-s \f2num\f1
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 1.0i
\f4-t \f2num\f1
Assume tabs are set every
.I num
columns, starting with the first column.
By default, tabs are set every 8 columns.
.TP 1.0i
\f4-x \f2num\f1
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 1.0i
\f4-y \f2num\f1
Translate the origin
.I num
inches along the positive y axis.
Positive
.I num
moves text up the page.
The default offset is \-0.25 inches.
.PP
A new logical page is started 
after 66 lines have been printed
on the current page, 
or whenever an \s-1ASCII\s+1 form feed character is read.
The number of lines per page can be changed using 
the \f4-l\fP option.
Unprintable \s-1ASCII\s+1 characters are ignored,
and lines that are too long are silently truncated by the printer.
.SH EXAMPLES
.PP
To print \f2file1\fP and \f2file2\fP in landscape mode,
issue the following command:
.PP
.RS
\f4postprint -pland \f2file1 file2\f1
.RE
.PP
To print three logical pages on each physical page in portrait mode:
.PP
.RS
\f4postprint -n3 \f2file\f1
.RE
.PP
.SH DIAGNOSTICS
An exit status of 0 is returned if
.I files
were successfully processed.
.SH FILES
\f4/usr/lib/postscript/postprint.ps
.br
/usr/lib/postscript/forms.ps
.br
/usr/lib/postscript/ps.requests\fP
.SH SEE ALSO
\f4download\fP(1),
\f4dpost\fP(1),
\f4postdaisy\fP(1),
\f4postdmd\fP(1),
\f4postio\fP(1),
\f4postmd\fP(1),
.br
\f4postreverse\fP(1),
\f4posttek\fP(1).
