From 3f1ab640669ac493f1b2985b70322dba7c037ac9 Mon Sep 17 00:00:00 2001
From: Jay Berkenbilt <ejb@ql.org>
Date: Thu, 22 Aug 2019 19:16:25 -0400
Subject: Pass offset and length to ParserCallbacks::handleObject

---
 manual/qpdf-manual.xml | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

(limited to 'manual')

diff --git a/manual/qpdf-manual.xml b/manual/qpdf-manual.xml
index edf61bdb..db2a54fa 100644
--- a/manual/qpdf-manual.xml
+++ b/manual/qpdf-manual.xml
@@ -4489,6 +4489,25 @@ print "\n";
           <function>getUIntValueAsUInt</function>.
          </para>
         </listitem>
+        <listitem>
+         <para>
+          When parsing content streams with
+          <classname>QPDFObjectHandle::ParserCallbacks</classname>, in
+          place of the method
+          <function>handleObject(QPDFObjectHandle)</function>, the
+          developer may override
+          <function>handleObject(QPDFObjectHandle, size_t offset,
+          size_t length)</function>. If this method is defined, it
+          will be invoked with the object along with its offset and
+          length within the overall contents being parsed. Intervening
+          spaces and comments are not included in offset and length.
+          Additionally, a new method
+          <function>contentSize(size_t)</function> may be implemented.
+          If present, it will be called prior to the first call to
+          <function>handleObject</function> with the total size in
+          bytes of the combined contents.
+         </para>
+        </listitem>
         <listitem>
          <para>
           The underlying implementation of QPDF arrays has been
-- 
cgit v1.2.3-54-g00ecf