Documentation Update For Counters (#246)

* Documentation Update

* Minor fixes

* source formatting (clang-format v11) (#265)

Co-authored-by: bwelton <bwelton@users.noreply.github.com>

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: bwelton <bwelton@users.noreply.github.com>

source/include/rocprofiler-sdk/profile_config.h

@@ -36,13 +36,20 @@ ROCPROFILER_EXTERN_C_INIT
  */
 
 /**
- * @brief Create Profile Configuration.
+ * @brief Create Profile Configuration. A profile is bound to an agent but can
+ *        be used across many contexts. The profile has a fixed set of counters
+ *        that are collected (and specified by counter_list). The available
+ *        counters for an agent can be queried using
+ *        @ref rocprofiler_iterate_agent_supported_counters.
  *
  * @param [in] agent Agent identifier
  * @param [in] counters_list List of GPU counters
  * @param [in] counters_count Size of counters list
  * @param [out] config_id Identifier for GPU counters group
  * @return ::rocprofiler_status_t
+ * @retval ROCPROFILER_STATUS_SUCCESS if profile created
+ * @retval ROCPROFILER_STATUS_ERROR if profile could not be created
+ *
  */
 rocprofiler_status_t ROCPROFILER_API
 rocprofiler_create_profile_config(rocprofiler_agent_t              agent,
@@ -56,6 +63,8 @@ rocprofiler_create_profile_config(rocprofiler_agent_t              agent,
  *
  * @param [in] config_id
  * @return ::rocprofiler_status_t
+ * @retval ROCPROFILER_STATUS_SUCCESS if profile destroyed
+ * @retval ROCPROFILER_STATUS_ERROR if profile could not be destroyed
  */
 rocprofiler_status_t ROCPROFILER_API
 rocprofiler_destroy_profile_config(rocprofiler_profile_config_id_t config_id);