Doxygen Improvements (#170)

* Doxygen updates

- Fix multiple @param where [in]/[out] was misplaced
- Fix @return
- Insert @retval
- Separate out installing conda environment from build docs step

[ROCm/rocprofiler-sdk commit: 14373c57be]

projects/rocprofiler-sdk/source/lib/rocprofiler/counters.cpp

@@ -37,7 +37,7 @@ rocprofiler_query_counter_name(rocprofiler_counter_id_t counter_id, const char**
  *
  * @param [in] counter_id
  * @param [out] instance_count
- * @return rocprofiler_status_t
+ * @return ::rocprofiler_status_t
  */
 rocprofiler_status_t ROCPROFILER_API
 rocprofiler_query_counter_instance_count(rocprofiler_agent_t      agent,