postprint(1) DG/UX R4.11MU05 postprint(1)
NAME
postprint - translate text files into PostScript
SYNOPSIS
/usr/lib/lp/postscript/postprint [-c int] [-f name] [-l int] [-m num]
[-n int] [-o list] [-p mode] [-r int] [-s num] [-t int] [-w int] [-x
num] [-y num] [-C file] [-d str] [-E str] [-H str] [-L file] [-N ]
[-P string] [-R action] [-F dir] [-T dir] [-S file] [-h str] [file]
...
where:
int An integral number.
num A real (floating-point) number.
name A font name.
list A list of page numbers.
mode p (portrait) or l (landscape).
str A string of text.
string An arbitrary PostScript string of text.
action A special PostScript request name.
dir A font or device directory.
file A PostScript input file.
DESCRIPTION
The postprint filter translates each text file into PostScript and
writes the results on the standard output. If no file is specified,
or if - is given as one of the file arguments, the standard input is
read.
Options are:
-c int Print int copies of each page. By default, only one copy
is printed.
-f name Print files using font name. Any PostScript font can be
used, although the best results will be obtained only with
constant width fonts. The default font is Courier.
-l int Set the length of a page to int lines. The default length
is 66. Setting int to 0 is allowed, and will cause
postprint to estimate a value based on the point size being
used.
-m num Magnify each logical page by the factor 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.
-n int Print int logical pages on each piece of paper. By
default, only one page is printed on each piece of paper.
-o list Print those pages given in the comma-separated list of page
numbers. The list may contain both single numbers and
ranges in the form N1-N2. A missing N1 means the lowest
numbered page; a missing N2 means the highest.
-p mode Print the files in either portrait or landscape mode. Only
the first character of mode is significant. The default
mode is portrait.
-r int Select carriage return behavior. Carriage returns are
ignored if int is 0, cause a return to column 1 if int is
1, and generate a newline if int is 2. The default
behavior is a return (-r1).
-s num Print 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.
-t int Assume tabs are set every int columns, starting with the
first column. By default, tabs are set every 8 columns.
-w int Set the width of a line to int characters. This option is
used to force line wrapping so that no information is lost
in the event a line is too long. If this option is not
supplied then no line wrapping is performed.
-x num Translate the origin 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 num moves
everything right. The default offset is 0.25 inches.
-y num Translate the origin num inches along the positive Y axis.
Positive num moves text up the page. The default offset is
-0.25 inches.
-C file Copy 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.
-d str Print the date str on the first line of each page left
justified. The date str may be a literal string or a
date(1) format string.
-E str Print the multi-line text str as the title. The title str
consists of one or more strings of characters separated by
new lines (\n) and is printed at the top of the first
physical page after the date string. Each line of the
title str is centered and printed using 17 point font.
-H str Print the multi-line text str as a column heading. The
column heading str consists of one or more strings of
characters separated by new lines (\n) and is printed at
the top of each page after the date string and title. The
column heading str is printed in boldface type and
underlined.
-L file Use file as the PostScript prologue. The default prologue
is /usr/lib/lp/postscript/postprint.ps.
-N Prints page number at the bottom center of each page. This
option reserves the last three lines of the page for page
numbering.
-P string Add 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.
-R action Request a special action (i.e., manualfeed or ledgertray)
on a per page or global basis. The action string has the
following format:
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 defining
a private requests file, using the same format as defined
in the default file. Multiple occurrences of the -R option
are supported.
-h str On trusted systems running with MAC labels, the file's MAC
label is printed at the top and bottom of each printed
page. If supplied str is printed instead. If "0" is given
then no label is printed.
A new logical page is started after 66 lines (or the number of lines
specified by the -l option) have been printed on the current page. A
new logical page is also started whenever an ASCII form feed
character is read. Unprintable characters are ignored, and lines
that are too long are silently truncated by the printer.
International Features
postprint can print documents of various languages. This feature
uses PostScript font definition files of the form:
fontdir/devicedir/fontfile
Each of fontdir, devicedir, and fontfile can be set using the options
described below.
Options are:
-F fontdir
Find the code set definition under font directory fontdir.
The default font directory is /usr/lib/font.
-T devicedir
Find the code set definition in device directory devdevicedir.
The default device directory is devpost.
-S fontfile
Find the code set definition in file fontfile, which contains
a font definition that implements the code set desired.
The following code set fontfiles are provided:
ascii US English
ps88591 ISO 8859-1 (Latin 1)
ps88592 ISO 8859-2 (Latin 2)
ps88597 ISO 8859-7 (Latin/Greek)
Note: The default code set for postprint is postscript, the standard
PostScript encoding. This encoding is identical to the ascii code
set with two exceptions: postscript maps the minus character (\055)
to hyphen and the grave accent (\140) to leftquote.
EXAMPLES
To print file1 and file2 in landscape mode, issue the following
command:
postprint -pland file1 file2
To print three logical pages on each physical page in portrait mode:
postprint -n3 file
To print a document using the ISO 8859-1 Western European coded
character set:
postprint -Sps88591 file
To print file ascii in Times Roman instead of Courier Roman:
postprint -f Times-Roman ascii
DIAGNOSTICS
An exit status of 0 is returned if each file was successfully
processed.
FILES
/usr/lib/lp/postscript/postprint.ps PostScript prologue
/usr/lib/lp/postscript/forms.ps Logical page functions
/usr/lib/lp/postscript/ps.requests Request definitions
SEE ALSO
download(1), dpost(1), postdaisy(1), postdmd(1), postio(1),
postmd(1), postreverse(1), posttek(1).
NOTES
Underlining, boldface, and other forms of overstriking may not work
if the carriage return behavior is changed from its default.
The -S option is a Data General extension.
Licensed material--property of copyright holder(s)