From 4ad94864781f48b1a4b77f9cfb934622bf756ba1 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Mon, 17 Jun 2024 12:51:52 +0200 Subject: Adding upstream version 4.23.0. Signed-off-by: Daniel Baumann --- upstream/archlinux/man1/psnup.1 | 152 ++++++++++++++++++++-------------------- 1 file changed, 77 insertions(+), 75 deletions(-) (limited to 'upstream/archlinux/man1/psnup.1') diff --git a/upstream/archlinux/man1/psnup.1 b/upstream/archlinux/man1/psnup.1 index 586ae35a..af0d9e9f 100644 --- a/upstream/archlinux/man1/psnup.1 +++ b/upstream/archlinux/man1/psnup.1 @@ -1,118 +1,120 @@ -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.1. -.TH PSNUP "1" "February 2023" "psnup 2.10" "User Commands" +.TH PSPDFUTILS "1" "2024\-04\-08" "pspdfutils 3.3.2" "User Commands" .SH NAME -psnup - put multiple pages of a PostScript document on to one page +pspdfutils .SH SYNOPSIS -.B psnup -[\fI\,OPTION\/\fR...] \fI\,-NUP \/\fR[\fI\,INFILE \/\fR[\fI\,OUTFILE\/\fR]] +.B pspdfutils +[OPTION...] -NUMBER [INFILE [OUTFILE]] .SH DESCRIPTION +.PP +.B psnup +uses +.B pstops +to impose multiple logical pages on to each physical sheet of paper. +.PP +Paper sizes can be given either as a name (see +.BR paper(1) ) +or as \fBwidth\fRx\fBheight\fR (see +.BR psutils (1) +for the available units). Put multiple pages of a PostScript document on to one page. + .TP \fB\-NUMBER\fR number of pages to impose on each output page + .TP -\fB\-p\fR, \fB\-\-paper\fR=\fI\,PAPER\/\fR -output paper name or dimensions +\fBINFILE\fR +`\-' or no INFILE argument means standard input + +.TP +\fBOUTFILE\fR +`\-' or no OUTFILE argument means standard output + +.SH OPTIONS .TP -\fB\-P\fR, \fB\-\-inpaper\fR=\fI\,PAPER\/\fR -input paper name or dimensions +\fB\-p\fR \fI\,PAPER\/\fR, \fB\-\-paper\fR \fI\,PAPER\/\fR +output paper name or dimensions (WIDTHxHEIGHT) + .TP -\fB\-m\fR, \fB\-\-margin\fR=\fI\,DIMENSION\/\fR +\fB\-P\fR \fI\,INPAPER\/\fR, \fB\-\-inpaper\fR \fI\,INPAPER\/\fR +input paper name or dimensions (WIDTHxHEIGHT) + +.TP +\fB\-m\fR \fI\,DIMENSION\/\fR, \fB\-\-margin\fR \fI\,DIMENSION\/\fR width of margin around each output page [default 0pt]; useful for thumbnail sheets, as the original page margins will be shrunk + .TP -\fB\-b\fR, \fB\-\-border\fR=\fI\,DIMENSION\/\fR +\fB\-b\fR \fI\,DIMENSION\/\fR, \fB\-\-border\fR \fI\,DIMENSION\/\fR width of border around each input page + .TP -\fB\-d\fR, \fB\-\-draw\fR[=\fI\,DIMENSION\/\fR] -draw a line of given width around each page -[relative to input page size; argument defaults to -1pt; default is no line] +\fB\-d\fR \fI\,[DIMENSION]\/\fR, \fB\-\-draw\fR \fI\,[DIMENSION]\/\fR +draw a line of given width (relative to original +page) around each page [argument defaults to 1pt; +default is no line; width is fixed for PDF] + .TP \fB\-l\fR, \fB\-\-rotatedleft\fR input pages are rotated left 90 degrees + .TP \fB\-r\fR, \fB\-\-rotatedright\fR input pages are rotated right 90 degrees + .TP \fB\-f\fR, \fB\-\-flip\fR swap output pages' width and height + .TP \fB\-c\fR, \fB\-\-transpose\fR swap columns and rows (column\-major order) + .TP -\fB\-t\fR, \fB\-\-tolerance\fR=\fI\,NUMBER\/\fR -maximum wasted area in square pt [default: 100,000] -.TP -\fB\-q\fR, \fB\-\-quiet\fR -don't show page numbers being output -.TP -\fB\-\-help\fR -display this help and exit +\fB\-t\fR \fI\,NUMBER\/\fR, \fB\-\-tolerance\fR \fI\,NUMBER\/\fR +maximum wasted area in square pt [default: 100000] + .TP \fB\-v\fR, \fB\-\-version\fR -display version information and exit -.PP +show program's version number and exit + +.TP +\fB\-q\fR, \fB\-\-quiet\fR +don't show progress + +.SH COMMENTS psnup aborts with an error if it cannot arrange the input pages so as to waste less than the given tolerance. -.PP -The output paper size defaults to the input paper size; if that is not given, -the default given by the `paper' command is used. -.PP -The input paper size defaults to the output paper size. -.PP -In row\-major order (the default), adjacent pages are placed in rows across -the paper; in column\-major order, they are placed in columns down the page. -.PP -.B psnup -uses -.B pstops -to impose multiple logical pages on to each physical sheet of paper. -.PP -Paper sizes can be given either as a name (see -.BR paper(1) ) -or as \fBwidth\fRx\fBheight\fR (see -.BR psutils (1) -for the available units). -.SS "Exit status:" -.TP -0 -if OK, -.TP -1 -if arguments or options are incorrect, or there is some other problem -starting up, -.TP -2 -if there is some problem during processing, typically an error reading or -writing an input or output file. +The output page size defaults to the input page size; if none is specified +in the document or on the command line, the default given by the `paper' +command is used. + +The input page size defaults to the output page size. + +In row\-major order (the default), adjacent pages are placed in rows +across the paper; in column\-major order, they are placed in columns down +the page. .SH EXAMPLES -The potential use of this utility is varied but one particular -use is in conjunction with +The potential use of this utility is varied but one particular +use is in conjunction with .BR psbook (1). -For example, using groff to create a PostScript document and lpr as -the -.SM UNIX -print spooler a typical command line might look like this: +For example, using groff to create a PostScript document and lpr as +the +.SM UNIX +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 +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 +pages 2 then 3 of the input document on the second output page. + .SH AUTHOR -Written by Angus J. C. Duggan and Reuben Thomas. -.SH COPYRIGHT -Copyright \(co Reuben Thomas 2016\-2022. -Released under the GPL version 3, or (at your option) any later version. -.SH TRADEMARKS -.B PostScript -is a trademark of Adobe Systems Incorporated. -.SH "SEE ALSO" -.BR psutils (1), -.BR paper (1) +.nf +Reuben Thomas +.fi -- cgit v1.2.3