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>

source/include/rocprofiler-sdk/rocprofiler.h

@@ -22,6 +22,34 @@
 
 #pragma once
 
+/**
+ *
+ * \file rocprofiler.h
+ * \brief ROCProfiler-SDK API interface.
+ *
+ * \mainpage ROCProfiler-SDK API Specification
+ *
+ * \section introduction Introduction
+ * ROCprofiler-SDK is a library that implements the profiling and performance monitoring
+ * capabilities for AMD's ROCm platform. It provides a comprehensive set of APIs for:
+ *
+ * - Hardware performance counters monitoring
+ * - PC sampling for kernel execution analysis
+ * - Buffer and callback-based tracing mechanisms
+ * - Device and dispatch counting services
+ * - External correlation tracking
+ * - HIP and HSA runtime profiling support
+ *
+ * The library is designed to help developers analyze and optimize the performance
+ * of applications running on AMD GPUs. It offers both low-level hardware access
+ * and high-level profiling abstractions to accommodate different profiling needs.
+ *
+ *
+ * \section compatibility Compatibility
+ * ROCprofiler-SDK is compatible with AMD ROCm platform and supports
+ * profiling of applications using HIP and HSA runtimes.
+ */
+
 #include <stddef.h>
 #include <stdint.h>