Em Fri, 28 Jun 2019 05:39:25 -0700 Joe Perches <joe@xxxxxxxxxxx> escreveu: > On Fri, 2019-06-28 at 09:12 -0300, Mauro Carvalho Chehab wrote: > > That gets rid of this warning: > > > > ./kernel/time/hrtimer.c:1119: WARNING: Block quote ends without a blank line; unexpected unindent. > > > > and displays nicely both at the source code and at the produced > > documentation. > > > > Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@xxxxxxxxxx> > > --- > > kernel/time/hrtimer.c | 7 ++++--- > > 1 file changed, 4 insertions(+), 3 deletions(-) > > > > diff --git a/kernel/time/hrtimer.c b/kernel/time/hrtimer.c > > index edb230aba3d1..5ee77f1a8a92 100644 > > --- 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 > > I think this last line should be indented 3 more spaces too That would produce a warning, and will change the font for the content of the first line to bold. ReST is pedantic with whitespaces, as it uses it to identify continuation lines. For it to consider one line as a continuation of the previous one, the texts on both lines (after markups) should start at the same place. So, on: * foo bar "bar" is considered a continuation of the first line. So, identical to: * foo bar But: * foo bar foobar the whitespace doesn't match. it will change the font for the first line to bold, and place foobar on a separate line. (yeah, I know that, for kernel-doc, this sucks) Thanks, Mauro
