SWDEV-448163 - Fix doxygen warnings

This is a first batch of doxygen warnings fixes.

Signed-off-by: Sebastian Luzynski <Sebastian.Luzynski@amd.com>
Change-Id: Iba81d08b15738f80d86626113026e8a7e9cab42b

catch/multiproc/hipDeviceTotalMemMproc.cc

@@ -169,4 +169,9 @@ TEST_CASE("Unit_hipDeviceTotalMem_MaskedDevices") {
   }
 }
 
+/**
+ * End doxygen group hipDeviceTotalMem.
+ * @}
+ */
+
 #endif

catch/multiproc/hipIpcEventHandle.cc

@@ -431,4 +431,9 @@ TEST_CASE("Unit_hipIpcEventHandle_ParameterValidation") {
  *  - @ref Unit_hipIpcEventHandle_ParameterValidation
  */
 
+/**
+ * End doxygen group hipIpcOpenEventHandle.
+ * @}
+ */
+
 #endif

catch/multiproc/hipIpcMemAccessTest.cc

@@ -271,4 +271,9 @@ TEST_CASE("Unit_hipIpcMemAccess_ParameterValidation") {
   HIP_CHECK(hipFree(Ad));
 }
 
+/**
+ * End doxygen group hipIpcOpenMemHandle.
+ * @}
+ */
+
 #endif

catch/performance/event/hipEventDestroy.cc

@@ -51,4 +51,9 @@ class HipEventDestroyBenchmark : public Benchmark<HipEventDestroyBenchmark> {
 TEST_CASE("Performance_hipEventDestroy") {
   HipEventDestroyBenchmark benchmark;
   benchmark.Run();
-}
+}
+
+/**
+ * End doxygen group event.
+ * @}
+ */

catch/performance/event/hipEventElapsedTime.cc

@@ -66,3 +66,8 @@ TEST_CASE("Performance_hipEventElapsedTime") {
   HipEventElapsedTimeBenchmark benchmark;
   benchmark.Run();
 }
+
+/**
+ * End doxygen group event.
+ * @}
+ */

catch/performance/event/hipEventQuery.cc

@@ -56,3 +56,8 @@ TEST_CASE("Performance_hipEventQuery") {
   HipEventQueryBenchmark benchmark;
   benchmark.Run();
 }
+
+/**
+ * End doxygen group event.
+ * @}
+ */

catch/performance/event/hipEventRecord.cc

@@ -71,3 +71,8 @@ TEST_CASE("Performance_hipEventRecord") {
     RunBenchmark(stream.stream());
   }
 }
+
+/**
+ * End doxygen group event.
+ * @}
+ */

catch/performance/event/hipEventSynchronize.cc

@@ -68,3 +68,8 @@ TEST_CASE("Performance_hipEventSynchronize") {
   const auto flag = GENERATE(hipEventDefault, hipEventBlockingSync);
   RunBenchmark(flag);
 }
+
+/**
+ * End doxygen group event.
+ * @}
+ */

catch/performance/kernelLaunch/hipExtLaunchKernel.cc

@@ -118,3 +118,8 @@ TEST_CASE("Performance_hipExtLaunchKernel") {
     SECTION("event-based timing") { RunBenchmark<KernelType::kLarge, kTimerTypeEvent>(sync); }
   }
 }
+
+/**
+ * End doxygen group kernelLaunch.
+ * @}
+ */

catch/performance/kernelLaunch/hipLaunchCooperativeKernel.cc

@@ -128,3 +128,8 @@ TEST_CASE("Performance_hipLaunchCooperativeKernel") {
     SECTION("event-based timing") { RunBenchmark<KernelType::kLarge, kTimerTypeEvent>(sync); }
   }
 }
+
+/**
+ * End doxygen group kernelLaunch.
+ * @}
+ */

catch/performance/kernelLaunch/hipLaunchKernel.cc

@@ -116,3 +116,8 @@ TEST_CASE("Performance_hipLaunchKernel") {
     SECTION("event-based timing") { RunBenchmark<KernelType::kLarge, kTimerTypeEvent>(sync); }
   }
 }
+
+/**
+ * End doxygen group kernelLaunch.
+ * @}
+ */

catch/performance/kernelLaunch/triple_chevron.cc

