Received-SPF: pass (google.com: domain of linux-kernel+bounces-126919-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) client-ip=2604:1380:45e3:2400::1;
Precedence: bulk
MIME-Version: 1.0
References: <20240331172652.14086-1-rdunlap@infradead.org> <20240331172652.14086-5-rdunlap@infradead.org>
In-Reply-To: <20240331172652.14086-5-rdunlap@infradead.org>
From: John Stultz <jstultz@google.com>
Date: Mon, 1 Apr 2024 10:45:36 -0700
Message-ID: <CANDhNCppHJVPLhMyDE3mRAKBtp7=56bodLAnbwH=g15=sbWxbQ@mail.gmail.com>
Subject: Re: [PATCH 4/6] tick/sched: fix various kernel-doc warnings
To: Randy Dunlap <rdunlap@infradead.org>
Cc: linux-kernel@vger.kernel.org, 
	Anna-Maria Behnsen <anna-maria@linutronix.de>, Frederic Weisbecker <frederic@kernel.org>, 
	Thomas Gleixner <tglx@linutronix.de>, Stephen Boyd <sboyd@kernel.org>, Ingo Molnar <mingo@kernel.org>
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

On Sun, Mar 31, 2024 at 10:26=E2=80=AFAM Randy Dunlap <rdunlap@infradead.or=
g> wrote:
>
> Fix a slew of kernel-doc warnings in tick-sched.c:
>
> tick-sched.c:650: warning: Function parameter or struct member 'now' not =
described in 'tick_nohz_update_jiffies'
> tick-sched.c:741: warning: No description found for return value of 'get_=
cpu_idle_time_us'
> tick-sched.c:767: warning: No description found for return value of 'get_=
cpu_iowait_time_us'
> tick-sched.c:1210: warning: No description found for return value of 'tic=
k_nohz_idle_got_tick'
> tick-sched.c:1228: warning: No description found for return value of 'tic=
k_nohz_get_next_hrtimer'
> tick-sched.c:1243: warning: No description found for return value of 'tic=
k_nohz_get_sleep_length'
> tick-sched.c:1282: warning: Function parameter or struct member 'cpu' not=
 described in 'tick_nohz_get_idle_calls_cpu'
> tick-sched.c:1282: warning: No description found for return value of 'tic=
k_nohz_get_idle_calls_cpu'
> tick-sched.c:1294: warning: No description found for return value of 'tic=
k_nohz_get_idle_calls'
> tick-sched.c:1577: warning: Function parameter or struct member 'hrtimer'=
 not described in 'tick_setup_sched_timer'
> tick-sched.c:1577: warning: Excess function parameter 'mode' description =
in 'tick_setup_sched_timer'
>
> Signed-off-by: Randy Dunlap <rdunlap@infradead.org>

Acked-by: John Stultz <jstultz@google.com>