Skip to contentSkip to conversation

docs: pt_BR: translate process/changes.rst

PATCH Superseded Daniel Pereira 2 participants 4 messages Feb 9 – Feb 23

Subsystems (2)
Documentation Portuguese (brazilian) translation

v3 of 5 Superseded Latest is v5 →

lore
Share & tools
lore

Daniel Pereira

author maintainer
#0 lore raw

PATCH v3 1/1 docs: pt_BR: translate process/changes.rst

Translate the Documentation/process/changes.rst file into Portuguese. This document provides the list of minimum software requirements necessary to compile and run the Linux kernel.

Signed-off-by Daniel Pereira <[email protected]>

---
Note: This patch depends on the previous work:
"[PATCH v5] docs: pt_BR: Add initial Portuguese translation" if the pt_BR translation directory is not yet present in the tree.

v3:
- Removed the ".. _changes:" label to avoid global namespace collisions.
- Updated reference in howto.rst to use :doc: syntax.

v2:
- Removed modifications to Documentation/translations/index.rst as requested by Jonathan Corbet.
- Reverted global index links to use standard :ref: syntax.

 Documentation/translations/pt_BR/index.rst    |   1 +
 .../translations/pt_BR/process/changes.rst    | 540 ++++++++++++++++++
 .../translations/pt_BR/process/howto.rst      |   2 +-
 3 files changed, 542 insertions(+), 1 deletion(-)
 create mode 100644 Documentation/translations/pt_BR/process/changes.rst
Documentation/translations/pt_BR/index.rst +1 -0
index 44fafb3c7..55f9f377e 100644
@@ -67,3 +67,4 @@ kernel e sobre como ver seu trabalho integrado.
    :maxdepth: 1
 
    Como começar <process/howto>
+   Requisitos mínimos <process/changes>
Documentation/translations/pt_BR/process/changes.rst new file +540 -0

540 lines not on this page · raw message

Documentation/translations/pt_BR/process/howto.rst +1 -1
index 8ed780aa1..e8ccee6b9 100644
@@ -99,7 +99,7 @@ que são de leitura obrigatória:
     o que é necessário fazer para configurar e compilar o kernel. Pessoas
     que são novas no kernel devem começar por aqui.
 
-  :ref:`Documentation/process/changes.rst <changes>`
+  :doc:`changes`
     Este arquivo fornece uma lista das versões mínimas de vários pacotes de
     software que são necessários para compilar e executar o kernel com
     sucesso.
Signature · 1 line
2.47.3
maintainer
#1 lore raw
Quoted 5 lines · Daniel Pereira

Translate the Documentation/process/changes.rst file into Portuguese. This document provides the list of minimum software requirements necessary to compile and run the Linux kernel.

Signed-off-by Daniel Pereira <[email protected]>
Quoted 8 lines

---
Note: This patch depends on the previous work:
"[PATCH v5] docs: pt_BR: Add initial Portuguese translation" if the pt_BR translation directory is not yet present in the tree.

v3:
- Removed the ".. _changes:" label to avoid global namespace collisions.
- Updated reference in howto.rst to use :doc: syntax.

Received.

Please slow down a little; sending multiple versions minutes apart is just a way to overwhelm reviewers and maintainers.

Thanks,

jon

maintainer
#2 lore raw
In reply to Daniel Pereira
Quoted 5 lines · Daniel Pereira

Translate the Documentation/process/changes.rst file into Portuguese. This document provides the list of minimum software requirements necessary to compile and run the Linux kernel.

Signed-off-by Daniel Pereira <[email protected]>

OK, this one needs a couple of fixes before I can apply it. One is that the lines are way long. Remember that we want the plain-text documentation to be readable, so please keep to the 80-column limit there.

The other one is here:

Documentation/translations/pt_BR/process/changes.rst line 367

Quoted 2 lines
Documentation/translations/pt_BR/process/changes.rst new file +2 -0
+Por favor, consulte :ref:`sphinx_install` em :ref:`Documentation/doc-guide/sphinx.rst` <sphinxdoc> para detalhes
+sobre os requisitos do Sphinx.

That creates a build warning:

Quoted 1 line

Documentation/translations/pt_BR/process/changes.rst:366: WARNING: undefined label: 'documentation/doc-guide/sphinx.rst' [ref.ref]

Don't use :ref: here, just say "Documentation/doc-guide/sphinx.rst' and the right thing will happen.

Yes, it looks like the original is wrong here too; I'll take care of that.

Thanks,

jon

author maintainer
#3 lore raw
Quoted 26 lines · Jonathan Corbet
Quoted 5 lines · Daniel Pereira

Translate the Documentation/process/changes.rst file into Portuguese. This document provides the list of minimum software requirements necessary to compile and run the Linux kernel.

Signed-off-by Daniel Pereira <[email protected]>

OK, this one needs a couple of fixes before I can apply it. One is that the lines are way long. Remember that we want the plain-text documentation to be readable, so please keep to the 80-column limit there.

The other one is here:

Documentation/translations/pt_BR/process/changes.rst line 367

Quoted 2 lines
Documentation/translations/pt_BR/process/changes.rst new file +2 -0
+Por favor, consulte :ref:`sphinx_install` em :ref:`Documentation/doc-guide/sphinx.rst` <sphinxdoc> para detalhes
+sobre os requisitos do Sphinx.

That creates a build warning:

Quoted 1 line

Documentation/translations/pt_BR/process/changes.rst:366: WARNING: undefined label: 'documentation/doc-guide/sphinx.rst' [ref.ref]

Don't use :ref: here, just say "Documentation/doc-guide/sphinx.rst' and the right thing will happen.

Quoted 6 lines

Yes, it looks like the original is wrong here too; I'll take care of that.

Thanks,

jon

Hi Jon,

Thank you for the review and for catching those issues.

I will fix the line lengths to stay within the 80-column limit and correct the reference as suggested to resolve the build warning. I'll send a v2 of the patch shortly with these adjustments.

Best regards,
Daniel Pereira