Messages in this thread |  | | Date | Mon, 4 May 2026 22:26:37 +0200 | | From | Mauro Carvalho Chehab <> | | Subject | Re: [PATCH 8/9] docs: maintainers_include: don't ignore invalid profile entries |
| |
On Mon, 4 May 2026 18:08:06 +0200 Miguel Ojeda <miguel.ojeda.sandonis@gmail.com> wrote:
> On Mon, May 4, 2026 at 5:51 PM Mauro Carvalho Chehab > <mchehab+huawei@kernel.org> wrote: > > > > Currently, there is a "P" entry for Rust pin-point that is > > neither a valid ReST file nor an hyperlink. While the real > > I guess you mean pin-init above, i.e. this entry: > > P: rust/pin-init/CONTRIBUTING.md > > It would be nice to clarify it in the commit message that it refers to > a file (which is allowed for `P:` entries according to the docs).
It is not written there, but by file, it would actually be expected a file within Documentation in ReST format ;-)
> And, yeah, ideally we could make it a hyperlink to the raw file.
I'm afraid that this is not possible. Sphinx doesn't allow hyperlinks to point to files outside the documentation root (which is Documentation/ when SPHINXDIRS is not used).
IMO the best would be to run:
pandoc -i rust/pin-init/CONTRIBUTING.md -t rst -o Documentation/rust/pin-init-profile.rst sed s,rust/pin-init/CONTRIBUTING.md,Documentation/rust/pin-init-profile.rst, -i MAINTAINERS
This way, it will generate a proper hyperlink.
Thanks, Mauro
|  |