C API: overhaul error handling

* Handle error conditions that occur when using the object handle
  interfaces. In the past, some exceptions were not correctly
  converted to errors or warnings.
* Add more detailed information to qpdf-c.h
* Make it possible to work more explicitly with uninitialized objects

1 files changed, 18 insertions, 0 deletions

diff --git a/ChangeLog b/ChangeLog
index 299b6272..341ae8e4 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,21 @@
+2021-12-10  Jay Berkenbilt  <ejb@ql.org>
+
+	* C API: Overhaul how errors are handle the C API's object handle
+	interfaces. Clarify documentation regarding object accessors and
+	how type errors and warnings are handled. Many cases that used to
+	crash code that used the C API can now be trapped and will be
+	written stderr if not trapped. The new method
+	qpdf_register_oh_error_handler can be used to specifically handle
+	errors that occur when accessing object handles. See qpdf-c.h for
+	details.
+
+	* C API: Add qpdf_oh_new_uninitialized to explicitly create
+	uninitialized object handles.
+
+	* Add new error code qpdf_e_object that is used for exceptions
+	(including warnings) that are caused by using QPDFObjectHandle
+	methods on object handles of the wrong type.
+
 2021-12-02  Jay Berkenbilt  <ejb@ql.org>
 
 	* C API: Add qpdf_oh_is_initialized.