[SYCL] Enable doc generation via GitHub Pages

.github/workflows/gh_pages.yml

@@ -0,0 +1,43 @@
+name: Generate Doxygen documentation
+
+on:
+  schedule:
+  - cron: 0 1 * * *
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+      with:
+        ref: sycl
+        path: repo
+    - uses: actions/checkout@v2
+      with:
+        repository: intel/llvm-docs
+        path: docs
+    - name: Install deps
+      run: sudo apt-get install -y doxygen graphviz ssh
+    - name: Build Docs
+      run: |
+        mkdir -p $GITHUB_WORKSPACE/build
+        cd $GITHUB_WORKSPACE/build
+        python $GITHUB_WORKSPACE/repo/buildbot/configure.py -w $GITHUB_WORKSPACE \
+        -s $GITHUB_WORKSPACE/repo -o $GITHUB_WORKSPACE/build -t Release --docs
+        cmake --build . --target doxygen-sycl
+    - name: Deploy
+      env:
+        SSH_KEY: ${{secrets.ACTIONS_DEPLOY_KEY}}
+      run: |
+        mkdir -p ~/.ssh
+        echo "$SSH_KEY" > ~/.ssh/id_rsa
+        chmod 600 ~/.ssh/id_rsa
+        eval "$(ssh-agent -s)"
+        ssh-add -k ~/.ssh/id_rsa
+        cd $GITHUB_WORKSPACE/docs
+        yes | \cp -rf $GITHUB_WORKSPACE/build/tools/sycl/doc/doxygen/html/* .
+        git config --global user.name "iclsrc"
+        git config --global user.email "[email protected]"
+        git add .
+        git diff-index --quiet HEAD || git commit -m "Update docs" -s
+        git push

buildbot/configure.py

@@ -17,6 +17,7 @@ def do_configure(args):
     libclc_targets_to_build = ''
     sycl_build_pi_cuda = 'OFF'
     llvm_enable_assertions = 'ON'
+    llvm_enable_doxygen = 'OFF'
 
     if platform.system() == 'Linux':
         icd_loader_lib = os.path.join(icd_loader_lib, "libOpenCL.so")
@@ -32,6 +33,9 @@ def do_configure(args):
     if args.assertions:
         llvm_enable_assertions = 'ON'
 
+    if args.docs:
+        llvm_enable_doxygen = 'ON'
+
     install_dir = os.path.join(args.obj_dir, "install")
 
     cmake_cmd = [
@@ -52,6 +56,7 @@ def do_configure(args):
         "-DSYCL_ENABLE_WERROR=ON",
         "-DCMAKE_INSTALL_PREFIX={}".format(install_dir),
         "-DSYCL_INCLUDE_TESTS=ON", # Explicitly include all kinds of SYCL tests.
+        "-DLLVM_ENABLE_DOXYGEN={}".format(llvm_enable_doxygen),
         llvm_dir
     ]
 
@@ -84,6 +89,7 @@ def main():
                         metavar="BUILD_TYPE", required=True, help="build type, debug or release")
     parser.add_argument("--cuda", action='store_true', help="switch from OpenCL to CUDA")
     parser.add_argument("--assertions", action='store_true', help="build with assertions")
+    parser.add_argument("--docs", action='store_true', help="build Doxygen documentation")
 
     args = parser.parse_args()