Update translations

github-actions[bot] · github-actions[bot] · commit d58c7531a428 · 2025-06-21T23:53:21.000Z
diff --git a/c-api/init.po b/c-api/init.po
@@ -11,7 +11,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.11\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-05-23 16:05+0000\n"
+"POT-Creation-Date: 2025-06-13 16:17+0000\n"
 "PO-Revision-Date: 2023-05-24 02:09+0000\n"
 "Last-Translator: Rafael Fontenelle <rffontenelle@gmail.com>, 2025\n"
 "Language-Team: Portuguese (Brazil) (https://app.transifex.com/python-doc/"
@@ -2334,7 +2334,7 @@ msgstr ""
 
 #: ../../c-api/init.rst:231 ../../c-api/init.rst:480 ../../c-api/init.rst:506
 msgid "path (in module sys)"
-msgstr ""
+msgstr "path (no módulo sys)"
 
 #: ../../c-api/init.rst:231 ../../c-api/init.rst:480 ../../c-api/init.rst:506
 #: ../../c-api/init.rst:947 ../../c-api/init.rst:1389
@@ -2495,7 +2495,7 @@ msgstr "stdin (no módulo sys)"
 
 #: ../../c-api/init.rst:1418
 msgid "Py_Initialize (C function)"
-msgstr ""
+msgstr "Py_Initialize (função C)"
 
 #: ../../c-api/init.rst:1448
 msgid "close (in module os)"
diff --git a/c-api/intro.po b/c-api/intro.po
@@ -11,7 +11,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.11\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-05-02 15:33+0000\n"
+"POT-Creation-Date: 2025-06-13 16:17+0000\n"
 "PO-Revision-Date: 2023-05-24 02:09+0000\n"
 "Last-Translator: Rafael Fontenelle <rffontenelle@gmail.com>, 2025\n"
 "Language-Team: Portuguese (Brazil) (https://app.transifex.com/python-doc/"
@@ -518,6 +518,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:331
 msgid ""
@@ -537,6 +548,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:347
 msgid ""
@@ -555,6 +582,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:363
 msgid ""
@@ -566,6 +608,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:371
 msgid ""
@@ -576,6 +626,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:382
 msgid "Reference Count Details"
@@ -597,6 +653,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:397
 msgid ""
@@ -690,6 +760,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:476
 msgid ""
@@ -915,6 +992,11 @@ msgid ""
 "following example function shows some error cleanup.  First, to remind you "
 "why you like Python, we show the equivalent Python code::"
 msgstr ""
+"Um exemplo simples de detecção de exceções e transmiti-las é mostrado no "
+"exemplo :c:func:`!sum_sequence` acima. Acontece que este exemplo não precisa "
+"limpar nenhuma referência de propriedade quando detecta um erro. A função de "
+"exemplo a seguir mostra alguma limpeza de erro. Primeiro, para lembrar por "
+"que você gosta de Python, mostramos o código Python equivalente::"
 
 #: ../../c-api/intro.rst:664
 msgid "Here is the corresponding C code, in all its glory::"
@@ -1108,6 +1190,13 @@ msgid ""
 "macro:`!Py_DEBUG` is enabled in the Unix build, compiler optimization is "
 "disabled."
 msgstr ""
+"Compilar o interpretador com a macro :c:macro:`!Py_DEBUG` definida produz o "
+"que geralmente se entende por :ref:`uma construção de depuração do Python "
+"<debug-build>`. :c:macro:`!Py_DEBUG` é habilitada na construção Unix "
+"adicionando :option:`--with-pydebug` ao comando :file:`./configure`. Também "
+"está implícito na presença da macro não específica do Python :c:macro:`!"
+"_DEBUG`. Quando :c:macro:`!Py_DEBUG` está habilitado na construção do Unix, "
+"a otimização do compilador é desabilitada."
 
 #: ../../c-api/intro.rst:825
 msgid ""
@@ -1153,71 +1242,71 @@ msgstr "tipo"
 
 #: ../../c-api/intro.rst:327
 msgid "Py_INCREF (C function)"
-msgstr ""
+msgstr "Py_INCREF (função C)"
 
 #: ../../c-api/intro.rst:327
 msgid "Py_DECREF (C function)"
-msgstr ""
+msgstr "Py_DECREF (função C)"
 
 #: ../../c-api/intro.rst:403
 msgid "PyList_SetItem (C function)"
-msgstr ""
+msgstr "PyList_SetItem (função C)"
 
 #: ../../c-api/intro.rst:403
 msgid "PyTuple_SetItem (C function)"
-msgstr ""
+msgstr "PyTuple_SetItem (função C)"
 
 #: ../../c-api/intro.rst:474
 msgid "set_all()"
-msgstr ""
+msgstr "set_all()"
 
 #: ../../c-api/intro.rst:493
 msgid "PyList_GetItem (C function)"
-msgstr ""
+msgstr "PyList_GetItem (função C)"
 
 #: ../../c-api/intro.rst:493
 msgid "PySequence_GetItem (C function)"
-msgstr ""
+msgstr "PySequence_GetItem (função C)"
 
 #: ../../c-api/intro.rst:523
 msgid "sum_list()"
