diff options
Diffstat (limited to 'manual')
-rw-r--r-- | manual/json.rst | 16 | ||||
-rw-r--r-- | manual/release-notes.rst | 10 |
2 files changed, 18 insertions, 8 deletions
diff --git a/manual/json.rst b/manual/json.rst index 2e71bdab..92a89b6b 100644 --- a/manual/json.rst +++ b/manual/json.rst @@ -595,11 +595,17 @@ Documentation appears in the corresponding location of the actual output. The corresponding output can have any value including ``null``. - - An array in the help output always contains a single element. It - indicates that the corresponding location in the actual output is - an array of any length, and that each element of the array has - whatever format is implied by the single element of the help - output's array. + - A single-element array in the help output indicates that the + corresponding location in the actual output is either a single + item or is an array of any length. The single item or each + element of the array has whatever format is implied by the single + element of the help output's array. + + - A multi-element array in the help output indicates that the + corresponding location in the actual output is an array of the + same length. Each element of the output array has whatever format + is implied by the corresponding element of the help output's + array. For example, the help output indicates includes a ``"pagelabels"`` key whose value is an array of one element. That element is a diff --git a/manual/release-notes.rst b/manual/release-notes.rst index 3d5b5cc5..ebbfd4f5 100644 --- a/manual/release-notes.rst +++ b/manual/release-notes.rst @@ -163,9 +163,13 @@ For a detailed list of changes, please see the file - See examples :file:`examples/qpdfjob-save-attachment.cc` and :file:`examples/qpdfjob-c-save-attachment.cc`. - - New methods ``insertItemAndGet``, ``appendItemAndGet``, - ``eraseItemAndGet``, ``replaceKeyAndGet``, and - ``removeKeyAndGet`` return the newly added or removed object. + - In ``QPDFObjectHandle``, new methods ``insertItemAndGetNew``, + ``appendItemAndGetNew``, and ``replaceKeyAndGetNew`` return the + newly added item. New methods ``eraseItemAndGetOld``, + ``replaceKeyAndGetOld``, and ``removeKeyAndGetOld`` return the + item that was just removed or, in the case of + ``replaceKeyAndGetOld``, a ``null`` object if the object was not + previously there. - Add new ``Pipeline`` methods to reduce the amount of casting that is needed: |