[PATCH for-10.2 8/8] MAINTAINERS: Put kernel-doc under the "docs build machinery" section

Peter Maydell posted 8 patches 3 months ago
[PATCH for-10.2 8/8] MAINTAINERS: Put kernel-doc under the "docs build machinery" section
Posted by Peter Maydell 3 months ago
We never had a MAINTAINERS entry for the old kernel-doc script; add
the files for the new Python kernel-doc under "Sphinx documentation
configuration and build machinery", as the most appropriate
subsection.

Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
---
 MAINTAINERS | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/MAINTAINERS b/MAINTAINERS
index a07086ed762..efa59ce7c36 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -4436,6 +4436,8 @@ F: docs/sphinx/
 F: docs/_templates/
 F: docs/devel/docs.rst
 F: docs/devel/qapi-domain.rst
+F: scripts/kernel-doc
+F: scripts/lib/kdoc/
 
 Rust build system integration
 M: Manos Pitsidianakis <manos.pitsidianakis@linaro.org>
-- 
2.43.0
Re: [PATCH for-10.2 8/8] MAINTAINERS: Put kernel-doc under the "docs build machinery" section
Posted by Mauro Carvalho Chehab 3 months ago
Em Thu, 14 Aug 2025 18:13:23 +0100
Peter Maydell <peter.maydell@linaro.org> escreveu:

> We never had a MAINTAINERS entry for the old kernel-doc script; add
> the files for the new Python kernel-doc under "Sphinx documentation
> configuration and build machinery", as the most appropriate
> subsection.
> 
> Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
> ---
>  MAINTAINERS | 2 ++
>  1 file changed, 2 insertions(+)
> 
> diff --git a/MAINTAINERS b/MAINTAINERS
> index a07086ed762..efa59ce7c36 100644
> --- a/MAINTAINERS
> +++ b/MAINTAINERS
> @@ -4436,6 +4436,8 @@ F: docs/sphinx/
>  F: docs/_templates/
>  F: docs/devel/docs.rst
>  F: docs/devel/qapi-domain.rst
> +F: scripts/kernel-doc
> +F: scripts/lib/kdoc/

If you want, feel free to add me there either as maintainer or
reviewer. I can gladly help you maintaining it.

Either way:

Reviewed-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>

-

PS.: On a side note, there is a RFC still under discussion about
moving the script location upstream to tools/docs. Nothing decided
yet. One of the points we're still unsure is where we would place
the library directory. So, this may end being slipping to the next
kernel cycle.


>  
>  Rust build system integration
>  M: Manos Pitsidianakis <manos.pitsidianakis@linaro.org>



Thanks,
Mauro
Re: [PATCH for-10.2 8/8] MAINTAINERS: Put kernel-doc under the "docs build machinery" section
Posted by Peter Maydell 2 months, 2 weeks ago
On Fri, 15 Aug 2025 at 11:40, Mauro Carvalho Chehab
<mchehab+huawei@kernel.org> wrote:
>
> Em Thu, 14 Aug 2025 18:13:23 +0100
> Peter Maydell <peter.maydell@linaro.org> escreveu:
>
> > We never had a MAINTAINERS entry for the old kernel-doc script; add
> > the files for the new Python kernel-doc under "Sphinx documentation
> > configuration and build machinery", as the most appropriate
> > subsection.
> >
> > Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
> > ---
> >  MAINTAINERS | 2 ++
> >  1 file changed, 2 insertions(+)
> >
> > diff --git a/MAINTAINERS b/MAINTAINERS
> > index a07086ed762..efa59ce7c36 100644
> > --- a/MAINTAINERS
> > +++ b/MAINTAINERS
> > @@ -4436,6 +4436,8 @@ F: docs/sphinx/
> >  F: docs/_templates/
> >  F: docs/devel/docs.rst
> >  F: docs/devel/qapi-domain.rst
> > +F: scripts/kernel-doc
> > +F: scripts/lib/kdoc/
>
> If you want, feel free to add me there either as maintainer or
> reviewer. I can gladly help you maintaining it.

Thanks, that would be very helpful. I've added you as a line to
this "Sphinx documentation configuration and build machinery"
section:
M: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>

(and since this whole series is now reviewed I'll take
it via target-arm.next with that tweak.)

-- PMM