CamlPDF v0.1 Request For Comment
================================

Please see the file 'LICENSE' in this directory for terms of use.

To install, see file 'INSTALL' in this directory.

This is a pre-release of CamlPDF, an OCaml library for reading, writing and
manipulating Adobe portable document files. It is presented as a literate
program in the manner of Knuth. Since this is an implementation of someone
else's technology (unlike the rest of our work, which is new), we have decided
to release it for free use (see the LICENCE file for full conditions).

CamlPDF consists of a set of low level modules for representing, reading and
writing the basic structure of PDF (Pdf, Pdfread, Pdfwrite, Pdfcodec, Pdfpages,
Pdffun), together with an initial attempt at a higher level API (Pdfdoc). The
auxiliary libraries Utility, Io, Units and Paper are not directly related to
PDF.

Five examples (Pdfhello, Pdfdecomp, Pdfmerge, Pdfdraft, Pdftest) are provided.

Please advise of the following:
  o Files which cannot be read or written, or any other runtime error;
  o Suggestions as to the concretion of the higher level APIs;
  o Instances of particularly slow or resource-hungry scenarios.

Please be aware that PDF is a highly complex format and that many files are
malformed. We will incorporate support for malformed files if Acrobat reads
them.

It is anticipated that a further, stable release will be made in a few months'
time. We will endeavour to make no incompatible changes to the API of the low
level modules between now and then, but make no promise.

John Whitington
camlpdf@coherentgraphics.co.uk

