EXSWHTEC-224 - Test cases ID clean up and documentation for Initialization&Version (#83)

- Test cases ID clean up and documentation for Initialization and Version

catch/unit/device/hipInit.cc

@@ -18,13 +18,29 @@ LIABILITY, WHETHER INN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR INN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 THE SOFTWARE.
 */
-/*
-Testcase Scenarios :
-Unit_hipInit_Positive - Test explicit HIP initalization with hipInit api
-Unit_hipInit_Negative_InvalidFlag - Test unsuccessful HIP initalization with hipInit api when flag is invalid
-*/
+
 #include <hip_test_common.hh>
 
+/**
+ * @addtogroup hipInit hipInit
+ * @{
+ * @ingroup DriverTest
+ * `hipInit(unsigned int flags)` -
+ * Explicitly initializes the HIP runtime.
+ */
+
+/**
+ * Test Description
+ * ------------------------
+ *  - Initialize HIP runtime.
+ *  - Call a HIP API and check that the runtime is initialized successfully.
+ * Test source
+ * ------------------------
+ *  - unit/device/hipInit.cc
+ * Test requirements
+ * ------------------------
+ *  - HIP_VERSION >= 5.2
+ */
 TEST_CASE("Unit_hipInit_Positive") {
   HIP_CHECK(hipInit(0));
 
@@ -34,6 +50,19 @@ TEST_CASE("Unit_hipInit_Positive") {
   REQUIRE(count >= 0);
 }
 
+/**
+ * Test Description
+ * ------------------------
+ *  - Validates handling of invalid arguments:
+ *    -# When flag has invalid value equal to -1
+ *      - Expected output: return `hipErrorInvalidValue`
+ * Test source
+ * ------------------------
+ *  - unit/device/hipInit.cc
+ * Test requirements
+ * ------------------------
+ *  - HIP_VERSION >= 5.2
+ */
 TEST_CASE("Unit_hipInit_Negative") {
   // If initialization is attempted with invalid flag, error shall be reported
   unsigned int invalid_flag = 1;