summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
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
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')
-rw-r--r--Master/texmf-dist/doc/man/man1/pdfxup.193
-rw-r--r--Master/texmf-dist/doc/man/man1/pdfxup.man1.pdfbin0 -> 19180 bytes
-rw-r--r--Master/texmf-dist/doc/support/pdfxup/README36
-rw-r--r--Master/texmf-dist/doc/support/pdfxup/RELEASES25
-rw-r--r--Master/texmf-dist/doc/support/pdfxup/pdfxup.pdfbin0 -> 6016 bytes
5 files changed, 154 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)
diff --git a/Master/texmf-dist/doc/man/man1/pdfxup.man1.pdf b/Master/texmf-dist/doc/man/man1/pdfxup.man1.pdf
new file mode 100644
index 00000000000..b8a1e06463f
--- /dev/null
+++ b/Master/texmf-dist/doc/man/man1/pdfxup.man1.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/pdfxup/README b/Master/texmf-dist/doc/support/pdfxup/README
new file mode 100644
index 00000000000..63d426a25c8
--- /dev/null
+++ b/Master/texmf-dist/doc/support/pdfxup/README
@@ -0,0 +1,36 @@
+PDFXUP -- v1.30 (2015/10/06)
+N. Markey <pdfxup@markey.fr>
+
+
+pdfxup is a unix/linux shell script that 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 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.
+
+
+
+%% (c) 2015/10/06 Nicolas Markey <pdfxup at markey dot fr>
+%%
+%% This work may be distributed and/or modified under the conditions of
+%% the LaTeX Project Public License, either version 1.3 of this license
+%% or (at your option) any later version. The latest version of this
+%% license is in
+%%
+%% http://www.latex-project.org/lppl.txt
+%%
+%% and version 1.3 or later is part of all distributions of LaTeX version
+%% 2005/12/01 or later.
+%%
+%% This work has the LPPL maintenance status `maintained'.
+%% The Current Maintainer of this work is Nicolas Markey.
diff --git a/Master/texmf-dist/doc/support/pdfxup/RELEASES b/Master/texmf-dist/doc/support/pdfxup/RELEASES
new file mode 100644
index 00000000000..ea248f6c4ad
--- /dev/null
+++ b/Master/texmf-dist/doc/support/pdfxup/RELEASES
@@ -0,0 +1,25 @@
+
+##################################################################
+##
+## Release notes
+##
+##################################################################
+Author: Nicolas Markey
+Please send your comments to <pdfxup@markey.fr>
+
+v1.00 (2015/08/23)
+ - first release
+
+v1.10 (2015/09/08)
+ - added option 'booklet'
+ - corrected numerous computation/spacing bugs in LaTeX file
+ - added succinct documentation
+
+v1.20 (2015/09/11)
+ - added options -nobb, -bb, -p
+ - solved bug with dots in PDF file names
+
+v1.30 (2015/10/06)
+ - added options -g and -s for getting and then manually
+ - setting bounding box.
+ - created man page
diff --git a/Master/texmf-dist/doc/support/pdfxup/pdfxup.pdf b/Master/texmf-dist/doc/support/pdfxup/pdfxup.pdf
new file mode 100644
index 00000000000..a2466a429b5
--- /dev/null
+++ b/Master/texmf-dist/doc/support/pdfxup/pdfxup.pdf
Binary files differ