From ddd889af9d21c4cb6b3cf74ec750a3340217567c Mon Sep 17 00:00:00 2001 From: Jay Berkenbilt Date: Sun, 20 Nov 2022 15:33:13 -0500 Subject: Fix release notes and ChangeLog for 11.2 --- include/qpdf/QPDFObjectHandle.hh | 35 +++++++++++++++++++++-------------- 1 file changed, 21 insertions(+), 14 deletions(-) (limited to 'include') diff --git a/include/qpdf/QPDFObjectHandle.hh b/include/qpdf/QPDFObjectHandle.hh index f8bcb055..bf0da746 100644 --- a/include/qpdf/QPDFObjectHandle.hh +++ b/include/qpdf/QPDFObjectHandle.hh @@ -616,34 +616,41 @@ class QPDFObjectHandle QPDF_DLL static QPDFObjectHandle newFromMatrix(QPDFMatrix const&); + // Note: new stream creation methods have were added to the QPDF + // class starting with version 11.2.0. The ones in this class are + // here for backward compatibility. + // Create a new stream and associate it with the given qpdf - // object. A subsequent call must be made to replaceStreamData() - // to provide data for the stream. The stream's dictionary may be + // object. A subsequent call must be made to replaceStreamData() + // to provide data for the stream. The stream's dictionary may be // retrieved by calling getDict(), and the resulting dictionary - // may be modified. Alternatively, you can create a new - // dictionary and call replaceDict to install it. + // may be modified. Alternatively, you can create a new dictionary + // and call replaceDict to install it. From QPDF 11.2, you can + // call QPDF::newStream() instead. QPDF_DLL static QPDFObjectHandle newStream(QPDF* qpdf); // Create a new stream and associate it with the given qpdf - // object. Use the given buffer as the stream data. The stream + // object. Use the given buffer as the stream data. The stream // dictionary's /Length key will automatically be set to the size - // of the data buffer. If additional keys are required, the + // of the data buffer. If additional keys are required, the // stream's dictionary may be retrieved by calling getDict(), and - // the resulting dictionary may be modified. This method is just - // a convenient wrapper around the newStream() and - // replaceStreamData(). It is a convenience methods for streams - // that require no parameters beyond the stream length. Note that + // the resulting dictionary may be modified. This method is just a + // convenient wrapper around the newStream() and + // replaceStreamData(). It is a convenience methods for streams + // that require no parameters beyond the stream length. Note that // you don't have to deal with compression yourself if you use - // QPDFWriter. By default, QPDFWriter will automatically compress - // uncompressed stream data. Example programs are provided that - // illustrate this. + // QPDFWriter. By default, QPDFWriter will automatically compress + // uncompressed stream data. Example programs are provided that + // illustrate this. From QPDF 11.2, you can call QPDF::newStream() + // instead. QPDF_DLL static QPDFObjectHandle newStream(QPDF* qpdf, std::shared_ptr data); - // Create new stream with data from string. This method will + // Create new stream with data from string. This method will // create a copy of the data rather than using the user-provided // buffer as in the std::shared_ptr version of newStream. + // From QPDF 11.2, you can call QPDF::newStream() instead. QPDF_DLL static QPDFObjectHandle newStream(QPDF* qpdf, std::string const& data); -- cgit v1.2.3-70-g09d2