Messages in this thread Patch in this message | | | From | Alex Shi <> | Subject | [PATCH 5/6] timekeeping: add ts/tk explaination for kernel-doc | Date | Fri, 13 Nov 2020 15:24:34 +0800 |
| |
this patch fixed kernel-doc mark incorrection: kernel/time/timekeeping.c:1543: warning: Function parameter or member 'ts' not described in 'read_persistent_clock64' kernel/time/timekeeping.c:764: warning: Function parameter or member 'tk' not described in 'timekeeping_forward_now' kernel/time/timekeeping.c:1331: warning: Function parameter or member 'ts' not described in 'timekeeping_inject_offset' kernel/time/timekeeping.c:1331: warning: Excess function parameter 'tv' description in 'timekeeping_inject_offset'
Signed-off-by: Alex Shi <alex.shi@linux.alibaba.com> Cc: John Stultz <john.stultz@linaro.org> Cc: Thomas Gleixner <tglx@linutronix.de> Cc: Stephen Boyd <sboyd@kernel.org> Cc: linux-kernel@vger.kernel.org --- kernel/time/timekeeping.c | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-)
diff --git a/kernel/time/timekeeping.c b/kernel/time/timekeeping.c index 9bee13d94d70..08ab749a76fc 100644 --- a/kernel/time/timekeeping.c +++ b/kernel/time/timekeeping.c @@ -759,6 +759,7 @@ static void timekeeping_update(struct timekeeper *tk, unsigned int action) /** * timekeeping_forward_now - update clock to the current time + * @tk: pointer to time clock which will be correct. * * Forward the current clock to update its state since the last call to * update_wall_time(). This is useful before significant clock changes, @@ -1327,7 +1328,7 @@ EXPORT_SYMBOL(do_settimeofday64); /** * timekeeping_inject_offset - Adds or subtracts from the current time. - * @tv: pointer to the timespec variable containing the offset + * @ts: pointer to the timespec variable containing the offset * * Adds or subtracts an offset value from the current time. */ @@ -1536,6 +1537,7 @@ u64 timekeeping_max_deferment(void) /** * read_persistent_clock64 - Return time from the persistent clock. + * @ts: pointer to timespec to initialize. * * Weak dummy function for arches that do not yet support it. * Reads the time from the battery backed persistent clock. @@ -1640,6 +1642,7 @@ static struct timespec64 timekeeping_suspend_time; /** * __timekeeping_inject_sleeptime - Internal function to add sleep interval + * @tk: pointer to a timekeeper to be updated * @delta: pointer to a timespec delta value * * Takes a timespec offset measuring a suspend interval and properly -- 2.29.GIT
| |