add: manuals for param tests

6 files changed, 44 insertions, 3 deletions

diff --git a/man/mt_assert.3 b/man/mt_assert.3
index f18b63f..3013a34 100644
--- a/man/mt_assert.3
+++ b/man/mt_assert.3
@@ -48,6 +48,8 @@ Proper example can be found in
 .BR mt_defs_ext (3),
 .BR mt_run (3),
 .BR mt_run_named (3),
+.BR mt_run_param (3),
+.BR mt_run_named_param (3),
 .BR mt_fok (3),
 .BR mt_ferr (3),
 .BR mt_return (3),
diff --git a/man/mt_defs.3 b/man/mt_defs.3
index b53e0d0..a6076e3 100644
--- a/man/mt_defs.3
+++ b/man/mt_defs.3
@@ -113,6 +113,8 @@ has already been called in a single file.
 .PP
 .BR mt_run (3),
 .BR mt_run_named (3),
+.BR mt_run_param (3),
+.BR mt_run_named_param (3),
 .BR mt_assert (3),
 .BR mt_fail (3),
 .BR mt_fok (3),
diff --git a/man/mt_fok.3 b/man/mt_fok.3
index f2f81da..dd09002 100644
--- a/man/mt_fok.3
+++ b/man/mt_fok.3
@@ -72,6 +72,8 @@ under the hood.
 .BR mt_defs_ext (3),
 .BR mt_run (3),
 .BR mt_run_named (3),
+.BR mt_run_param (3),
+.BR mt_run_named_param (3),
 .BR mt_assert (3),
 .BR mt_fail (3),
 .BR mt_return (3)
diff --git a/man/mt_return.3 b/man/mt_return.3
index d5987e6..4ce2d1f 100644
--- a/man/mt_return.3
+++ b/man/mt_return.3
@@ -38,7 +38,9 @@ Proper example can be found in
 .BR mt_defs (3),
 .BR mt_defs_ext (3),
 .BR mt_run (3),
-.BR mt_run (3),
+.BR mt_run_named (3),
+.BR mt_run_param (3),
+.BR mt_run_named_param (3),
 .BR mt_assert (3),
 .BR mt_fail (3),
 .BR mt_fok (3),
diff --git a/man/mt_run.3 b/man/mt_run.3
index 456e87a..17cba99 100644
--- a/man/mt_run.3
+++ b/man/mt_run.3
@@ -9,11 +9,17 @@ c/c++
 .PP
 .B #include <mtest.h>
 .PP
-.BI "void (*" function_name ")(void)
+.BI "void (*" function_name ")(void)"
 .br
+.BI "void (*" function_name_param ")(void *" parameter ")"
+.PP
 .BI "mt_run(" function_name ")"
 .br
+.BI "mt_run_param(" function_name_param ", " parameter ")"
+.br
 .BI "mt_run_named(" function_name ", " test_name ")"
+.br
+.BI "mt_run_named_param(" function_name_param ", " parameter ", " test_name ")"
 .PP
 .BI "static void (*" mt_prepare_test ")(void)"
 .br
@@ -48,7 +54,15 @@ that will be printed instead of
 when reporting test results.
 .I test_name
 should be simple
-. Bconst char *.
+.B const char *.
+.PP
+.BR mt_run_param (3)
+and
+.BR mt_run_named_param (3)
+works in the same way as they non-parameter counterpart, but
+.I parameter
+will be passed to
+.IR function_name_param .
 .PP
 Optionally user can also set two function pointers
 .I mt_prepare_test
@@ -75,6 +89,11 @@ c/c++
 
     mt_defs();
 
+    static void test_param(void *param)
+    {
+        mt_assert(bar((int *)i) == 0);
+    }
+
     static void test(void)
     {
         mt_assert(foo() == 0);
@@ -82,10 +101,17 @@ c/c++
 
     int main(void)
     {
+        int i;
+
         mt_run(test);
         mt_run_named(test, "test param 1");
         mt_run_named(test, "test_param 2");
 
+        for (i = 0; i != 5; ++i)
+        {
+            mt_run_param(test_param, &i);
+        }
+
         mt_return();
     }
 .EX
diff --git a/man/mtest_overview.7 b/man/mtest_overview.7
index 551b45a..43835ad 100644
--- a/man/mtest_overview.7
+++ b/man/mtest_overview.7
@@ -19,8 +19,12 @@ For c/c++
 .br
 .BI "mt_run(" function_name ")"
 .br
+.BI "mt_run_param(" function_name_param ", " parameter ")"
+.br
 .BI "mt_run_named(" function_name ", " test_name ")"
 .br
+.BI "mt_run_named_param(" function_name_param ", " parameter ", " test_name ")"
+.br
 .BI "mt_assert(" expression ")"
 .br
 .BI "mt_fail(" expression ")"
@@ -110,6 +114,9 @@ Example of using mt in posix shell
 .BR mt_defs (3),
 .BR mt_defs_ext (3),
 .BR mt_run (3),
+.BR mt_run_named (3),
+.BR mt_run_param (3),
+.BR mt_run_named_param (3),
 .BR mt_assert (3),
 .BR mt_fail (3),
 .BR mt_fok (3),