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.