Doc clarifications
diff --git a/inc/qcbor/qcbor_spiffy_decode.h b/inc/qcbor/qcbor_spiffy_decode.h
index c7b7062..ed5cb83 100644
--- a/inc/qcbor/qcbor_spiffy_decode.h
+++ b/inc/qcbor/qcbor_spiffy_decode.h
@@ -661,9 +661,10 @@
* but the decoding will not proceed past the end or the array.
*
* The typical way to iterate over items in an array is to call
- * QCBORDecode_VGetNext() until @ref QCBOR_ERR_NO_MORE_ITEMS is
- * returned. Other methods like QCBORDecode_GetInt64(),
- * QCBORDecode_GetBignum() and such may also called.
+ * QCBORDecode_VGetNext() until QCBORDecode_GetError() returns
+ * @ref QCBOR_ERR_NO_MORE_ITEMS. Other methods like QCBORDecode_GetInt64(),
+ * QCBORDecode_GetBignum() and such may also called until
+ * QCBORDecode_GetError() doesn't return QCBOR_SUCCESS.
*
* Nested decoding of arrays may be handled by calling
* QCBORDecode_EnterArray() or by using QCBORDecode_VGetNext() to
@@ -672,15 +673,15 @@
* QCBORDecode_Rewind() can be called to restart decoding from the
* first item in the array.
*
- * When all decoding in array is complete QCBORDecode_ExitArray() must
+ * When all decoding in an array is complete, QCBORDecode_ExitArray() must
* be called. It is a decoding error to not have a corresponding call
* to QCBORDecode_ExitArray() for every call to QCBORDecode_EnterArray().
- * If not @ref QCBOR_ERR_ARRAY_OR_MAP_STILL_OPEN will be returned when
+ * If not, @ref QCBOR_ERR_ARRAY_OR_MAP_STILL_OPEN will be returned when
* QCBORDecode_Finish() is called.
*
- * When QCBORDecode_ExitArray() is called the traversal cusor is at
+ * After QCBORDecode_ExitArray() is called the traversal cusor is at
* the item right after the array. This is true whether or not all
- * items in the array are consumed. QCBORDecode_ExitArray() can even
+ * items in the array were consumed. QCBORDecode_ExitArray() can even
* be called right after QCBORDecode_EnterArray() as a way to skip
* over an array and all its contents.
*