linux-kernel - Re: [PATCH v3 0/8] Improve support for building docs with Sphinx 3.1+

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Date:   Fri, 25 Sep 2020 09:31:58 +0200
From:   Mauro Carvalho Chehab <mchehab+huawei@...nel.org>
To:     Linux Doc Mailing List <linux-doc@...r.kernel.org>
Cc:     linux-kernel@...r.kernel.org, Jonathan Corbet <corbet@....net>,
        Niklas Söderlund 
        <niklas.soderlund+renesas@...natech.se>,
        Alexandre Courbot <acourbot@...omium.org>,
        Arnd Bergmann <arnd@...db.de>,
        Boris Brezillon <boris.brezillon@...labora.com>,
        Ezequiel Garcia <ezequiel@...labora.com>,
        Hans Verkuil <hverkuil-cisco@...all.nl>,
        Helen Koike <helen.koike@...labora.com>,
        Jacopo Mondi <jacopo@...ndi.org>,
        Jernej Skrabec <jernej.skrabec@...l.net>,
        Jian-Jia Su <jjsu@...omium.org>,
        Laurent Pinchart <laurent.pinchart@...asonboard.com>,
        Mauro Carvalho Chehab <mchehab@...nel.org>,
        Michael Tretter <m.tretter@...gutronix.de>,
        Paul Kocialkowski <paul.kocialkowski@...tlin.com>,
        Philipp Zabel <p.zabel@...gutronix.de>,
        Randy Dunlap <rdunlap@...radead.org>,
        Ricardo Ribalda <ribalda@...nel.org>,
        Sakari Ailus <sakari.ailus@...ux.intel.com>,
        Sean Young <sean@...s.org>,
        Sergey Senozhatsky <sergey.senozhatsky@...il.com>,
        Tomasz Figa <tfiga@...omium.org>, linux-media@...r.kernel.org
Subject: Re: [PATCH v3 0/8] Improve support for building docs with Sphinx
 3.1+

Em Fri, 25 Sep 2020 08:30:38 +0200
Mauro Carvalho Chehab <mchehab+huawei@...nel.org> escreveu:

> Sphinx 3.x new c domain code broke the doc build on several ways:
> 
> - it broke the cdomains.py extension that were giving namespace
>   support for C references;
> - it broke the automarkup script;
> - it broke c:type references that kernel-doc and other parts of the
>   kernel were using to do cross-references with C declarations.
> 
> This series address only part of those issues. It halves the number
> of warnings produced when Spinx 3.x is used.  Yet, we still
> have 1.7 K warnings.

At least some of the warnings seem to be due to some issues at
Sphinx 3.x. I opened an issue to Sphinx upstream:

	https://github.com/sphinx-doc/sphinx/issues/8241

Thanks,
Mauro