Adding upstream version 4.22.0.upstream/4.22.0

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

1 files changed, 213 insertions, 0 deletions

diff --git a/upstream/fedora-rawhide/man1/pstops.1 b/upstream/fedora-rawhide/man1/pstops.1
new file mode 100644
index 00000000..db3dae68
--- /dev/null
+++ b/upstream/fedora-rawhide/man1/pstops.1
@@ -0,0 +1,213 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.1.
+.TH PSTOPS "1" "February 2023" "pstops 2.10" "User Commands"
+.SH NAME
+pstops - rearrange pages of a PostScript document
+.SH SYNOPSIS
+.B pstops
+[\fI\,OPTION\/\fR...] [\fI\,INFILE \/\fR[\fI\,OUTFILE\/\fR]]
+.SH DESCRIPTION
+Rearrange pages of a PostScript document.
+.PP
+The input PostScript file should follow the Adobe Document Structuring
+Conventions.
+.PP
+.I Pstops
+can be used to perform arbitrary re-arrangements of documents. For many tasks,
+it is simpler to use the other utilities in the PSUtils suite: see
+.BR psutils (1).
+.TP
+\fB\-S\fR, \fB\-\-specs\fR=\fI\,SPECS\/\fR
+page specifications (see below)
+.TP
+\fB\-R\fR, \fB\-\-pages\fR=\fI\,PAGES\/\fR
+select the given page ranges
+.TP
+\fB\-e\fR, \fB\-\-even\fR
+select even\-numbered output pages
+.TP
+\fB\-o\fR, \fB\-\-odd\fR
+select odd\-numbered output pages
+.TP
+\fB\-r\fR, \fB\-\-reverse\fR
+reverse the order of the output pages
+.TP
+\fB\-p\fR, \fB\-\-paper\fR=\fI\,PAPER\/\fR
+output paper name or dimensions (WIDTHxHEIGHT)
+.TP
+\fB\-P\fR, \fB\-\-inpaper\fR=\fI\,PAPER\/\fR
+input paper name or dimensions (WIDTHxHEIGHT)
+.TP
+\fB\-d\fR, \fB\-\-draw\fR[=\fI\,DIMENSION\/\fR]
+draw a line of given width (relative to original
+page) around each page [argument defaults to 1;
+default is 0]
+.TP
+\fB\-b\fR, \fB\-\-nobind\fR
+disable PostScript bind operators in prolog;
+may be needed for complex page rearrangements
+.TP
+\fB\-q\fR, \fB\-\-quiet\fR
+don't show page numbers being output
+.TP
+\fB\-\-help\fR
+display this help and exit
+.TP
+\fB\-v\fR, \fB\-\-version\fR
+display version information and exit
+.PP
+PAGES is a comma\-separated list of pages and page ranges.
+.PP
+Each may be a page number, or a page range of the form
+.IB first \- last .
+If
+.I first
+is omitted, the first page is assumed, and if
+.I last
+is omitted, the last page is assumed.
+The prefix character \[oq]_\[cq] indicates that the page number is relative to the end
+of the document, counting backwards.
+If just this character with no page number is used, a blank page will be
+inserted.
+Page numbers refer to the pages as they occur in the file, starting
+at one.
+The actual page number in the document may be different.
+.PP
+SPECS is a list of page specifications [default is "0", which selects
+each page in its normal order].
+.PP
+Pagespecs have the following 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 [\fIturns\fP][ @\fIscale\fP ][ ( \fIxoff\fP , \fIyoff\fP ) ]
+.TP
+.I turns
+=
+.IR turn [ turns ]
+.TP
+.I turn
+=
+.BR L | R | U | H | V
+.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.
+.PP
+.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.
+If there is only one page specification,
+the \fIpageno\fR (0) may be omitted.
+.PP
+The optional dimensions
+.I xoff
+and
+.I yoff
+shift the page by the specified amount.
+.I xoff
+and
+.I yoff
+may either be lengths (see
+.BR psutils (1))
+or followed by
+.B "w"
+or
+.B "h"
+to indicate a multiple of the output paper width or height.
+.PP
+The optional parameters
+.BR L ,
+.BR R ,
+.BR U ,
+.BR H ,
+and
+.B V
+rotate the page left, right, or upside-down, and flip (mirror) the page
+horizontally or vertically respectively.
+The optional
+.I scale
+parameter scales the page by the fraction specified.
+If the optional minus sign is specified, the page number is relative to the end of
+the document, instead of the start.
+.PP
+Pages whose
+.IR spec s
+are separated by
+.B +
+will be merged into a single page; otherwise,
+they will remain as separate pages.
+.PP
+The shift, rotation, and scaling are applied
+to the PostScript transformation matrix
+in that order, regardless of the order
+in which they appear on the command line.
+.PP
+Paper size names are converted to dimensions using
+.BR paper (1).
+The output paper size, if set, is used (after scaling) to set the
+clipping path for each page.
+.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.
+.SH EXAMPLES
+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 and Reuben Thomas.
+.SH BUGS
+.B pstops
+does not accept all DSC comments.
+.SH COPYRIGHT
+Copyright \(co Reuben Thomas 2017\-2023.
+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)