This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "gcc-wwwdocs".

The branch, master has been updated
       via  66d5ee21c412fef8fc3c664f2aa2fdaf241e9f72 (commit)
      from  745430b2e92b32951dcd7e8572d5e54e189c74b7 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit 66d5ee21c412fef8fc3c664f2aa2fdaf241e9f72
Author: Sam James <s...@gentoo.org>
Date:   Wed Feb 12 09:11:27 2025 +0000

    bugs: improve "ABI changes" subsection
    
    C++ ABI for C++ standards with full support by GCC (rather than those
    marked as experimental per https://gcc.gnu.org/projects/cxx-status.html)
    should be stable. It's certainly not the case in 2025 that one needs a
    full world rebuild for C++ libraries using e.g. the default standard
    or any other supported standard by C++, unless it is marked experimental
    where we provide no guarantees.

diff --git a/htdocs/bugs/index.html b/htdocs/bugs/index.html
index c4907c38..c7c040e8 100644
--- a/htdocs/bugs/index.html
+++ b/htdocs/bugs/index.html
@@ -647,14 +647,14 @@ GCC maintains a 'Porting to' resource for new versions:
 components: the first defines how the elements of classes are laid
 out, how functions are called, how function names are mangled, etc;
 the second part deals with the internals of the objects in libstdc++.
-Although we strive for a non-changing ABI, so far we have had to
-modify it with each major release.  If you change your compiler to a
-different major release <em>you must recompile all libraries that
-contain C++ code</em>.  If you fail to do so you risk getting linker
-errors or malfunctioning programs.
-It should not be necessary to recompile if you have changed
-to a bug-fix release of the same version of the compiler; bug-fix
-releases are careful to avoid ABI changes. See also the
+For C++ standards marked as
+<a href="https://gcc.gnu.org/projects/cxx-status.html";>experimental</a>,
+stable ABI is not guaranteed: for these, if you change your compiler to a
+different major release <em>you must recompile any libraries that were built
+using a C++ -std= flag that was still experimental</em>.  If you fail
+to do so, you risk getting linker errors or malfunctioning programs.
+It should not be necessary to recompile for C++ standards supported fully
+by GCC, such as the default standard.  See also the
 <a href="https://gcc.gnu.org/onlinedocs/gcc/Compatibility.html";>compatibility
 section</a> of the GCC manual.</p>
 

-----------------------------------------------------------------------

Summary of changes:
 htdocs/bugs/index.html | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)


hooks/post-receive
-- 
gcc-wwwdocs

Reply via email to