diff options
Diffstat (limited to 'Master/texmf-dist/doc/man/man1/psnup.1')
-rw-r--r-- | Master/texmf-dist/doc/man/man1/psnup.1 | 133 |
1 files changed, 54 insertions, 79 deletions
diff --git a/Master/texmf-dist/doc/man/man1/psnup.1 b/Master/texmf-dist/doc/man/man1/psnup.1 index 06922e43575..8b6e8a0e4d8 100644 --- a/Master/texmf-dist/doc/man/man1/psnup.1 +++ b/Master/texmf-dist/doc/man/man1/psnup.1 @@ -1,140 +1,115 @@ -.TH PSNUP 1 "PSUtils Release 1 Patchlevel 17" +.TH PSNUP 1 "PSUtils" .SH NAME 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 \-\fInup\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 -option gives the paper height, -normally specified in -.B "cm" +.B \-h +option gives the paper height, specified in +.BR pt , +.BR mm , +.BR cm , or -.B "in" -to convert -PostScript's points (1/72 of an inch) -to centimeters or inches. +.BR in . The -.I \-p -option can be used as an alternative, to set the paper size to -.B a3, a4, a5, b5, letter, legal, tabloid, statement, executive, folio, quarto -or -.B 10x14. -The default paper size is -.B a4. +.B \-p +option can be used instead, to set the paper size; otherwise a default value is used. +See +.BR paper (1). 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 @@ -142,19 +117,19 @@ print spooler a typical command line might look like this: .sp groff -Tps -ms \fIfile\fP | psbook | psnup -2 | lpr .sp -Where file is a 4 page document this command will result in a +where file is a 4 page document this command will result in a two page document printing two pages of \fIfile\fP per page and rearranges the page order to match the input pages 4 and 1 on the first output page and pages 2 then 3 of the input document on the second output page. .SH AUTHOR -Copyright (C) Angus J. C. Duggan 1991-1995 +Written by Angus J. C. Duggan. .SH "SEE ALSO" -epsffit(1), psbook(1), psnup(1), psresize(1), psselect(1), pstops(1), extractres(1), fixdlsrps(1), fixfmps(1), fixpsditps(1), fixpspps(1), fixscribeps(1), fixtpps(1), fixwfwps(1), fixwpps(1), fixwwps(1), includeres(1), psmerge(1), getafm(1) +.Br psutils (1) .SH TRADEMARKS .B PostScript is a trademark of Adobe Systems Incorporated. .SH BUGS -.I Psnup +.B Psnup does not accept all DSC comments. |