From: Anna-Maria Behnsen Date: Tue, 23 Jan 2024 16:46:59 +0000 (+0100) Subject: jiffies: Transform comment about time_* functions into DOC block X-Git-Url: http://git.maquefel.me/?a=commitdiff_plain;h=c92a7eb6c642812fb08851e580973c3b83e0227c;p=linux.git jiffies: Transform comment about time_* functions into DOC block This general note about time_* functions is also useful to be available in kernel documentation. Therefore transform it into a kernel-doc DOC block with proper formatting. Signed-off-by: Anna-Maria Behnsen Signed-off-by: Thomas Gleixner Link: https://lore.kernel.org/r/20240123164702.55612-6-anna-maria@linutronix.de --- diff --git a/include/linux/jiffies.h b/include/linux/jiffies.h index e0ae2a43e0ebd..d9f1435a5a13c 100644 --- a/include/linux/jiffies.h +++ b/include/linux/jiffies.h @@ -102,12 +102,15 @@ static inline u64 get_jiffies_64(void) } #endif -/* - * These inlines deal with timer wrapping correctly. You are - * strongly encouraged to use them: - * 1. Because people otherwise forget - * 2. Because if the timer wrap changes in future you won't have to - * alter your driver code. +/** + * DOC: General information about time_* inlines + * + * These inlines deal with timer wrapping correctly. You are strongly encouraged + * to use them: + * + * #. Because people otherwise forget + * #. Because if the timer wrap changes in future you won't have to alter your + * driver code. */ /**