[SDK] Release 1.0 Public API Modifications (#277)

* Make sure all structs/enums can be forward declared

* Updates to counter collection

- consistency updates and cleanup

* Conversion of dimension information to info struct

* Added deprecated folder

* Testing changes

* merge changes

* Fix shadowed variable

* Source code formatting

* Fix shadowed variable

* Update rocprofiler_counter_info_v1_t member names

* Split version.h into version.h and ext_version.h

- ext_version.h contains external version info, e.g. ROCPROFILER_HSA_API_TABLE_MAJOR_VERSION, ROCPROFILER_HSA_RUNTIME_VERSION
- this reduces amount of recompilation after a commit since version.h gets updated with the git revision

* profile_config -> counter_config

* EOF new line

* [Samples] Reduce header includes + reorg counter collection samples

* Misc compilation fixes

- shadowed variables
- use of [[deprecated("...")]] in C code
- unused variables

* Minor misc modifications

- use common:: instead of rocprofiler::common:: when inside rocprofiler namespace
- counters.cpp
  - move local anon namespace functions into rocprofiler::counters:: anon namespace
  - use std::string_view for get_static_string
  - const ref for get_static_ptr
  - misc namespace shortening

* [Public API] rocprofiler_get_version_triplet + rocprofiler_version_triplet_t

- struct rocprofiler_version_triplet_t containing fields for the major, minor, and patch version
- public API function: rocprofiler_get_version_triplet
- define C++ operators for rocprofiler_version_triplet_t
- C++ function compute_version_triplet

* [Tests] Improve async-copy-testing test

- relax constraints
- improve logging

* Update counter_config.h doxygen docs

* ROCPROFILER_SDK_BETA_COMPAT

- ppdef which helps with renaming when set to 1

* Remove spurious include

* Fix includes for cxx/version.hpp

* Doxygen fixes for rocprofiler_get_version and rocprofiler_get_version_triplet

* Public API Experimental Designation

- ROCPROFILER_SDK_EXPERIMENTAL added to experimental function
- "(experimental)" added to doxygen @brief entries

* Fix use of assert instead of static_assert in hip/stream.cpp

* Use typedef instead of define for rocprofiler_profile_config_id_t

* Use inline rocprofiler_{create,destroy}_profile_config instead of ppdef

- added <rocprofiler-sdk/deprecated/profile_config.h>

* Doxygen for rocprofiler_{create,destroy}_profile_config

* ROCPROFILER_SDK_DEPRECATED_WARNINGS

* Temporarily comment out ROCPROFILER_SDK_DEPRECATED_WARNINGS=1

* cmake formatting

* Misc variable renaming in samples and tests

* Fix declarations of types

* Fix hip stream tracing service struct name

- rocprofiler_callback_tracing_stream_handle_data_t renamed to rocprofiler_callback_tracing_hip_stream_api_data_t

* Rename "HIP_STREAM_API" to "HIP_STREAM"

---------

Co-authored-by: Jonathan R. Madsen <jonathanrmadsen@gmail.com>
Co-authored-by: Benjamin Welton <bewelton@amd.com>

source/docs/api-reference/counter_collection_services.rst

@@ -65,7 +65,7 @@ After creating a context and buffer to store results in ``tool_init``, it is hig
     // Setup the dispatch profile counting service. This service will trigger the dispatch_callback
     // when a kernel dispatch is enqueued into the HSA queue. The callback will specify what
     // counters to collect by returning a profile config id.
-    ROCPROFILER_CALL(rocprofiler_configure_buffered_dispatch_counting_service(
+    ROCPROFILER_CALL(rocprofiler_configure_buffer_dispatch_counting_service(
                          ctx, buff, dispatch_callback, nullptr),
                      "Could not setup buffered service");
 
@@ -145,21 +145,21 @@ Profile Setup
     {
         // Contains name and other attributes about the counter.
         // See API documentation for more info on the contents of this struct.
-        rocprofiler_counter_info_v0_t version;
+        rocprofiler_counter_info_v0_t info;
         ROCPROFILER_CALL(
             rocprofiler_query_counter_info(
-                counter, ROCPROFILER_COUNTER_INFO_VERSION_0, static_cast<void*>(&version)),
+                counter, ROCPROFILER_COUNTER_INFO_VERSION_0, static_cast<void*>(&info)),
             "Could not query info for counter");
     }
 
 
-4. After identifying the counters to be collected, construct a profile by passing a list of these counters to ``rocprofiler_create_profile_config``.
+4. After identifying the counters to be collected, construct a profile by passing a list of these counters to ``rocprofiler_create_counter_config``.
 
 .. code-block:: cpp
 
     // Create and return the profile
-    rocprofiler_profile_config_id_t profile;
-    ROCPROFILER_CALL(rocprofiler_create_profile_config(
+    rocprofiler_counter_config_id_t profile;
+    ROCPROFILER_CALL(rocprofiler_create_counter_config(
                          agent, counters_array, counters_array_count, &profile),
                      "Could not construct profile cfg");
 
@@ -172,7 +172,7 @@ Profile Setup
     - Profile created is *only valid* for the agent it was created for.
     - Profiles are immutable. To collect a new counter set, construct a new profile.
     - A single profile can be used multiple times on the same agent.
-    - Counter Ids supplied to ``rocprofiler_create_profile_config`` are *agent-specific* and can't be used to construct profiles for other agents.
+    - Counter Ids supplied to ``rocprofiler_create_counter_config`` are *agent-specific* and can't be used to construct profiles for other agents.
 
 Dispatch Counting Callback
 --------------------------
@@ -183,7 +183,7 @@ When a kernel is dispatched, a dispatch callback is issued to the tool to allow
 
     void
     dispatch_callback(rocprofiler_dispatch_counting_service_data_t dispatch_data,
-                      rocprofiler_profile_config_id_t*             config,
+                      rocprofiler_counter_config_id_t*             config,
                       rocprofiler_user_data_t* user_data,
                       void* /*callback_data_args*/)
 
@@ -197,9 +197,9 @@ This callback is invoked after the context starts and allows the tool to specify
 .. code-block:: cpp
 
     void
-    set_profile(rocprofiler_context_id_t                 context_id,
-                rocprofiler_agent_id_t                   agent,
-                rocprofiler_agent_set_profile_callback_t set_config,
+    set_profile(rocprofiler_context_id_t               context_id,
+                rocprofiler_agent_id_t                 agent,
+                rocprofiler_device_counting_agent_cb_t set_config,
                 void*)
 
 The profile to be used for this agent is specified by calling ``set_config(agent, profile)``.
@@ -210,7 +210,7 @@ Buffered callback
 Data from collected counter values is returned through a buffered callback. The buffered callback routines are similar for dispatch and device counting except that some data such as kernel launch Ids is not available in device counting mode. Here is a sample iteration to print out counter collection data:
 
 .. code-block:: cpp
-    
+
     for(size_t i = 0; i < num_headers; ++i)
     {
         auto* header = headers[i];