Re: [PATCH 00/30] docs: fix documentation build parsing errors

From: Mauro Carvalho Chehab
Date: Fri Sep 11 2020 - 01:50:54 EST

Em Thu, 10 Sep 2020 10:42:50 -0600
Jonathan Corbet <corbet@xxxxxxx> escreveu:

> On Wed, 9 Sep 2020 16:10:31 +0200
> Mauro Carvalho Chehab <mchehab+huawei@xxxxxxxxxx> wrote:
> > Currently, there are several warnings/errors produced when building
> > the documentation with "make htmldocs".
> >
> > This series fixes almost all such errors. It is produced against
> > linux-next, branch next-20200909.
> >
> > Some of the patches here were already sent individually, but nobody
> > picked them. So, I'm re-sending the full series.
> I'd sure love to just apply the whole series and clean up a lot of this
> stuff, but (1) I'm not entirely comfortable taking a few through
> docs-next, and (2) some of them don't apply even if I catch up to -rc4.
> So I'm going to pass through them individually and snag as many as I can...

Yeah. As I commented on the other series, as warnings reach upstream
from different trees, the only sane way to fix them is by using linux-next.

I'll keep rebase those. This way, if something ends being lost, we could
submit upstream by the end of the merge window.

Btw, as Andrii gently submitted a fix for the two remaining litmus doc
warnings, once everything gets merged, htmldocs should now produce
zero doc warnings.

I'll keep track on this. Hopefully, we can make 5.10 free of doc warnings,
and build robots can start warning about newly introduced ones.