[docs] Improve readability of ROCprofiler-SDK API library documentation (#359)

* Use custom .rst to make api doc more readable.

* Update index.rst

* Misc docs updates

- doxygen source code fixes
- updated doxygen files
- fixed conf.py (does not generate code in source tree)

* Update source/docs/api-reference/rocprofiler-sdk_api_reference.rst

Co-authored-by: Rawat, Swati <Swati.Rawat@amd.com>

* Update source/docs/api-reference/rocprofiler-sdk_api_reference.rst

Co-authored-by: Rawat, Swati <Swati.Rawat@amd.com>

* Update source/docs/api-reference/rocprofiler-sdk_api/modules.rst

Co-authored-by: Rawat, Swati <Swati.Rawat@amd.com>

* Update source/docs/api-reference/rocprofiler-sdk_api/global_data_structures_topics_files.rst

Co-authored-by: Rawat, Swati <Swati.Rawat@amd.com>

* Duplicate

* test warnings

* Update CMakeLists.txt

* Update rocprofiler-sdk.dox.in

* Update update-docs.sh

* fix docs build failures by -q -T flags.

* set warn_as_error to NO.

* test -W to suppress warnings.

* remove -q flag from make.

* reduce dot graph depth to 100

* Update custom docs target

- docs target is now no longer part of the dependency list for the all target
- installation of docs requires explicitly building the docs target (i.e. OPTIONAL install of _build/html/ folder)

* add quit and trace mode back.

* increase DOT_GRAPH_MAX_NODES to 500 back.

* Format.

---------

Co-authored-by: Venkateshwar Reddy Kandula <vkandula@amd.com>
Co-authored-by: Jonathan R. Madsen <jonathanrmadsen@gmail.com>
Co-authored-by: Bhardwaj, Gopesh <Gopesh.Bhardwaj@amd.com>
Co-authored-by: Rawat, Swati <Swati.Rawat@amd.com>
Co-authored-by: Madsen, Jonathan <Jonathan.Madsen@amd.com>

source/docs/api-reference/rocprofiler-sdk_api/modules/agent_information.rst

@@ -0,0 +1,11 @@
+.. meta::
+  :description: The Agent Information reference page.
+
+.. _agent_information_reference:
+
+*******************************************************************************
+Agent Information
+*******************************************************************************
+
+.. doxygengroup:: AGENTS
+   :content-only:

source/docs/api-reference/rocprofiler-sdk_api/modules/buffer_handling.rst

@@ -0,0 +1,11 @@
+.. meta::
+  :description: The buffer handling reference page.
+
+.. _buffer_handling_reference:
+
+*******************************************************************************
+Buffer handling
+*******************************************************************************
+
+.. doxygengroup:: BUFFER_HANDLING
+   :content-only:

source/docs/api-reference/rocprofiler-sdk_api/modules/buffer_tracing.rst

@@ -0,0 +1,11 @@
+.. meta::
+  :description: The buffer tracing reference page.
+
+.. _buffer_tracing_reference:
+
+*******************************************************************************
+Buffer tracing
+*******************************************************************************
+
+.. doxygengroup:: BUFFER_TRACING_SERVICE
+   :content-only:

source/docs/api-reference/rocprofiler-sdk_api/modules/callback_tracing.rst

@@ -0,0 +1,11 @@
+.. meta::
+  :description: The callback tracing reference page.
+
+.. _callback_tracing_reference:
+
+*******************************************************************************
+Callback tracing
+*******************************************************************************
+
+.. doxygengroup:: CALLBACK_TRACING_SERVICE
+   :content-only:

source/docs/api-reference/rocprofiler-sdk_api/modules/context_management.rst

@@ -0,0 +1,11 @@
+.. meta::
+  :description: The context management reference page.
+
+.. _context_management_reference:
+
+*******************************************************************************
+Context management
+*******************************************************************************
+
+.. doxygengroup:: CONTEXT_OPERATIONS
+   :content-only:

source/docs/api-reference/rocprofiler-sdk_api/modules/counter_config.rst

@@ -0,0 +1,11 @@
+.. meta::
+  :description: The counter config reference page.
+
+.. _counter_config_reference:
+
+*******************************************************************************
+Counter config
+*******************************************************************************
+
+.. doxygengroup:: COUNTER_CONFIG
+   :content-only:

source/docs/api-reference/rocprofiler-sdk_api/modules/counters.rst

@@ -0,0 +1,11 @@
+.. meta::
+  :description: The counters reference page.
+
+.. _counters_reference:
+
+*******************************************************************************
+Counters
+*******************************************************************************
+
+.. doxygengroup:: COUNTERS
+   :content-only:

source/docs/api-reference/rocprofiler-sdk_api/modules/device_counting_service.rst

@@ -0,0 +1,11 @@
+.. meta::
+  :description: The device counting service reference page.
+
+.. _device_counting_service_reference:
+
+*******************************************************************************
+Device counting service
+*******************************************************************************
+
+.. doxygengroup:: device_counting_service
+   :content-only:

source/docs/api-reference/rocprofiler-sdk_api/modules/dispatch_counting_service.rst

@@ -0,0 +1,11 @@
+.. meta::
+  :description: The dispatch counting service reference page.
+
+.. _dispatch_counting_service_reference:
+
+*******************************************************************************
+Dispatch counting service
+*******************************************************************************
+
+.. doxygengroup:: dispatch_counting_service
+   :content-only:

source/docs/api-reference/rocprofiler-sdk_api/modules/external_correalation.rst

@@ -0,0 +1,11 @@
+.. meta::
+  :description: The external correlation reference page.
+
+.. _external_correlation_reference:
+
+*******************************************************************************
+External correlation
+*******************************************************************************
+
+.. doxygengroup:: EXTERNAL_CORRELATION
+   :content-only:

source/docs/api-reference/rocprofiler-sdk_api/modules/intercept_table.rst

@@ -0,0 +1,11 @@
+.. meta::
+  :description: The Intercept table reference page.
+
+.. _intercept_table_reference:
+
+*******************************************************************************
+Intercept table
+*******************************************************************************
+
+.. doxygengroup:: INTERCEPT_TABLE
+   :content-only:

source/docs/api-reference/rocprofiler-sdk_api/modules/internal_threading_management.rst

@@ -0,0 +1,11 @@
+.. meta::
+  :description: The intenal threading management reference page.
+
+.. _internal_threading_management_reference:
+
+*******************************************************************************
+Internal threading management
+*******************************************************************************
+
+.. doxygengroup:: INTERNAL_THREADING
+   :content-only:

source/docs/api-reference/rocprofiler-sdk_api/modules/ompt_registration.rst

@@ -0,0 +1,11 @@
+.. meta::
+  :description: The OMPT Registration reference page.
+
+.. _ompt_registration_reference:
+
+*******************************************************************************
+OMPT Registration
+*******************************************************************************
+
+.. doxygengroup:: OMPT_REGISTRATION
+   :content-only:

source/docs/api-reference/rocprofiler-sdk_api/modules/pc_sampling_service.rst

@@ -0,0 +1,11 @@
+.. meta::
+  :description: The PC Sampling service reference page.
+
+.. _pc_sampling_service_reference:
+
+*******************************************************************************
+PC Sampling service
+*******************************************************************************
+
+.. doxygengroup:: PC_SAMPLING_SERVICE
+   :content-only:

source/docs/api-reference/rocprofiler-sdk_api/modules/thread_trace.rst

@@ -0,0 +1,11 @@
+.. meta::
+  :description: The thread trace reference page.
+
+.. _thread_trace_reference:
+
+*******************************************************************************
+Thread trace
+*******************************************************************************
+
+.. doxygengroup:: THREAD_TRACE
+   :content-only:

source/docs/api-reference/rocprofiler-sdk_api/modules/tool_registration.rst

@@ -0,0 +1,11 @@
+.. meta::
+  :description: The tool registration reference page.
+
+.. _tool_registration_reference:
+
+*******************************************************************************
+Tool registration
+*******************************************************************************
+
+.. doxygengroup:: REGISTRATION_GROUP
+   :content-only: