time: Fix various kernel-doc problems
authorRandy Dunlap <rdunlap@infradead.org>
Tue, 3 Jan 2023 03:28:49 +0000 (19:28 -0800)
committerIngo Molnar <mingo@kernel.org>
Tue, 3 Jan 2023 10:07:58 +0000 (11:07 +0100)
commitf3cb80804b8295323919e031281768ba3bf5f8da
tree535b39105f10e545a7dc3ac8a5f4604521fe50af
parent69b41ac87e4a664de78a395ff97166f0b2943210
time: Fix various kernel-doc problems

Clean up kernel-doc complaints about function names and non-kernel-doc
comments in kernel/time/. Fixes these warnings:

  kernel/time/time.c:479: warning: expecting prototype for set_normalized_timespec(). Prototype was for set_normalized_timespec64() instead
  kernel/time/time.c:553: warning: expecting prototype for msecs_to_jiffies(). Prototype was for __msecs_to_jiffies() instead

  kernel/time/timekeeping.c:1595: warning: contents before sections
  kernel/time/timekeeping.c:1705: warning: This comment starts with '/**', but isn't a kernel-doc comment.
   * We have three kinds of time sources to use for sleep time
  kernel/time/timekeeping.c:1726: warning: This comment starts with '/**', but isn't a kernel-doc comment.
   * 1) can be determined whether to use or not only when doing

  kernel/time/tick-oneshot.c:21: warning: missing initial short description on line:
   * tick_program_event
  kernel/time/tick-oneshot.c:107: warning: expecting prototype for tick_check_oneshot_mode(). Prototype was for tick_oneshot_mode_active() instead

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Signed-off-by: Ingo Molnar <mingo@kernel.org>
Link: https://lore.kernel.org/r/20230103032849.12723-1-rdunlap@infradead.org
kernel/time/tick-oneshot.c
kernel/time/time.c
kernel/time/timekeeping.c