From 18c4907e5dd20d92add4ca11b64828b4865cbc31 Mon Sep 17 00:00:00 2001 From: Wolfgang Bangerth Date: Mon, 8 May 2023 13:26:30 -0600 Subject: [PATCH] Add a changelog entry. --- doc/news/changes/major/20230508Bangerth | 15 +++++++++++++++ 1 file changed, 15 insertions(+) create mode 100644 doc/news/changes/major/20230508Bangerth 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. +
+(Wolfgang Bangerth, 2023/05/08) -- 2.39.5