Debian Codegraph @

upstream/debian-unstable/man1/psbook.1

raw
1 .TH PSBOOK "1" "2025\-09\-08" "psutils 3.3.14" "User Commands"
2 .SH NAME
3 psbook
4 .SH SYNOPSIS
5 .B psbook
6 [OPTION...] [INFILE [OUTFILE]]
7 .SH DESCRIPTION
8 .PP
9 .B psbook
10 uses
11 .B pstops
12 to rearrange pages from a PDF or PostScript document into \[oq]signatures\[cq] for
13 printing books or booklets, creating a new file.
14 A \[oq]signature\[cq], often called a \[oq]section\[cq] in bookbinding, is a
15 series of sheets that are folded together to be stitched into the book's
16 binding. Each sheet has two pages per side; the number of pages in a
17 signature must therefore be a multiple of four.
18 Extra blank sides will be added if the file does not contain a multiple of
19 four pages.
20 .PP
21 The output should be printed 2-up (this can be achieved with \fBpsnup\fR(1))
22 and duplex, as for short-edge binding. Alternatively, the output of
23 .B psnup
24 can be passed through the following command:
25 .sp
26 pstops '2:0(0,0),1U(1w,1h)'
27 .sp
28 to rotate the verso page upside-down, and the result can be printed duplex
29 as for long-edge binding.
30 Rearrange pages in a PDF or PostScript document into signatures.
31
32 .TP
33 \fBINFILE\fR
34 `\-' or no INFILE argument means standard input
35
36 .TP
37 \fBOUTFILE\fR
38 `\-' or no OUTFILE argument means standard output
39
40 .SH OPTIONS
41 .TP
42 \fB\-s\fR \fI\,SIGNATURE\/\fR, \fB\-\-signature\fR \fI\,SIGNATURE\/\fR
43 number of pages per signature;
44 0 = all pages in one signature [default];
45 1 = do not rearrange the pages;
46 otherwise, a multiple of 4
47
48 .TP
49 \fB\-v\fR, \fB\-\-version\fR
50 show program's version number and exit
51
52 .TP
53 \fB\-q\fR, \fB\-\-quiet\fR
54 don't show progress
55
56 .SH COMMENTS
57 PAGES is a comma\-separated list of pages and page ranges; see pstops(1)
58 for more details.
59
60 .SH AUTHOR
61 .nf
62 Reuben Thomas <[email protected]>
63 .fi