On Thu, 2019-06-27 at 14:46 -0700, tip-bot for Mauro Carvalho Chehab wrote: > Commit-ID: 516337048fa40496ae5ca9863c367ec991a44d9a > Gitweb: https://git.kernel.org/tip/516337048fa40496ae5ca9863c367ec991a44d9a > Author: Mauro Carvalho Chehab <mchehab+samsung@xxxxxxxxxx> > AuthorDate: Mon, 24 Jun 2019 07:33:26 -0300 > Committer: Thomas Gleixner <tglx@xxxxxxxxxxxxx> > CommitDate: Thu, 27 Jun 2019 23:30:04 +0200 > > hrtimer: Use a bullet for the returns bullet list > > That gets rid of this warning: > > ./kernel/time/hrtimer.c:1119: WARNING: Block quote ends without a blank line; unexpected unindent. Doesn't this form occur multiple dozens of times in kernel sources? For instance: $ git grep -B3 -A5 -P "^ \* Returns:?$" | \ grep -P -A8 '\-\s+\*\s*@\w+:' I think the warning is odd at best and docutils might be updated or the warning ignored or suppressed. > and displays nicely both at the source code and at the produced > documentation. > diff --git a/kernel/time/hrtimer.c b/kernel/time/hrtimer.c [] > @@ -1114,9 +1114,10 @@ EXPORT_SYMBOL_GPL(hrtimer_start_range_ns); > * @timer: hrtimer to stop > * > * Returns: > - * 0 when the timer was not active > - * 1 when the timer was active > - * -1 when the timer is currently executing the callback function and > + * > + * * 0 when the timer was not active > + * * 1 when the timer was active > + * * -1 when the timer is currently executing the callback function and > * cannot be stopped > */ > int hrtimer_try_to_cancel(struct hrtimer *timer)
