source: trunk/third/transcript/man/psnup.1p @ 9090

Revision 9090, 4.2 KB checked in by ghudson, 28 years ago (diff)
This commit was generated by cvs2svn to compensate for changes in r9089, which included commits to RCS files with non-trunk default branches.
Line 
1.TH PSNUP 1 "19 August 1992" "Adobe Systems"
2\" Copyright (c) 1985,1987,1991,1992 Adobe Systems Incorporated. All Rights Reserved.
3\" ATTN GOVERNMENT END USERS: See notice of rights in file XPSLIBDIRX/Notice
4\" RCSID: $Header: /afs/dev.mit.edu/source/repository/third/transcript/man/psnup.1p,v 1.1.1.1 1996-10-07 20:25:39 ghudson Exp $
5.ds PS P\s-2OST\s+2S\s-2CRIPT\s+2
6.SH NAME
7psnup\(emprint multiple pages on a sheet of paper.
8.SH SYNOPSIS
9.B psnup
10[
11.B -rGf
12] [
13.BI -n nupspec
14] [
15.BI -S  papersize
16] [
17.BI -s  pagesize
18] [
19.BI -w pagewidth
20] [
21.BI -h pageheight
22]
23.br
24[
25.BI -p  outputfile
26] [
27.BI -P printer
28] [
29.BI -d printer
30] [
31.I file
32]
33.SH DESCRIPTION
34.I psnup
35reads in a \*(PS language
36.I file
37(or the standard input if no file is named) and, if the
38input conforms to the \*(PS language document structuring conventions,
39provides page rotation, printing of multiple pages on a sheet
40of paper (n-up printing), selection of page and paper sizes,
41and writes the resulting file on the standard output.  The output
42may be directed to a file.
43.sp
44The possible options are:
45.TP
46.BI -n nupspec
47.I nupspec
48may be a single number specifying how many pages will be
49printed on each sheet of paper, or a specification  of the form:
50.I n
51x
52.I m,
53where
54.I n
55and
56.I m
57specify rows and columns, respectively. Rows refers to
58the number of page images across a sheet of paper, columns to the
59number of page images down a sheet of paper.  The specification
60.BI -n 2x2
61is  equivalent to the specification
62.BI -n 4.
63If the number of pages on a sheet is specified as a single
64number, the number must be a power of 2.
65.TP
66.B -r
67rotates the page 90 degrees (landscape mode).
68When using the n-up capability of
69.I psnup,
70this option
71is preferable to the landscape option of pslpr because the rotation of the page
72is taken into account when laying out multiple pages on a sheet of paper.
73.TP
74.BI -S papersize
75specifies size of paper for which output is to be formatted.  The
76default is Letter (8.5 x 11).
77.TP
78.BI -s pagesize
79specifies the size of pages being printed n-up (i.e., the original size).  The
80default is Letter (8.5 x 11).
81.TP
82.BI -w pagewidth
83if the size of the pages being printed n-up isn't a standard size, you can
84specify the width and height instead.  Numbers followed by "i" will be
85interpreted in inches, by "m" in millimeters, and numbers without
86qualification will be interpreted as specifying the distance in points.
87.TP
88.BI -h pageheight
89specifies the height of the page being printed n-up.
90.TP
91.B -G
92formats the document in psnup's "gaudy" mode, with borders around the virtual
93pages.  If no n-up specification is given, the input file is printed with
94four virtual pages per sheet of paper.
95.TP
96.BI -p outputfile
97writes output to the specified file.
98.BI-p -
99means write output to standard output.
100.TP
101.BI -P printername
102.TP
103.BI -d printername
104uses
105.IR printername's
106\*(PS Printer Description file for information about available paper sizes.
107The
108result is
109.IR not
110spooled to the printer.
111
112.SH EXAMPLES
113The following command reads a \*(PS language file called printfile.ps
114and formats it with four pages on a sheet of paper.  The file is
115piped through pslpr to be printed on the printer called ps.
116
117.RS
118psnup -n4 printfile.ps | pslpr -Pps
119
120.RE
121In this example, a text file is processed by enscript, creating a \*(PS
122language file, which is piped to
123.I
124psnup,
125which rotates the file and formats it with three virtual pages across
126and two virtual pages down the paper.
127The formatted file is printed by piping the file through pslpr.
128
129.RS
130enscript -p- textfile | psnup -r -n3x2 | pslpr
131
132.RE
133In this example, a text file is processed by enscript, creating a \*(PS
134language file, which is piped to
135.I psnup,
136formatted in gaudy mode (
137.B -G
138option),
139with four virtual pages per actual page of output.
140The formatted file is printed by piping the file through pslpr.  The
141result is printed pages with four original text pages on each sheet, with each
142original text page surrounded by a border.
143
144.RS
145enscript -p- textfile | psnup -G -n4 | pslpr
146
147.RE
148.SH FILES
149.TP 2.2i
150XPSLIBDIRX/psnup.pro
151the prologue for
152.I psnup
153files.
154.br
155.SH "SEE ALSO"
156transcript(1), enscript(1), pslpr (1), postscript(7).
157.SH AUTHOR
158Adobe Systems Incorporated
159.SH "NOTES"
160\*(PS is a registered trademark of Adobe Systems Incorporated.
Note: See TracBrowser for help on using the repository browser.