python
diff --git a/‎c-api/stable.po
Lines changed: 110 additions & 12 deletions b/‎c-api/stable.po
Lines changed: 110 additions & 12 deletions
@@ -4,17 +4,16 @@
 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
 #
 # Translators:
-# Claudio Rogerio Carvalho Filho <excriptbrasil@gmail.com>, 2021
+# Rafael Fontenelle <rffontenelle@gmail.com>, 2023
 #
 #, fuzzy
 msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2023-09-01 14:13+0000\n"
+"POT-Creation-Date: 2023-12-01 14:14+0000\n"
 "PO-Revision-Date: 2021-06-28 00:50+0000\n"
-"Last-Translator: Claudio Rogerio Carvalho Filho <excriptbrasil@gmail.com>, "
-"2021\n"
+"Last-Translator: Rafael Fontenelle <rffontenelle@gmail.com>, 2023\n"
 "Language-Team: Portuguese (Brazil) (https://app.transifex.com/python-doc/"
 "teams/5390/pt_BR/)\n"
 "MIME-Version: 1.0\n"
@@ -26,7 +25,7 @@ msgstr ""
 
 #: ../../c-api/stable.rst:7
 msgid "C API Stability"
-msgstr ""
+msgstr "Estabilidade da API C"
 
 #: ../../c-api/stable.rst:9
 msgid ""
@@ -35,6 +34,11 @@ msgid ""
 "(typically by only adding new API). Changing existing API or removing API is "
 "only done after a deprecation period or to fix serious issues."
 msgstr ""
+"A menos que documentado de outra forma, a API C do Python é coberta pela "
+"Política de Compatibilidade com versões anteriores, :pep:`387`. A maioria "
+"das alterações são compatíveis com a fonte (normalmente adicionando apenas "
+"uma nova API). A alteração ou remoção da API existente só é feita após um "
+"período de descontinuação ou para corrigir problemas sérios."
 
 #: ../../c-api/stable.rst:15
 msgid ""
@@ -44,27 +48,39 @@ msgid ""
 "work on 3.10.8 and vice versa, but will need to be compiled separately for "
 "3.9.x and 3.10.x."
 msgstr ""
+"A Interface Binário de Aplicação (ABI) do CPython é compatível para frente e "
+"para trás através de uma versão menor (se elas forem compiladas da mesma "
+"maneira; veja :ref:`stable-abi-platform` abaixo). Portanto, o código "
+"compilado para Python 3.10.0 funcionará em 3.10.8 e vice-versa, mas "
+"precisará ser compilado separadamente para 3.9.x e 3.10.x."
 
 #: ../../c-api/stable.rst:21
 msgid "There are two tiers of C API with different stability expectations:"
 msgstr ""
+"Existem dois níveis de API C com diferentes expectativas de estabilidade:"
 
 #: ../../c-api/stable.rst:23
 msgid ""
 ":ref:`Unstable API <unstable-c-api>`, may change in minor versions without a "
 "deprecation period. It is marked by the ``PyUnstable`` prefix in names."
 msgstr ""
+":ref:`API Instável <unstable-c-api>` (\"Unstable API\"), pode mudar em "
+"versões menores sem período de depreciação. É marcado pelo prefixo "
+"``PyUnstable`` nos nomes."
 
 #: ../../c-api/stable.rst:25
 msgid ""
 ":ref:`Limited API <limited-c-api>`, is compatible across several minor "
 "releases. When :c:macro:`Py_LIMITED_API` is defined, only this subset is "
 "exposed from ``Python.h``."
 msgstr ""
+":ref:`API Limitada <limited-c-api>` (\"Limited API\"), é compatível em "
+"várias versões menores. Quando :c:macro:`Py_LIMITED_API` é definido, apenas "
+"este subconjunto é exposto de ``Python.h``."
 
 #: ../../c-api/stable.rst:29
 msgid "These are discussed in more detail below."
-msgstr ""
+msgstr "Elas são discutidas em mais detalhes abaixo."
 
 #: ../../c-api/stable.rst:31
 msgid ""
