diff options
Diffstat (limited to 'Build/source/texk/psutils/psutils-src/pstops.1')
-rw-r--r-- | Build/source/texk/psutils/psutils-src/pstops.1 | 169 |
1 files changed, 169 insertions, 0 deletions
diff --git a/Build/source/texk/psutils/psutils-src/pstops.1 b/Build/source/texk/psutils/psutils-src/pstops.1 new file mode 100644 index 00000000000..d2750877382 --- /dev/null +++ b/Build/source/texk/psutils/psutils-src/pstops.1 @@ -0,0 +1,169 @@ +.TH PSTOPS 1 "PSUtils" +.SH NAME +pstops \- shuffle pages in a PostScript file +.SH SYNOPSIS +.B pstops +.RB [ \-q ] +.RB [ \-b ] +.RB [ \-w\fIwidth\fR ] +.RB [ \-h\fIheight\fR ] +.RB [ \-p\fIpaper\fR ] +.RB [ \-d [ \fIlwidth\fR ]] +.I pagespecs +.RI [ infile +.RI [ outfile ]] +.SH DESCRIPTION +.I Pstops +rearranges pages from a PostScript document, creating a new PostScript file. +The input PostScript file should follow the Adobe Document Structuring +Conventions. +.I Pstops +can be used to perform a large number of arbitrary re-arrangements of +Documents, including arranging for printing 2-up, 4-up, booklets, reversing, +selecting front or back sides of documents, scaling, etc. +.PP +.I pagespecs +follow the syntax: +.RS +.TP 12 +.I pagespecs += +.RI [ modulo\fB:\fP ] specs +.TP +.I specs += +.IR spec [ \fB+\fPspecs | \fB,\fPspecs ] +.TP +.I spec += +.RB [ - ] \fIpageno\fP [ L | R | U ][ H | V ][ @\fIscale\fP ][ ( \fIxoff\fP , \fIyoff\fP ) ] +.RE +.sp +.I modulo +is the number of pages in each block. The value of +.I modulo +should be greater than 0; the default value is 1. +.I specs +are the page specifications for the pages in each block. The value of the +.I pageno +in each +.I spec +should be between 0 (for the first page in the block) and \fImodulo\fR-1 +(for the last page in each block) inclusive. +The optional dimensions +.I xoff +and +.I yoff +shift the page by the specified amount. +.I xoff +and +.I yoff +are in PostScript's points, but may be followed by the units +.B "cm" +or +.B "in" +to convert to centimetres or inches, or the flag +.B "w" +or +.B "h" +to specify as a multiple of the width or height. +The optional parameters +.BR L , +.BR R , +.BR R , +.BR R , +and +.B V +rotate the page left, right, or upside-down, and flip (mirror) page +horizontally or vertically. +The optional +.I scale +parameter scales the page by the fraction specified. +If the optional minus sign is specified, the page is relative to the end of +the document, instead of the start. + +If page +.IR spec s +are separated by +.B + +the pages will be merged into one page; if they are separated by +.B , +they will be on separate pages. +If there is only one page specification, with +.I pageno +zero, the \fIpageno\fR may be omitted. + +The shift, rotation, and scaling are applied +to the PostScript transformation matrix +in that order regardless of which order +they appear on the command line. +The matrix accumulates the individual transformations. +The effect on the image is to first scale with respect to an origin +at the lower left corner, then rotate about the same origin, and +finally shift. +.PP +The +.B \-w +option gives the width which is used by the +.B "w" +dimension specifier, and the +.B \-h +option gives the height which is used by the +.B "h" +dimension specifier. These dimensions are also used (after scaling) to set the +clipping path for each page. +The +.B \-p +option can be used as an alternative, to set the paper size. See +.BR paper (1). +.PP +The +.B \-b +option prevents any +.B bind +operators in the PostScript prolog from binding. This may be needed in cases +where complex multi-page re-arrangements are being done. +.PP +The +.D \-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, +i.e., it is scaled up or down with the rest of the page. +.PP +Pstops normally prints the page numbers of the pages re-arranged; the +.B \-q +option suppresses this. +.SH EXAMPLES +This section contains some sample re-arrangements. To put two pages on one +sheet (of A4 paper), the pagespec to use is: +.sp +.ce +"2:0L@.7(21cm,0)+1L@.7(21cm,14.85cm)" +.sp +To select all of the odd pages in reverse order, use: +.sp +.ce +2:-0 +.sp +To re-arrange pages for printing 2-up booklets, use +.sp +.ce +"4:-3L@.7(21cm,0)+0L@.7(21cm,14.85cm)" +.sp +for the front sides, and +.sp +.ce +"4:1L@.7(21cm,0)+-2L@.7(21cm,14.85cm)" +.sp +for the reverse sides (or join them with a comma for duplex printing). +.SH AUTHOR +Written by Angus J. C. Duggan. +.SH "SEE ALSO" +.BR psutils (1) +.SH TRADEMARKS +.B PostScript +is a trademark of Adobe Systems Incorporated. +.SH BUGS +.B Pstops +does not accept all DSC comments. |