24/06/2024 15:46, Juraj Linkeš:
> The tool used to generate DTS API docs is Sphinx, which is already in
> use in DPDK. The same configuration is used to preserve style with one
> DTS-specific configuration (so that the DPDK docs are unchanged) that
> modifies how the sidebar displays the content.
> 
> Sphinx generates the documentation from Python docstrings. The docstring
> format is the Google format [0] which requires the sphinx.ext.napoleon
> extension. The other extension, sphinx.ext.intersphinx, enables linking
> to object in external documentations, such as the Python documentation.
> 
> There are two requirements for building DTS docs:
> * The same Python version as DTS or higher, because Sphinx imports the
>   code.
> * Also the same Python packages as DTS, for the same reason.
> 
> [0] 
> https://google.github.io/styleguide/pyguide.html#38-comments-and-docstrings
> 
> Signed-off-by: Juraj Linkeš <juraj.lin...@pantheon.tech>
> Reviewed-by: Luca Vizzarro <luca.vizza...@arm.com>
> Reviewed-by: Jeremy Spewock <jspew...@iol.unh.edu>
> Tested-by: Luca Vizzarro <luca.vizza...@arm.com>
> Tested-by: Nicholas Pratte <npra...@iol.unh.edu>
> ---
>  buildtools/call-sphinx-build.py | 31 ++++++++++++++++++--------
>  doc/api/doxy-api-index.md       |  3 +++
>  doc/api/doxy-api.conf.in        |  2 ++
>  doc/api/meson.build             | 11 +++++++---
>  doc/guides/conf.py              | 39 ++++++++++++++++++++++++++++-----
>  doc/guides/meson.build          |  1 +
>  doc/guides/tools/dts.rst        | 34 +++++++++++++++++++++++++++-
>  dts/doc/meson.build             | 27 +++++++++++++++++++++++
>  dts/meson.build                 | 16 ++++++++++++++
>  meson.build                     |  1 +
>  10 files changed, 147 insertions(+), 18 deletions(-)
>  create mode 100644 dts/doc/meson.build
>  create mode 100644 dts/meson.build

There are unrelated changes in this patch.
Please I would prefer to have existing code changed in a separate patch,
so we have only DTS addition in the last patch.


Reply via email to