Thorsten Schwander > TeX-AutoTeX > TeX::AutoTeX::ConcatPDF

Download:
TeX-AutoTeX-v0.906.0.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  1
Open  0
View/Report Bugs
Module Version: 0.94.0   Source  

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.

syntax highlighting: