[committed] libstdc++: Document linker option for C++23 [PR105678]

[Jonathan Wakely via Gcc-patches]

Tested powerpc64le-linux, pushed to trunk. Needs backporting.

-- >8 --

libstdc++-v3/ChangeLog:

        PR libstdc++/105678
        * doc/xml/manual/using.xml: Document -lstdc++_libbacktrace
        requirement for using std::stacktrace. Also adjust -frtti and
        -fexceptions to document non-default (i.e. negative) forms.
        * doc/html/*: Regenerate.
---

diff --git a/libstdc++-v3/doc/xml/manual/using.xml 
b/libstdc++-v3/doc/xml/manual/using.xml
index 36b86702d22..0b9a0c98518 100644
--- a/libstdc++-v3/doc/xml/manual/using.xml
+++ b/libstdc++-v3/doc/xml/manual/using.xml
@@ -69,12 +69,16 @@
     </row>
 
     <row>
-      <entry><literal>-fexceptions</literal></entry>
+      <entry>
+       <literal>-fno-exceptions</literal>
+      </entry>
       <entry>See <link linkend="intro.using.exception.no">exception-free 
dialect</link></entry>
     </row>
 
     <row>
-      <entry><literal>-frtti</literal></entry>
+      <entry>
+       <literal>-fno-rtti</literal>
+      </entry>
       <entry>As above, but RTTI-free dialect.</entry>
     </row>
 
@@ -104,6 +108,17 @@
       </entry>
     </row>
 
+    <row>
+      <entry><literal>-lstdc++_libbacktrace</literal></entry>
+      <entry>Until C++23 support is non-experimental, linking to
+       <filename class="libraryfile">libstdc++_libbacktrace.a</filename>
+       is required for use of the C++23 type
+       <classname>std::stacktrace</classname>
+       and related types in
+       <filename class="headerfile">&lt;stacktrace&gt;</filename>.
+      </entry>
+    </row>
+
     <row>
       <entry><literal>-fopenmp</literal></entry>
       <entry>For <link linkend="manual.ext.parallel_mode">parallel</link> 
mode.</entry>
-- 
2.37.2