ROCTx Documentation (#29)

* Add roctx doc

* Add roctx doxyfile input

* Update links and toc

* Build doxysphinx for both doxygen files

* Update scripts

* Generate roctx doxygen files

* Change doxygen path

to allow for 2 doxyfiles

* Make doxygen dir for script

* Call make _doxygen dir with p flag

* Create _doxygen dir in workfllow

* Create doc dirs for doxygen

* Run update docs as sudo

* Fix typo in mkdir command

* Include graphviz for dot

* Install dot for docs CI

* Install dot as sudo due to permission denied

* Install doxygen via sudo

* Install doxysphinx

* Add postcheckout step to RTD to config and gen doxygen docs

* On RTD, update doxygen after creating env

* update docs.yml

* update docs.yml

* fixing build-docs-from-source

* Fixing build docs from source

* update docs.yml

* trying to fix readthedocs

* trying to fix readthedocs

* update docs.yml

* improve mainpage documentation

* update docs

* clang-format fix

---------

Co-authored-by: Sam Wu <22262939+samjwu@users.noreply.github.com>
Co-authored-by: Madsen, Jonathan <Jonathan.Madsen@amd.com>

[ROCm/rocprofiler-sdk commit: 73e7f8cfb1]

projects/rocprofiler-sdk/source/scripts/update-docs.sh

@@ -24,11 +24,13 @@ message "Generating rocprofiler-sdk.dox"
 cmake -DSOURCE_DIR=${SOURCE_DIR} -DPROJECT_NAME="Rocprofiler SDK" -P ${WORK_DIR}/generate-doxyfile.cmake
 
 message "Generating doxygen xml files"
+mkdir -p _doxygen
 doxygen rocprofiler-sdk.dox
-doxygen rocprofiler-sdk.dox
+doxygen rocprofiler-sdk-roctx.dox
 
 message "Running doxysphinx"
-doxysphinx build ${WORK_DIR} ${WORK_DIR}/_build/html ${WORK_DIR}/_doxygen/html
+doxysphinx build ${WORK_DIR} ${WORK_DIR}/_build/html ${WORK_DIR}/_doxygen/rocprofiler-sdk/html
+doxysphinx build ${WORK_DIR} ${WORK_DIR}/_build/html ${WORK_DIR}/_doxygen/roctx/html
 
 message "Building html documentation"
 make html SPHINXOPTS="--keep-going -n"

projects/rocprofiler-sdk/source/scripts/update-doxygen.sh

@@ -10,7 +10,11 @@ popd
 pushd ${WORK_DIR}
 cmake -DSOURCE_DIR=${SOURCE_DIR} -P generate-doxyfile.cmake
 
-doxygen rocprofiler-sdk.dox
 
-doxysphinx build ${WORK_DIR} ${WORK_DIR}/_build/html ${WORK_DIR}/_doxygen/html
+mkdir -p _doxygen
+doxygen rocprofiler-sdk.dox
+doxygen rocprofiler-sdk-roctx.dox
+
+doxysphinx build ${WORK_DIR} ${WORK_DIR}/_build/html ${WORK_DIR}/_doxygen/rocprofiler-sdk/html
+doxysphinx build ${WORK_DIR} ${WORK_DIR}/_build/html ${WORK_DIR}/_doxygen/roctx/html
 popd