include: Document fail().
diff --git a/include/cmocka.h b/include/cmocka.h
index 6f0bacc..28cf849 100755
--- a/include/cmocka.h
+++ b/include/cmocka.h
@@ -384,8 +384,23 @@
_assert_not_in_set(value, values, number_of_values, __FILE__, __LINE__)
-/* Forces the test to fail immediately and quit. */
+/**
+ * @defgroup cmocka_exec Running Tests
+ * @ingroup cmocka
+ *
+ * This is the way tests are executed with CMocka.
+ *
+ * @{
+ */
+
+#ifdef DOXYGEN
+/**
+ * @brief Forces the test to fail immediately and quit.
+ */
+void fail(void);
+#else
#define fail() _fail(__FILE__, __LINE__)
+#endif
/* Generic method to kick off testing */
#define run_test(f) _run_test(#f, f, NULL, UNIT_TEST_FUNCTION_TYPE_TEST, NULL)
@@ -423,6 +438,8 @@
*/
#define run_tests(tests) _run_tests(tests, sizeof(tests) / sizeof(tests)[0])
+/** @} */
+
/* Dynamic allocators */
#define test_malloc(size) _test_malloc(size, __FILE__, __LINE__)
#define test_calloc(num, size) _test_calloc(num, size, __FILE__, __LINE__)
