Update translations

github-actions[bot] · github-actions[bot] · commit 5efdd76beb34 · 2025-06-22T00:39:26.000Z
diff --git a/c-api/intro.po b/c-api/intro.po
@@ -11,7 +11,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.10\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-05-02 16:07+0000\n"
+"POT-Creation-Date: 2025-06-06 16:52+0000\n"
 "PO-Revision-Date: 2022-11-05 17:21+0000\n"
 "Last-Translator: Rafael Fontenelle <rffontenelle@gmail.com>, 2024\n"
 "Language-Team: Portuguese (Brazil) (https://app.transifex.com/python-doc/"
@@ -438,6 +438,17 @@ msgid ""
 "objects that reference each other here; for now, the solution is \"don't do "
 "that.\")"
 msgstr ""
+"A contagem de referências é importante porque os computadores atuais têm um "
+"tamanho de memória finito (e frequentemente severamente limitado); ela conta "
+"quantos lugares diferentes existem que possuem uma :term:`referência forte` "
+"a um objeto. Tal lugar pode ser outro objeto, ou uma variável C global (ou "
+"estática), ou uma variável local em alguma função C. Quando a última :term:"
+"`referência forte` a um objeto é liberada (ou seja, sua contagem de "
+"referências se torna zero), o objeto é desalocado. Se ele contiver "
+"referências a outros objetos, essas referências são liberadas. Esses outros "
+"objetos podem ser desalocados por sua vez, se não houver mais referências a "
+"eles, e assim por diante. (Há um problema óbvio com objetos que referenciam "
+"uns aos outros aqui; por enquanto, a solução é \"não faça isso\".)"
 
 #: ../../c-api/intro.rst:272
 msgid ""
@@ -457,6 +468,22 @@ msgid ""
 "``sizeof(Py_ssize_t) >= sizeof(void*)``). Thus, the reference count "
 "increment is a simple operation."
 msgstr ""
+"Contagens de referências são sempre manipuladas explicitamente. A maneira "
+"normal é usar a macro :c:func:`Py_INCREF` para obter uma nova referência a "
+"um objeto (ou seja, incrementar sua contagem de referências em um), e :c:"
+"func:`Py_DECREF` para liberar essa referência (ou seja, decrementar a "
+"contagem de referências em um). A macro :c:func:`Py_DECREF` é "
+"consideravelmente mais complexa do que a incref, pois deve verificar se a "
+"contagem de referências se torna zero e, em seguida, fazer com que o "
+"desalocador do objeto seja chamado. O desalocador é um ponteiro para função "
+"contido na estrutura de tipo do objeto. O desalocador específico do tipo "
+"cuida da liberação de referências para outros objetos contidos no objeto se "
+"este for um tipo de objeto composto, como uma lista, bem como de executar "
+"qualquer finalização adicional necessária. Não há chance de a contagem de "
+"referências transbordar; pelo menos tantos bits são usados ​​para armazenar a "
+"contagem de referência quantos forem os locais de memória distintos na "
+"memória virtual (presumindo ``sizeof(Py_ssize_t) >= sizeof(void*)``). "
+"Portanto, o incremento da contagem de referências é uma operação simples."
 
 #: ../../c-api/intro.rst:288
 msgid ""
@@ -475,6 +502,21 @@ msgid ""
 "that are called from Python; the call mechanism guarantees to hold a  "
 "reference to every argument for the duration of the call."
 msgstr ""
+"Não é necessário manter uma :term:`referência forte` (ou seja, incrementar a "
+"contagem de referências) para cada variável local que contém um ponteiro "
+"para um objeto. Em teoria, a contagem de referências do objeto aumenta em um "
+"quando a variável é feita para apontar para ele e diminui em um quando a "
+"variável sai do escopo. No entanto, esses dois se cancelam, portanto, no "
+"final, a contagem de referências não mudou. A única razão real para usar a "
+"contagem de referências é evitar que o objeto seja desalocado enquanto nossa "
+"variável estiver apontando para ele. Se sabemos que existe pelo menos uma "
+"outra referência ao objeto que vive pelo menos tanto quanto nossa variável, "
+"não há necessidade de tomar uma nova :term:`referência forte` (ou seja, "
+"incrementar a contagem de referências) temporariamente. Uma situação "
+"importante em que isso ocorre é em objetos que são passados como argumentos "
+"para funções C em um módulo de extensão que são chamados de Python; o "
+"mecanismo de chamada garante manter uma referência a todos os argumentos "
+"durante a chamada."
 
 #: ../../c-api/intro.rst:304
 msgid ""
@@ -486,6 +528,14 @@ msgid ""
 "code path which allows control to flow back to the user from a :c:func:"
 "`Py_DECREF`, so almost any operation is potentially dangerous."
 msgstr ""
+"No entanto, uma armadilha comum é extrair um objeto de uma lista e mantê-lo "
+"por um tempo, sem tomar uma nova referência. Alguma outra operação poderia "
+"remover o objeto da lista, liberando essa referência e possivelmente "
+"desalocando-o. O perigo real é que operações aparentemente inocentes podem "
+"invocar código Python arbitrário que poderia fazer isso; existe um caminho "
+"de código que permite que o controle flua de volta para o usuário a partir "
+"de um :c:func:`Py_DECREF`, então quase qualquer operação é potencialmente "
+"perigosa."
 
 #: ../../c-api/intro.rst:312
 msgid ""
