Adding upstream version 4.23.0.upstream/4.23.0

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 77 insertions, 75 deletions

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 <rrt@sc3d.org>
+.fi