summaryrefslogtreecommitdiff
path: root/static/v10/man1/postprint.1
diff options
context:
space:
mode:
authorJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-25 21:07:28 -0400
committerJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-25 21:07:28 -0400
commit711594636704defae873be1a355a292505585afd (patch)
tree59ee13f863830d8beba6cfd02bbe813dd486c26f /static/v10/man1/postprint.1
parent3258a063c1f189d7b019e40e525b46bef9b9a7b1 (diff)
docs: Added UNIX V10 Manuals
Diffstat (limited to 'static/v10/man1/postprint.1')
-rw-r--r--static/v10/man1/postprint.1257
1 files changed, 257 insertions, 0 deletions
diff --git a/static/v10/man1/postprint.1 b/static/v10/man1/postprint.1
new file mode 100644
index 00000000..93dd3ff8
--- /dev/null
+++ b/static/v10/man1/postprint.1
@@ -0,0 +1,257 @@
+.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)