@@ -103,3 +103,8 @@ TEST_CASE("Performance_Triple_Chevron") {
     SECTION("event-based timing") { RunBenchmark<KernelType::kLarge, kTimerTypeEvent>(sync); }
   }
 }
+
+/**
+ * End doxygen group kernelLaunch.
+ * @}
+ */

catch/performance/memcpy/hipMemcpy.cc

@@ -188,3 +188,8 @@ TEST_CASE("Performance_hipMemcpy_DeviceToDevice_DisablePeerAccess") {
   const auto dst_allocation_type = LinearAllocs::hipMalloc;
   RunBenchmark(dst_allocation_type, src_allocation_type, allocation_size, hipMemcpyDeviceToDevice);
 }
+
+/**
+ * End doxygen group memcpy.
+ * @}
+ */

catch/performance/memcpy/hipMemcpy2D.cc

@@ -181,3 +181,8 @@ TEST_CASE("Performance_hipMemcpy2D_DeviceToDevice_EnablePeerAccess") {
   const auto width = GENERATE(4_KB, 4_MB, 16_MB);
   RunBenchmark(width, 32, hipMemcpyDeviceToDevice, true);
 }
+
+/**
+ * End doxygen group memcpy.
+ * @}
+ */

catch/performance/memcpy/hipMemcpy2DAsync.cc

@@ -186,3 +186,8 @@ TEST_CASE("Performance_hipMemcpy2DAsync_DeviceToDevice_EnablePeerAccess") {
   const auto width = GENERATE(4_KB, 4_MB, 16_MB);
   RunBenchmark(width, 32, hipMemcpyDeviceToDevice, true);
 }
+
+/**
+ * End doxygen group memcpy.
+ * @}
+ */

catch/performance/memcpy/hipMemcpy2DFromArray.cc

@@ -125,3 +125,8 @@ TEST_CASE("Performance_hipMemcpy2DFromArray_DeviceToDevice_EnablePeerAccess") {
   const auto width = GENERATE(4_KB, 8_KB, 16_KB);
   RunBenchmark(width, 32, hipMemcpyDeviceToDevice, true);
 }
+
+/**
+ * End doxygen group memcpy.
+ * @}
+ */

catch/performance/memcpy/hipMemcpy2DFromArrayAsync.cc

@@ -131,3 +131,8 @@ TEST_CASE("Performance_hipMemcpy2DFromArrayAsync_DeviceToDevice_EnablePeerAccess
   const auto width = GENERATE(4_KB, 8_KB, 16_KB);
   RunBenchmark(width, 32, hipMemcpyDeviceToDevice, true);
 }
+
+/**
+ * End doxygen group memcpy.
+ * @}
+ */

catch/performance/memcpy/hipMemcpy2DToArray.cc

@@ -125,3 +125,8 @@ TEST_CASE("Performance_hipMemcpy2DToArray_DeviceToDevice_EnablePeerAccess") {
   const auto width = GENERATE(4_KB, 8_KB, 16_KB);
   RunBenchmark(width, 32, hipMemcpyDeviceToDevice, true);
 }
+
+/**
+ * End doxygen group memcpy.
+ * @}
+ */

catch/performance/memcpy/hipMemcpy2DToArrayAsync.cc

@@ -131,3 +131,8 @@ TEST_CASE("Performance_hipMemcpy2DToArrayAsync_DeviceToDevice_EnablePeerAccess")
   const auto width = GENERATE(4_KB, 8_KB, 16_KB);
   RunBenchmark(width, 32, hipMemcpyDeviceToDevice, true);
 }
+
+/**
+ * End doxygen group memcpy.
+ * @}
+ */

catch/performance/memcpy/hipMemcpy3D.cc

@@ -187,3 +187,8 @@ TEST_CASE("Performance_hipMemcpy3D_DeviceToDevice_EnablePeerAccess") {
   const auto width = GENERATE(4_KB, 4_MB, 16_MB);
   RunBenchmark(make_hipExtent(width, 16, 4), hipMemcpyDeviceToDevice, true);
 }
+
+/**
+ * End doxygen group memcpy.
+ * @}
+ */

catch/performance/memcpy/hipMemcpy3DAsync.cc