@@ -496,6 +546,12 @@ msgid ""
 "This leaves the caller with the responsibility to call :c:func:`Py_DECREF` "
 "when they are done with the result; this soon becomes second nature."
 msgstr ""
+"Uma abordagem segura é sempre usar as operações genéricas (funções cujo nome "
+"começa com ``PyObject_``, ``PyNumber_``, ``PySequence_`` ou ``PyMapping_``). "
+"Essas operações sempre criam uma nova :term:`referência forte` (ou seja, "
+"incrementam a contagem de referências) do objeto que retornam. Isso deixa o "
+"chamador com a responsabilidade de chamar :c:func:`Py_DECREF` quando "
+"terminar com o resultado; isso logo se torna uma segunda natureza."
 
 #: ../../c-api/intro.rst:323
 msgid "Reference Count Details"
@@ -517,6 +573,20 @@ msgid ""
 "said to *borrow* the reference. Nothing needs to be done for a :term:"
 "`borrowed reference`."
 msgstr ""
+"O comportamento da contagem de referências de funções na API C/Python é "
+"melhor explicado em termos de *propriedade de referências*. A propriedade "
+"pertence às referências, nunca aos objetos (os objetos não são possuídos: "
+"eles são sempre compartilhados). \"Possuir uma referência\" significa ser "
+"responsável por chamar Py_DECREF nela quando a referência não for mais "
+"necessária. A propriedade também pode ser transferida, o que significa que o "
+"código que recebe a propriedade da referência torna-se responsável por "
+"eventualmente efetuar um liberando ela chamando :c:func:`Py_DECREF` ou :c:"
+"func:`Py_XDECREF` quando não é mais necessário -- ou passando essa "
+"responsabilidade (geralmente para o responsável pela chamada). Quando uma "
+"função passa a propriedade de uma referência para seu chamador, diz-se que o "
+"chamador recebe uma *nova* referência. Quando nenhuma propriedade é "
+"transferida, diz-se que o chamador *toma emprestado* a referência. Nada "
+"precisa ser feito para uma :term:`referência emprestada`."
 
 #: ../../c-api/intro.rst:338
 msgid ""
@@ -610,6 +680,13 @@ msgid ""
 "For example, this function sets all items of a list (actually, any mutable "
 "sequence) to a given item::"
 msgstr ""
+"É muito mais comum usar :c:func:`PyObject_SetItem` e amigos com itens cujas "
+"referências você está apenas pegando emprestado, como argumentos que foram "
+"passados para a função que você está escrevendo. Nesse caso, o comportamento "
+"deles em relação às referências é muito mais são, já que você não precisa "
+"tomar uma nova referência só para poder doá-la (\"mande-a ser roubada\"). "
+"Por exemplo, esta função define todos os itens de uma lista (na verdade, "
+"qualquer sequência mutável) para um determinado item::"
 
 #: ../../c-api/intro.rst:417
 msgid ""
diff --git a/howto/logging-cookbook.po b/howto/logging-cookbook.po
@@ -11,7 +11,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.10\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-05-09 17:01+0000\n"
+"POT-Creation-Date: 2025-06-20 16:58+0000\n"
 "PO-Revision-Date: 2022-11-05 17:21+0000\n"
 "Last-Translator: Rafael Fontenelle <rffontenelle@gmail.com>, 2024\n"
 "Language-Team: Portuguese (Brazil) (https://app.transifex.com/python-doc/"
@@ -67,7 +67,7 @@ msgstr ""
 "além disso, o código da aplicação pode definir e configurar um logger pai em "
 "um módulo e criar (mas não configurar) um logger filho em um módulo "
 "separado, e todas as chamadas de logger para o filho passarão para o pai.  "
-"Aqui está um módulo prinicipal::"
+"Aqui está um módulo principal::"
 
 #: ../../howto/logging-cookbook.rst:56
 msgid "Here is the auxiliary module::"
diff --git a/potodo.md b/potodo.md
@@ -4,7 +4,7 @@
 
 
 
-# c-api (57.69% done)
+# c-api (57.86% done)
 
 - allocation.po                    8 /   9 ( 88.0% translated).
 - arg.po                         193 / 195 ( 98.0% translated).
@@ -14,7 +14,6 @@
 - gcsupport.po                    10 /  40 ( 25.0% translated).
 - init.po                        119 / 310 ( 38.0% translated).
 - init_config.po                 129 / 375 ( 34.0% translated).
-- intro.po                        79 /  86 ( 91.0% translated).
 - long.po                         30 /  51 ( 58.0% translated).
 - memory.po                       57 / 184 ( 30.0% translated).
 - module.po                       48 /  99 ( 48.0% translated).
@@ -324,5 +323,5 @@
 - 3.7.po                         243 / 555 ( 43.0% translated).
 
 
-# TOTAL (65.21% done)
+# TOTAL (65.22% done)
 
diff --git a/stats.json b/stats.json
@@ -1 +1 @@
-{"completion": "65.21%", "translated": 33698, "entries": 51675, "updated_at": "2025-06-21T00:34:59+00:00Z"}
+{"completion": "65.22%", "translated": 33705, "entries": 51675, "updated_at": "2025-06-22T00:39:24+00:00Z"}

Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-{"completion": "65.21%", "translated": 33698, "entries": 51675, "updated_at": "2025-06-21T00:34:59+00:00Z"}`
	`1`	`+{"completion": "65.22%", "translated": 33705, "entries": 51675, "updated_at": "2025-06-22T00:39:24+00:00Z"}`