texlive[53282] trunk: pdfxup (31dec19)

[commits+karl at tug.org]

Revision: 53282
          http://tug.org/svn/texlive?view=revision&revision=53282
Author:   karl
Date:     2020-01-01 00:14:23 +0100 (Wed, 01 Jan 2020)
Log Message:
-----------
pdfxup (31dec19)

Modified Paths:
--------------
    trunk/Build/source/texk/texlive/linked_scripts/pdfxup/pdfxup
    trunk/Master/texmf-dist/doc/man/man1/pdfxup.1
    trunk/Master/texmf-dist/doc/man/man1/pdfxup.man1.pdf
    trunk/Master/texmf-dist/doc/support/pdfxup/README
    trunk/Master/texmf-dist/doc/support/pdfxup/RELEASES
    trunk/Master/texmf-dist/doc/support/pdfxup/pdfxup.pdf
    trunk/Master/texmf-dist/scripts/pdfxup/pdfxup

Modified: trunk/Build/source/texk/texlive/linked_scripts/pdfxup/pdfxup
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/man/man1/pdfxup.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/pdfxup.1	2019-12-31 23:13:20 UTC (rev 53281)
+++ trunk/Master/texmf-dist/doc/man/man1/pdfxup.1	2019-12-31 23:14:23 UTC (rev 53282)
@@ -1,8 +1,8 @@
 .\" Manpage for pdfxup.
 .\" Contact pdfxup at markey.fr to correct errors or typos.
-.TH man 1 "6 october 2015" "1.30" "pdfxup man page"
+.TH man 1 "31 december 2019" "1.50" "pdfxup man page"
 .SH NAME
-pdfxup \- n-up PDF pages with reduced margins
+pdfxup \- n-up tool with reduced margins
 .SH SYNOPSIS
 pdfxup [OPTIONS] [FILE]
 .SH DESCRIPTION
@@ -28,15 +28,20 @@
 \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)
+\fB\-l\fR, \fB\-\-landscape\fR
 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;
+\fB\-b\fR (le|se), \fB\-\-booklet\fR (le|se)
+configure for printing as a booklet. Value 'le' (which is the default
+value when \fB\-b\fR is used with no argument) means 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\-c\fR, \fB\-\-clip\fR
+clip pages to the computed bounding box. By default, content is not
+clipped, which may result in overlap of neighbouring pages. With this
+option, anything outside the bounding box will not be displayed.
+.TP
 \fB\-o\fR file, \fB\-\-output\fR file
 name of output file;
 .TP
@@ -44,7 +49,8 @@
 ask before overwriting output file;
 .TP
 \fB\-fw\fR d, \fB\-\-framewidth\fR d
-width of the frame around each page (default 0.4pt);
+width of the frame around each page (default 0.4pt). Set to 0pt to have no
+frame at all;
 .TP
 \fB\-im\fR d, \fB\-\-innermargins\fR d
 inner margin between frame and page (default 5pt);
@@ -52,24 +58,38 @@
 \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
+\fB\-is\fR d, \fB\-\-intspaces\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;
+\fB\-p\fR list, \fB\-\-pages\fR list
+only consider sublist of pages of input document. List is a
+comma-separated list of pages or ranges pages of the form a-b; a can
+be omitted to start from first page, and b can be omitted to end at
+the last page. Therefore, "\fB\-p\fR -" (which is the default)
+includes all pages. Also allows modulo, so that "\fB\-p\fR 0%2" would
+include only even-numbered pages.
 .TP
-\fB\-bb\fR a-b, \fB\-\-pages\fR a-b
-only consider pages a to b of input document for computing bounding box;
+\fB\-bb\fR list, \fB\-\-bb\fR list
+only consider sublist of pages 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;
+\fB\-nobb\fR list, \fB\-\-no-bb\fR list
+omit list of pages of input document from computation of bounding box;
 .TP
-\fB\-g\fR (0|1), \fB\-\-get-bb\fR (0|1)
+\fB\-g\fR, \fB\-\-get-bb\fR
 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\-w\fR file, \fB\-\-watermark\fR file
+use file as background watermark. file can be any format accepted by
+pdflatex (e.g. png or pdf). If file is a multipage PDF file, page n of
+the watermark file is used with page n of the input file, and the last
+page of the watermark file is repeated if the input file has more pages;
+.TP
+\fB\-wp\fR p, \fB\-\-watermark-period\fR p
+repeat the last p pages of the watermark file instead of only the last one;
+.TP
 \fB\-d\fR, \fB\-\-debug\fR
 debug mode: keep intermediary files;
 .TP
@@ -77,7 +97,7 @@
 select verbosity (default: 1);
 .TP
 \fB\-q\fR, \fB\-\-quiet\fR
-run quietly (equiv. '-V=0')
+run quietly (equiv. '-V=0');
 .TP
 \fB\-v\fR, \fB\-\-version\fR
 print version number and exit;
@@ -84,10 +104,25 @@
 .TP
 \fB\-h\fR, \fB\-\-help\fR
 print help message and exit.
-
+.SH EXAMPLES
+.TP
+\fB# pdfxup file.pdf\fR
+produces 2-up pdf file from file.pdf
+.TP
+\fB# pdfxup -bb 1-4 file.pdf\fR
+same behaviour, but computes the bounding box only using the 
+first 4 pages (this saves time when processing long documents)
+.TP
+\fB# pdfxup -b -o booklet.pdf file.pdf\fR
+same behaviour, but creates a booklet (as booklet.pdf)
+.TP
+\fB# pdfxup -kbb -x1 -y2 -l0 beamer-frames.pdf\fR
+arranges 2 beamer frames per page (not reducing margins)
+.TP
+\fB# pdfxup -kbb -x2 -y2 -l beamer-frames.pdf:1-12,15-19\fR
+arranges 4 beamer frames per page (not reducing margins), including
+only frames 1 to 12 and 15 to 19.
 .SH SEE ALSO
 gs(1), pdflatex(1)
-.SH BUGS
-No known bugs.
 .SH AUTHOR
 Nicolas Markey (pdfxup at markey.fr)

Modified: trunk/Master/texmf-dist/doc/man/man1/pdfxup.man1.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/support/pdfxup/README
===================================================================
--- trunk/Master/texmf-dist/doc/support/pdfxup/README	2019-12-31 23:13:20 UTC (rev 53281)
+++ trunk/Master/texmf-dist/doc/support/pdfxup/README	2019-12-31 23:14:23 UTC (rev 53282)
@@ -1,26 +1,24 @@
-PDFXUP -- v1.30 (2015/10/06)
+PDFXUP -- v1.50 (2019/12/31)
 N. Markey <pdfxup at 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 is a bash 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.
+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>
+%% (c) 2019/12/31 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

Modified: trunk/Master/texmf-dist/doc/support/pdfxup/RELEASES
===================================================================
--- trunk/Master/texmf-dist/doc/support/pdfxup/RELEASES	2019-12-31 23:13:20 UTC (rev 53281)
+++ trunk/Master/texmf-dist/doc/support/pdfxup/RELEASES	2019-12-31 23:14:23 UTC (rev 53282)
@@ -23,3 +23,8 @@
  - added options -g and -s for getting and then manually
  - setting bounding box.
  - created man page
+
+v1.50 (2019/12/31)
+ - added the -c option (to clip pages)
+ - corrected + improved option -p
+ - added watermarking
\ No newline at end of file

Modified: trunk/Master/texmf-dist/doc/support/pdfxup/pdfxup.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/scripts/pdfxup/pdfxup
===================================================================
(Binary files differ)