Le Thu, 28 Aug 2025 18:50:37 +0200, Kory Maincent <kory.maincent@xxxxxxxxxxx> a écrit : > Le Mon, 28 Jul 2025 18:01:59 +0200, > Mauro Carvalho Chehab <mchehab+huawei@xxxxxxxxxx> a écrit : > > > Instead of manually calling ynl_gen_rst.py, use a Sphinx extension. > > This way, no .rst files would be written to the Kernel source > > directories. > > > > We are using here a toctree with :glob: property. This way, there > > is no need to touch the netlink/specs/index.rst file every time > > a new Netlink spec is added/renamed/removed. > > ... > > > diff --git a/Documentation/networking/index.rst > > b/Documentation/networking/index.rst index ac90b82f3ce9..b7a4969e9bc9 100644 > > --- a/Documentation/networking/index.rst > > +++ b/Documentation/networking/index.rst > > @@ -57,7 +57,7 @@ Contents: > > filter > > generic-hdlc > > generic_netlink > > - netlink_spec/index > > + ../netlink/specs/index > > Faced a doc build warning that say netlink_spec/index.rst is not used. > > $ git grep netlink_spec > Documentation/networking/mptcp.rst:netlink_spec/mptcp_pm.rst. > Documentation/translations/zh_CN/networking/index.rst:* netlink_spec/index > > I think we can remove the whole directory and change these, right? Oops just saw that is was some local leftover. This first warning get removed with a clean tree. > Also got a doc build warning that says netlink/specs/index is not existing > even if it exists. Maybe a sphinx parsing issue ?! > > Regards, -- Köry Maincent, Bootlin Embedded Linux and kernel engineering https://bootlin.com
