Debian Codegraph @

texmf-dist/doc/man/man1/dvibook.1

raw
1 .\" Copyright (c) 1987-2020 UMD-CS, released under the X11 license;
2 .\" see README and source files.
3 .TH DVIBOOK 1 "8 September 2020" "TeX Live"
4 .SH NAME
5 dvibook \- rearrange pages in DVI file into signatures
6 .SH SYNOPSIS
7 .B dvibook
8 [
9 .B \-q
10 ] [
11 .B \-s\fI<num>
12 ] [
13 .B \-r
14 ] [
15 .B \-i
16 .I infile
17 ] [
18 .B \-o
19 .I outfile
20 ]
21 [
22 .I infile
23 [
24 .I outfile
25 ] ]
26 .SH DESCRIPTION
27 .I Dvibook
28 rearranges pages from a DVI file produced by TeX into ``signatures'' for
29 printing books or booklets, creating a new DVI file
30 usable by any of the TeX conversion programs.
31 .PP
32 The
33 .I \-s
34 option selects the size of signature which will be used. The signature size is
35 the number of sides which will be folded and bound together; the number given
36 should be a multiple of four. The default is to use one signature for the
37 whole file. Extra blank sides will be added if the file does not contain a
38 multiple of four pages.
39 .PP
40 By default, dvibook rearranges the pages into left\-hand side binding
41 signatures; the
42 .I \-r
43 option switches to right\-hand side binding signatures. This might be useful
44 for pTeX vertical writing (tate\-kumi) documents.
45 .PP
46 Dvibook normally prints the page numbers of the pages rearranged; the
47 .I \-q
48 option suppresses this.
49 .SH AUTHOR
50 Angus Duggan, from dviselect(1), by
51 Chris Torek, University of Maryland. Currently maintained as part
52 of TeX Live (https://tug.org/texlive).
53 .SH "SEE ALSO"
54 dvitodvi(1), dviconcat(1), dviselect(1), latex(1), tex(1)
55 .br
56 .I "MC-TeX User's Guide"
57 .SH BUGS
58 .I Dvibook
59 does not adjust the parameters in the postamble; however, since these
60 values are normally used only to size certain structures in the output
61 conversion programs, and the parameters never need to be adjusted upward,
62 this has not proven to be a problem.