The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

TeX::AutoTeX::ConcatPDF - concatenate a list of PDF files

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.