@@ -74,10 +90,15 @@ msgid ""
 "python.org/c/core-dev/c-api/30>`_ to discuss adding public API for your use "
 "case."
 msgstr ""
+"Nomes prefixados por um sublinhado, como ``_Py_InternalState``, são APIs "
+"privadas que podem ser alteradas sem aviso prévio, mesmo em lançamentos de "
+"correção. Se você precisa usar essa API, considere entrar em contato com os "
+"`desenvolvedores do CPython <https://discuss.python.org/c/core-dev/c-"
+"api/30>`_ para discutir a adição de uma API pública para o seu caso de uso."
 
 #: ../../c-api/stable.rst:40
 msgid "Unstable C API"
-msgstr ""
+msgstr "API C Instável"
 
 #: ../../c-api/stable.rst:44
 msgid ""
@@ -86,32 +107,43 @@ msgid ""
 "without any deprecation warnings. However, it will not change in a bugfix "
 "release (e.g. from 3.10.0 to 3.10.1)."
 msgstr ""
+"Qualquer API nomeada com o prefixo \"PyUnstable\" expõe detalhes de "
+"implementação do CPython e pode mudar em cada versão menor (por exemplo, de "
+"3.9 para 3.10) sem nenhum aviso de depreciação. No entanto, não mudará em "
+"uma versão de correção de bugs (por exemplo, de 3.10.0 para 3.10.1)."
 
 #: ../../c-api/stable.rst:49
 msgid ""
 "It is generally intended for specialized, low-level tools like debuggers."
 msgstr ""
+"É geralmente destinado a ferramentas especializadas de baixo nível, como "
+"depuradores."
 
 #: ../../c-api/stable.rst:51
 msgid ""
 "Projects that use this API are expected to follow CPython development and "
 "spend extra effort adjusting to changes."
 msgstr ""
+"Projetos que utilizam esta API são esperados para seguir o desenvolvimento "
+"do CPython e dedicar esforço extra para se ajustar às mudanças."
 
 #: ../../c-api/stable.rst:56
 msgid "Stable Application Binary Interface"
-msgstr "Interface binária de aplicativo estável"
+msgstr "Interface Binária de Aplicação Estável"
 
 #: ../../c-api/stable.rst:58
 msgid ""
 "For simplicity, this document talks about *extensions*, but the Limited API "
 "and Stable ABI work the same way for all uses of the API – for example, "
 "embedding Python."
 msgstr ""
+"Para simplificar, este documento fala sobre *extensões*, mas a API Limitada "
+"e a ABI Estável funcionam da mesma maneira para todos os usos da API -- por "
+"exemplo, embutir o Python."
 
 #: ../../c-api/stable.rst:65
 msgid "Limited C API"
-msgstr ""
+msgstr "API C Limitada"
 
 #: ../../c-api/stable.rst:67
 msgid ""
@@ -120,12 +152,18 @@ msgid ""
 "multiple versions of Python. Contents of the Limited API are :ref:`listed "
 "below <limited-api-list>`."
 msgstr ""
+"Python 3.2 introduziu a *API Limitada*, um subconjunto da API C do Python. "
+"Extensões que apenas usam o Limited API podem ser compiladas uma vez e "
+"funcionar com várias versões do Python. Os conteúdos da API Limitada estão :"
+"ref:`listados abaixo <limited-api-list>`."
 
 #: ../../c-api/stable.rst:74
 msgid ""
 "Define this macro before including ``Python.h`` to opt in to only use the "
 "Limited API, and to select the Limited API version."
 msgstr ""
+"Defina essa macro antes de incluir ``Python.h`` para optar por usar apenas a "
+"API Limitada e selecionar a versão da API Limitada."
 
 #: ../../c-api/stable.rst:77
 msgid ""
@@ -135,43 +173,62 @@ msgid ""
 "the specified one onward, and can use Limited API introduced up to that "
 "version."
 msgstr ""
