Making ROCTx API doxygen generated document more readable (#385)

* Making ROCTx API doxygen generated document more readable * fixing build * Fix linking errors * Fixing header * Fixing Topics and Types * doxygen configuration fixes * Fixing build * Fix unnecessory doc parsing warnings * formatting and linting fixes * rebasing SDK modular PR * Fixing missing line * Fixing ROCtx documentation after merge * Removing flake changes * changed back WARN_IF_DOC_ERROR to Yes
2025-05-23 04:38:55 +05:30
@@ -0,0 +1,15 @@
+.. meta::
+  :description: The Global Data structures, topics and files reference page.
+
+.. _global_roctx_data_structures_topics_files_reference:
+
+*******************************************************************************
+Global Data structures, topics, files
+*******************************************************************************
+
+This ROCprofiler-SDK-ROCTx API topic covers:
+
+* :ref:`global_roctx_basic_data_types_reference`
+* :doc:`../../_doxygen/roctx/html/topics`
+* :doc:`../../_doxygen/roctx/html/files`
+
@@ -0,0 +1,12 @@
+.. meta::
+  :description: The global basic data types reference page.
+
+.. _global_roctx_basic_data_types_reference:
+
+*******************************************************************************
+Global Basic Data Types
+*******************************************************************************
+
+.. doxygengroup:: BASIC_DATA_TYPES
+   :content-only:
+   :project: roctx
@@ -0,0 +1,17 @@
+.. meta::
+  :description: The ROCprofiler-SDK-ROCTx API modules reference page.
+  :keywords: AMD, ROCm, modules
+
+.. _roctx_modules_reference:
+
+*******************************************************************************
+Modules
+*******************************************************************************
+
+The ROCprofiler-SDK-ROCTx API is organized into the following modules based on functionality:
+
+* :ref:`markers_information_reference`
+* :ref:`ranges_information_reference`
+* :ref:`profiler-control_information_reference`
+* :ref:`naming-utilities_information_reference`
+
@@ -0,0 +1,12 @@
+.. meta::
+  :description: Markers Information reference page.
+
+.. _markers_information_reference:
+
+*******************************************************************************
+Markers Information
+*******************************************************************************
+
+.. doxygengroup:: marker_group
+   :content-only:
+   :project: roctx
@@ -0,0 +1,12 @@
+.. meta::
+  :description: Naming utilities Information reference page.
+
+.. _naming-utilities_information_reference:
+
+*******************************************************************************
+Naming Information
+*******************************************************************************
+
+.. doxygengroup:: UTILITIES
+   :content-only:
+   :project: roctx
@@ -0,0 +1,12 @@
+.. meta::
+  :description: Profiler Control Information reference page.
+
+.. _profiler-control_information_reference:
+
+*******************************************************************************
+Profiler Control Information
+*******************************************************************************
+
+.. doxygengroup:: PROFILER_COMM
+   :content-only:
+   :project: roctx
@@ -0,0 +1,12 @@
+.. meta::
+  :description: Ranges Information reference page.
+
+.. _ranges_information_reference:
+
+*******************************************************************************
+Ranges Information
+*******************************************************************************
+
+.. doxygengroup:: range_group
+   :content-only:
+   :project: roctx
@@ -0,0 +1,66 @@
+.. meta::
+  :description: ROCprofiler-SDK-ROCTx API reference page
+  :keywords: AMD, ROCm, HSA
+
+.. _rocprofiler_sdk_roctx_api_reference:
+
+********************************************************************************
+ROCTx API
+********************************************************************************
+
+Introduction
+============
+
+ROCTx is a comprehensive library that implements the AMD code annotation API. It provides
+essential functionality for:
+
+- Event annotation and marking
+- Code range tracking and management
+- Profiler control and customization
+- Thread and device naming capabilities
+
+Key features:
+
+- Nested range tracking with push/pop functionality
+- Process-wide range management
+- Thread-specific and global profiler control
+- Device and stream naming support
+- HSA agent and HIP device management
+
+The API is divided into several main components:
+
+1. **Markers** - For single event annotations
+2. **Ranges** - For tracking code execution spans
+3. **Profiler Control** - For managing profiling tool behavior
+4. **Naming Utilities** - For labeling threads, devices, and streams
+
+Thread Safety:
+
+- Range operations are thread-local and thread-safe
+- Marking operations are thread-safe
+- Profiler control operations are process-wide
+
+Integration:
+
+- Compatible with HIP runtime
+- Supports HSA (Heterogeneous System Architecture)
+- Provides both C and C++ interfaces
+
+Performance Considerations:
+
+- Minimal overhead for marking and range operations
+- Thread-local storage for efficient range stacking
+- Lightweight profiler control mechanisms
+
+.. note::
+
+   All string parameters must be null-terminated.
+
+.. warning::
+
+   Proper nesting of range push/pop operations is the user's responsibility.
+
+This ROCTx API topic broadly covers:
+
+* :ref:`roctx_modules_reference`
+* :ref:`global_roctx_data_structures_topics_files_reference`
@@ -8,4 +8,5 @@ Agent Information
 *******************************************************************************

 .. doxygengroup:: AGENTS
+   :project: rocprofiler-sdk
   :content-only:
@@ -9,3 +9,4 @@ Buffer handling

 .. doxygengroup:: BUFFER_HANDLING
   :content-only:
+   :project: rocprofiler-sdk
@@ -9,3 +9,4 @@ Buffer tracing

 .. doxygengroup:: BUFFER_TRACING_SERVICE
   :content-only:
+   :project: rocprofiler-sdk
@@ -9,3 +9,4 @@ Callback tracing

 .. doxygengroup:: CALLBACK_TRACING_SERVICE
   :content-only:
+   :project: rocprofiler-sdk   
@@ -9,3 +9,4 @@ Context management

 .. doxygengroup:: CONTEXT_OPERATIONS
   :content-only:
+   :project: rocprofiler-sdk
@@ -9,3 +9,4 @@ Counter config

 .. doxygengroup:: COUNTER_CONFIG
   :content-only:
+   :project: rocprofiler-sdk
@@ -9,3 +9,4 @@ Counters

 .. doxygengroup:: COUNTERS
   :content-only:
+   :project: rocprofiler-sdk   
@@ -9,3 +9,4 @@ Device counting service

 .. doxygengroup:: device_counting_service
   :content-only:
+   :project: rocprofiler-sdk
@@ -9,3 +9,4 @@ Dispatch counting service

 .. doxygengroup:: dispatch_counting_service
   :content-only:
+   :project: rocprofiler-sdk
@@ -9,3 +9,4 @@ External correlation

 .. doxygengroup:: EXTERNAL_CORRELATION
   :content-only:
+   :project: rocprofiler-sdk
@@ -9,3 +9,4 @@ Intercept table

 .. doxygengroup:: INTERCEPT_TABLE
   :content-only:
+   :project: rocprofiler-sdk
@@ -9,3 +9,4 @@ Internal threading management

 .. doxygengroup:: INTERNAL_THREADING
   :content-only:
+   :project: rocprofiler-sdk
@@ -9,3 +9,4 @@ OMPT Registration

 .. doxygengroup:: OMPT_REGISTRATION
   :content-only:
+   :project: rocprofiler-sdk
@@ -9,3 +9,4 @@ PC Sampling service

 .. doxygengroup:: PC_SAMPLING_SERVICE
   :content-only:
+   :project: rocprofiler-sdk
@@ -9,3 +9,4 @@ Thread trace

 .. doxygengroup:: THREAD_TRACE
   :content-only:
+   :project: rocprofiler-sdk
@@ -9,3 +9,4 @@ Tool registration

 .. doxygengroup:: REGISTRATION_GROUP
   :content-only:
+   :project: rocprofiler-sdk