diff mbox series

[1/1] tst_test: Document @scall, @sample.

Message ID 20240607103902.76903-1-pvorel@suse.cz
State Superseded
Headers show
Series [1/1] tst_test: Document @scall, @sample. | expand

Commit Message

Petr Vorel June 7, 2024, 10:39 a.m. UTC
All undocumented members are in the library "undescribed",
better to document the purpose.

Signed-off-by: Petr Vorel <pvorel@suse.cz>
---
 include/tst_test.h | 4 ++++
 1 file changed, 4 insertions(+)

Comments

Petr Vorel June 7, 2024, 1:29 p.m. UTC | #1
Also message is not described. I would add:

Kind regards,
Petr

+++ include/tst_test.h
@@ -646,6 +646,8 @@ int main(int argc, char *argv[])
 /**
  * TST_TEST_TCONF() - Exit tests with a TCONF message.
  *
+ * @message Error message (reason to skip the test).
+ *
  * This macro is used in test that couldn't be compiled either because current
  * CPU architecture is unsupported or because of missing development libraries.
  */
diff mbox series

Patch

diff --git a/include/tst_test.h b/include/tst_test.h
index 8dc20d110..63f707834 100644
--- a/include/tst_test.h
+++ b/include/tst_test.h
@@ -428,6 +428,10 @@  struct tst_ulimit_val {
  *            can be set. May be executed several times if test was passed '-i'
  *            or '-d' command line parameters.
  *
+ * @scall: Internal only (timer measurement library).
+ *
+ * @sample: Internal only (timer measurement library).
+ *
  * @resource_files: A NULL terminated array of filenames that will be copied
  *                  to the test temporary directory from the LTP datafiles
  *                  directory.