summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man1/pdfbook.1
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/man/man1/pdfbook.1')
-rw-r--r--Master/texmf-dist/doc/man/man1/pdfbook.186
1 files changed, 86 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/man/man1/pdfbook.1 b/Master/texmf-dist/doc/man/man1/pdfbook.1
new file mode 100644
index 00000000000..75f72bd5aef
--- /dev/null
+++ b/Master/texmf-dist/doc/man/man1/pdfbook.1
@@ -0,0 +1,86 @@
+.TH "pdfbook" "1" "10 March 2010" "" ""
+.SH "NAME"
+pdfbook \- put the pages of PDF files into 2-up signatures
+.SH "SYNOPSIS"
+.PP
+pdfbook [--short-edge] [OPTION [OPTION] \&.\&.\&.] [SRC [PAGESPEC] [SRC [PAGESPEC]] \&.\&.\&.]
+.PP
+.SH "DESCRIPTION"
+.PP
+pdfbook makes 2-up versions of PDF files, with the pages ordered as
+signatures. The default signature size is 4: to change this, use the
+option '--signature N', where N is a multiple of 4 (alternatively use '--signature* N' for
+right-edge binding).
+.PP
+The default is to make pages suitable for long-edge binding. For short-edge
+binding, use '--short-edge' as the first argument; this will only work if the LaTeX package 'everyshi' is installed.
+.PP
+The default output page orientation is
+landscape. To change this, use the '--no-landscape' option.
+.PP
+By default, the option '--booklet true' is used (see the pdfpages manual
+for details). To turn this off, just specify '--booklet false'.
+.PP
+If no source PDF file ('SRC') is specified, input
+is from /dev/stdin. If 'PAGESPEC' is omitted, all pages are processed.
+.PP
+Source files are processed sequentially into a single output
+unless the '--batch' option is used, in which case they are processed
+separately.
+.PP
+pdfbook is a simple wrapper for pdfjam, which provides a front end to
+many of the capabilities of the pdfpages
+package for pdflatex\&. A working installation of pdflatex, with
+the pdfpages package, is required\&.
+.PP
+pdfbook operates on one or more PDF files, and (either with the '--batch'
+option or with '--outfile DIR' where 'DIR' is a directory) the
+resulting files have
+the suffix '-book' applied to their names by default. To change the suffix,
+use the '--suffix' option, for example
+.PP
+.RS
+.B pdfbook --suffix 'sig4' --batch myfile1.pdf myfile2.pdf
+.RE
+.PP
+will result in files named 'myfile1-sig4.pdf' and 'myfile2-sig4.pdf'.
+.PP
+pdfbook is part of the "PDFjam" package of tools, whose homepage is at
+http://www.warwick.ac.uk/go/pdfjam\&.
+.PP
+.SH "SETUP"
+.PP
+See http://go.warwick.ac.uk/pdfjam .
+.PP
+.SH "USAGE"
+.PP
+For the other available options and
+site/user defaults, see the output of
+.PP
+.RS
+.B pdfjam --help
+.RE
+.PP
+For further information and some examples see
+http://go.warwick.ac.uk/pdfjam .
+.PP
+.SH "LIMITATIONS AND BUGS"
+.PP
+pdfbook does not work with encrypted PDF files, and does not
+preserve hyperlinks.
+.PP
+Please report bugs! See the website at
+http://www.warwick.ac.uk/go/pdfjam \&.
+.PP
+.SH "LICENSE"
+.PP
+PDFjam is distributed under the GNU public license\&.
+.PP
+.SH "SEE ALSO"
+.PP
+pdfjam(1)\&.
+.PP
+.SH "AUTHOR"
+.PP
+pdfbook is written and maintained by David Firth as part of the PDFjam package\&.
+