Re: [PATCH] docs: translations: pt_BR: translate programming-language.rst

From: Daniel Pereira

Date: Thu Oct 22 2026 - 08:25:05 EST


Em seg., 19 de out. de 2026 às 22:05, Gabriel Ribeiro
<ic.gabrielribeiro@xxxxxxxxx> escreveu:
>
> Translate the programming language guide and link it from the pt_BR
> process index.
>
> Assisted-by: LLM
> Signed-off-by: Gabriel Ribeiro <ic.gabrielribeiro@xxxxxxxxx>

The "Assisted-by:" tag is no longer necessary, so please drop it
in the next version.

I also have two small comments, both about labels that clash with
the original document and should trigger Sphinx "duplicate label"
warnings.

> +
> +.. _programming_language:

This label is already defined by
Documentation/process/programming-language.rst. The other pt_BR
documents use a "pt_BR_" prefix, so please rename it to:


> +O kernel Linux é escrito na linguagem de programação C [c-language]_.
> +Mais precisamente, o kernel costuma ser compilado com ``gcc`` [gcc]_
> +usando ``-std=gnu11`` [gcc-c-dialect-options]_, que seleciona o dialeto
> +GNU do padrão ISO C11. ``clang`` [clang]_ também é suportado; consulte
> +a documentação sobre
> +:ref:`Compilando o Linux com Clang/LLVM <kbuild_llvm>`.

> +Consulte Documentation/rust/index.rst para mais informações.
> +
> +.. [c-language] http://www.open-std.org/jtc1/sc22/wg14/www/standards
> +.. [gcc] https://gcc.gnu.org
> +.. [clang] https://clang.llvm.org
> +.. [gcc-c-dialect-options] https://gcc.gnu.org/onlinedocs/gcc/C-Dialect-Options.html
> +.. [gnu-extensions] https://gcc.gnu.org/onlinedocs/gcc/C-Extensions.html
> +.. [gcc-attribute-syntax] https://gcc.gnu.org/onlinedocs/gcc/Attribute-Syntax.html
> +.. [n2049] http://www.open-std.org/jtc1/sc22/wg14/www/docs/n2049.pdf
> +.. [rust-language] https://www.rust-lang.org
> +.. [rustc] https://doc.rust-lang.org/rustc/
> +.. [rust-editions] https://doc.rust-lang.org/edition-guide/editions/
> +.. [rust-unstable-features] https://github.com/Rust-for-Linux/linux/issues/2
> --

Citation labels are global in Sphinx, so these collide with the
ones in the English document as well. The other translations of
this file prefix them (it_IT uses [it-c-language], sp_SP uses
[sp-c-language], zh_TW uses [zh_tw_c-language]). Please do the
same for all eleven citations, e.g. [pt-c-language], and update
the references in the text accordingly ([pt-c-language]_, etc).

With those changes fixed, feel free to send a v2 (with a short
changelog below the "---" line)