Update header documentation and ChangeLog entry for PCLm

1 files changed, 7 insertions, 2 deletions

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);