+"Defina ``Py_LIMITED_API`` com o valor de :c:macro:`PY_VERSION_HEX` "
+"correspondente à versão mais baixa do Python que sua extensão suporta. A "
+"extensão funcionará sem recompilação com todas as versões do Python 3 a "
+"partir da especificada e poderá usar a API Limitada introduzida até aquela "
+"versão."
 
 #: ../../c-api/stable.rst:83
 msgid ""
 "Rather than using the ``PY_VERSION_HEX`` macro directly, hardcode a minimum "
 "minor version (e.g. ``0x030A0000`` for Python 3.10) for stability when "
 "compiling with future Python versions."
 msgstr ""
+"Em vez de usar diretamente a macro ``PY_VERSION_HEX``, codifique uma versão "
+"menor mínima (por exemplo, ``0x030A0000`` para o Python 3.10) para garantir "
+"estabilidade ao compilar com versões futuras do Python."
 
 #: ../../c-api/stable.rst:87
 msgid ""
 "You can also define ``Py_LIMITED_API`` to ``3``. This works the same as "
 "``0x03020000`` (Python 3.2, the version that introduced Limited API)."
 msgstr ""
+"Você também pode definir ``Py_LIMITED_API`` como ``3``. Isso funciona da "
+"mesma forma que ``0x03020000`` (Python 3.2, a versão que introduziu a API "
+"Limitada)."
 
 #: ../../c-api/stable.rst:94
 msgid "Stable ABI"
-msgstr ""
+msgstr "ABI Estável"
 
 #: ../../c-api/stable.rst:96
 msgid ""
 "To enable this, Python provides a *Stable ABI*: a set of symbols that will "
 "remain compatible across Python 3.x versions."
 msgstr ""
+"Para habilitar isso, o Python fornece uma *ABI estável*: um conjunto de "
+"símbolos que permanecerão compatíveis em todas as versões do Python 3.x."
 
 #: ../../c-api/stable.rst:99
 msgid ""
 "The Stable ABI contains symbols exposed in the :ref:`Limited API <limited-c-"
 "api>`, but also other ones – for example, functions necessary to support "
 "older versions of the Limited API."
 msgstr ""
+"A ABI Estável contém símbolos expostos na :ref:`API Limitada <limited-c-"
+"api>`, mas também outros -- por exemplo, funções necessárias para suportar "
+"versões mais antigas da API Limitada."
 
 #: ../../c-api/stable.rst:103
 msgid ""
 "On Windows, extensions that use the Stable ABI should be linked against "
 "``python3.dll`` rather than a version-specific library such as ``python39."
 "dll``."
 msgstr ""
+"No Windows, as extensões que usam a ABI Estável devem ser vinculadas a "
+"``python3.dll`` em vez de uma biblioteca específica de versão, como "
+"``python39.dll``."
 
 #: ../../c-api/stable.rst:107
 msgid ""
@@ -181,30 +238,46 @@ msgid ""
 "to ensure that, for example, extensions built with the 3.10+ Limited API are "
 "not installed for lower versions of Python."
 msgstr ""
+"Em algumas plataformas, o Python procurará e carregará arquivos de "
+"biblioteca compartilhada com o nome marcado como ``abi3`` (por exemplo, "
+"``meumódulo.abi3.so``). Ele não verifica se essas extensões estão em "
+"conformidade com uma ABI Estável. O usuário (ou suas ferramentas de "
+"empacotamento) precisa garantir que, por exemplo, as extensões construídas "
+"com a API Limitada 3.10+ não sejam instaladas em versões mais baixas do "
+"Python."
 
 #: ../../c-api/stable.rst:114
 msgid ""
 "All functions in the Stable ABI are present as functions in Python's shared "
 "library, not solely as macros. This makes them usable from languages that "
 "don't use the C preprocessor."
 msgstr ""
+"Todas as funções na ABI estável estão presentes como funções na biblioteca "
+"compartilhada do Python, não apenas como macros. Isso as torna utilizáveis "
+"em linguagens que não utilizam o pré-processador C."
 
 #: ../../c-api/stable.rst:120
 msgid "Limited API Scope and Performance"
-msgstr ""
+msgstr "Escopo e Desempenho da API Limitada"
 
 #: ../../c-api/stable.rst:122
 msgid ""
 "The goal for the Limited API is to allow everything that is possible with "
 "the full C API, but possibly with a performance penalty."
 msgstr ""
