summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man1/pdfxup.1
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2016-04-22 21:56:17 +0000
committerKarl Berry <karl@freefriends.org>2016-04-22 21:56:17 +0000
commit50e2368597d5f6fe2057195d0ae6a9f2044923e4 (patch)
tree259c16628d85d72c6ed7bb88f4091aea83a520f8 /Master/texmf-dist/doc/man/man1/pdfxup.1
parent04babbee2a9805682c3fdda4c353a3d56893d1e4 (diff)
pdfxup (22apr16)
git-svn-id: svn://tug.org/texlive/trunk@40690 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/man/man1/pdfxup.1')
-rw-r--r--Master/texmf-dist/doc/man/man1/pdfxup.193
1 files changed, 93 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/man/man1/pdfxup.1 b/Master/texmf-dist/doc/man/man1/pdfxup.1
new file mode 100644
index 00000000000..72da16aa97f
--- /dev/null
+++ b/Master/texmf-dist/doc/man/man1/pdfxup.1
@@ -0,0 +1,93 @@
+.\" Manpage for pdfxup.
+.\" Contact pdfxup@markey.fr to correct errors or typos.
+.TH man 1 "6 october 2015" "1.30" "pdfxup man page"
+.SH NAME
+pdfxup \- n-up PDF pages with reduced margins
+.SH SYNOPSIS
+pdfxup [OPTIONS] [FILE]
+.SH DESCRIPTION
+pdfxup creates a PDF document where each page is obtained by combining
+several pages of a PDF file given as output. The important feature of
+pdfxup, compared to similar programs, is that it tries to compute the
+(global) bounding box of the input PDF file, in order to remove the
+margins and to keep the text only. Instead of having the font size
+divided by 2 (for the case of 2-up output), in some case you may end up
+with almost the same font size as in the original document (as is the
+case for a default 'article' document produced by LaTeX).
+
+pdfxup uses ghostscript for computing the maximal bounding box of (some
+of) the pages of the document, and then uses pdflatex (with graphicx
+package) in order to produce the new document.
+.SH OPTIONS
+pdfxup accepts numerous options. The most important ones are:
+.\" additional options should be lister here...
+.TP
+\fB\-x\fR n, \fB\-\-columns\fR n
+sets the number of columns in the output file (default 2);
+.TP
+\fB\-y\fR n, \fB\-\-rows\fR n
+sets the number of lines in the output file (default 1);
+.TP
+\fB\-l\fR (0|1), \fB\-\-landscape\fR (0|1)
+sets orientation of paper (of final document) landscape;
+.TP
+\fB\-b\fR (0|1|le|se), \fB\-\-booklet\fR (0|1|le|se)
+configure for printing as a booklet. '1' is equivalent to 'le', which
+assumes that two-sided printing is in 'long-edge' mode (you turn from
+one page to the next along the long edge of the paper). 'se' is
+the 'short-edge' option;
+.TP
+\fB\-o\fR file, \fB\-\-output\fR file
+name of output file;
+.TP
+\fB\-i\fR
+ask before overwriting output file;
+.TP
+\fB\-fw\fR d, \fB\-\-framewidth\fR d
+width of the frame around each page (default 0.4pt);
+.TP
+\fB\-im\fR d, \fB\-\-innermargins\fR d
+inner margin between frame and page (default 5pt);
+.TP
+\fB\-m\fR d, \fB\-\-margins\fR d
+margin of pages of the new document (default 5pt);
+.TP
+\fB\-is\fR d, \fB\-\-intspacess\fR d
+space between different pages (default 1pt);
+.TP
+\fB\-p\fR a-b, \fB\-\-pages\fR a-b
+only consider pages a to b of input document;
+.TP
+\fB\-bb\fR a-b, \fB\-\-pages\fR a-b
+only consider pages a to b of input document for computing bounding box;
+.TP
+\fB\-nobb\fR a-b, \fB\-\-no-bb\fR a-b
+omit pages a to b of input document from computation of bounding box;
+.TP
+\fB\-g\fR (0|1), \fB\-\-get-bb\fR (0|1)
+only compute (and output) bounding box;
+.TP
+\fB\-s\fR x y W H, \fB\-\-set-bb\fR x y W H
+set the bounding box to the given values;
+.TP
+\fB\-d\fR, \fB\-\-debug\fR
+debug mode: keep intermediary files;
+.TP
+\fB\-V [0-3]\fR, \fB\-\-verbose\fR [0-3]
+select verbosity (default: 1);
+.TP
+\fB\-q\fR, \fB\-\-quiet\fR
+run quietly (equiv. '-V=0')
+.TP
+\fB\-v\fR, \fB\-\-version\fR
+print version number and exit;
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+print help message and exit.
+
+.SH SEE ALSO
+gs(1), pdflatex(1)
+.SH BUGS
+No known bugs.
+.SH AUTHOR
+Nicolas Markey (pdfxup@markey.fr)