Re: [PATCH] doc:it_IT: align doc-guide translation

Jonathan Corbet <[email protected]> Mon, 03 Aug 2026 12:36:40 -0600
Newsgroups org.kernel.vger.linux-doc,org.kernel.vger.linux-kernel
Message-ID <[email protected]>
Federico Vaga <[email protected]> writes:

> Update the Italian translation of Documentation/doc-guide to catch up
> with the following upstream commits:
>
> doc-guide/index.rst:
>   commit a592a36e4937 ("Documentation: use a source-read extension for the index link boilerplate")
>   commit d40981350844 ("doc-guide: add help documentation checktransupdate.rst")
>
> doc-guide/sphinx.rst:
>   commit f1c2db1f145b ("docs: move test_doc_build.py to tools/docs")
>   commit abd61d1ff8f0 ("scripts: sphinx-pre-install: move it to tools/docs")
>   commit 9322af5e6557 ("docs: sphinx: add a file with the requirements for lowest version")
>   commit d6d886005d32 ("Docs: doc-guide: update sphinx.rst Sphinx version number")
>   commit 5ccab49c104c ("docs: doc-guide: clarify latest theme usage")
>   commit b31274d58d21 ("docs: drop the version constraints for sphinx and dependencies")
>   commit 40be2369dc0e ("Documentation: multiple .rst files: Fix grammar and more consistent formatting")
>   commit 3e893e16af55 ("docs: Raise the minimum Sphinx requirement to 2.4.4")
>   commit 86b17aaf2e88 ("docs: automarkup: linkify git revs")
>   commit 35d4a3c67eb5 ("docs/doc-guide: Clarify how to write tables")
>   commit 26d797ffc1c0 ("docs: update sphinx.rst to reflect the default theme change")
>   commit 679b4bc25fc7 ("docs/doc-guide: Add documentation on SPHINX_IMGMATH")
>   commit 4d627ef12b40 ("docs/doc-guide: Mention make variable SPHINXDIRS")
>   commit 7c43214dddfd ("docs/doc-guide: Add footnote on Inkscape for better images in PDF documents")
>
> doc-guide/kernel-doc.rst:
>   commit 827b9458c933 ("docs: kernel-doc.rst: document private: scope propagation")
>   commit eba6ffd126cd ("docs: kdoc: move kernel-doc to tools/docs")
>   commit 90f1d896d59f ("doc-guide: kernel-doc: specify that W=n does not check header files")
>   commit b580fa304c85 ("docs: kernel-doc.rst: document the new "var" kernel-doc markup")
>   commit 8deb5d725b48 ("docs: kernel-doc.rst: don't let automarkup mangle with consts")
>   commit dd3e817e879c ("doc-guide: kernel-doc: add %CONST examples")
>   commit 7e8a8143ecc3 ("docs: add support to build manpages from kerneldoc output")
>   commit 9e6c5870bb44 ("Documentation: kernel-doc: enumerate identifier *type*s")
>   commit 23a0bc285159 ("doc-guide: kernel-doc: document Returns: spelling")
>
> doc-guide/parse-headers.rst:
>   commit 6ae0f2072768 ("docs: parse-headers.rst: Fix a typo")
>   commit 68f3d40ea0ce ("docs: parse-headers.rst: remove uneeded parenthesis")
>   commit d69a03a97a2d ("docs: doc-guide: parse-headers.rst update its documentation")
>
> Also add the translations for the following pages, which had none:
>
> doc-guide/contributing.rst:
>   commit d96574b0b49d ("Add a document on how to contri
>
> doc-guide/maintainer-profile.rst:
>   commit 53b7f3aa411b ("Add a maintainer entry profile for documentation")
>
> doc-guide/checktransupdate.rst:
>   commit d40981350844 ("doc-guide: add help documentation checktransupdate.rst")
>
> Signed-off-by: Federico Vaga <[email protected]>
> ---
>  .../it_IT/doc-guide/checktransupdate.rst      |  59 ++++
>  .../it_IT/doc-guide/contributing.rst          | 319 ++++++++++++++++++
>  .../translations/it_IT/doc-guide/index.rst    |  13 +-
>  .../it_IT/doc-guide/kernel-doc.rst            |  88 +++--
>  .../it_IT/doc-guide/maintainer-profile.rst    |  60 ++++
>  .../it_IT/doc-guide/parse-headers.rst         | 220 ++++++------
>  .../translations/it_IT/doc-guide/sphinx.rst   | 178 +++++++---
>  7 files changed, 757 insertions(+), 180 deletions(-)
>  create mode 100644 Documentation/translations/it_IT/doc-guide/checktransupdate.rst
>  create mode 100644 Documentation/translations/it_IT/doc-guide/contributing.rst
>  create mode 100644 Documentation/translations/it_IT/doc-guide/maintainer-profile.rst

Applied, thanks.

jon