postprint(1M) (Line Printer PostScript Utilities) postprint(1M)
NAME
postprint - PostScript translator for text files
SYNOPSIS
/usr/lib/lp/postscript/postprint [options] [files]
DESCRIPTION
postprint translates text files into PostScript and writes the results
to standard output. If no files are specified, or if - is one of the
input files, standard input is read.
OPTIONS
-cnum Prints num copies of each page. By default only one copy is
printed.
-e Outputs octal escapes for non-printing ASCII characters.
-fname Prints text using font name. Any PostScript font can be used,
although the best results will only be obtained with constant
width fonts. The default font is Courier.
-lnum Sets the length of a page to num lines. By default num is 66.
Setting num to 0 is allowed, and will cause postprint to guess
a value, based on the point size that's being used.
-mnum Magnifies each logical page by the factor num. Pages are scaled
uniformly about the origin, which by default is located at the
center of each page. The default magnification is 1.0.
-nnum Prints num logical pages on each piece of paper, where num can
be any positive integer. By default num is set to 1.
-olist 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.
-pmode Prints files in either portrait or landscape mode. Only the
first character of mode (p or l) is significant. The default
mode is portrait.
-rnum Selects carriage return behavior. Carriage returns are ignored
if num is 0, cause a return to column 1 if num is 1, and gen-
erate a newline if num is 2. The default num is 0.
-snum Prints files using point size num. When printing in landscape
mode num is scaled by a factor that depends on the imaging area
of the device. The default size for portrait mode is 10.
-tnum Assumes tabs are set every num columns, starting with the first
column. By default tabs are set every 8 columns.
Page 1 Reliant UNIX 5.44 Printed 11/98
postprint(1M) (Line Printer PostScript Utilities) postprint(1M)
-xnum Translates the origin num inches along the positive x axis. The
default coordinate system has the origin fixed at the center of
the page, with positive x to the right and positive y up the
page. Positive num moves everything right. The default offset
is 0.25 inches.
-ynum Translates the origin num inches along the positive y axis.
Positive num moves everything up the page. The default offset
is 0.25 inches.
-Afile Appends a simple accounting record to file after all the input
files have been successfully translated. By default no account-
ing data is produced.
-Lfile Uses file as the PostScript prologue, which by default is
/usr/lib/lp/postscript/postprint.ps.
In addition, three options allow the insertion of arbitrary PostScript
at controlled points in the translation process:
-Cfile Copies file to the output file. file follows the prologue but
precedes any job initialization commands. file becomes part of
the job's global environment and must contain legitimate
PostScript commands.
-Pstring
Adds string to the output file. string follows the prologue but
precedes any job initialization commands. string becomes part
of the job's global environment and must be legitimate
PostScript.
-Raction
Requests special action (e.g. manual feed) on a per page or
global basis. The action string can be given as request,
request:page, or request:page:file. If page is omitted or given
as 0 the request applies to all pages. If file is omitted the
request lookup is done in /usr/lib/lp/postscript/ps.requests.
The collection of recognized requests can be modified or
extended by changing /usr/lib/lp/postscript/ps.requests. Multi-
ple occurrences of the -R option behave as expected.
A new logical page is started after 66 lines have been printed on the
current page, or whenever an ASCII form feed character is read. The
number of lines per page can be changed using the -l option. Unprint-
able ASCII characters are ignored, and lines that are too long are
silently truncated by the printer.
EXAMPLES
Print file1 and file2 in landscape mode,
postprint -pland file1 file2
Page 2 Reliant UNIX 5.44 Printed 11/98
postprint(1M) (Line Printer PostScript Utilities) postprint(1M)
Print 3 logical pages on each physical page in portrait mode,
postprint -n3 file
DIAGNOSTICS
0 exit status is returned if files were successfully processed.
FILES
/usr/lib/lp/postscript/postprint.ps
/usr/lib/lp/postscript/forms.ps
/usr/lib/lp/postscript/ps.requests
SEE ALSO
dpost(1M), postdaisy(1M), postdmd(1M), postio(1M), postmd(1M),
postreverse(1M), posttek(1M).
Page 3 Reliant UNIX 5.44 Printed 11/98