Re: [PATCH 0/9] docs: Fix various build warnings/errors

From: Tobin C. Harding
Date: Fri Mar 08 2019 - 15:16:31 EST


On Fri, Mar 08, 2019 at 09:40:03AM +0100, Markus Heiser wrote:
>
> Am 07.03.19 um 22:11 schrieb Tobin C. Harding:
> > Hi,
> >
> > I had a few hours to spare so I thought I'd clear some Sphinx build
> > warnings/errors. There isn't anything too controversial here. The only
> > interesting thing I hit was in patch 7 (docs: Remove unknown 'hint'
> > directive), I couldn't work out if this was a serious directive, a joke,
> > or a typo.
>
> Hi Tobin,
>
> the problem was a missing empty line (see my comment on this patch).
>
> The reST primer from sphinx-doc is always a good reference for the daily work
>
> http://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#directives

Thanks Marcus, that's actually how I came to the conclusion that they
should by asterisks.

http://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#lists-and-quote-like-blocks

Anyways, as usual LKML sorted me out :)

thanks,
Tobin.