summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man1/pdfnup.1
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2013-04-07 18:26:53 +0000
committerKarl Berry <karl@freefriends.org>2013-04-07 18:26:53 +0000
commitb04c2e1a42573e9735547702356c7b9a769a6855 (patch)
treec0753443f39500a062d7698fe6b94359c813f871 /Master/texmf-dist/doc/man/man1/pdfnup.1
parentfb0bf13304a356f197bfc1add17f98c07e96f17b (diff)
texmf -> texmf-dist: doc
git-svn-id: svn://tug.org/texlive/trunk@29714 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/man/man1/pdfnup.1')
-rw-r--r--Master/texmf-dist/doc/man/man1/pdfnup.178
1 files changed, 78 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/man/man1/pdfnup.1 b/Master/texmf-dist/doc/man/man1/pdfnup.1
new file mode 100644
index 00000000000..86953387e89
--- /dev/null
+++ b/Master/texmf-dist/doc/man/man1/pdfnup.1
@@ -0,0 +1,78 @@
+.TH "pdfnup" "1" "10 March 2010" "" ""
+.SH "NAME"
+pdfnup \- n-up the pages of pdf files
+.SH "SYNOPSIS"
+.PP
+pdfnup [OPTION [OPTION] \&.\&.\&.] [SRC [PAGESPEC] [SRC [PAGESPEC]] \&.\&.\&.]
+.PP
+.SH "DESCRIPTION"
+.PP
+pdfnup converts files in the Adobe Portable Document Format (PDF)
+to "n-up" PDF files, that is, with multiple input pages
+per output page, for
+more economical printing etc\&. The default processing is to 2-up
+landscape output with no frame around pages, equivalent to using the
+options '--nup 2x1 --landscape true --frame 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
+pdfnup 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 '-nup' applied to their names by default. To change
+the suffix,
+use the '--suffix' option, for example
+.PP
+.RS
+.B pdfnup --nup 2x2 --suffix '2x2' --batch myfile1.pdf myfile2.pdf
+.RE
+.PP
+will result in files named 'myfile1-2x2.pdf' and 'myfile2-2x2.pdf'.
+.PP
+pdfnup 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 and geometry packages, is required\&.
+.PP
+pdfnup 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 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
+pdfnup 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) pdfpun(1) \&.
+.PP
+.SH "AUTHOR"
+.PP
+pdfnup is written and maintained by David Firth as part of the PDFjam package\&.
+