diff mbox series

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

Message ID 20220822215352.93012-1-jwakely@redhat.com
State New
Headers show
Series [committed] libstdc++: Document linker option for C++23 <stacktrace> [PR105678] | expand

Commit Message

Jonathan Wakely Aug. 22, 2022, 9:53 p.m. UTC 
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 mbox series

Patch

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>