+"O objetivo da API Limitada é permitir tudo o que é possível com a API C "
+"completa, mas possivelmente com uma penalidade de desempenho."
 
 #: ../../c-api/stable.rst:125
 msgid ""
 "For example, while :c:func:`PyList_GetItem` is available, its “unsafe” macro "
 "variant :c:func:`PyList_GET_ITEM` is not. The macro can be faster because it "
 "can rely on version-specific implementation details of the list object."
 msgstr ""
+"Por exemplo, enquanto :c:func:`PyList_GetItem` está disponível, sua variante "
+"de macro \"insegura\" :c:func:`PyList_GET_ITEM` não está. A macro pode ser "
+"mais rápida porque pode depender de detalhes de implementação específicos da "
+"versão do objeto da lista."
 
 #: ../../c-api/stable.rst:130
 msgid ""
@@ -213,6 +286,10 @@ msgid ""
 "allowing stability as Python's data structures are improved, but possibly "
 "reducing performance."
 msgstr ""
+"Sem a definição de ``Py_LIMITED_API``, algumas funções da API C são "
+"colocadas \"inline\" ou substituídas por macros. Definir ``Py_LIMITED_API`` "
+"desativa esse inline, permitindo estabilidade à medida que as estruturas de "
+"dados do Python são aprimoradas, mas possivelmente reduzindo o desempenho."
 
 #: ../../c-api/stable.rst:135
 msgid ""
@@ -223,10 +300,17 @@ msgid ""
 "where a version-specific one is not available – for example, for prereleases "
 "of an upcoming Python version."
 msgstr ""
+"Ao deixar de fora a definição ``Py_LIMITED_API``, é possível compilar uma "
+"extensão da API Limitada com uma ABI específica da versão. Isso pode "
+"melhorar o desempenho para essa versão do Python, mas limitará a "
+"compatibilidade. Compilar com ``Py_LIMITED_API`` vai produzir uma extensão "
+"que pode ser distribuída quando uma específica da versão não estiver "
+"disponível -- por exemplo, para pré-lançamentos de uma próxima versão do "
+"Python."
 
 #: ../../c-api/stable.rst:144
 msgid "Limited API Caveats"
-msgstr ""
+msgstr "Limitações da API Limitada"
 
 #: ../../c-api/stable.rst:146
 msgid ""
@@ -235,6 +319,11 @@ msgid ""
 "`Stable ABI <stable-abi>`. ``Py_LIMITED_API`` only covers definitions, but "
 "an API also includes other issues, such as expected semantics."
 msgstr ""
+"Observe que compilar com ``Py_LIMITED_API`` *não* é uma garantia completa de "
+"que o código esteja em conformidade com a :ref:`API Limitada <limited-c-"
+"api>` ou com a :ref:`ABI Estável <stable-abi>`. ``Py_LIMITED_API`` abrange "
+"apenas definições, mas uma API também inclui outras questões, como semântica "
+"esperada."
 
 #: ../../c-api/stable.rst:151
 msgid ""
@@ -245,12 +334,21 @@ msgid ""
 "the argument will be used directly, causing a ``NULL`` dereference and "
 "crash. A similar argument works for fields of structs."
 msgstr ""
+"Uma questão que ``Py_LIMITED_API`` não protege é a chamada de uma função com "
+"argumentos inválidos em uma versão inferior do Python. Por exemplo, "
+"considere uma função que começa a aceitar ``NULL`` como argumento. No Python "
+"3.9, ``NULL`` agora seleciona um comportamento padrão, mas no Python 3.8, o "
+"argumento será usado diretamente, causando uma referência ``NULL`` e uma "
+"falha. Um argumento similar funciona para campos de estruturas."
 
 #: ../../c-api/stable.rst:158
 msgid ""
 "Another issue is that some struct fields are currently not hidden when "
 "``Py_LIMITED_API`` is defined, even though they're part of the Limited API."
 msgstr ""
+"Outra questão é que alguns campos de estrutura não estão atualmente ocultos "
+"quando ``Py_LIMITED_API`` é definido, mesmo que eles façam parte da API "
+"Limitada."
 
 #: ../../c-api/stable.rst:161
 msgid ""