[PATCH] docs: translations: pt_BR: add debugging index

[PATCH] docs: translations: pt_BR: add debugging index

[Lucas Adryell Ramalho]

Add a Brazilian Portuguese index for process/debugging, mirroring the
section layout of the original. No debugging documents have been
translated yet, so every entry is listed under a Todolist marker
instead of a toctree.

Signed-off-by: Lucas Adryell Ramalho <lucasadramalho@gmail.com>
---
 .../pt_BR/process/debugging/index.rst         | 73 +++++++++++++++++++
 .../translations/pt_BR/process/index.rst      |  1 +
 2 files changed, 74 insertions(+)
 create mode 100644 Documentation/translations/pt_BR/process/debugging/index.rst

diff --git a/Documentation/translations/pt_BR/process/debugging/index.rst b/Documentation/translations/pt_BR/process/debugging/index.rst
new file mode 100644
index 000000000..b223fae34
--- /dev/null
+++ b/Documentation/translations/pt_BR/process/debugging/index.rst
@@ -0,0 +1,73 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+=======================================================
+Dicas de depuração para desenvolvedores do Kernel Linux
+=======================================================
+
+Guias gerais
+------------
+
+Todolist:
+
+*   driver_development_debugging_guide
+*   gdb-kernel-debugging
+*   kgdb
+*   userspace_debugging_guide
+
+Guias específicos de subsistemas
+--------------------------------
+
+Todolist:
+
+*   media_specific_debugging_guide
+
+Dicas gerais de depuração
+-------------------------
+
+Dependendo do problema, um conjunto diferente de ferramentas está disponível
+para rastrear o problema ou até mesmo para perceber se há algum problema em
+primeiro lugar.
+
+Como primeiro passo, você precisa descobrir que tipo de problema você deseja
+depurar. Dependendo da resposta, sua metodologia e escolha de ferramentas podem
+variar.
+
+Preciso depurar com acesso limitado?
+------------------------------------
+
+Você possui acesso limitado à máquina ou não consegue parar a execução em
+andamento?
+
+Nesse caso, sua capacidade de depuração depende do suporte de depuração
+embutido no kernel fornecido pela distribuição.
+O :doc:`/process/debugging/userspace_debugging_guide` fornece uma breve visão
+geral sobre uma variedade de ferramentas de depuração possíveis nessa situação.
+Você pode verificar a capacidade do seu kernel, na maioria dos casos, olhando o
+arquivo de configuração dentro do diretório /boot.
+
+Eu tenho acesso root ao sistema?
+--------------------------------
+
+Você consegue facilmente substituir o módulo em questão ou instalar um novo
+kernel?
+
+Nesse caso, sua gama de ferramentas disponíveis é muito maior. Você
+pode encontrar as ferramentas
+no :doc:`/process/debugging/driver_development_debugging_guide`.
+
+A temporização é um fator?
+--------------------------
+
+É importante entender se o problema que você deseja depurar se manifesta
+de forma consistente (ou seja, para um determinado conjunto de entradas, você
+sempre obtém a mesma saída incorreta) ou de forma inconsistente. Se ele se
+manifestar de forma inconsistente, algum fator de temporização pode estar em
+jogo. Se a inserção de atrasos no código alterar o comportamento, é bastante
+provável que a temporização seja um fator determinante.
+
+Quando a temporização altera o resultado da execução do código, o uso de um
+simples printk() para fins de depuração pode não funcionar; uma alternativa
+semelhante é usar trace_printk(), que registra as mensagens de depuração no
+arquivo de rastreamento, em vez de no log do kernel.
+
+**Copyright** ©2024 : Collabora
diff --git a/Documentation/translations/pt_BR/process/index.rst b/Documentation/translations/pt_BR/process/index.rst
index 2c63d82bf..13cedb9fa 100644
--- a/Documentation/translations/pt_BR/process/index.rst
+++ b/Documentation/translations/pt_BR/process/index.rst
@@ -77,6 +77,7 @@ gerenciamento de bugs e vulnerabilidades.
 .. toctree::
    :maxdepth: 1
 
+   Dicas de depuração para desenvolvedores do Kernel Linux <debugging/index>
    Falhas de segurança <security-bugs>
    Problemas de hardware sob embargo <embargoed-hardware-issues>
    CVEs <cve>
-- 
2.55.0

Re: [PATCH] docs: translations: pt_BR: add debugging index

[Daniel Pereira]

Em sex., 18 de set. de 2026 às 01:28, Lucas Adryell Ramalho
<lucasadramalho@gmail.com> escreveu:
>
> Add a Brazilian Portuguese index for process/debugging, mirroring the
> section layout of the original. No debugging documents have been
> translated yet, so every entry is listed under a Todolist marker
> instead of a toctree.
>
> Signed-off-by: Lucas Adryell Ramalho <lucasadramalho@gmail.com>
> ---
>  .../pt_BR/process/debugging/index.rst         | 73 +++++++++++++++++++
>  .../translations/pt_BR/process/index.rst      |  1 +
>  2 files changed, 74 insertions(+)
>  create mode 100644 Documentation/translations/pt_BR/process/debugging/index.rst
>
Thanks, Lucas. The translation looks good to me.

Reviewed-by: Daniel Pereira <danielmaraboo@gmail.com>

Re: [PATCH] docs: translations: pt_BR: add debugging index

[Jonathan Corbet]

Lucas Adryell Ramalho <lucasadramalho@gmail.com> writes:

> Add a Brazilian Portuguese index for process/debugging, mirroring the
> section layout of the original. No debugging documents have been
> translated yet, so every entry is listed under a Todolist marker
> instead of a toctree.
>
> Signed-off-by: Lucas Adryell Ramalho <lucasadramalho@gmail.com>
> ---
>  .../pt_BR/process/debugging/index.rst         | 73 +++++++++++++++++++
>  .../translations/pt_BR/process/index.rst      |  1 +
>  2 files changed, 74 insertions(+)
>  create mode 100644 Documentation/translations/pt_BR/process/debugging/index.rst

Applied, thanks.

jon