Comment use of static ID in examples

Make sure people know that static ID should be used only for testing.

Comment use of static ID in examples
Make sure people know that static ID should be used only for testing.
Jay Berkenbilt
1 parent 8ddca96e
Showing 4 changed files with 7 additions and 4 deletions
examples/pdf-double-page-size.cc
examples/pdf-invert-images.cc
examples/pdf-linearize.c
examples/pdf-split-pages.cc
@@ -101,7 +101,7 @@ int main(int argc, char* argv[])
 	{
 	    // For the test suite, uncompress streams and use static
 	    // IDs.
-	    w.setStaticID(true);
+	    w.setStaticID(true); // for testing only
 	    w.setStreamDataMode(qpdf_s_uncompress);
 	}
 	w.write();
@@ -162,7 +162,7 @@ int main(int argc, char* argv[])
 	{
 	    // For the test suite, uncompress streams and use static
 	    // IDs.
-	    w.setStaticID(true);
+	    w.setStaticID(true); // for testing only
 	}
 	w.write();
 	std::cout << whoami << ": new file written to " << outfilename
@@ -50,7 +50,10 @@ int main(int argc, char* argv[])
     if (((qpdf_read(qpdf, infile, password) & QPDF_ERRORS) == 0) &&
 	((qpdf_init_write(qpdf, outfile) & QPDF_ERRORS) == 0))
     {
-	qpdf_set_static_ID(qpdf, QPDF_TRUE);
+        /* Use static ID for testing only. For production, a
+         * non-static ID is used. See also
+         * qpdf_set_deterministic_ID. */
+	qpdf_set_static_ID(qpdf, QPDF_TRUE); /* for testing only */
 	qpdf_set_linearization(qpdf, QPDF_TRUE);
 	qpdf_write(qpdf);
     }
@@ -36,7 +36,7 @@ static void process(char const* whoami,
 	{
 	    // For the test suite, uncompress streams and use static
 	    // IDs.
-	    outpdfw.setStaticID(true);
+	    outpdfw.setStaticID(true); // for testing only
 	    outpdfw.setStreamDataMode(qpdf_s_uncompress);
 	}
         outpdfw.write();