clock_gettime: Convert docs to docparse

Signed-off-by: Petr Vorel <pvorel@suse.cz>

Author: pevik

testcases/kernel/syscalls/clock_gettime/clock_gettime01.c

@@ -3,17 +3,18 @@
  * Copyright (c) 2019 Linaro Limited. All rights reserved.
  * Author: Rafael David Tinoco <rafael.tinoco@linaro.org>
  */
-/*
+
+/*\
  * Basic test for clock_gettime(2) on multiple clocks:
  *
- *  1) CLOCK_REALTIME
- *  2) CLOCK_MONOTONIC
- *  3) CLOCK_PROCESS_CPUTIME_ID
- *  4) CLOCK_THREAD_CPUTIME_ID
- *  5) CLOCK_REALTIME_COARSE
- *  6) CLOCK_MONOTONIC_COARSE
- *  7) CLOCK_MONOTONIC_RAW
- *  8) CLOCK_BOOTTIME
+ * #. CLOCK_REALTIME
+ * #. CLOCK_MONOTONIC
+ * #. CLOCK_PROCESS_CPUTIME_ID
+ * #. CLOCK_THREAD_CPUTIME_ID
+ * #. CLOCK_REALTIME_COARSE
+ * #. CLOCK_MONOTONIC_COARSE
+ * #. CLOCK_MONOTONIC_RAW
+ * #. CLOCK_BOOTTIME
  */
 
 #include "config.h"

testcases/kernel/syscalls/clock_gettime/clock_gettime02.c

@@ -3,19 +3,20 @@
  * Copyright (c) 2019 Linaro Limited. All rights reserved.
  * Author: Rafael David Tinoco <rafael.tinoco@linaro.org>
  */
-/*
+
+/*\
  * Bad argument tests for clock_gettime(2) on multiple clocks:
  *
- *  1) MAX_CLOCKS
- *  2) MAX_CLOCKS + 1
- *  3) CLOCK_REALTIME
- *  4) CLOCK_MONOTONIC
- *  5) CLOCK_PROCESS_CPUTIME_ID
- *  6) CLOCK_THREAD_CPUTIME_ID
- *  7) CLOCK_REALTIME_COARSE
- *  8) CLOCK_MONOTONIC_COARSE
- *  9) CLOCK_MONOTONIC_RAW
- * 10) CLOCK_BOOTTIME
+ * #. MAX_CLOCKS
+ * #. MAX_CLOCKS + 1
+ * #. CLOCK_REALTIME
+ * #. CLOCK_MONOTONIC
+ * #. CLOCK_PROCESS_CPUTIME_ID
+ * #. CLOCK_THREAD_CPUTIME_ID
+ * #. CLOCK_REALTIME_COARSE
+ * #. CLOCK_MONOTONIC_COARSE
+ * #. CLOCK_MONOTONIC_RAW
+ * #. CLOCK_BOOTTIME
  */
 
 #include "config.h"

testcases/kernel/syscalls/clock_gettime/clock_gettime03.c

@@ -3,7 +3,7 @@
  * Copyright (c) 2020 Cyril Hrubis <chrubis@suse.cz>
  */
 
-/*
+/*\
  * After a call to unshare(CLONE_NEWTIME) a new timer namespace is created, the
  * process that has called the unshare() can adjust offsets for CLOCK_MONOTONIC
  * and CLOCK_BOOTTIME for its children by writing to the '/proc/self/timens_offsets'.

testcases/kernel/syscalls/clock_gettime/clock_gettime04.c

@@ -8,13 +8,8 @@
  * Check time difference between successive readings and report a bug if
  * difference found to be over 5 ms.
  *
- * This test reports a s390x BUG which has been fixed in:
- *
- *    commit 5b43bd184530af6b868d8273b0a743a138d37ee8
- *    Author: Heiko Carstens <hca@linux.ibm.com>
- *    Date:   Wed Mar 24 20:23:55 2021 +0100
- *
- *    s390/vdso: fix initializing and updating of vdso_data
+ * This test reports a s390x BUG which has been fixed in kernel v5.12 in
+ * 5b43bd184530 ("s390/vdso: fix initializing and updating of vdso_data")
  */
 
 #include "config.h"

testcases/kernel/syscalls/clock_gettime/leapsec01.c

@@ -8,7 +8,8 @@
  * Ported to new library:
  * 07/2019	Christian Amann <camann@suse.com>
  */
-/*
+
+/*\
  * Regression test for hrtimer early expiration during and after leap seconds
  *
  * A bug in the hrtimer subsystem caused all TIMER_ABSTIME CLOCK_REALTIME