-msgstr ""
+msgstr "sum_list()"
 
 #: ../../c-api/intro.rst:555 ../../c-api/intro.rst:647
 msgid "sum_sequence()"
-msgstr ""
+msgstr "sum_sequence()"
 
 #: ../../c-api/intro.rst:590
 msgid "PyErr_Occurred (C function)"
-msgstr ""
+msgstr "PyErr_Occurred (função C)"
 
 #: ../../c-api/intro.rst:603
 msgid "PyErr_SetString (C function)"
-msgstr ""
+msgstr "PyErr_SetString (função C)"
 
 #: ../../c-api/intro.rst:603 ../../c-api/intro.rst:711
 msgid "PyErr_Clear (C function)"
-msgstr ""
+msgstr "PyErr_Clear (função C)"
 
 #: ../../c-api/intro.rst:627
 msgid "exc_info (in module sys)"
 msgstr "exc_info (no módulo sys)"
 
 #: ../../c-api/intro.rst:662 ../../c-api/intro.rst:709
 msgid "incr_item()"
-msgstr ""
+msgstr "incr_item()"
 
 #: ../../c-api/intro.rst:711
 msgid "PyErr_ExceptionMatches (C function)"
-msgstr ""
+msgstr "PyErr_ExceptionMatches (função C)"
 
 #: ../../c-api/intro.rst:711
 msgid "Py_XDECREF (C function)"
-msgstr ""
+msgstr "Py_XDECREF (função C)"
 
 #: ../../c-api/intro.rst:737
 msgid "Py_Initialize (C function)"
-msgstr ""
+msgstr "Py_Initialize (função C)"
 
 #: ../../c-api/intro.rst:737
 msgid "module"
@@ -1245,28 +1334,28 @@ msgstr "caminho"
 
 #: ../../c-api/intro.rst:737
 msgid "path (in module sys)"
-msgstr ""
+msgstr "path (no módulo sys)"
 
 #: ../../c-api/intro.rst:772
 msgid "Py_SetProgramName (C function)"
 msgstr ""
 
 #: ../../c-api/intro.rst:772
 msgid "Py_GetPath (C function)"
-msgstr ""
+msgstr "Py_GetPath (função C)"
 
 #: ../../c-api/intro.rst:772
 msgid "Py_GetPrefix (C function)"
-msgstr ""
+msgstr "Py_GetPrefix (função C)"
 
 #: ../../c-api/intro.rst:772
 msgid "Py_GetExecPrefix (C function)"
-msgstr ""
+msgstr "Py_GetExecPrefix (função C)"
 
 #: ../../c-api/intro.rst:772
 msgid "Py_GetProgramFullPath (C function)"
-msgstr ""
+msgstr "Py_GetProgramFullPath (função C)"
 
 #: ../../c-api/intro.rst:787
 msgid "Py_IsInitialized (C function)"
-msgstr ""
+msgstr "Py_IsInitialized (função C)"
diff --git a/howto/logging-cookbook.po b/howto/logging-cookbook.po
@@ -11,7 +11,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.11\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-05-02 15:33+0000\n"
+"POT-Creation-Date: 2025-06-13 16:17+0000\n"
 "PO-Revision-Date: 2023-05-24 02:11+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
@@ -5,16 +5,16 @@
 - license.po                      95 /  99 ( 95.0% translated).
 
 
-# c-api (56.90% done)
+# c-api (57.66% done)
 
 - exceptions.po                  193 / 347 ( 55.0% translated).
 - float.po                        14 /  35 ( 40.0% translated).
 - frame.po                        20 /  24 ( 83.0% translated).
 - gcsupport.po                     9 /  42 ( 21.0% translated).
 - import.po                       39 /  53 ( 73.0% translated).
-- init.po                        122 / 372 ( 32.0% translated).
+- init.po                        124 / 372 ( 33.0% translated).
 - init_config.po                 135 / 396 ( 34.0% translated).
-- intro.po                        95 / 127 ( 74.0% translated).
+- intro.po                       126 / 127 ( 99.0% translated).
 - long.po                         30 /  59 ( 50.0% translated).
 - memory.po                       53 / 189 ( 28.0% translated).
 - module.po                       61 / 109 ( 55.0% translated).
@@ -324,5 +324,5 @@
 - 3.8.po                         468 / 469 ( 99.0% translated).
 
 
-# TOTAL (67.82% done)
+# TOTAL (67.88% done)
 
diff --git a/stats.json b/stats.json
@@ -1 +1 @@
-{"completion": "67.82%", "translated": 37852, "entries": 55811, "updated_at": "2025-06-20T23:54:39+00:00Z"}
+{"completion": "67.88%", "translated": 37885, "entries": 55811, "updated_at": "2025-06-21T23:53:19+00:00Z"}

Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-{"completion": "67.82%", "translated": 37852, "entries": 55811, "updated_at": "2025-06-20T23:54:39+00:00Z"}`
	`1`	`+{"completion": "67.88%", "translated": 37885, "entries": 55811, "updated_at": "2025-06-21T23:53:19+00:00Z"}`