docs: pt_BR: Add initial Portuguese translation

Introduce the initial Portuguese (Brazilian) translation for the Linux kernel documentation (HOWTO document). It establishes the directory structure for the pt_BR locale and adds the official entry for the pt_BR maintainer in the MAINTAINERS file.

Additionally, this version adds pt_BR support to the documentation build script (Documentation/sphinx/translations.py) to ensure proper rendering and fixes the documentation hierarchy to avoid orphan file warnings.

---
v5:
- Final cleanup of the MAINTAINERS entry for proper formatting (TABS).
- Synchronized all changes into a clean branch structure (v5-final-clean).
v4:
- Removed unnecessary labels in all RST files as requested by Jon Corbet.
- Fixed alphabetical order in Documentation/translations/index.rst.
- Included the disclaimer in the documentation hierarchy to avoid orphan warnings.
- Added pt_BR support to Documentation/sphinx/translations.py.
- Updated MAINTAINERS and Signed-off-by with full name.
v3:
- Fixed alphabetical order in MAINTAINERS file.
- Removed trailing whitespaces in RST files.
- Fixed indentation in Documentation/translations/index.rst.
v2:
- Included pt_BR/index in the main translations index.
v1:
- Initial submission.

---
 Documentation/sphinx/translations.py          |   1 +
 Documentation/translations/index.rst          |   4 +-
 .../translations/pt_BR/disclaimer-pt_BR.rst   |  11 +
 Documentation/translations/pt_BR/index.rst    |  69 ++
 .../translations/pt_BR/process/howto.rst      | 637 ++++++++++++++++++
 MAINTAINERS                                   |   6 +
 6 files changed, 726 insertions(+), 2 deletions(-)
 create mode 100644 Documentation/translations/pt_BR/disclaimer-pt_BR.rst
 create mode 100644 Documentation/translations/pt_BR/index.rst
 create mode 100644 Documentation/translations/pt_BR/process/howto.rst

index 32c2b32b2..a03d4402b 100644
@@ -25,6 +25,7 @@ all_languages = {
     'it_IT': 'Italian',
     'ja_JP': 'Japanese',
     'ko_KR': 'Korean',
+    'pt_BR': 'Portuguese (Brazilian)',
     'sp_SP': 'Spanish',
 }
 

index b826c3479..b6d24f6f1 100644
@@ -10,11 +10,11 @@ Translations
    zh_CN/index
    zh_TW/index
    it_IT/index
-   ko_KR/index
    ja_JP/index
+   ko_KR/index
+   pt_BR/index
    sp_SP/index
 
-
 .. _translations_disclaimer:
 
 Disclaimer

new file mode 100644
index 000000000..3cae22c13
@@ -0,0 +1,11 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+
+
+Aviso sobre traduções para português
+====================================
+
+Esta documentação foi traduzida para português brasileiro por voluntários.
+Em caso de qualquer divergência entre esta tradução e o documento original
+em inglês, a versão em inglês (encontrada no diretório Documentation/)
+deve ser considerada a única fonte de verdade.

index 0efa8cc67..84428a6c7 100644
@@ -20760,6 +20760,12 @@ S:	Maintained
 F:	drivers/pnp/
 F:	include/linux/pnp.h
 
+PORTUGUESE (BRAZILIAN) TRANSLATION
+M:	Daniel Pereira <[email protected]>
+L:	[email protected]
+S:	Maintained
+F:	Documentation/translations/pt_BR/
+
 PORTWELL EC DRIVER
 M:	Yen-Chi Huang <[email protected]>
 L:	[email protected]

2.47.3

Thanks.

~Randy

The merge window starts tomorrow and closes in two weeks; new material will be applied after that. There's nothing more you need to do.

Thanks,

jon

The merge window has passed, the floodgates are opened, and I have applied this as the first 7.1-destined docs patch. All looks good, thanks for your patience; I'm sorry that the timing worked out so poorly.

jon

Hi Jon,

Thank you for applying the patch as the first 7.1-destined docs patch! I'm very glad to see the pt_BR structure landing in the mainline.

I appreciate your patience and guidance despite the timing of the merge window. Regarding the next steps, once the "[PATCH] docs: pt_BR:
translate process/changes.rst" is included, I will continue with the translations, as these documents are the foundation for all our future contributions and help establish the standard for the Brazilian community.

Best regards,
Daniel Pereira

I did speak just a bit too soon. Your new document included a label at the top:

That duplicates the label in the English version, leading to a build warning:

Bizarrely, this warning doesn't show up until something else is applied later; I'm mystified and will have to track that one down later.

The normal practice when dealing with labels of this type in translations is to add the language code at the beginning - to make it "_pt_process_howto" instead. I have taken the liberty of just applying that fix this time around.

Thanks,

jon