From: Jonathan Wakely Date: Mon, 22 Aug 2022 16:24:27 +0000 (+0100) Subject: libstdc++: Document linker option for C++23 [PR105678] X-Git-Tag: basepoints/gcc-14~5062 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=cc4fa7a210b638d6a46f14dab17f2361389d18e1;p=thirdparty%2Fgcc.git libstdc++: Document linker option for C++23 [PR105678] 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/html/bk02.html b/libstdc++-v3/doc/html/bk02.html index 7c47759f223a..182c94b59a61 100644 --- a/libstdc++-v3/doc/html/bk02.html +++ b/libstdc++-v3/doc/html/bk02.html @@ -1,2 +1,2 @@ -


PrevÂ	Â	Â Next

Table of Contents

The GNU C++ Library API Reference

PrevÂ	Â	Â Next
Backwards CompatibilityÂ	Home	Â The GNU C++ Library API Reference

\ No newline at end of file +


PrevÂ	Â	Â Next

Table of Contents

The GNU C++ Library API Reference

PrevÂ	Â	Â Next
AppendixÂ E.Â GNU Free Documentation LicenseÂ	Home	Â The GNU C++ Library API Reference

\ No newline at end of file diff --git a/libstdc++-v3/doc/html/manual/extensions.html b/libstdc++-v3/doc/html/manual/extensions.html index 82bf42e54b07..1b13d711714f 100644 --- a/libstdc++-v3/doc/html/manual/extensions.html +++ b/libstdc++-v3/doc/html/manual/extensions.html @@ -1,8 +1,8 @@ -PartÂ III.Â Extensions

PartÂ III.Â +PartÂ III.Â Extensions

PartÂ III.Â Extensions -
PrevÂ	The GNU C++ Library Manual	Â Next

PartÂ III.Â +

PrevÂ

The GNU C++ Library Manual

Â Next

PrevÂ	Up	Â Next
Interacting with CÂ	Home	Â

\ No newline at end of file +

Observations

Associative
Priority_Queue

Acknowledgments

Bibliography

22. HP/SGI Extensions

Backwards Compatibility
Deprecated

23. Utilities

24. Algorithms

25. Numerics

26. Iterators

27. Input and Output

Derived filebufs

28. Demangling

29. Concurrency

Design

Interface to Locks and Mutexes
Interface to Atomic Functions

Implementation

Using Built-in Atomic Functions
Thread Abstraction

Use

PrevÂ	Up	Â Next
ChapterÂ 15.Â + Concurrency + +Â	Home	Â

\ No newline at end of file diff --git a/libstdc++-v3/doc/html/manual/using.html b/libstdc++-v3/doc/html/manual/using.html index 641a08c688b4..08facffa4454 100644 --- a/libstdc++-v3/doc/html/manual/using.html +++ b/libstdc++-v3/doc/html/manual/using.html @@ -16,7 +16,11 @@ g++ -std=gnu++98 for older releases.

TableÂ 3.1.Â C++ Command Options

Option Flags	Description
`-std=c++98` or `-std=c++03`	Use the 1998 ISO C++ standard plus amendments.
`-std=gnu++98` or `-std=gnu++03` -	As directly above, with GNU extensions.
`-std=c++11`	Use the 2011 ISO C++ standard.
`-std=gnu++11`	As directly above, with GNU extensions.
`-std=c++14`	Use the 2014 ISO C++ standard.
`-std=gnu++14`	As directly above, with GNU extensions.
`-fexceptions`	See exception-free dialect
`-frtti`	As above, but RTTI-free dialect.
`-pthread`	For ISO C++11 +	As directly above, with GNU extensions.
`-std=c++11`	Use the 2011 ISO C++ standard.
`-std=gnu++11`	As directly above, with GNU extensions.
`-std=c++14`	Use the 2014 ISO C++ standard.
`-std=gnu++14`	As directly above, with GNU extensions.
+ `-fno-exceptions` +	See exception-free dialect
+ `-fno-rtti` +	As above, but RTTI-free dialect.
`-pthread`	For ISO C++11 `<thread>`, `<future>`, `<mutex>`, @@ -27,6 +31,12 @@
`-lstdc++fs`	Linking to `libstdc++fs` is required for use of the Filesystem library extensions in `<experimental/filesystem>`. +
`-lstdc++_libbacktrace`	Until C++23 support is non-experimental, linking to + `libstdc++_libbacktrace.a` + is required for use of the C++23 type + `std::stacktrace` + and related types in + `<stacktrace>`.
`-fopenmp`	For parallel mode.
`-ltbb`	Linking to tbb (Thread Building Blocks) is required for use of the Parallel Standard Algorithms and execution policies in `<execution>`. diff --git a/libstdc++-v3/doc/xml/manual/using.xml b/libstdc++-v3/doc/xml/manual/using.xml index 36b86702d224..0b9a0c985184 100644 --- a/libstdc++-v3/doc/xml/manual/using.xml +++ b/libstdc++-v3/doc/xml/manual/using.xml @@ -69,12 +69,16 @@ - -fexceptions + + -fno-exceptions + See exception-free dialect - -frtti + + -fno-rtti + As above, but RTTI-free dialect. @@ -104,6 +108,17 @@ + + -lstdc++_libbacktrace + Until C++23 support is non-experimental, linking to + libstdc++_libbacktrace.a + is required for use of the C++23 type + std::stacktrace + and related types in + <stacktrace>. + + + -fopenmp For parallel mode.