Tweak "AndGet" mutator functions again

Remove any ambiguity around whether old or new value is being
returned.

1 files changed, 9 insertions, 10 deletions

diff --git a/ChangeLog b/ChangeLog
index 1fddfe4f..612c359d 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,14 @@
 2022-07-24  Jay Berkenbilt  <ejb@ql.org>
 
+        * QPDFObjectHandle: for the methods insertItem, appendItem,
+        eraseItem, replaceKey, and removeKey, add a corresponding
+        "AndGetNew" and/or "AndGetOld" methods. The ones that end with
+        "AndGetNew" return the newly added item. The ones that end with
+        "AndGetOld" return the old value. The AndGetNew methods make it
+        possible to create a new object, add it to an array or dictionary,
+        and get a handle to it all in one line. The AndGetOld methods make
+        it easier to retrieve an old value when removing or replacing it.
+
         * Thanks to m-holger for doing significant cleanup of private APIs
         and internals around QPDFObjGen and for significantly improving
         the performance of QPDFObjGen -- See #731. This includes a few
@@ -168,16 +177,6 @@
         128-bit without AES) an error rather than a warning when
         --allow-weak-crypto is not specified. Fixes #576.
 
-2022-04-29  Jay Berkenbilt  <ejb@ql.org>
-
-        * QPDFObjectHandle: for the methods insertItem, appendItem,
-        eraseItem, replaceKey, and removeKey, add a corresponding "AndGet"
-        method (insertItemAndGet, appendItemAndGet, eraseItemAndGet,
-        replaceKeyAndGet, and removeKeyAndGet) that returns the newly
-        inserted, replaced, or removed item. This makes it possible to
-        create a new object, add it to an array or dictionary, and get a
-        handle to it all in one line.
-
 2022-04-24  Jay Berkenbilt  <ejb@ql.org>
 
         * Bug fix: "removeAttachment" in the job JSON now takes an array