diff --git a/libcxx/docs/ReleaseNotes.rst b/libcxx/docs/ReleaseNotes.rst --- a/libcxx/docs/ReleaseNotes.rst +++ b/libcxx/docs/ReleaseNotes.rst @@ -35,9 +35,24 @@ What's New in Libc++ 17.0.0? ============================ +The main focus of the libc++ team has been to implement new C++20 and C++23 +features. Work on the next C++ version, C++26, has started. + +The C++20 ``format`` library is marked as stable. The library is not complete since +the C++20 ``chrono`` library lacks supports for time zones and some clocks. + +The C++20 spaceship operator is almost complete. It misses ``long double`` and +time zone support. + There is an experimental implementation of the C++23 ``std`` module. See :ref:`ModulesInLibcxx` for more information. +An experimental implementation of the C++20 ``stop_token`` is available. + +Work has started on the C++17 Parallel STL. This feature is experimental, see +:ref:`pstl-status` for the current status. + + Implemented Papers ------------------ - P2520R0 - ``move_iterator`` should be a random access iterator @@ -48,11 +63,17 @@ - P2711R1 - Making Multi-Param Constructors Of views explicit (``join_with_view`` is not done yet) - P2572R1 - ``std::format`` fill character allowances - P2510R3 - Formatting pointers +- P2136R3 - ``invoke_r`` +- P2494R2 - Relaxing range adaptors to allow for move only types +- P2585R0 - Improving default container formatting +- P0408R7 - Efficient Access to ``basic_stringbuf``'s Buffer + Improvements and New Features ----------------------------- -- ``std::equal`` and ``std::ranges::equal`` are now forwarding to ``std::memcmp`` for integral types and pointers, - which can lead up to 40x performance improvements. +- ``std::equal``, ``std::ranges::equal``, ``std::find``, and + ``std::ranges::find`` are now forwarding to ``std::memcmp`` for trivially + equality comparable types, which can lead up to 40x performance improvements. - ``std::string_view`` now provides iterators that check for out-of-bounds accesses when the safe libc++ mode is enabled. @@ -85,6 +106,9 @@ Users can control whether the debug mode is enabled on a per translation unit basis using the ``-D_LIBCPP_ENABLE_DEBUG_MODE=1`` macro. See ``libcxx/docs/HardenedMode.rst`` for more details. +- ASAN annotations to detect container overflow have been added to the + containers ``std::deque``, and ``std::vector``. + Deprecations and Removals ------------------------- @@ -109,12 +133,12 @@ - C++23: ``atomic``, ``bit``, ``cstdint``, ``cstdlib``, ``cstring``, ``initializer_list``, ``limits``, ``new``, ``stdexcept``, ``system_error``, ``type_traits``, ``typeinfo`` -- ```` no longer includes ```` in any C++ version (it was previously included in C++17 and earlier). + - ```` no longer includes ```` in any C++ version (it was previously included in C++17 and earlier). -- ```` no longer includes ```` in any C++ version (it was previously included in C++20 and earlier). + - ```` no longer includes ```` in any C++ version (it was previously included in C++20 and earlier). -- ````, ````, and ```` no longer include ```` - in any C++ version (it was previously included in C++20 and earlier). + - ````, ````, and ```` no longer include ```` + in any C++ version (it was previously included in C++20 and earlier). - ````, ````, ````, ````, ```` and ```` no longer include ```` (it was previously included in all Standard versions). @@ -145,6 +169,8 @@ - LWG3631 ``basic_format_arg(T&&) should use remove_cvref_t throughout`` removed support for ``volatile`` qualified formatters. +- The unmaintained Solaris support has been removed. + Upcoming Deprecations and Removals ---------------------------------- @@ -172,6 +198,10 @@ API Changes ----------- +- Added ``__asan_annotate_container_with_allocator``, which is is a + customization point to allow users to disable Address Sanitizer annotations + for containers for specific allocators. See :ref:`turning-off-asan` for more + information. ABI Affecting Changes --------------------- diff --git a/libcxx/docs/Status/PSTL.rst b/libcxx/docs/Status/PSTL.rst --- a/libcxx/docs/Status/PSTL.rst +++ b/libcxx/docs/Status/PSTL.rst @@ -1,4 +1,4 @@ -.. pstl-status: +.. _pstl-status: ========================== libc++ Parallel STL Status diff --git a/libcxx/docs/UsingLibcxx.rst b/libcxx/docs/UsingLibcxx.rst --- a/libcxx/docs/UsingLibcxx.rst +++ b/libcxx/docs/UsingLibcxx.rst @@ -525,6 +525,8 @@ In C++26 formatting pointers gained a type ``P`` and allows to use zero-padding. These options have been retroactively applied to C++20. +.. _turning-off-asan: + Turning off ASan annotation in containers -----------------------------------------