@@ -190,3 +190,8 @@ TEST_CASE("Performance_hipMemcpy3DAsync_DeviceToDevice_EnablePeerAccess") {
   const auto width = GENERATE(4_KB, 4_MB, 16_MB);
   RunBenchmark(make_hipExtent(width, 16, 4), hipMemcpyDeviceToDevice, true);
 }
+
+/**
+ * End doxygen group memcpy.
+ * @}
+ */

catch/performance/memcpy/hipMemcpyAsync.cc

@@ -190,3 +190,8 @@ TEST_CASE("Performance_hipMemcpyAsync_DeviceToDevice_EnablePeerAccess") {
   const auto dst_allocation_type = LinearAllocs::hipMalloc;
   RunBenchmark(dst_allocation_type, src_allocation_type, allocation_size, hipMemcpyDeviceToDevice, true);
 }
+
+/**
+ * End doxygen group memcpy.
+ * @}
+ */

catch/performance/memcpy/hipMemcpyAtoH.cc

@@ -67,3 +67,8 @@ TEST_CASE("Performance_hipMemcpyAtoH") {
   const auto host_allocation_type = GENERATE(LinearAllocs::malloc, LinearAllocs::hipHostMalloc);
   RunBenchmark(host_allocation_type, allocation_size);
 }
+
+/**
+ * End doxygen group memcpy.
+ * @}
+ */

catch/performance/memcpy/hipMemcpyDtoD.cc

@@ -101,3 +101,8 @@ TEST_CASE("Performance_hipMemcpyDtoD_PeerAccessDisabled") {
   const auto allocation_size = GENERATE(4_KB, 4_MB, 16_MB);
   RunBenchmark(allocation_size);
 }
+
+/**
+ * End doxygen group memcpy.
+ * @}
+ */

catch/performance/memcpy/hipMemcpyDtoDAsync.cc

@@ -104,3 +104,8 @@ TEST_CASE("Performance_hipMemcpyDtoDAsync_PeerAccessDisabled") {
   const auto allocation_size = GENERATE(4_KB, 4_MB, 16_MB);
   RunBenchmark(allocation_size);
 }
+
+/**
+ * End doxygen group memcpy.
+ * @}
+ */

catch/performance/memcpy/hipMemcpyDtoH.cc

@@ -70,3 +70,8 @@ TEST_CASE("Performance_hipMemcpyDtoH") {
   const auto host_allocation_type = GENERATE(LinearAllocs::malloc, LinearAllocs::hipHostMalloc);
   RunBenchmark(host_allocation_type, device_allocation_type, allocation_size);
 }
+
+/**
+ * End doxygen group memcpy.
+ * @}
+ */

catch/performance/memcpy/hipMemcpyDtoHAsync.cc

@@ -73,3 +73,8 @@ TEST_CASE("Performance_hipMemcpyDtoHAsync") {
   const auto host_allocation_type = GENERATE(LinearAllocs::malloc, LinearAllocs::hipHostMalloc);
   RunBenchmark(host_allocation_type, device_allocation_type, allocation_size);
 }
+
+/**
+ * End doxygen group memcpy.
+ * @}
+ */

catch/performance/memcpy/hipMemcpyFromSymbol.cc

@@ -114,3 +114,8 @@ TEST_CASE("Performance_hipMemcpyFromSymbol_WithOffset") {
   size_t offset = GENERATE_REF(0, size / 2);
   RunBenchmark(array.data() + offset, result.data() + offset, sizeof(int) * (size - offset), offset * sizeof(int));
 }
+
+/**
+ * End doxygen group memcpy.
+ * @}
+ */

catch/performance/memcpy/hipMemcpyFromSymbolAsync.cc

@@ -120,3 +120,8 @@ TEST_CASE("Performance_hipMemcpyFromSymbolAsync_WithOffset") {
   size_t offset = GENERATE_REF(0, size / 2);
   RunBenchmark(array.data() + offset, result.data() + offset, sizeof(int) * (size - offset), offset * sizeof(int));
 }
+
+/**
+ * End doxygen group memcpy.
+ * @}
+ */

catch/performance/memcpy/hipMemcpyHtoA.cc

