llvm-project/libcxx/docs/DesignDocs
Louis Dionne 2eadbc8614 [libc++] Rework the whole availability markup implementation
Currently, vendor-specific availability markup is enabled by default.
This means that even when building against trunk libc++, the headers
will by default prevent you from using some features that were not
released in the dylib on your target platform. This is a source of
frustration since people building libc++ from sources are usually not
trying to use some vendor's released dylib.

For that reason, I've been thinking for a long time that availability
annotations should be off by default, which is the primary change that
this commit enables.

In addition, it reworks the implementation to make it easier for new
vendors to add availability annotations for their platform, and it
refreshes the documentation to reflect the current state of the codebase.

Finally, a CMake configuration option is added to control whether
availability annotations should be turned on for the flavor of libc++
being created. The intent is for vendors like Apple to turn it on, and
for the upstream libc++ to leave it off (the default).

Differential Revision: https://reviews.llvm.org/D90843
2020-11-05 12:28:52 -05:00
..
ABIVersioning.rst
CapturingConfigInfo.rst Update an example to use the new LLVM file header. 2019-01-19 11:54:04 +00:00
DebugMode.rst update debugging docs to be less out of date 2019-06-08 04:59:41 +00:00
ExperimentalFeatures.rst [libcxx] Slightly improved policy for handling experimental features 2019-06-11 14:48:40 +00:00
ExtendedCXX03Support.rst Add documentation and tests for Clangs C++11 extensions in C++03. 2019-06-11 22:53:49 +00:00
FeatureTestMacros.rst [libc++] Update the <version> header in-place from generate_feature_test_macro_components 2020-10-13 09:18:35 -04:00
FileTimeType.rst Support tests in freestanding 2019-02-04 20:31:13 +00:00
ThreadingSupportAPI.rst
UniquePtrTrivialAbi.rst Reland [libcxx]Put clang::trivial_abi on smart pointers 2020-07-20 11:54:34 -04:00
VisibilityMacros.rst [libc++] Make sure we can build libc++ with -fvisibility=hidden 2018-10-25 12:13:43 +00:00