linux-kernel - Re: [PATCH RFC 00/11] use toctree :caption: for ToC headings

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] [day] [month] [year] [list]

Message-ID: <87ttpk87m3.fsf@meer.lwn.net>
Date:   Fri, 17 Nov 2023 13:09:24 -0700
From:   Jonathan Corbet <corbet@....net>
To:     Vegard Nossum <vegard.nossum@...cle.com>,
        linux-doc@...r.kernel.org,
        Mauro Carvalho Chehab <mchehab@...nel.org>
Cc:     Jani Nikula <jani.nikula@...el.com>, linux-kernel@...r.kernel.org,
        Vegard Nossum <vegard.nossum@...cle.com>,
        Alex Shi <alexs@...nel.org>, Armin Wolf <W_Armin@....de>,
        Dmitry Torokhov <dmitry.torokhov@...il.com>,
        Fangrui Song <maskray@...gle.com>,
        Federico Vaga <federico.vaga@...a.pv.it>,
        gaochao <gaochao49@...wei.com>,
        Greg Kroah-Hartman <gregkh@...uxfoundation.org>,
        Hans de Goede <hdegoede@...hat.com>,
        Hu Haowen <src.res.211@...il.com>,
        Iwona Winiarska <iwona.winiarska@...el.com>,
        Julien Panis <jpanis@...libre.com>,
        Ricardo Cañuelo <ricardo.canuelo@...labora.com>,
        Richard Cochran <richardcochran@...il.com>,
        Rui Li <me@...ui.org>, SeongJae Park <sj@...nel.org>,
        Stephan Mueller <smueller@...onox.de>,
        Tomas Winkler <tomas.winkler@...el.com>,
        Wan Jiabing <wanjiabing@...o.com>,
        Wu XiangCheng <bobwxc@...il.cn>,
        Yanteng Si <siyanteng@...ngson.cn>
Subject: Re: [PATCH RFC 00/11] use toctree :caption: for ToC headings

Vegard Nossum <vegard.nossum@...cle.com> writes:

> Hi,
>
> This patch series replaces some instances of 'class:: toc-title' with
> toctree's :caption: attribute, see the last patch in the series for
> some more rationale/explanation.
>
> There are some dependencies here: the first patch is necessary for the
> headings in following patches to be styled correctly with the alabaster
> theme (rtd_sphinx already has it), and the last patch depends on most
> of the previous patches to not use the old .toc-title class anymore.
>
> Assuming people agree with the general direction, I thought maybe the
> easiest thing would be to collect maintainer acks in this round and
> then for me to resubmit everything to the documentation tree/maintainer
> in one go.

Easiest thing seems to be for me to just apply it, so I've done that.
It would have been a bit easier if you'd worked against a recent
docs-next, but so it goes...

Thanks,

jon