From: Wolfgang Bangerth <bangerth@colostate.edu>
Date: Mon, 8 May 2023 19:26:30 +0000 (-0600)
Subject: Add a changelog entry.
X-Git-Tag: v9.5.0-rc1~247^2
X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=refs%2Fpull%2F15178%2Fhead;p=dealii.git

Add a changelog entry.
---

diff --git a/doc/news/changes/major/20230508Bangerth b/doc/news/changes/major/20230508Bangerth
new file mode 100644
index 0000000000..5424e336ec
--- /dev/null
+++ b/doc/news/changes/major/20230508Bangerth
@@ -0,0 +1,15 @@
+Changed: Several parts of the library involve interfacing with
+external libraries by way of user-defined callback functions. Specific
+examples are the interfaces to the SUNDIALS solvers (e.g., the
+SUNDIALS::KINSOL class). These interfaces typically required using the
+convention for error reporting defined by the underlying library -- in
+the case of SUNDIALS, for example, callbacks needed to return zero in
+case of success, a negative value for an irrecoverable error, and a
+positive value for a recoverable error.
+
+This approach does not scale across the many interfaces we have. As a
+consequence, we standardized how callbacks should behave, as
+documented in @ref GlossUserProvidedCallBack "this glossary entry". 
+The interfaces in SUNDIALS::KINSOL have been changed correspondingly.
+<br>
+(Wolfgang Bangerth, 2023/05/08)