[libcxx-commits] [libcxx] f7e4f04 - [libc++] Add a CI job to build the documentation

[Louis Dionne via libcxx-commits]

Author: Louis Dionne
Date: 2020-11-05T15:33:09-05:00
New Revision: f7e4f041d65280258027ab8e2b55f497b5d1d56e

URL: https://github.com/llvm/llvm-project/commit/f7e4f041d65280258027ab8e2b55f497b5d1d56e
DIFF: https://github.com/llvm/llvm-project/commit/f7e4f041d65280258027ab8e2b55f497b5d1d56e.diff

LOG: [libc++] Add a CI job to build the documentation

At the same time, fix an issue that broke the documentation since 2eadbc86142b.

Added: 
    

Modified: 
    libcxx/docs/index.rst
    libcxx/utils/ci/buildkite-pipeline.yml
    libcxx/utils/ci/run-buildbot.sh

Removed: 
    


################################################################################
diff  --git a/libcxx/docs/index.rst b/libcxx/docs/index.rst
index 75d5b8226b4c..f1c0906f4c4d 100644
--- a/libcxx/docs/index.rst
+++ b/libcxx/docs/index.rst
@@ -154,7 +154,6 @@ Design Documents
 .. toctree::
    :maxdepth: 1
 
-   DesignDocs/AvailabilityMarkup
    DesignDocs/DebugMode
    DesignDocs/CapturingConfigInfo
    DesignDocs/ABIVersioning

diff  --git a/libcxx/utils/ci/buildkite-pipeline.yml b/libcxx/utils/ci/buildkite-pipeline.yml
index 05d670368fe9..faa108156dee 100644
--- a/libcxx/utils/ci/buildkite-pipeline.yml
+++ b/libcxx/utils/ci/buildkite-pipeline.yml
@@ -202,6 +202,17 @@ steps:
         - exit_status: -1  # Agent was lost
           limit: 2
 
+  - label: "Documentation"
+    command: "libcxx/utils/ci/run-buildbot.sh documentation"
+    artifact_paths:
+      - "**/test-results.xml"
+    agents:
+      queue: "libcxx-builders"
+    retry:
+      automatic:
+        - exit_status: -1  # Agent was lost
+          limit: 2
+
   - label: "Legacy standalone build"
     command: "libcxx/utils/ci/run-buildbot.sh legacy-standalone"
     artifact_paths:

diff  --git a/libcxx/utils/ci/run-buildbot.sh b/libcxx/utils/ci/run-buildbot.sh
index 1f0b3c7c71b3..5502cde7c704 100755
--- a/libcxx/utils/ci/run-buildbot.sh
+++ b/libcxx/utils/ci/run-buildbot.sh
@@ -169,6 +169,13 @@ benchmarks)
     generate-cmake
     check-cxx-benchmarks
 ;;
+documentation)
+  export CC=clang
+  export CXX=clang++
+  generate-cmake -DLLVM_ENABLE_SPHINX=ON
+  echo "+++ Generating documentation"
+  ninja -C "${BUILD_DIR}" docs-libcxx-html
+;;
 unified-standalone)
     export CC=clang
     export CXX=clang++