aboutsummaryrefslogtreecommitdiff
path: root/libstdc++-v3/doc
AgeCommit message (Collapse)AuthorFilesLines
2018-05-10Document Dual ABI for std::ios_base::failureJonathan Wakely7-18/+89
* doc/xml/faq.xml: Link to C++17 status. Add note to outdated answer. * doc/xml/manual/debug_mode.xml: Add array and forward_list to list of C++11 containers with Debug Mode support. * doc/xml/manual/using.xml: Document Dual ABI for ios_base::failure. * doc/html/*: Regenerate. From-SVN: r260129
2018-05-07Document -lstdc++fs requirement for std::filesystemJonathan Wakely1-1/+3
* doc/xml/manual/using.xml (table.cmd_options): Document that the C++17 Filesystem implementation also needs -lstdc++fs. From-SVN: r260011
2018-04-11Update libstdc++ manual in preparation for GCC 8 releaseJonathan Wakely26-46/+270
* doc/xml/manual/abi.xml: Document header locations in recent releases. * doc/xml/manual/evolution.xml: Add API changes since GCC 5. * doc/xml/manual/spine.xml: Update copyright years. * doc/xml/manual/strings.xml: Adjust tolower example to avoid undefined behaviour. * doc/xml/manual/test.xml: Update outdated notes on VERIFY in tests. * doc/html/*: Regenerate. From-SVN: r259308
2018-04-10Update links to archived copy of SGI STL docsJonathan Wakely8-17/+17
* doc/xml/faq.xml: Update links to archived copy of SGI STL docs. * doc/xml/manual/backwards_compatibility.xml: Likewise. * doc/xml/manual/containers.xml: Likewise. * doc/xml/manual/debug_mode.xml: Likewise. * doc/xml/manual/extensions.xml: Likewise. * doc/xml/manual/policy_data_structures_biblio.xml: Likewise. * doc/xml/manual/using.xml: Likewise. * doc/xml/manual/utilities.xml: Likewise. From-SVN: r259286
2018-03-18api.xml: www.fsf.org has moved to https.Gerald Pfeifer6-6/+6
* doc/xml/api.xml: www.fsf.org has moved to https. Also omit trailing slash for domain level link. * doc/xml/faq.xml: Ditto. * doc/xml/manual/appendix_free.xml (software): Ditto. * doc/xml/manual/intro.xml: Ditto. * doc/xml/manual/spine.xml: Ditto. * doc/xml/spine.xml: Ditto. From-SVN: r258637
2018-03-18documentation_hacking.xml: Adjust link to docbook.org.Gerald Pfeifer1-1/+1
* doc/xml/manual/documentation_hacking.xml: Adjust link to docbook.org. From-SVN: r258636
2018-01-29Regenerate libstdc++ documentationJonathan Wakely6-12/+18
* doc/xml/faq.xml: Update copyright years. * doc/html/*: Regenerate. From-SVN: r257142
2018-01-03Update copyright years.Jakub Jelinek3-3/+3
From-SVN: r256169
2017-12-27PR libstdc++/83538 fix std::match_results<T>::reference (LWG 2306)Jonathan Wakely1-0/+6
PR libstdc++/83538 * doc/xml/manual/intro.xml: Document LWG 2306 change. * include/bits/regex.h (match_results::reference): Change to non-const reference. * testsuite/28_regex/match_results/typedefs.cc: Check types are correct. From-SVN: r256012
2017-11-21Fix invalid XML in libstdc++ manualPrzemyslaw Wirkus1-1/+1
2017-11-21 Przemyslaw Wirkus <przemyslaw.wirkus@arm.com> * doc/xml/manual/using.xml (manual.intro.using.macros): Move variablelist element at the end of its list. From-SVN: r255023
2017-11-17Enable building libstdc++-v3 with Intel CETIgor Tsimbalist1-1/+2
libstdc++-v3/ * acinclude.m4: Add cet.m4. * configure.ac: Set CET_FLAGS. Update EXTRA_CFLAGS, EXTRA_CXX_FLAGS. * libsupc++/Makefile.am: Use Add EXTRA_CFLAGS. * Makefile.in: Regenerate. * configure: Likewise. * doc/Makefile.in: Likewise. * include/Makefile.in: Likewise. * libsupc++/Makefile.in: Likewise. * po/Makefile.in: Likewise. * python/Makefile.in: Likewise. * src/Makefile.in: Likewise. * src/c++11/Makefile.in: Likewise. * src/c++98/Makefile.in: Likewise. * src/filesystem/Makefile.in: Likewise. * testsuite/Makefile.in: Likewise. From-SVN: r254895
2017-11-05* doc/xml/manual/abi.xml: Move docs.oracle.com references to https.Gerald Pfeifer1-2/+2
From-SVN: r254426
2017-10-30Minor tweak to libstdc++ FAQJonathan Wakely1-4/+9
* doc/xml/faq.xml: Adjust "What is libstdc++?" answer slightly. From-SVN: r254224
2017-10-25Update C++17 library status documentationJonathan Wakely110-329/+480
* doc/xml/manual/status_cxx2017.xml: Update C++17 status, and information on feature-test macros. * doc/html/*: Regenerate. From-SVN: r254078
2017-10-23PR libstdc++/82644 document IS 29124 supportJonathan Wakely2-0/+319
Also fix declarations of special functions in C++17, to import them into the global namespace in <math.h>, and to prevent defining the non-standard hypergeometric functions in strict mode. PR libstdc++/82644 * doc/xml/manual/intro.xml: Include new section. * doc/xml/manual/status_cxxis29124.xml: New section on IS 29124 status. * include/bits/specfun.h [__STRICT_ANSI__] (hyperg, hypergf, hypergl) (conf_hyperg, conf_hypergf, conf_hypergl): Don't declare. * include/c_compatibility/math.h: Import special functions into global namespace for C++17. * testsuite/26_numerics/headers/cmath/82644.cc: New test. * testsuite/26_numerics/headers/cmath/functions_global_c++17.cc: New test. From-SVN: r254004
2017-10-19Update references to C++17 in libstdc++ manualJonathan Wakely1-16/+16
* doc/xml/manual/status_cxx2017.xml: Update references to C++17 section numbers. From-SVN: r253895
2017-10-13PR libstdc++/82522 overload map insert functions for rvalues (LWG 2354)Jonathan Wakely1-0/+6
PR libstdc++/82522 * doc/xml/manual/intro.xml: Document LWG 2354 changes. * include/bits/stl_map.h (map::insert(value_type&&)) (map::insert(const_iterator, value_type&&)): Add overload for rvalues. * include/bits/stl_multimap.h (multimap::insert(value_type&&)) (multimap::insert(const_iterator, value_type&&)): Likewise. * include/bits/unordered_map.h (unordered_map::insert(value_type&&)) (unordered_map::insert(const_iterator, value_type&&)) (unordered_multimap::insert(value_type&&)) (unordered_multimap::insert(const_iterator, value_type&&)): Likewise. * testsuite/23_containers/map/modifiers/insert/dr2354.cc: New test. * testsuite/23_containers/multimap/modifiers/insert/dr2354.cc: New test. * testsuite/23_containers/unordered_map/insert/dr2354.cc: New test. * testsuite/23_containers/unordered_multimap/insert/dr2354.cc: New test. From-SVN: r253725
2017-09-13Fix broken URLs in libstdc++ API docsJonathan Wakely1-3/+3
* doc/doxygen/mainpage.html: Fix broken URLs. From-SVN: r252070
2017-09-13PR libstdc++/81835 fix broken URLs in libstdc++ docsJonathan Wakely2-2/+2
PR libstdc++/81835 * doc/xml/manual/extensions.xml: Replace unstable URL. * doc/html/manual/ext_demangling.html: Regenerate. * libsupc++/cxxabi.h (__cxa_demangle): Fix broken URL. From-SVN: r252066
2017-09-12PR libstdc++/79433 no #error for including headers with wrong -stdJonathan Wakely1-9/+19
PR libstdc++/79433 * doc/xml/manual/status_cxx2017.xml: Update feature-test macros. * doc/html/*: Regenerate. * include/Makefile.am: Remove <bits/c++17_warning.h>. * include/Makefile.in: Regenerate. * include/bits/c++17_warning.h: Remove. * include/bits/string_view.tcc: Do not include <bits/c++17_warning.h> for pre-C++17 modes. * include/std/any: Likewise. (__cpp_lib_any): Define. * include/std/mutex (__cpp_lib_scoped_lock): Adjust value as per new SD-6 draft. * include/std/numeric (__cpp_lib_gcd_lcm): Define as per new SD-6 draft. * include/std/optional: Do not include <bits/c++17_warning.h>. (__cpp_lib_optional): Define. * include/std/shared_mutex: Do not include <bits/c++14_warning.h>. * include/std/string_view: Do not include <bits/c++17_warning.h>. (__cpp_lib_string_view): Define. * include/std/variant: Do not include <bits/c++17_warning.h>. (__cpp_lib_variant): Define. * testsuite/20_util/optional/cons/value_neg.cc: Adjust dg-error line numbers. * testsuite/26_numerics/gcd/1.cc: Test for __cpp_lib_gcd_lcm. * testsuite/26_numerics/gcd/gcd_neg.cc: Adjust dg-error line numbers. * testsuite/26_numerics/lcm/1.cc: Test for __cpp_lib_gcd_lcm. * testsuite/26_numerics/lcm/lcm_neg.cc: Adjust dg-error line numbers. * testsuite/30_threads/scoped_lock/requirements/typedefs.cc: Adjust expected value of __cpp_lib_scoped_lock. From-SVN: r252018
2017-09-09allocator.xml: Adjust link for Hoard.Gerald Pfeifer2-3/+3
* doc/xml/manual/allocator.xml: Adjust link for Hoard. * doc/html/manual/memory.html: Regenerate. From-SVN: r251919
2017-07-21Add AddressSanitizer annotations to std::vectorJonathan Wakely1-0/+18
* config/allocator/malloc_allocator_base.h [__SANITIZE_ADDRESS__] (_GLIBCXX_SANITIZE_STD_ALLOCATOR): Define. * config/allocator/new_allocator_base.h [__SANITIZE_ADDRESS__] (_GLIBCXX_SANITIZE_STD_ALLOCATOR): Define. * doc/xml/manual/using.xml (_GLIBCXX_SANITIZE_VECTOR): Document macro. * include/bits/stl_vector.h [_GLIBCXX_SANITIZE_VECTOR] (_Vector_impl::_Asan, _Vector_impl::_Asan::_Reinit) (_Vector_impl::_Asan::_Grow, _GLIBCXX_ASAN_ANNOTATE_REINIT) (_GLIBCXX_ASAN_ANNOTATE_GROW, _GLIBCXX_ASAN_ANNOTATE_GREW) (_GLIBCXX_ASAN_ANNOTATE_SHRINK, _GLIBCXX_ASAN_ANNOTATE_BEFORE_DEALLOC): Define annotation helper types and macros. (vector::~vector, vector::push_back, vector::pop_back) (vector::_M_erase_at_end): Add annotations. * include/bits/vector.tcc (vector::reserve, vector::emplace_back) (vector::insert, vector::_M_erase, vector::operator=) (vector::_M_fill_assign, vector::_M_assign_aux) (vector::_M_insert_rval, vector::_M_emplace_aux) (vector::_M_insert_aux, vector::_M_realloc_insert) (vector::_M_fill_insert, vector::_M_default_append) (vector::_M_shrink_to_fit, vector::_M_range_insert): Annotate. From-SVN: r250430
2017-07-11Improvements to the libstdc++ FAQ and manualJonathan Wakely5-403/+455
* doc/xml/faq.xml: Update several old entries. Improve cross-references. * doc/xml/manual/intro.xml: Add anchors to each DR. * doc/html/*: Regenerate. From-SVN: r250125
2017-06-16PR libstdc++/81092 add std::wstring symbols and bump library versionJonathan Wakely4-6/+26
PR libstdc++/81092 * acinclude.m4: Bump libtool_VERSION. * config/abi/post/i386-linux-gnu/baseline_symbols.txt: Update. * config/abi/post/x86_64-linux-gnu/32/baseline_symbols.txt: Update. * config/abi/pre/gnu.ver: Add wstring constructor symbols to GLIBCXX_3.4.24 version and move random_device::_M_get_entropy() symbol to new GLIBCXX_3.4.25 version. * doc/xml/manual/abi.xml: Document new versions. * doc/html/*: Regenerate. * testsuite/21_strings/basic_string/cons/char/8.cc: Use base object constructors to ensure required symbols are exported. * testsuite/21_strings/basic_string/cons/wchar_t/8.cc: Likewise. * testsuite/util/testsuite_abi.cc: Add new version. From-SVN: r249246
2017-06-14Fix libstdc++ testsuite failures with -D_GLIBCXX_USE_CXX11_ABI=0Jonathan Wakely1-2/+2
* doc/xml/manual/test.xml: Correct instructions on running tests. * testsuite/21_strings/basic_string/cons/char/deduction.cc: Adjust to pass when -D_GLIBCXX_USE_CXX11_ABI=0 added to RUNTESTFLAGS. * testsuite/21_strings/basic_string/cons/wchar_t/deduction.cc: Likewise. * testsuite/27_io/basic_ios/copyfmt/char/1.cc: Likewise. * testsuite/27_io/basic_ios/exceptions/char/1.cc: Likewise. * testsuite/27_io/basic_istream/extractors_arithmetic/char/ exceptions_failbit.cc: Likewise. * testsuite/27_io/basic_istream/extractors_arithmetic/wchar_t/ exceptions_failbit.cc: Likewise. * testsuite/27_io/basic_istream/extractors_other/char/ exceptions_null.cc: Likewise. * testsuite/27_io/basic_istream/extractors_other/wchar_t/ exceptions_null.cc: Likewise. * testsuite/27_io/basic_istream/sentry/char/12297.cc: Likewise. * testsuite/27_io/basic_istream/sentry/wchar_t/12297.cc: Likewise. * testsuite/27_io/basic_ostream/inserters_other/char/ exceptions_null.cc: Likewise. * testsuite/27_io/basic_ostream/inserters_other/wchar_t/ exceptions_null.cc: Likewise. * testsuite/27_io/ios_base/storage/2.cc: Likewise. From-SVN: r249206
2017-06-12Finish implementing P0426R1 "Constexpr for std::char_traits" for C++17Pedro Alves1-3/+2
As discussed in PR c++/80265 ("__builtin_{memcmp,memchr,strlen} are not usable in constexpr functions"), use __builtin_constant_p to tell whether we can defer to a constexpr algorithm. I used __always_inline__ just to be thorough. It isn't really really necessary as far as I could determine. Changes like these: if (__n == 0) return 0; - return wmemcmp(__s1, __s2, __n); + else + return wmemcmp(__s1, __s2, __n); are necessary otherwise G++ complains that we're calling a non-constexpr function, which looks like a a manifestation of PR67026 to me. libstdc++-v3: 2017-06-12 Pedro Alves <palves@redhat.com> * doc/xml/manual/status_cxx2017.xml: Update C++17 constexpr char_traits status. * doc/html/*: Regenerate. * include/bits/char_traits.h (_GLIBCXX_ALWAYS_INLINE): Define if not already defined. (__cpp_lib_constexpr_char_traits): Uncomment. (__constant_string_p, __constant_char_array_p): New. (std::char_traits<char>, std::char_traits<wchar_t>): Add _GLIBCXX17_CONSTEXPR on compare, length and find and use __constant_string_p, __constant_char_array_p and __builtin_constant_p to defer to __gnu_cxx::char_traits at compile time. * testsuite/21_strings/char_traits/requirements/ constexpr_functions_c++17.cc: Uncomment __cpp_lib_constexpr_char_traits tests. Uncomment test_compare<char>, test_length<char>, test_find<char>, test_compare<wchar_t>, test_length<wchar_t> and test_find<wchar_t> static_assert tests. From-SVN: r249137
2017-06-09Support move-only deleters in std::shared_ptr (LWG 2802)Jonathan Wakely1-0/+23
* doc/xml/manual/intro.xml: Document LWG 2802, 2873 and 2942 changes. * include/bits/shared_ptr.h (shared_ptr): Use rvalues for deleters (LWG 2802). * include/bits/shared_ptr_base.h (_Sp_ebo_helper, _Sp_counted_deleter (_Sp_counted_deleter::_Impl, __shared_count, __shared_ptr): Likewise. * testsuite/20_util/shared_ptr/cons/lwg2802.cc: New. From-SVN: r249061
2017-06-02PR libstdc++/80624 satisfy invariant for char_traits<char16_t>::eof()Jonathan Wakely1-0/+4
PR libstdc++/80624 * doc/xml/manual/status_cxx2011.xml: Document to_int_type behaviour. * include/bits/char_traits.h (char_traits<char16_t>::to_int_type): Transform eof value to U+FFFD. * testsuite/21_strings/char_traits/requirements/char16_t/eof.cc: New. * testsuite/27_io/basic_streambuf/sgetc/char16_t/80624.cc: New. * testsuite/27_io/basic_streambuf/sputc/char16_t/80624.cc: New. From-SVN: r248843
2017-05-23PR libstdc++/67578 Implement non-trivial std::random_device::entropyXi Ruoyao1-0/+2
2017-05-23 Xi Ruoyao <ryxi@stu.xidian.edu.cn> Jonathan Wakely <jwakely@redhat.com> PR libstdc++/67578 * acinclude.m4: Bump libtool_VERSION. * config/abi/pre/gnu.ver: Create GLIBCXX_3.4.24 with new symbol. * config.h.in: Regenerate. * configure: Regenerate. * configure.ac: Add test for <linux/random.h>. * doc/xml/manual/abi.xml: Document new library version. * include/bits/random.h (random_device::entropy) [_GLIBCXX_USE_RANDOM_TR1]: Add call to new _M_getentropy member. (random_device::_M_getentropy): Declare. * src/c++11/random.cc (random_device::_M_getentropy): Define. * testsuite/util/testsuite_abi.cc: Add GLIBCXX_3.4.24 to known versions, and make it the latest version. Co-Authored-By: Jonathan Wakely <jwakely@redhat.com> From-SVN: r248374
2017-05-18Fix typos in libstdc++ manualJonathan Wakely4-4/+4
* doc/xml/manual/policy_data_structures.xml: Fix typo. * doc/xml/manual/test_policy_data_structures.xml: Likewise. * doc/html/*: Regenerate. From-SVN: r248189
2017-05-18Update libstdc++ version info in manualJonathan Wakely4-2/+19
* doc/xml/manual/abi.xml: Document latest library versions. * doc/xml/manual/build_hacking.xml: Document requirement to update abi.xml when bumping library versions. * doc/html/*: Regenerate. From-SVN: r248186
2017-05-16Implement std::experimental::source_location (N4519)Jonathan Wakely2-4/+3
* configure: Regenerate. * doc/xml/manual/status_cxx2017.xml: Update status table. * doc/html/*: Regenerate. * include/Makefile.am: Add new header. * include/Makefile.in: Regenerate. * include/experimental/source_location: New header implementing N4519. * testsuite/experimental/source_location/1.cc: New test. From-SVN: r248110
2017-05-16Add cross-reference for test permutations in libstdc++ manualJonathan Wakely2-2/+6
* doc/xml/manual/appendix_contributing.xml: Link to test docs and note higher DejaGnu version requirement. * doc/html/*: Regenerate. From-SVN: r248092
2017-05-16Add cross-reference for BADNAMES in libstdc++ manualJonathan Wakely2-2/+2
* doc/xml/manual/appendix_contributing.xml: Link to the list of bad identifiers. * doc/html/*: Regenerate. From-SVN: r248091
2017-05-11Fix ViewCVS URLs in libstdc++ manualJonathan Wakely4-12/+12
* doc/xml/manual/allocator.xml: Fix ViewCVS URLs. * doc/xml/manual/mt_allocator.xml: Likewise. * doc/html/*: Regenerate. From-SVN: r247911
2017-05-08Clarify mt_allocator documentation w.r.t deallocationJonathan Wakely2-2/+4
* doc/xml/manual/mt_allocator.xml: Clarify deallocation behaviour. * doc/html/*: Regenerate. From-SVN: r247742
2017-04-19Rationalise ABI links in libstdc++ manualJonathan Wakely6-22/+22
* doc/xml/manual/abi.xml: Rephrase one of the references to the Itanium C++ ABI. * doc/xml/manual/test.xml: Document DejaGnu 1.5.3 requirement. * doc/html/*: Regenerate. From-SVN: r247003
2017-04-11faq.xml: Update reference link to C++ ABI for Itanium.Gerald Pfeifer2-4/+4
* doc/xml/faq.xml: Update reference link to C++ ABI for Itanium. * doc/xml/manual/abi.xml. Ditto (thrice). From-SVN: r246860
2017-04-03Remove duplicated entry in C++17 library status tableJonathan Wakely2-14/+3
* doc/xml/manual/status_cxx2017.xml: Remove duplicate table entry. * doc/html/*: Regenerate. From-SVN: r246661
2017-04-03Update C++17 library status table in manualJonathan Wakely4-8/+88
* doc/xml/manual/status_cxx2017.xml: Update C++17 status table. * doc/xml/manual/appendix_contributing.xml (contrib.organization): Add directories for debug, parallel and profile headers. * doc/html/*: Regenerate. From-SVN: r246656
2017-03-28Add _GLIBCXX_RELEASE macro to "Using" section of manualJonathan Wakely5-25/+55
* doc/xml/manual/abi.xml: Add xml:id anchor. * doc/xml/manual/using.xml (manual.intro.using.macros): Document _GLIBCXX_RELEASE. Link to new anchor for __GLIBCXX__ notes. (concurrency.io.structure): Add markup. * doc/html/*: Regenerate. From-SVN: r246532
2017-03-23Fix broken links in manual and remove outdated infoJonathan Wakely14-175/+38
* doc/xml/faq.xml: Add link. * doc/xml/manual/backwards_compatibility.xml: Remove outdated information on pre-ISO headers. Replace broken link to C++ FAQ Lite. * doc/xml/manual/io.xml: Update broken link. * doc/html/*: Regenerate. From-SVN: r246425
2017-03-18appendix_contributing.xml: Convert link to ansi.org to https.Gerald Pfeifer2-22/+6
* doc/xml/manual/appendix_contributing.xml: Convert link to ansi.org to https. Update link to the C++ standard at ansi.org. * doc/xml/faq.xml: Remove information redundant with the above; instead add a reference. From-SVN: r246259
2017-03-15Fix typo in config.h.in commentJonathan Wakely1-1/+0
* acinclude.m4 (GLIBCXX_CHECK_S_ISREG_OR_S_IFREG): Fix typo in comment. * config.h.in: Regenerate. * configure: Regenerate. * doc/Makefile.in: Regenerate. From-SVN: r246165
2017-03-09Define std::byte for C++17 (P0298R3)Jonathan Wakely1-12/+13
* doc/xml/manual/status_cxx2017.xml: Document std::byte support. * include/c_global/cstddef (std::byte): Define for C++17. * testsuite/18_support/byte/global_neg.cc: New test. * testsuite/18_support/byte/ops.cc: New test. * testsuite/18_support/byte/requirements.cc: New test. From-SVN: r246005
2017-03-05Add std::scoped_lock for C++17Jonathan Wakely11-29/+24
* doc/xml/manual/status_cxx2017.xml: Document P0156R2 status. * doc/html/*: Regenerate. * include/std/mutex (scoped_lock): Implement new C++17 template. * testsuite/30_threads/scoped_lock/cons/1.cc: New test. * testsuite/30_threads/scoped_lock/requirements/ explicit_instantiation.cc: New test. * testsuite/30_threads/scoped_lock/requirements/typedefs.cc: New test. From-SVN: r245903
2017-03-02debug_mode.xml: Update and simplify note on link- and run-time coexistence.Gerald Pfeifer1-9/+5
* doc/xml/manual/debug_mode.xml: Update and simplify note on link- and run-time coexistence. Co-Authored-By: François Dumont <frs.dumont@gmail.com> Co-Authored-By: Jonathan Wakely <jwakely@redhat.com> From-SVN: r245848
2017-03-01documentation_hacking.xml: Tweak link to doxygen.org.Gerald Pfeifer1-1/+1
* doc/xml/manual/documentation_hacking.xml: Tweak link to doxygen.org. From-SVN: r245808
2017-02-19* doc/xml/manual/debug.xml: Adjust link to ThreadSanitizer.Gerald Pfeifer1-1/+1
From-SVN: r245572
2017-02-18io.xml: Update link to groups.google.com.Gerald Pfeifer1-2/+2
* doc/xml/manual/io.xml: Update link to groups.google.com. Tweak link description. From-SVN: r245565