update doxygen process (#2110)

.github/scripts/doxygen.sh

@@ -0,0 +1,25 @@
+#! /bin/bash
+
+# Copyright (c) Microsoft. All rights reserved.
+# Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+set -o errexit # Exit if command failed.
+set -o nounset # Exit if variable not set.
+set -o pipefail # Exit if pipe failed.
+
+sudo apt update
+sudo apt install -y git cmake python flex bison
+
+pushd ~
+git clone -b Release_1_9_0 https://github.com/doxygen/doxygen.git
+pushd doxygen
+mkdir build
+pushd build
+cmake -G "Unix Makefiles" ..
+make
+sudo make install
+popd
+popd
+popd
+
+doxygen docs/Doxyfile

.github/workflows/build_docs.yml

@@ -0,0 +1,29 @@
+name: Build and Deploy Docs
+
+on:
+  workflow_dispatch:
+    inputs:
+        commitRef:
+          description: 'Git SHA commit to use to build docs'
+          required: true
+
+jobs:
+  push-docs:
+
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+        with:
+          ref: ${{ github.event.inputs.commitRef }}
+
+      - name: Install and Build Doxygen
+        run: .github/scripts/doxygen.sh
+
+      - name: Deploy
+        uses: JamesIves/github-pages-deploy-action@4.1.3
+        with:
+          branch: gh-pages
+          folder: doc/html
+          clean: true
+          ssh-key: ${{ secrets.DEPLOY_KEY }}

provisioning_client/inc/azure_prov_client/prov_device_ll_client.h

@@ -1,6 +1,11 @@
 // Copyright (c) Microsoft. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
+/** @file prov_device_ll_client.h
+*   @brief Low level provisioning client.
+*
+*/
+
 #ifndef PROV_DEVICE_LL_CLIENT_H
 #define PROV_DEVICE_LL_CLIENT_H