diff options
Diffstat (limited to 'upstream/archlinux/man1/psbook.1')
| -rw-r--r-- | upstream/archlinux/man1/psbook.1 | 95 |
1 files changed, 51 insertions, 44 deletions
diff --git a/upstream/archlinux/man1/psbook.1 b/upstream/archlinux/man1/psbook.1 index b7a50398..5efc1254 100644 --- a/upstream/archlinux/man1/psbook.1 +++ b/upstream/archlinux/man1/psbook.1 @@ -1,57 +1,64 @@ -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.1. -.TH PSBOOK "1" "February 2023" "psbook 2.10" "User Commands" +.TH PSPDFUTILS "1" "2024\-04\-08" "pspdfutils 3.3.2" "User Commands" .SH NAME -psbook - rearrange pages in a PostScript document into signatures +pspdfutils .SH SYNOPSIS -.B psbook -[\fI\,OPTION\/\fR...] [\fI\,INFILE \/\fR[\fI\,OUTFILE\/\fR]] +.B pspdfutils +[OPTION...] [INFILE [OUTFILE]] .SH DESCRIPTION -Rearrange pages in a PostScript document into signatures. -.TP -\fB\-s\fR, \fB\-\-signature\fR=\fI\,N\/\fR -number of pages per signature; -0 = all pages in one signature [default]; -1 = one page per signature; -otherwise, a multiple of 4 -.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 .B psbook uses .B pstops -to rearrange pages from a PostScript document into \[oq]signatures\[cq] for -printing books or booklets, creating a new PostScript file. -The signature size is the number of sides which will be folded and bound -together; the number given should be a multiple of four. +to rearrange pages from a PDF or PostScript document into \[oq]signatures\[cq] for +printing books or booklets, creating a new file. +A \[oq]signature\[cq], often called a \[oq]section\[cq] in bookbinding, is a +series of sheets that are folded together to be stitched into the book's +binding. Each sheet has two pages per side; the number of pages in a +signature must therefore be a multiple of four. Extra blank sides will be added if the file does not contain a multiple of four pages. -.SS "Exit status:" +.PP +The output should be printed 2-up (this can be achieved with +.BR psnup ) +and duplex, as for short-edge binding. Alternatively, the output of +.B psnup +can be passed through the following command: +.sp +pstops '2:0(0,0),1U(1w,1h)' +.sp +to rotate the verso page upside-down, and the result can be printed duplex +as for long-edge binding. +Rearrange pages in a PDF or PostScript document into signatures. + .TP -0 -if OK, +\fBINFILE\fR +`\-' or no INFILE argument means standard input + .TP -1 -if arguments or options are incorrect, or there is some other problem -starting up, +\fBOUTFILE\fR +`\-' or no OUTFILE argument means standard output + +.SH OPTIONS .TP -2 -if there is some problem during processing, typically an error reading or -writing an input or output file. +\fB\-s\fR \fI\,SIGNATURE\/\fR, \fB\-\-signature\fR \fI\,SIGNATURE\/\fR +number of pages per signature; +0 = all pages in one signature [default]; +1 = do not rearrange the pages; +otherwise, a multiple of 4 + +.TP +\fB\-v\fR, \fB\-\-version\fR +show program's version number and exit + +.TP +\fB\-q\fR, \fB\-\-quiet\fR +don't show progress + +.SH COMMENTS +PAGES is a comma\-separated list of pages and page ranges; see pstops(1) +for more details. + .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 |