summaryrefslogtreecommitdiff
path: root/Build/source/texk/psutils/psutils-1.21-PATCHES/patch-20-psnup-man
blob: bbfc848c87844384ba43cb0909cb33876091af96 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
diff -ur psutils-1.21.orig/psnup.1 psutils-1.21/psnup.1
--- psutils-1.21.orig/psnup.1	2013-10-21 23:28:08.000000000 +0200
+++ psutils-1.21/psnup.1	2013-12-04 11:12:43.000000000 +0100
@@ -3,53 +3,32 @@
 psnup \- multiple pages per sheet
 .SH SYNOPSIS
 .B psnup
-[
-.B \-w\fIwidth\fR
-] [
-.B \-h\fIheight\fR
-] [
-.B \-p\fIpaper\fR
-] [
-.B \-W\fIwidth\fR
-] [
-.B \-H\fIheight\fR
-] [
-.B \-P\fIpaper\fR
-] [
-.B \-l
-] [
-.B \-r
-] [
-.B \-f
-] [
-.B \-c
-] [
-.B \-m\fImargin\fR
-] [
-.B \-b\fIborder\fR
-] [
-.B \-d\fIlwidth\fR
-] [
-.B \-s\fIscale\fR
-] [
-.B \-n\fIup\fR
-] [
-.B \-q
-] [
-.I infile
-[
-.I outfile
-] ]
+.RB [ \-w\fIwidth\fR ]
+.RB [ \-h\fIheight\fR ]
+.RB [ \-p\fIpaper\fR ]
+.RB [ \-W\fIwidth\fR ]
+.RB [ \-H\fIheight\fR ]
+.RB [ \-P\fIpaper\fR ]
+.RB [ \-l | \-r | \-f ]
+.RB [ \-c ]
+.RB [ \-m\fImargin\fR ]
+.RB [ \-b\fIborder\fR ]
+.RB [ \-d [ \fIlwidth\fR ]]
+.RB [ \-s\fIscale\fR ]
+.RB [ \-\fInup\fR ]
+.RB [ \-q ]
+.RI [ infile
+.RI [ outfile ]]
 .SH DESCRIPTION
-.I Psnup
+.B Psnup
 puts multiple logical pages onto each physical sheet of paper.
 The input PostScript file should follow the Adobe Document Structuring
 Conventions.
 .PP
 The
-.I \-w
+.B \-w
 option gives the paper width, and the
-.I \-h
+.B \-h
 option gives the paper height, specified in
 .BR pt ,
 .BR mm ,
@@ -57,79 +36,80 @@
 or
 .BR in .
 The 
-.I \-p
+.B \-p
 option can be used instead, to set the paper size; otherwise a default value is used.
 See
 .BR papersize (5).
 The
-.I \-W, \-H,
+.BR \-W ,
+.BR \-H ,
 and
-.I \-P
+.B \-P
 options set the input paper size, if it is different from the output
 size. This makes it easy to impose pages of one size on a different size of
 paper.
 .PP
 The
-.I \-l
+.B \-l
 option should be used for pages which are in landscape orientation (rotated 90
 degrees anticlockwise). The
-.I \-r
+.B \-r
 option should be used for pages which are in seascape orientation (rotated 90
 degrees clockwise), and the
-.I \-f
+.B \-f
 option should be used for pages which have the width and height interchanged,
 but are not rotated.
 .PP
-.I Psnup
+.B Psnup
 normally uses `row-major' layout, where adjacent pages are placed in rows
 across the paper.
 The
-.I \-c
+.B \-c
 option changes the order to `column-major', where successive pages are placed
 in columns down the paper.
 .PP
 A margin to leave around the whole page can be specified with the
-.I \-m
+.B \-m
 option. This is useful for sheets of `thumbnail' pages, because the normal
 page margins are reduced by putting multiple pages on a single sheet.
 .PP
 The
-.I \-b
+.B \-b
 option is used to specify an additional margin around each page on a sheet.
 .PP
 The
-.I \-d
+.B \-d
 option draws a line around the border of each page, of the specified width.
 If the \fIlwidth\fR parameter is omitted, a default linewidth of 1 point is
 assumed. The linewidth is relative to the original page dimensions,
-\fIi.e.\fR it is scaled down with the rest of the page.
+i.e., it is scaled down with the rest of the page.
 .PP
 The scale chosen by
-.I psnup
+.B psnup
 can be overridden with the
-.I \-s
+.B \-s
 option. This is useful to merge pages which are already reduced.
 .PP
 The
-.I \-\fInup\fR
+.BI \- nup
 option selects the number of logical pages to put on each sheet of paper. This
 can be any whole number;
-.I psnup
+.B psnup
 tries to optimise the layout so that the minimum amount of space is wasted. If
-.I psnup
+.B psnup
 cannot find a layout within its tolerance limit, it will abort with an error
 message. The alternative form
-.I \i \fInup\fR
+.BI \-n nup
 can also be used, for compatibility with other n-up programs.
 .PP
-.I Psnup
+.B Psnup
 normally prints the page numbers of the pages re-arranged; the
-.I \-q
+.B \-q
 option suppresses this.
 .SH EXAMPLES
 The potential use of this utility is varied but one particular 
 use is in conjunction with 
-.I psbook(1).
+.BR psbook (1).
 For example, using groff to create a PostScript document and lpr as 
 the 
 .SM UNIX 
@@ -151,5 +131,5 @@
 .B PostScript
 is a trademark of Adobe Systems Incorporated.
 .SH BUGS
-.I Psnup
+.B Psnup
 does not accept all DSC comments.