Added more comments

Author: EuphoricThinking

test/common/test_helpers.h

@@ -50,9 +50,12 @@ static inline bool UT_LOG_ERR(const char *format, ...) {
 
     fprintf(stderr, "\n");
 
+    // For lazy evaluation in GTEST_OUT_*
     return false;
 }
 
+// Assertions which does not impact the program execution
+// Formatting is intended to resemble GTEST assertions outputs
 #define GTEST_OUT_EQ(lhs, rhs)                                                  \
     ((bool)(((lhs) == (rhs)) ||                                                \
             (UT_LOG_ERR("%s:%d %s - assertion failure\nExpected: %s == %s, actual: (0x%llx) vs (0x%llx)"     \
@@ -64,13 +67,13 @@ static inline bool UT_LOG_ERR(const char *format, ...) {
 
 #define GTEST_OUT_NE(lhs, rhs)                                                  \
     ((bool)(((lhs) != (rhs)) ||                                                \
-            (UT_LOG_ERR("%s:%d %s - assertion failure\nExpected: %s != %s, actual: %llx vs %llx"     \
+            (UT_LOG_ERR("%s:%d %s - assertion failure\nExpected: %s != %s, actual: (0x%llx) vs (0x%llx)"     \
                       ,                                              \
                       __FILE__, __LINE__, __func__, #lhs,                      \
                       #rhs, (unsigned long long)(lhs),                         \
                       (unsigned long long)(rhs)),                              \
              0)))
-             
+
 // Assert a condition is true at runtime
 #define UT_ASSERT(cnd)                                                         \
     ((void)((cnd) || (UT_FATAL("%s:%d %s - assertion failure: %s", __FILE__,   \