documentation fixes
diff --git a/inc/qcbor/qcbor_decode.h b/inc/qcbor/qcbor_decode.h
index d725582..e9c40fc 100644
--- a/inc/qcbor/qcbor_decode.h
+++ b/inc/qcbor/qcbor_decode.h
@@ -291,11 +291,11 @@
/** Type for a double floating-point number. Data is in @c val.double. */
#define QCBOR_TYPE_DOUBLE 27
-/** Special type for integers between -(2^63) - 2 to -(2^64) that
+/** Special type for integers between -2^63 - 1 to -2^64 that
* can't be returned as @ref QCBOR_TYPE_INT64 because they don't fit
* in an int64_t. The value is returned in @c val.uint64, but this
* isn't the number transmitted. Do this arithmatic (carefully to
- * avoid over/underflow) to get the value transmitted - val.uint64 - 1.
+ * avoid over/underflow) to get the value transmitted: - val.uint64 - 1.
* See QCBOREncode_AddNegativeUInt64() for a longer explanation
* and warning. */
#define QCBOR_TYPE_65BIT_NEG_INT 28
diff --git a/inc/qcbor/qcbor_encode.h b/inc/qcbor/qcbor_encode.h
index 9289ca7..0aa28f6 100644
--- a/inc/qcbor/qcbor_encode.h
+++ b/inc/qcbor/qcbor_encode.h
@@ -562,23 +562,22 @@
* QCBOR (making this a complete CBOR implementation).
*
* The most negative value QCBOREncode_AddInt64() can encode is
- * -9223372036854775808 which is -(2^63) -1 or negative
+ * -9223372036854775808 which is -2^63 or negative
* 0x800000000000. This can encode from -9223372036854775809 to
- * -18446744073709551616 or -(2^63) - 2 to -(2^64). Note that
+ * -18446744073709551616 or -2^63 - 1 to -2^64. Note that
* it is not possible to represent plus or minus 18446744073709551616
* in any standard C data type.
*
- * Negative integers are normally decoded in QCBOR with type \ref
- * QCBOR_TYPE_INT64. Integers in the range of -9223372036854775809 to
- * -18446744073709551616 are returned as \ref QCBOR_TYPE_65BIT_NEG_INT.
+ * Negative integers are normally decoded in QCBOR with type
+ * @ref QCBOR_TYPE_INT64. Integers in the range of -9223372036854775809
+ * to -18446744073709551616 are returned as @ref QCBOR_TYPE_65BIT_NEG_INT.
*
- * WARNING: some CBOR decoders will be unable to decode
- * -9223372036854775809 to -18446744073709551616. Most CPUs do not
- * have registers that can represent this range either. If you need
- * 65-bit negative integers, you likely need 66, 67 and 68-bit
- * negative integers so it's likely better to use
- * QCBOREncode_AddTNegativeBignum() where you can have any number of
- * bits. TODO: also see xxxx
+ * WARNING: some CBOR decoders will be unable to decode -2^63 - 1 to
+ * -2^64. Also, most CPUs do not have registers that can represent
+ * this range. If you need 65-bit negative integers, you likely need
+ * negative 66, 67 and 68-bit negative integers so it is likely better
+ * to use CBOR big numbers where you can have any number of bits. See
+ * QCBOREncode_AddTNegativeBignum() and TODO: also xxxx
*/
void
QCBOREncode_AddNegativeUInt64(QCBOREncodeContext *pCtx, uint64_t uNum);