llvm-project/libcxx/docs
Mark de Wever 0c111dd86f [libc++] Documents details of the pre-commit CI.
This documentation aims to make it cleare how the libc++ pre-commit CI
works. For libc++ developers and other LLVM projects whose changes can
affect libc++.

This was discusses with @aaron.ballman as a follow on some unclearities
for the Clang communitee how the libc++ pre-commit CI works.

Note some parts depend on patches under review as commented in the
documentation.

Reviewed By: ldionne, #libc, philnik

Differential Revision: https://reviews.llvm.org/D133249
2022-11-10 20:20:17 +01:00
..
DesignDocs [libc++] Rewrites graph_header_deps.py. 2022-09-25 15:06:21 +02:00
Helpers [libc++][doc] Use issue labels. 2021-10-15 17:30:33 +02:00
Status [libc++] Implement P2438R2 (std::string::substr() &&) 2022-11-02 20:28:47 +01:00
AddingNewCIJobs.rst [libc++] Add timeout to BuildKite jobs 2021-08-09 15:31:04 -04:00
BuildingLibcxx.rst [SystemZ][z/OS] Add ASCII and 32-bit variants for libc++. 2022-10-03 17:24:02 -05:00
CMakeLists.txt
Contributing.rst [libc++] Documents details of the pre-commit CI. 2022-11-10 20:20:17 +01:00
FeatureTestMacroTable.rst [libc++] Add FTM for constexpr vector 2022-11-09 22:45:20 +01:00
README.txt [libc++] NFC: Add note about how the libcxx website gets updated 2021-07-05 10:25:33 -04:00
ReleaseNotes.rst [libc++] Implement P2438R2 (std::string::substr() &&) 2022-11-02 20:28:47 +01:00
TestingLibcxx.rst [libc++] Add a bunch of missing _LIBCPP_HIDE_FROM_ABI 2022-08-13 22:41:22 +02:00
UsingLibcxx.rst [libc++] Add [[nodiscard]] extensions to ranges algorithms 2022-11-05 16:38:46 +01:00
conf.py Bump the trunk major version to 16 2022-07-26 21:34:45 -07:00
index.rst [libc++] Documents details of the pre-commit CI. 2022-11-10 20:20:17 +01:00

README.txt

libc++ Documentation
====================

The libc++ documentation is written using the Sphinx documentation generator. It is
currently tested with Sphinx 1.1.3.

To build the documents into html configure libc++ with the following cmake options:

  * -DLLVM_ENABLE_SPHINX=ON
  * -DLIBCXX_INCLUDE_DOCS=ON

After configuring libc++ with these options the make rule `docs-libcxx-html`
should be available.

The documentation in this directory is published at https://libcxx.llvm.org. It is kept up-to-date
by a build bot: https://lab.llvm.org/buildbot/#/builders/publish-sphinx-docs. If you notice that the
documentation is not updating anymore, please contact one of the maintainers.