Use description from mattip

1 files changed, 7 insertions, 23 deletions

diff --git a/doc/release/upcoming_changes/21154.improvement.rst b/doc/release/upcoming_changes/21154.improvement.rst
index 5ff2a3ebf..38630b47b 100644
--- a/doc/release/upcoming_changes/21154.improvement.rst
+++ b/doc/release/upcoming_changes/21154.improvement.rst
@@ -1,23 +1,7 @@
-Math C library feature detection now works for wasm
----------------------------------------------------
-The previous feature detection generated C stubs like: 
-
-.. code-block:: C
-
-    void exp(void); // incorrect signature!
-    exp();
-    
-Then checked whether compiling and linking these worked. This generates warnings
-that complain that ``exp`` actually has signature ``double exp(double)`` but would
-otherwise work. However ``wasm-ld`` creates a hard error in this case, so when
-compiling to a wasm target everything is detected as missing.
-
-This is now fixed: we feature detect instead with code like:
-
-.. code-block:: C
-
-    double exp(double); // correct signature!
-    exp((double)0);
-
-which ``wasm-ld`` will link. As a side effect, the feature detection code now
-works without generating linker warnings.
+Math C library feature detection now uses correct signatures
+------------------------------------------------------------
+Compiling is preceded by a detection phase to determine whether the
+underlying libc supports certain math operations. Previously this code
+did not respect the proper signatures. Fixing this enables compilation
+for the ``wasm-ld`` backend (compilation for web assembly) and reduces
+the number of warnings.