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, 0 insertions, 169 deletions
diff --git a/Build/source/texk/psutils/psutils-src/pstops.1 b/Build/source/texk/psutils/psutils-src/pstops.1 deleted file mode 100644 index d2750877382..00000000000 --- a/Build/source/texk/psutils/psutils-src/pstops.1 +++ /dev/null @@ -1,169 +0,0 @@ -.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. |