← Back to branch summary

~ubuntu-branches/ubuntu/jaunty/texlive-bin/jaunty-security

« back to all changes in this revision

Viewing changes to build/source/utils/psutils/pstops.man

  • Committer: Bazaar Package Importer
  • Author(s): Norbert Preining
  • Date: 2008-06-26 23:14:59 UTC
  • mfrom: (2.1.30 intrepid)
  • Revision ID: james.westby@ubuntu.com-20080626231459-y02rjsrgtafu83yr
Tags: 2007.dfsg.2-3
http://bugs.debian.org/482915
add missing source roadmap.fig of roadmap.eps in fontinst documentation
(Closes: #482915) (urgency medium due to RC bug)
(new patch add-missing-fontinst-source)

Show diffs side-by-side

added added

removed removed

Lines of Context:
build/source/utils/psutils/pstops.man
 
1
.TH PSTOPS 1 "PSUtils Release @RELEASE@ Patchlevel @PATCHLEVEL@"
 
2
.SH NAME
 
3
pstops \- shuffle pages in a PostScript file
 
4
.SH SYNOPSIS
 
5
.B pstops
 
6
[
 
7
.B \-q
 
8
] [
 
9
.B \-b
 
10
] [
 
11
.B \-w\fIwidth\fR
 
12
] [
 
13
.B \-h\fIheight\fR
 
14
] [
 
15
.B \-p\fIpaper\fR
 
16
] [
 
17
.B \-d\fIlwidth\fR
 
18
]
 
19
.I pagespecs
 
20
[
 
21
.I infile
 
22
[
 
23
.I outfile
 
24
] ]
 
25
.SH DESCRIPTION
 
26
.I Pstops
 
27
rearranges pages from a PostScript document, creating a new PostScript file.
 
28
The input PostScript file should follow the Adobe Document Structuring
 
29
Conventions.
 
30
.I Pstops
 
31
can be used to perform a large number of arbitrary re-arrangements of
 
32
Documents, including arranging for printing 2-up, 4-up, booklets, reversing,
 
33
selecting front or back sides of documents, scaling, etc.
 
34
.PP
 
35
.I pagespecs
 
36
follow the syntax:
 
37
.RS
 
38
.TP 12
 
39
.I pagespecs
 
40
.I = [modulo:]specs
 
41
.TP
 
42
.I specs
 
43
.I = spec[+specs][,specs]
 
44
.TP
 
45
.I spec
 
46
.I = [-]pageno[L][R][U][@scale][(xoff,yoff)]
 
47
.RE
 
48
.sp
 
49
.I modulo
 
50
is the number of pages in each block. The value of
 
51
.I modulo
 
52
should be greater than 0; the default value is 1.
 
53
.I specs
 
54
are the page specifications for the pages in each block. The value of the
 
55
.I pageno
 
56
in each
 
57
.I spec
 
58
should be between 0 (for the first page in the block) and \fImodulo\fR-1
 
59
(for the last page in each block) inclusive.
 
60
The optional dimensions
 
61
.I xoff
 
62
and
 
63
.I yoff
 
64
shift the page by the specified amount.
 
65
.I xoff
 
66
and
 
67
.I yoff
 
68
are in PostScript's points, but may be followed by the units
 
69
.B "cm"
 
70
or
 
71
.B "in"
 
72
to convert to centimetres or inches, or the flag
 
73
.B "w"
 
74
or
 
75
.B "h"
 
76
to specify as a multiple of the width or height.
 
77
The optional parameters \fIL\fR, \fIR\fR, and \fIU\fR rotate the page left,
 
78
right, or upside-down.
 
79
The optional
 
80
.I scale
 
81
parameter scales the page by the fraction specified.
 
82
If the optional minus sign is specified, the page is relative to the end of
 
83
the document, instead of the start.
 
84
 
 
85
If page \fIspec\fRs are separated by
 
86
.B \+
 
87
the pages will be merged into one page; if they are separated by
 
88
.B \,
 
89
they will be on separate pages.
 
90
If there is only one page specification, with
 
91
.I pageno
 
92
zero, the \fIpageno\fR may be omitted.
 
93
 
 
94
The shift, rotation, and scaling are performed
 
95
in that order regardless of which order
 
96
they appear on the command line.
 
97
.PP
 
98
The
 
99
.I \-w
 
100
option gives the width which is used by the
 
101
.B "w"
 
102
dimension specifier, and the
 
103
.I \-h
 
104
option gives the height which is used by the
 
105
.B "h"
 
106
dimension specifier. These dimensions are also used (after scaling) to set the
 
107
clipping path for each page.
 
108
The 
 
109
.I \-p
 
110
option can be used as an alternative, to set the paper size to
 
111
.B a3, a4, a5, b5, letter, legal, tabloid, statement, executive, folio, quarto
 
112
or
 
113
.B 10x14.
 
114
The default paper size is
 
115
.B @PAPER@.
 
116
.PP
 
117
The
 
118
.I \-b
 
119
option prevents any
 
120
.B bind
 
121
operators in the PostScript prolog from binding. This may be needed in cases
 
122
where complex multi-page re-arrangements are being done.
 
123
.PP
 
124
The
 
125
.I \-d
 
126
option draws a line around the border of each page, of the specified width.
 
127
If the \fIlwidth\fR parameter is omitted, a default linewidth of 1 point is
 
128
assumed. The linewidth is relative to the original page dimensions,
 
129
\fIi.e.\fR it is scaled up or down with the rest of the page.
 
130
.PP
 
131
Pstops normally prints the page numbers of the pages re-arranged; the
 
132
.I \-q
 
133
option suppresses this.
 
134
.SH EXAMPLES
 
135
This section contains some sample re-arrangements. To put two pages on one
 
136
sheet (of A4 paper), the pagespec to use is:
 
137
.sp
 
138
.ce
 
139
2:0L@.7(21cm,0)+1L@.7(21cm,14.85cm)
 
140
.sp
 
141
To select all of the odd pages in reverse order, use:
 
142
.sp
 
143
.ce
 
144
2:-0
 
145
.sp
 
146
To re-arrange pages for printing 2-up booklets, use
 
147
.sp
 
148
.ce
 
149
4:-3L@.7(21cm,0)+0L@.7(21cm,14.85cm)
 
150
.sp
 
151
for the front sides, and
 
152
.sp
 
153
.ce
 
154
4:1L@.7(21cm,0)+-2L@.7(21cm,14.85cm)
 
155
.sp
 
156
for the reverse sides (or join them with a comma for duplex printing).
 
157
.SH AUTHOR
 
158
Copyright (C) Angus J. C. Duggan 1991-1995
 
159
.SH "SEE ALSO"
 
160
@MAN@
 
161
.SH TRADEMARKS
 
162
.B PostScript
 
163
is a trademark of Adobe Systems Incorporated.
 
164
.SH BUGS
 
165
.I Pstops
 
166
does not accept all DSC comments.