NAME
TeX::AutoTeX::ConcatPDF - concatenate a list of PDF file
VERSION
This documentation refers to TeX::AutoTeX::ConcatPDF version 0.9
SYNOPSIS
use TeX::AutoTeX::ConcatPDF qw(concatenate_pdf);
stamp_pdf($pdfoutfile, $list_ref);
DESCRIPTION
This module creates a PDF file which consists of the concatenation of the list of PDF files passed in.
There are many tools which provide similar functionality. Most of them seem to mangle annotations, in particular hyperlinks, in confusing ways.
The combination of pdflatex and pdfpages, which arXiv uses in production, does not carry forward hyperlinks, which is preferable to incorrect hyperlinks.
An easy alternative to the fairly involved procedure used here is a straightforward system call to ghostscript with appropriate arguments, e.g.
gs -dBATCH -dNOPAUSE -q -sDEVICE=pdfwrite -sOutputFile=combined.pdf file1.pdf file2.pdf
with the mentioned drawbacks for the resulting file combined.pdf.
SUBROUTINES/METHODS
The single subroutine exported by this package is concatenate_pdf.
concatenate_pdf
concatenate_pdf takes 2 arguments, the name of a file to which the generated PDF file will be written, and a reference to a list, which contains the ordered list of PDF files to be concatenated.
DIAGNOSTICS
croak and die
CONFIGURATION AND ENVIRONMENT
none
DEPENDENCIES
CAM::PDF
INCOMPATIBILITIES
none
BUGS AND LIMITATIONS
CAM::PDF sometimes chokes on large and/or complex PDF files.
Please report bugs to www-admin
AUTHOR
Thorsten Schwander <schwande@cs.cornell.edu>
LICENSE AND COPYRIGHT
Copyright (c) 2008 - 2011 arxiv.org http://arxiv.org/help/contact
This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic.