From 4b908ade7079d9d7632a9ee0de3ce9c09a418fc4 Mon Sep 17 00:00:00 2001 From: Jay Berkenbilt Date: Mon, 21 Aug 2017 18:53:14 -0400 Subject: Update header documentation and ChangeLog entry for PCLm --- ChangeLog | 10 ++++++++++ include/qpdf/QPDFWriter.hh | 9 +++++++-- 2 files changed, 17 insertions(+), 2 deletions(-) diff --git a/ChangeLog b/ChangeLog index 5b9553d9..78015087 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,13 @@ +2017-08-21 Jay Berkenbilt + + * Add support for writing PCLm files. Most of the work was done by + Sahil Arora as part of a Google Summer + of Code project in 2017. PCLm support is useful only for clients + that specifically know how to create PCLm files. Support in qpdf + is just for ensuring that objects are written in the correct order + and for including some additional material in the output that is + required by the PCLm standard. + 2017-08-19 Jay Berkenbilt * Remove --precheck-streams. This is enabled by default now diff --git a/include/qpdf/QPDFWriter.hh b/include/qpdf/QPDFWriter.hh index 0ab2f2ad..59a0dd98 100644 --- a/include/qpdf/QPDFWriter.hh +++ b/include/qpdf/QPDFWriter.hh @@ -353,8 +353,13 @@ class QPDFWriter QPDF_DLL void setLinearization(bool); - // Create PCLm output. Enables writing unreferenced objects, - // set PCLm header and writes pages before file catalog and page tree. + // Create PCLm output. This is only useful for clients that know + // how to create PCLm files. If a file is structured exactly as + // PCLm requires, this call will tell QPDFWriter to write the PCLm + // header, create certain unreferenced streams required by the + // standard, and write the objects in the required order. Calling + // this on an ordinary PDF serves no purpose. There is no + // command-line argument that causes this method to be called. QPDF_DLL void setPCLm(bool); -- cgit v1.2.3-54-g00ecf