This package reads and writes any document that conforms to the PDF
specification generously provided by Adobe at
http://partners.adobe.com/public/developer/pdf/index_reference.html (link last
checked Oct 2005).

The file format through PDF 1.5 is well-supported, with the exception of the
"linearized" or "optimized" output format, which this module can read but not
write. Many specific aspects of the document model are not manipulable with
this package (like fonts), but if the input document is correctly written, then
this module will preserve the model integrity.

The PDF writing feature saves as PDF 1.4-compatible. That means that we cannot
write compressed object streams. The consequence is that reading and then
writing a PDF 1.5+ document may enlarge the resulting file by a fair margin.

This library grants you some power over the PDF security model. Note that
applications editing PDF documents via this library MUST respect the security
preferences of the document. Any violation of this respect is contrary to
Adobe's intellectual property position, as stated in the reference manual at
the above URL.

Technical detail regarding corrupt PDFs: This library adheres strictly to the
PDF specification. Adobe's Acrobat Reader is more lenient, allowing some
corrupted PDFs to be viewable. Therefore, it is possible that some PDFs may be
readable by Acrobat that are illegible to this library. In particular, files
which have had line endings converted to or from DOS/Windows style (i.e. CR-NL)
may be rendered unusable even though Acrobat does not complain. Future library
versions may relax the parser, but not yet.