From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752437AbdLKW4x (ORCPT ); Mon, 11 Dec 2017 17:56:53 -0500 Received: from ms.lwn.net ([45.79.88.28]:56026 "EHLO ms.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751612AbdLKW4w (ORCPT ); Mon, 11 Dec 2017 17:56:52 -0500 Date: Mon, 11 Dec 2017 15:56:51 -0700 From: Jonathan Corbet To: Ingo Molnar , Peter Zijlstra Cc: LKML , Al Viro Subject: sched: Update kerneldoc for sched_rr_get_interval() Message-ID: <20171211155651.7b098034@lwn.net> Organization: LWN.net MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Commit abca5fc535a3e ("sched_rr_get_interval(): move compat to native, get rid of set_fs()") changed the prototype of that function but left the kerneldoc comments unchanged, leading to these docs-build warnings: ./kernel/sched/core.c:5113: warning: No description found for parameter 't' ./kernel/sched/core.c:5113: warning: Excess function parameter 'interval' description in 'sched_rr_get_interval' Update the documentation (noting that it's not a user-space address anymore) and make the docs build a little quieter. Signed-off-by: Jonathan Corbet --- kernel/sched/core.c | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/kernel/sched/core.c b/kernel/sched/core.c index 75554f366fd3..a6e9edb55333 100644 --- a/kernel/sched/core.c +++ b/kernel/sched/core.c @@ -5100,12 +5100,12 @@ SYSCALL_DEFINE1(sched_get_priority_min, int, policy) /** * sys_sched_rr_get_interval - return the default timeslice of a process. * @pid: pid of the process. - * @interval: userspace pointer to the timeslice value. + * @t: pointer to the timeslice value. * * this syscall writes the default timeslice value of a given process - * into the user-space timespec buffer. A value of '0' means infinity. + * into the timespec64 buffer. A value of '0' means infinity. * - * Return: On success, 0 and the timeslice is in @interval. Otherwise, + * Return: On success, 0 and the timeslice is in @t. Otherwise, * an error code. */ static int sched_rr_get_interval(pid_t pid, struct timespec64 *t) -- 2.14.3