1
0
mirror of https://github.com/RPCS3/llvm-mirror.git synced 2024-11-22 18:54:02 +01:00
llvm-mirror/cmake/modules
Tom Stellard 00be3f56b9 [clang][cmake] Include generated rst files in html built by docs-clang-html target
Summary:
This is an attempt to simply the process of building the clang
documentation, which should help avoid some of the recent issues we've
had generating the documentation for the website.

The html documentation for clang is generated by sphinx from the
reStructuredText (rst) files we have in the clang/docs directory.
There are also some rst files that need to be generated by TableGen,
before they can be passed to sphinx.  Prior to this patch we were not
generating those rst files as part with the build system and they had to be
generated manually.

This patch enables the automatic generation of these rst files, but
since they are generated at build time the cannot be placed in the
clang/docs directory and must go into the cmake build directory.

Unfortunately sphinx does not currently support multiple source
directories[1], so in order to be able to generate the full
documentation, we need to work around this by copying the
rst files from the clang/docs into the  build directory before
generating the html documentation.

[1] https://github.com/sphinx-doc/sphinx/issues/3132

Reviewers: rsmith, aaron.ballman, beanz, smeenai, phosek, compnerd, mgorny, delcypher

Reviewed By: mgorny, delcypher

Subscribers: delcypher, merge_guards_bot, mgorny, llvm-commits, cfe-commits

Tags: #clang, #llvm

Differential Revision: https://reviews.llvm.org/D72875
2020-03-05 21:30:37 -08:00
..
AddLLVM.cmake [CMake] Use PUBLIC link mode for static libraries 2020-02-29 11:05:59 -08:00
AddLLVMDefinitions.cmake
AddOCaml.cmake [llvm] [ocaml] Support linking against dylib 2019-10-11 14:32:43 +00:00
AddSphinxTarget.cmake [clang][cmake] Include generated rst files in html built by docs-clang-html target 2020-03-05 21:30:37 -08:00
CheckAtomic.cmake [CMake] CheckAtomic.cmake: catch false positives in RISC-V 2020-02-17 18:53:41 +00:00
CheckCompilerVersion.cmake MSVC Buggy version detection: turn pre-processor error into CMake configuration time check 2020-01-31 00:11:55 +00:00
CheckLinkerFlag.cmake
ChooseMSVCCRT.cmake
CMakeLists.txt Fix compiler extension in standalone mode 2020-02-20 07:19:04 +01:00
CrossCompile.cmake [cmake] Pass external project source directories to sub-configures 2019-10-17 19:24:58 +00:00
DetermineGCCCompatible.cmake
FindLibpfm.cmake
FindOCaml.cmake
FindSphinx.cmake
FindZ3.cmake
GenerateVersionFromVCS.cmake
GetHostTriple.cmake [AIX] Improve 32/64-bit build configuration 2020-02-20 15:41:00 -05:00
HandleLLVMOptions.cmake Build fix: Turn off _GLIBCXX_DEBUG based on a compile check 2020-03-02 16:16:26 +01:00
HandleLLVMStdlib.cmake
LLVM-Config.cmake Remove AllTargetsAsmPrinters 2020-01-17 19:04:06 -05:00
LLVMConfig.cmake.in Make LLVM_APPEND_VC_REV=OFF affect clang, lld, and lldb as well. 2020-01-16 19:04:08 -05:00
LLVMConfigVersion.cmake.in
LLVMDistributionSupport.cmake
LLVMExternalProjectUtils.cmake [CMake] Use LLVM tools external project build where possible 2020-02-07 13:43:30 -08:00
LLVMInstallSymlink.cmake
LLVMProcessSources.cmake
TableGen.cmake [tablegen] Emit string literals instead of char arrays 2020-01-27 18:22:25 +00:00
UseLibtool.cmake
VersionFromVCS.cmake [cmake] Remove SVN support from VersionFromVCS.cmake 2019-11-08 09:59:42 -08:00