From: Louis Dionne <ldionne@apple.com>
Date: Thu, 5 Nov 2020 19:34:29 +0000 (-0500)
Subject: [libc++] Add a CI job to build the documentation
X-Git-Tag: llvmorg-13-init~6934
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=f7e4f041d65280258027ab8e2b55f497b5d1d56e;p=platform%2Fupstream%2Fllvm.git

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

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

diff --git a/libcxx/docs/index.rst b/libcxx/docs/index.rst
index 75d5b82..f1c0906 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 05d6703..faa1081 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 1f0b3c7..5502cde 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++