maintainer updates for jan '25 (semihosting, gdb, plugins, docs) pre-PR

[PATCH v2 31/37] docs/sphinx: include kernel-doc script as a dependency

Posted by Alex Bennée 2 months, 3 weeks ago

When we update the script we should rebuild the docs. Otherwise
breaking changes made to the kdoc script don't become apparent until
later.

Signed-off-by: Alex Bennée <alex.bennee@linaro.org>
---
 docs/sphinx/depfile.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/sphinx/depfile.py b/docs/sphinx/depfile.py
index e74be6af98..d3c774d28b 100644
--- a/docs/sphinx/depfile.py
+++ b/docs/sphinx/depfile.py
@@ -31,6 +31,9 @@ def get_infiles(env):
         for path in Path(static_path).rglob('*'):
             yield str(path)
 
+    # also include kdoc script
+    yield str(env.config.kerneldoc_bin[1])
+
 
 def write_depfile(app, exception):
     if exception:
-- 
2.39.5

Re: [PATCH v2 31/37] docs/sphinx: include kernel-doc script as a dependency

Posted by Pierrick Bouvier 2 months, 3 weeks ago

On 1/14/25 03:38, Alex Bennée wrote:
> When we update the script we should rebuild the docs. Otherwise
> breaking changes made to the kdoc script don't become apparent until
> later.
> 
> Signed-off-by: Alex Bennée <alex.bennee@linaro.org>
> ---
>   docs/sphinx/depfile.py | 3 +++
>   1 file changed, 3 insertions(+)
> 
> diff --git a/docs/sphinx/depfile.py b/docs/sphinx/depfile.py
> index e74be6af98..d3c774d28b 100644
> --- a/docs/sphinx/depfile.py
> +++ b/docs/sphinx/depfile.py
> @@ -31,6 +31,9 @@ def get_infiles(env):
>           for path in Path(static_path).rglob('*'):
>               yield str(path)
>   
> +    # also include kdoc script
> +    yield str(env.config.kerneldoc_bin[1])
> +
>   
>   def write_depfile(app, exception):
>       if exception:

Reviewed-by: Pierrick Bouvier <pierrick.bouvier@linaro.org>