@@ -67,3 +67,8 @@ TEST_CASE("Performance_hipMemcpyHtoA") {
   const auto host_allocation_type = GENERATE(LinearAllocs::malloc, LinearAllocs::hipHostMalloc);
   RunBenchmark(host_allocation_type, allocation_size);
 }
+
+/**
+ * End doxygen group memcpy.
+ * @}
+ */

catch/performance/memcpy/hipMemcpyHtoD.cc

@@ -68,3 +68,8 @@ TEST_CASE("Performance_hipMemcpyHtoD") {
   const auto host_allocation_type = GENERATE(LinearAllocs::malloc, LinearAllocs::hipHostMalloc);
   RunBenchmark(host_allocation_type, device_allocation_type, allocation_size);
 }
+
+/**
+ * End doxygen group memcpy.
+ * @}
+ */

catch/performance/memcpy/hipMemcpyHtoDAsync.cc

@@ -72,3 +72,8 @@ TEST_CASE("Performance_hipMemcpyHtoDAsync") {
   const auto host_allocation_type = GENERATE(LinearAllocs::malloc, LinearAllocs::hipHostMalloc);
   RunBenchmark(host_allocation_type, device_allocation_type, allocation_size);
 }
+
+/**
+ * End doxygen group memcpy.
+ * @}
+ */

catch/performance/memcpy/hipMemcpyParam2D.cc

@@ -186,3 +186,8 @@ TEST_CASE("Performance_hipMemcpyParam2D_DeviceToDevice_EnablePeerAccess") {
   const auto width = GENERATE(4_KB, 4_MB, 16_MB);
   RunBenchmark(width, 32, hipMemcpyDeviceToDevice, true);
 }
+
+/**
+ * End doxygen group memcpy.
+ * @}
+ */

catch/performance/memcpy/hipMemcpyParam2DAsync.cc

@@ -191,3 +191,8 @@ TEST_CASE("Performance_hipMemcpyParam2DAsync_DeviceToDevice_EnablePeerAccess") {
   const auto width = GENERATE(4_KB, 4_MB, 16_MB);
   RunBenchmark(width, 32, hipMemcpyDeviceToDevice, true);
 }
+
+/**
+ * End doxygen group memcpy.
+ * @}
+ */

catch/performance/memcpy/hipMemcpyToSymbol.cc

@@ -107,3 +107,8 @@ TEST_CASE("Performance_hipMemcpyToSymbol_WithOffset") {
   size_t offset = GENERATE_REF(0, size / 2);
   RunBenchmark(array.data() + offset, sizeof(int) * (size - offset), offset * sizeof(int));
 }
+
+/**
+ * End doxygen group memcpy.
+ * @}
+ */

catch/performance/memcpy/hipMemcpyToSymbolAsync.cc

@@ -114,3 +114,8 @@ TEST_CASE("Performance_hipMemcpyToSymbolAsync_WithOffset") {
   size_t offset = GENERATE_REF(0, size / 2);
   RunBenchmark(array.data() + offset, sizeof(int) * (size - offset), offset * sizeof(int));
 }
+
+/**
+ * End doxygen group memcpy.
+ * @}
+ */

catch/performance/memcpy/hipMemcpyWithStream.cc

@@ -190,3 +190,8 @@ TEST_CASE("Performance_hipMemcpyWithStream_DeviceToDevice_EnablePeerAccess") {
   const auto dst_allocation_type = LinearAllocs::hipMalloc;
   RunBenchmark(dst_allocation_type, src_allocation_type, allocation_size, hipMemcpyDeviceToDevice, true);
 }
+
+/**
+ * End doxygen group memcpy.
+ * @}
+ */

catch/unit/event/hipEventCreate.cc

@@ -51,3 +51,8 @@ TEST_CASE("Unit_hipEventCreate_Positive") {
 
   HIP_CHECK(hipEventDestroy(event));
 }
+
+/**
+ * End doxygen group hipEventCreate.
+ * @}
+ */

catch/unit/event/hipEventCreateWithFlags.cc

@@ -347,4 +347,10 @@ TEST_CASE("Unit_hipEventCreateWithFlags_DefaultFlg_CohHstMem") {
     eMemoryToTest::eCoherentHostMemory, hipEventDefault);
   }
 }
+
+/**
+ * End doxygen group hipEventCreateWithFlags.
+ * @}
+ */
+
 #endif