From: Wolfgang Bangerth <bangerth@colostate.edu>
Date: Wed, 31 May 2023 23:15:55 +0000 (-0600)
Subject: Add changelog entry.
X-Git-Tag: v9.5.0-rc1~173^2
X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=refs%2Fpull%2F15291%2Fhead;p=dealii.git

Add changelog entry.
---

diff --git a/doc/news/changes/incompatibilities/20230531Bangerth b/doc/news/changes/incompatibilities/20230531Bangerth
new file mode 100644
index 0000000000..d9804e1d54
--- /dev/null
+++ b/doc/news/changes/incompatibilities/20230531Bangerth
@@ -0,0 +1,13 @@
+Changed: The SUNDIALS::KINSOL, SUNDIALS::ARKode, and SUNDIALS::IDA
+interfaces used to use callbacks through which users provide
+information to these solvers. If user code encountered errors, this
+was indicated via integer return codes -- a zero return value
+indicating success.
+
+This is not in line with how C++ typically operates; in C++ errors are
+typically indicated via exceptions. The interfaces to the libraries
+above have been changed to now use exceptions instead, and this
+convention has been documented in a glossary entry on
+@ref GlossUserProvidedCallBack "user provided callback".
+<br>
+(Wolfgang Bangerth, 2023/05/31)