Support documentation build + install + packaging (#369)

* Support documentation build + install + packaging

* Fix NUM_ROCPROFILER_PACKAGING_COMPONENTS check

cmake/rocprofiler_config_packaging.cmake

@@ -37,11 +37,12 @@ list(REMOVE_ITEM ROCPROFILER_PACKAGING_COMPONENTS "Development" "Unspecified")
 list(LENGTH ROCPROFILER_PACKAGING_COMPONENTS NUM_ROCPROFILER_PACKAGING_COMPONENTS)
 
 # the packages we will generate
-set(ROCPROFILER_COMPONENT_GROUPS "core" "tests")
+set(ROCPROFILER_COMPONENT_GROUPS "core" "tests" "docs")
 
 set(COMPONENT_GROUP_core_COMPONENTS "core" "development" "samples" "tools" "Development"
                                     "Unspecified")
 set(COMPONENT_GROUP_tests_COMPONENTS "tests")
+set(COMPONENT_GROUP_docs_COMPONENTS "docs")
 
 # variables for each component group. Note: eventually we will probably want to separate
 # the core to just be the runtime libraries, development to be the headers and cmake
@@ -52,26 +53,35 @@ set(COMPONENT_NAME_development "dev")
 set(COMPONENT_NAME_samples "samples")
 set(COMPONENT_NAME_tools "tools")
 set(COMPONENT_NAME_tests "tests")
+set(COMPONENT_NAME_docs "docs")
 
 set(COMPONENT_SEP_core "")
 set(COMPONENT_SEP_development "-")
 set(COMPONENT_SEP_samples "-")
 set(COMPONENT_SEP_tools "-")
 set(COMPONENT_SEP_tests "-")
+set(COMPONENT_SEP_docs "-")
 
 set(COMPONENT_DEP_core "")
 set(COMPONENT_DEP_development "rocprofiler-sdk")
 set(COMPONENT_DEP_samples "rocprofiler-sdk")
 set(COMPONENT_DEP_tools "rocprofiler-sdk")
 set(COMPONENT_DEP_tests "rocprofiler-sdk")
+set(COMPONENT_DEP_docs "")
 
 set(COMPONENT_DESC_core "rocprofiler-sdk libraries, headers, samples, and tools")
 set(COMPONENT_DESC_development "rocprofiler-sdk development files")
 set(COMPONENT_DESC_samples "rocprofiler-sdk samples")
 set(COMPONENT_DESC_tools "rocprofiler-sdk tools")
 set(COMPONENT_DESC_tests "rocprofiler-sdk tests")
+set(COMPONENT_DESC_docs "rocprofiler-sdk documentation")
 
-if(NOT NUM_ROCPROFILER_PACKAGING_COMPONENTS EQUAL 5)
+set(EXPECTED_PACKAGING_COMPONENTS 5)
+if(ROCPROFILER_BUILD_DOCS)
+    set(EXPECTED_PACKAGING_COMPONENTS 6)
+endif()
+
+if(NOT NUM_ROCPROFILER_PACKAGING_COMPONENTS EQUAL EXPECTED_PACKAGING_COMPONENTS)
     message(
         FATAL_ERROR
             "Error new install component needs COMPONENT_NAME_* and COMPONENT_SEP_* entries"

cmake/rocprofiler_options.cmake

@@ -40,12 +40,8 @@ rocprofiler_add_option(ROCPROFILER_BUILD_SAMPLES "Enable building the code sampl
                        ${ROCPROFILER_BUILD_CI})
 rocprofiler_add_option(ROCPROFILER_BUILD_CODECOV
                        "Enable building for code coverage analysis" OFF)
-
-# CLI and FILE plugins are always built
-foreach(_PLUGIN "ATT" "CTF" "PERFETTO")
-    rocprofiler_add_option(ROCPROFILER_BUILD_PLUGIN_${_PLUGIN}
-                           "Enable building the ${_PLUGIN} plugin" ON)
-endforeach()
+rocprofiler_add_option(ROCPROFILER_BUILD_DOCS
+                       "Enable build + install + packaging documentation" OFF)
 
 rocprofiler_add_option(
     ROCPROFILER_BUILD_GHC_FS

source/CMakeLists.txt

@@ -8,3 +8,4 @@ endif()
 add_subdirectory(include)
 add_subdirectory(lib)
 add_subdirectory(bin)
+add_subdirectory(docs)

source/docs/.gitignore

@@ -2,4 +2,4 @@
 /_build
 /_doxygen
 /.gitinfo
-/rocprofiler.dox
+/*.dox

source/docs/CMakeLists.txt

@@ -0,0 +1,71 @@
+#
+#
+
+if(NOT ROCPROFILER_BUILD_DOCS)
+    return()
+endif()
+
+set(PACKAGE_NAME ${PROJECT_NAME}-sdk)
+
+include(FetchContent)
+
+if(CMAKE_VERSION VERSION_GREATER_EQUAL 3.24)
+    cmake_policy(SET CMP0135 NEW)
+endif()
+
+if(NOT EXISTS ${PROJECT_BINARY_DIR}/external/miniconda.sh)
+    file(DOWNLOAD https://repo.continuum.io/miniconda/Miniconda3-latest-Linux-x86_64.sh
+         ${PROJECT_BINARY_DIR}/external/miniconda.sh)
+endif()
+
+function(DOCS_EXECUTE_PROCESS)
+    string(REPLACE ";" " " _MSG "${ARGN}")
+    message(STATUS "[rocprofiler][docs] Executing: ${_MSG}")
+
+    execute_process(
+        COMMAND ${ARGN}
+        RESULT_VARIABLE _RET
+        OUTPUT_VARIABLE _OUT
+        ERROR_VARIABLE _ERR
+        WORKING_DIRECTORY ${PROJECT_BINARY_DIR}/external COMMAND_ERROR_IS_FATAL ANY)
+
+    if(NOT _RET EQUAL 0)
+        message(STATUS "docs command failed: ${_RET}")
+        message(STATUS "stderr:\n${_ERR}")
+        message(STATUS "stdout:\n${_OUT}")
+    endif()
+endfunction()
+
+if(NOT EXISTS ${PROJECT_BINARY_DIR}/external/miniconda)
+    docs_execute_process(/bin/bash ${PROJECT_BINARY_DIR}/external/miniconda.sh -b -p
+                         ${PROJECT_BINARY_DIR}/external/miniconda)
+    docs_execute_process(${PROJECT_BINARY_DIR}/external/miniconda/bin/conda config --set
+                         always_yes yes)
+    docs_execute_process(${PROJECT_BINARY_DIR}/external/miniconda/bin/conda update -c
+                         defaults -n base conda)
+endif()
+
+if(NOT EXISTS ${PROJECT_BINARY_DIR}/external/miniconda/envs/rocprofiler-docs)
+    docs_execute_process(${PROJECT_BINARY_DIR}/external/miniconda/bin/conda env create -n
+                         rocprofiler-docs -f ${CMAKE_CURRENT_LIST_DIR}/environment.yml)
+endif()
+
+file(
+    WRITE "${CMAKE_CURRENT_BINARY_DIR}/build-docs.sh"
+    "#!/bin/bash -e
+
+export PATH=${PROJECT_BINARY_DIR}/external/miniconda/bin:\${PATH}
+source activate
+conda activate rocprofiler-docs
+${PROJECT_SOURCE_DIR}/source/scripts/update-docs.sh 1> /dev/null
+rm -r ${PROJECT_SOURCE_DIR}/build-docs
+")
+
+add_custom_target(docs ALL /bin/bash ${CMAKE_CURRENT_BINARY_DIR}/build-docs.sh)
+
+install(
+    DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/_build/html/
+    DESTINATION ${CMAKE_INSTALL_DATAROOTDIR}/html/${PACKAGE_NAME}
+    COMPONENT docs
+    USE_SOURCE_PERMISSIONS FILES_MATCHING
+    PATTERN "*")

source/docs/rocprofiler-sdk.dox

@@ -1,402 +0,0 @@
-# Doxyfile 1.9.8
-
-#---------------------------------------------------------------------------
-# Project related configuration options
-#---------------------------------------------------------------------------
-DOXYFILE_ENCODING      = UTF-8
-PROJECT_NAME           = 
-PROJECT_NUMBER         = 0.0.0
-PROJECT_BRIEF          = "ROCm Profiling API and tools"
-PROJECT_LOGO           =
-OUTPUT_DIRECTORY       = _doxygen
-CREATE_SUBDIRS         = NO
-CREATE_SUBDIRS_LEVEL   = 8
-ALLOW_UNICODE_NAMES    = YES
-OUTPUT_LANGUAGE        = English
-BRIEF_MEMBER_DESC      = YES
-REPEAT_BRIEF           = YES
-ABBREVIATE_BRIEF       =
-ALWAYS_DETAILED_SEC    = YES
-INLINE_INHERITED_MEMB  = YES
-FULL_PATH_NAMES        = YES
-STRIP_FROM_PATH        = /home/jrmadsen/devel/c++/ROCm-Developer-Tools/rocprofiler-v2-internal/source/include \
-                         /home/jrmadsen/devel/c++/ROCm-Developer-Tools/rocprofiler-v2-internal/build-docs/source/include
-STRIP_FROM_INC_PATH    = /home/jrmadsen/devel/c++/ROCm-Developer-Tools/rocprofiler-v2-internal/source/include \
-                         /home/jrmadsen/devel/c++/ROCm-Developer-Tools/rocprofiler-v2-internal/build-docs/source/include
-SHORT_NAMES            = NO
-JAVADOC_AUTOBRIEF      = NO
-JAVADOC_BANNER         = NO
-QT_AUTOBRIEF           = NO
-MULTILINE_CPP_IS_BRIEF = YES
-PYTHON_DOCSTRING       = YES
-INHERIT_DOCS           = YES
-SEPARATE_MEMBER_PAGES  = NO
-TAB_SIZE               = 4
-ALIASES                =
-OPTIMIZE_OUTPUT_FOR_C  = YES
-OPTIMIZE_OUTPUT_JAVA   = NO
-OPTIMIZE_FOR_FORTRAN   = NO
-OPTIMIZE_OUTPUT_VHDL   = NO
-OPTIMIZE_OUTPUT_SLICE  = NO
-EXTENSION_MAPPING      = hpp=C++ \
-                         cpp=C++ \
-                         hh=C++ \
-                         cc=C++ \
-                         h=C \
-                         c=C \
-                         py=Python
-MARKDOWN_SUPPORT       = YES
-TOC_INCLUDE_HEADINGS   = 2
-MARKDOWN_ID_STYLE      = DOXYGEN
-AUTOLINK_SUPPORT       = YES
-BUILTIN_STL_SUPPORT    = YES
-CPP_CLI_SUPPORT        = NO
-SIP_SUPPORT            = NO
-IDL_PROPERTY_SUPPORT   = YES
-DISTRIBUTE_GROUP_DOC   = NO
-GROUP_NESTED_COMPOUNDS = YES
-SUBGROUPING            = YES
-INLINE_GROUPED_CLASSES = NO
-INLINE_SIMPLE_STRUCTS  = YES
-TYPEDEF_HIDES_STRUCT   = YES
-LOOKUP_CACHE_SIZE      = 5
-NUM_PROC_THREADS       = 0
-TIMESTAMP              = NO
-#---------------------------------------------------------------------------
-# Build related configuration options
-#---------------------------------------------------------------------------
-EXTRACT_ALL            = YES
-EXTRACT_PRIVATE        = NO
-EXTRACT_PRIV_VIRTUAL   = NO
-EXTRACT_PACKAGE        = NO
-EXTRACT_STATIC         = NO
-EXTRACT_LOCAL_CLASSES  = YES
-EXTRACT_LOCAL_METHODS  = NO
-EXTRACT_ANON_NSPACES   = NO
-RESOLVE_UNNAMED_PARAMS = YES
-HIDE_UNDOC_MEMBERS     = NO
-HIDE_UNDOC_CLASSES     = YES
-HIDE_FRIEND_COMPOUNDS  = NO
-HIDE_IN_BODY_DOCS      = NO
-INTERNAL_DOCS          = NO
-CASE_SENSE_NAMES       = NO
-HIDE_SCOPE_NAMES       = NO
-HIDE_COMPOUND_REFERENCE= NO
-SHOW_HEADERFILE        = YES
-SHOW_INCLUDE_FILES     = YES
-SHOW_GROUPED_MEMB_INC  = NO
-FORCE_LOCAL_INCLUDES   = YES
-INLINE_INFO            = YES
-SORT_MEMBER_DOCS       = YES
-SORT_BRIEF_DOCS        = NO
-SORT_MEMBERS_CTORS_1ST = YES
-SORT_GROUP_NAMES       = NO
-SORT_BY_SCOPE_NAME     = NO
-STRICT_PROTO_MATCHING  = NO
-GENERATE_TODOLIST      = NO
-GENERATE_TESTLIST      = NO
-GENERATE_BUGLIST       = NO
-GENERATE_DEPRECATEDLIST= NO
-ENABLED_SECTIONS       =
-MAX_INITIALIZER_LINES  = 30
-SHOW_USED_FILES        = YES
-SHOW_FILES             = YES
-SHOW_NAMESPACES        = YES
-FILE_VERSION_FILTER    =
-LAYOUT_FILE            =
-CITE_BIB_FILES         =
-#---------------------------------------------------------------------------
-# Configuration options related to warning and progress messages
-#---------------------------------------------------------------------------
-QUIET                  = NO
-WARNINGS               = YES
-WARN_IF_UNDOCUMENTED   = YES
-WARN_IF_DOC_ERROR      = YES
-WARN_IF_INCOMPLETE_DOC = YES
-WARN_NO_PARAMDOC       = YES
-WARN_IF_UNDOC_ENUM_VAL = NO
-WARN_AS_ERROR          = YES
-WARN_FORMAT            = "---> WARNING! $file:$line: $text"
-WARN_LINE_FORMAT       = "at line $line of file $file"
-WARN_LOGFILE           =
-#---------------------------------------------------------------------------
-# Configuration options related to the input files
-#---------------------------------------------------------------------------
-INPUT                  = /home/jrmadsen/devel/c++/ROCm-Developer-Tools/rocprofiler-v2-internal/README.md \
-                         /home/jrmadsen/devel/c++/ROCm-Developer-Tools/rocprofiler-v2-internal/source/include/rocprofiler-sdk \
-                         /home/jrmadsen/devel/c++/ROCm-Developer-Tools/rocprofiler-v2-internal/build-docs/source/include/rocprofiler-sdk/version.h
-INPUT_ENCODING         = UTF-8
-INPUT_FILE_ENCODING    =
-FILE_PATTERNS          = *.h \
-                         *.hh \
-                         *.hpp \
-                         *.c \
-                         *.cc \
-                         *.cxx \
-                         *.cpp \
-                         *.c++ \
-                         *.icc \
-                         *.tcc \
-                         conf.py
-RECURSIVE              = YES
-EXCLUDE                =
-EXCLUDE_SYMLINKS       = YES
-EXCLUDE_PATTERNS       = */.git/* \
-                         /home/jrmadsen/devel/c++/ROCm-Developer-Tools/rocprofiler-v2-internal/**/tests/* \
-                         /home/jrmadsen/devel/c++/ROCm-Developer-Tools/rocprofiler-v2-internal/**/scripts/* \
-                         /home/jrmadsen/devel/c++/ROCm-Developer-Tools/rocprofiler-v2-internal/**/docs/*
-EXCLUDE_SYMBOLS        = "std::*" \
-                         "ROCPROFILER_ATTRIBUTE" \
-                         "ROCPROFILER_API" \
-                         "ROCPROFILER_NONNULL" \
-                         "ROCPROFILER_PUBLIC_API" \
-                         "ROCPROFILER_HIDDEN_API" \
-                         "ROCPROFILER_EXPORT_DECORATOR" \
-                         "ROCPROFILER_IMPORT_DECORATOR" \
-                         "ROCPROFILER_EXPORT" \
-                         "ROCPROFILER_IMPORT" \
-                         "ROCPROFILER_HANDLE_LITERAL" \
-                         "ROCPROFILER_EXTERN_C_INIT" \
-                         "ROCPROFILER_EXTERN_C_FINI"
-EXAMPLE_PATH           = /home/jrmadsen/devel/c++/ROCm-Developer-Tools/rocprofiler-v2-internal/samples
-EXAMPLE_PATTERNS       = *.h \
-                         *.hh \
-                         *.hpp \
-                         *.c \
-                         *.cc \
-                         *.cpp \
-                         *.txt
-EXAMPLE_RECURSIVE      = YES
-IMAGE_PATH             =
-INPUT_FILTER           =
-FILTER_PATTERNS        =
-FILTER_SOURCE_FILES    = NO
-FILTER_SOURCE_PATTERNS =
-USE_MDFILE_AS_MAINPAGE = /home/jrmadsen/devel/c++/ROCm-Developer-Tools/rocprofiler-v2-internal/README.md
-FORTRAN_COMMENT_AFTER  = 72
-#---------------------------------------------------------------------------
-# Configuration options related to source browsing
-#---------------------------------------------------------------------------
-SOURCE_BROWSER         = YES
-INLINE_SOURCES         = YES
-STRIP_CODE_COMMENTS    = NO
-REFERENCED_BY_RELATION = YES
-REFERENCES_RELATION    = YES
-REFERENCES_LINK_SOURCE = YES
-SOURCE_TOOLTIPS        = YES
-USE_HTAGS              = NO
-VERBATIM_HEADERS       = YES
-#---------------------------------------------------------------------------
-# Configuration options related to the alphabetical class index
-#---------------------------------------------------------------------------
-ALPHABETICAL_INDEX     = YES
-IGNORE_PREFIX          =
-#---------------------------------------------------------------------------
-# Configuration options related to the HTML output
-#---------------------------------------------------------------------------
-GENERATE_HTML          = YES
-HTML_OUTPUT            = html
-HTML_FILE_EXTENSION    = .html
-HTML_HEADER            =
-HTML_FOOTER            =
-HTML_STYLESHEET        =
-HTML_EXTRA_STYLESHEET  = ../../external/doxygen-awesome-css/doxygen-awesome.css
-HTML_EXTRA_FILES       =
-HTML_COLORSTYLE        = LIGHT
-HTML_COLORSTYLE_HUE    = 220
-HTML_COLORSTYLE_SAT    = 100
-HTML_COLORSTYLE_GAMMA  = 80
-HTML_DYNAMIC_MENUS     = YES
-HTML_DYNAMIC_SECTIONS  = YES
-HTML_CODE_FOLDING      = YES
-HTML_INDEX_NUM_ENTRIES = 1000
-GENERATE_DOCSET        = NO
-DOCSET_FEEDNAME        = "Doxygen generated docs"
-DOCSET_FEEDURL         =
-DOCSET_BUNDLE_ID       = org.doxygen.rocprofiler
-DOCSET_PUBLISHER_ID    = org.doxygen.amd
-DOCSET_PUBLISHER_NAME  = "Advanced Micro Devices, Inc."
-GENERATE_HTMLHELP      = NO
-CHM_FILE               =
-HHC_LOCATION           =
-GENERATE_CHI           = NO
-CHM_INDEX_ENCODING     =
-BINARY_TOC             = NO
-TOC_EXPAND             = YES
-SITEMAP_URL            =
-GENERATE_QHP           = NO
-QCH_FILE               =
-QHP_NAMESPACE          =
-QHP_VIRTUAL_FOLDER     = doxy
-QHP_CUST_FILTER_NAME   =
-QHP_CUST_FILTER_ATTRS  =
-QHP_SECT_FILTER_ATTRS  =
-QHG_LOCATION           =
-GENERATE_ECLIPSEHELP   = NO
-ECLIPSE_DOC_ID         = org.doxygen.rocprofiler
-DISABLE_INDEX          = NO
-GENERATE_TREEVIEW      = YES
-FULL_SIDEBAR           = NO
-ENUM_VALUES_PER_LINE   = 1
-TREEVIEW_WIDTH         = 300
-EXT_LINKS_IN_WINDOW    = YES
-OBFUSCATE_EMAILS       = YES
-HTML_FORMULA_FORMAT    = png
-FORMULA_FONTSIZE       = 12
-FORMULA_MACROFILE      =
-USE_MATHJAX            = NO
-MATHJAX_VERSION        = MathJax_2
-MATHJAX_FORMAT         = HTML-CSS
-MATHJAX_RELPATH        = http://cdn.mathjax.org/mathjax/latest
-MATHJAX_EXTENSIONS     =
-MATHJAX_CODEFILE       =
-SEARCHENGINE           = NO
-SERVER_BASED_SEARCH    = NO
-EXTERNAL_SEARCH        = NO
-SEARCHENGINE_URL       =
-SEARCHDATA_FILE        = searchdata.xml
-EXTERNAL_SEARCH_ID     =
-EXTRA_SEARCH_MAPPINGS  =
-#---------------------------------------------------------------------------
-# Configuration options related to the LaTeX output
-#---------------------------------------------------------------------------
-GENERATE_LATEX         = NO
-LATEX_OUTPUT           = latex
-LATEX_CMD_NAME         = latex
-MAKEINDEX_CMD_NAME     = makeindex
-LATEX_MAKEINDEX_CMD    = makeindex
-COMPACT_LATEX          = NO
-PAPER_TYPE             =
-EXTRA_PACKAGES         = float
-LATEX_HEADER           =
-LATEX_FOOTER           =
-LATEX_EXTRA_STYLESHEET =
-LATEX_EXTRA_FILES      =
-PDF_HYPERLINKS         = YES
-USE_PDFLATEX           = YES
-LATEX_BATCHMODE        = YES
-LATEX_HIDE_INDICES     = NO
-LATEX_BIB_STYLE        = plain
-LATEX_EMOJI_DIRECTORY  =
-#---------------------------------------------------------------------------
-# Configuration options related to the RTF output
-#---------------------------------------------------------------------------
-GENERATE_RTF           = NO
-RTF_OUTPUT             = rtf
-COMPACT_RTF            = NO
-RTF_HYPERLINKS         = NO
-RTF_STYLESHEET_FILE    =
-RTF_EXTENSIONS_FILE    =
-#---------------------------------------------------------------------------
-# Configuration options related to the man page output
-#---------------------------------------------------------------------------
-GENERATE_MAN           = NO
-MAN_OUTPUT             = man
-MAN_EXTENSION          = .3
-MAN_SUBDIR             =
-MAN_LINKS              = YES
-#---------------------------------------------------------------------------
-# Configuration options related to the XML output
-#---------------------------------------------------------------------------
-GENERATE_XML           = NO
-XML_OUTPUT             = xml
-XML_PROGRAMLISTING     = YES
-XML_NS_MEMB_FILE_SCOPE = YES
-#---------------------------------------------------------------------------
-# Configuration options related to the DOCBOOK output
-#---------------------------------------------------------------------------
-GENERATE_DOCBOOK       = NO
-DOCBOOK_OUTPUT         = docbook
-#---------------------------------------------------------------------------
-# Configuration options for the AutoGen Definitions output
-#---------------------------------------------------------------------------
-GENERATE_AUTOGEN_DEF   = NO
-#---------------------------------------------------------------------------
-# Configuration options related to Sqlite3 output
-#---------------------------------------------------------------------------
-GENERATE_SQLITE3       = NO
-SQLITE3_OUTPUT         = sqlite3
-SQLITE3_RECREATE_DB    = YES
-#---------------------------------------------------------------------------
-# Configuration options related to the Perl module output
-#---------------------------------------------------------------------------
-GENERATE_PERLMOD       = NO
-PERLMOD_LATEX          = NO
-PERLMOD_PRETTY         = YES
-PERLMOD_MAKEVAR_PREFIX =
-#---------------------------------------------------------------------------
-# Configuration options related to the preprocessor
-#---------------------------------------------------------------------------
-ENABLE_PREPROCESSING   = YES
-MACRO_EXPANSION        = YES
-EXPAND_ONLY_PREDEF     = NO
-SEARCH_INCLUDES        = NO
-INCLUDE_PATH           = /home/jrmadsen/devel/c++/ROCm-Developer-Tools/rocprofiler-v2-internal/source/include
-INCLUDE_FILE_PATTERNS  = *.h
-PREDEFINED             = "ROCPROFILER_API=" \
-                         "ROCPROFILER_EXPORT=" \
-                         "ROCPROFILER_IMPORT=" \
-                         "ROCPROFILER_NONNULL(...)=" \
-                         "ROCPROFILER_PUBLIC_API=" \
-                         "ROCPROFILER_HIDDEN_API=" \
-                         "ROCPROFILER_EXPORT_DECORATOR=" \
-                         "ROCPROFILER_IMPORT_DECORATOR=" \
-                         "ROCPROFILER_HANDLE_LITERAL=" \
-                         "ROCPROFILER_EXTERN_C_INIT=" \
-                         "ROCPROFILER_EXTERN_C_FINI=" \
-                         "__attribute__(x)=" \
-                         "__declspec(x)=" \
-                         "size_t=unsigned long" \
-                         "uintptr_t=unsigned long" \
-                         "DOXYGEN_SHOULD_SKIP_THIS=1"
-EXPAND_AS_DEFINED      =
-SKIP_FUNCTION_MACROS   = NO
-#---------------------------------------------------------------------------
-# Configuration options related to external references
-#---------------------------------------------------------------------------
-TAGFILES               =
-GENERATE_TAGFILE       = _doxygen/tagfile.xml
-ALLEXTERNALS           = NO
-EXTERNAL_GROUPS        = YES
-EXTERNAL_PAGES         = YES
-#---------------------------------------------------------------------------
-# Configuration options related to diagram generator tools
-#---------------------------------------------------------------------------
-HIDE_UNDOC_RELATIONS   = NO
-HAVE_DOT               = YES
-DOT_NUM_THREADS        = 0
-DOT_COMMON_ATTR        = "fontname=Helvetica,fontsize=12"
-DOT_EDGE_ATTR          = "labelfontname=Helvetica,labelfontsize=12"
-DOT_NODE_ATTR          = "shape=box,height=0.2,width=0.4"
-DOT_FONTPATH           =
-CLASS_GRAPH            = YES
-COLLABORATION_GRAPH    = YES
-GROUP_GRAPHS           = YES
-UML_LOOK               = YES
-UML_LIMIT_NUM_FIELDS   = 10
-DOT_UML_DETAILS        = YES
-DOT_WRAP_THRESHOLD     = 17
-TEMPLATE_RELATIONS     = YES
-INCLUDE_GRAPH          = YES
-INCLUDED_BY_GRAPH      = YES
-CALL_GRAPH             = YES
-CALLER_GRAPH           = YES
-GRAPHICAL_HIERARCHY    = YES
-DIRECTORY_GRAPH        = YES
-DIR_GRAPH_MAX_DEPTH    = 1
-DOT_IMAGE_FORMAT       = svg
-INTERACTIVE_SVG        = NO
-DOT_PATH               = /opt/conda/envs/rocprofiler-docs/bin/dot
-DOTFILE_DIRS           =
-DIA_PATH               =
-DIAFILE_DIRS           =
-PLANTUML_JAR_PATH      =
-PLANTUML_CFG_FILE      =
-PLANTUML_INCLUDE_PATH  =
-DOT_GRAPH_MAX_NODES    = 50
-MAX_DOT_GRAPH_DEPTH    = 0
-DOT_MULTI_TARGETS      = YES
-GENERATE_LEGEND        = YES
-DOT_CLEANUP            = YES
-MSCGEN_TOOL            =
-MSCFILE_DIRS           =