python
diff --git a/‎howto/instrumentation.po
Lines changed: 87 additions & 17 deletions b/‎howto/instrumentation.po
Lines changed: 87 additions & 17 deletions
diff --git a/‎potodo.md
Lines changed: 2 additions & 2 deletions b/‎potodo.md
Lines changed: 2 additions & 2 deletions
diff --git a/‎stats.json
Lines changed: 1 addition & 1 deletion b/‎stats.json
Lines changed: 1 addition & 1 deletion
@@ -16,7 +16,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.8\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-09-20 17:26+0000\n"
+"POT-Creation-Date: 2024-10-04 17:06+0000\n"
 "PO-Revision-Date: 2020-05-30 11:54+0000\n"
 "Last-Translator: Rafael Fontenelle <rffontenelle@gmail.com>, 2024\n"
 "Language-Team: Portuguese (Brazil) (https://app.transifex.com/python-doc/"
@@ -50,25 +50,33 @@ msgid ""
 "what the processes on a computer system are doing.  They both use domain-"
 "specific languages allowing a user to write scripts which:"
 msgstr ""
+"DTrace e SystemTap são ferramentas de monitoramento, cada uma fornecendo uma "
+"maneira de inspecionar o que os processos em um sistema de computador estão "
+"fazendo. Ambas usam linguagens específicas de domínio, permitindo que um "
+"usuário escreva scripts que:"
 
 #: ../../howto/instrumentation.rst:16
 msgid "filter which processes are to be observed"
 msgstr "filtrar quais processos devem ser observados"
 
 #: ../../howto/instrumentation.rst:17
 msgid "gather data from the processes of interest"
-msgstr ""
+msgstr "coletem dados dos processos de interesse"
 
 #: ../../howto/instrumentation.rst:18
 msgid "generate reports on the data"
-msgstr ""
+msgstr "gerem relatórios sobre os dados"
 
 #: ../../howto/instrumentation.rst:20
 msgid ""
 "As of Python 3.6, CPython can be built with embedded \"markers\", also known "
 "as \"probes\", that can be observed by a DTrace or SystemTap script, making "
 "it easier to monitor what the CPython processes on a system are doing."
 msgstr ""
+"A partir do Python 3.6, o CPython pode ser criado com \"marcadores\" "
+"incorporados, também conhecidos como \"sondas\" (*probes*), que podem ser "
+"observados por um script DTrace ou SystemTap, facilitando o monitoramento do "
+"que os processos CPython em um sistema estão fazendo."
 
 #: ../../howto/instrumentation.rst:27
 msgid ""
@@ -77,21 +85,28 @@ msgid ""
 "DTrace scripts can stop working or work incorrectly without warning when "
 "changing CPython versions."
 msgstr ""
+"Os marcadores DTrace são detalhes de implementação do interpretador CPython. "
+"Não há garantias sobre a compatibilidade de sondas entre versões do CPython. "
+"Os scripts DTrace podem parar de funcionar ou funcionar incorretamente sem "
+"aviso ao alterar as versões do CPython."
 
 #: ../../howto/instrumentation.rst:34
 msgid "Enabling the static markers"
-msgstr ""
+msgstr "Habilitando os marcadores estáticos"
 
 #: ../../howto/instrumentation.rst:36
 msgid ""
 "macOS comes with built-in support for DTrace.  On Linux, in order to build "
 "CPython with the embedded markers for SystemTap, the SystemTap development "
 "tools must be installed."
 msgstr ""
+"O macOS vem com suporte embutido para DTrace. No Linux, para construir o "
+"CPython com os marcadores incorporados para SystemTap, as ferramentas de "
+"desenvolvimento SystemTap devem ser instaladas."
 
 #: ../../howto/instrumentation.rst:40
 msgid "On a Linux machine, this can be done via::"
-msgstr ""
+msgstr "Em uma máquina Linux, isso pode ser feito via:"
 
 #: ../../howto/instrumentation.rst:44
 msgid "or::"
@@ -107,12 +122,18 @@ msgid ""
 "in the background and listing all probes made available by the Python "
 "provider::"
 msgstr ""
+"No macOS, você pode listar as sondas DTrace disponíveis executando um "
+"processo Python em segundo plano e listando todas as sondas disponibilizadas "
+"pelo provedor Python::"
 
 #: ../../howto/instrumentation.rst:72
 msgid ""
 "On Linux, you can verify if the SystemTap static markers are present in the "
 "built binary by seeing if it contains a \".note.stapsdt\" section."
 msgstr ""
+"No Linux, você pode verificar se os marcadores estáticos do SystemTap estão "
+"presentes no binário compilado, observando se ele contém uma seção \".note."
+"stapsdt\"."
 
 #: ../../howto/instrumentation.rst:80
 msgid ""
@@ -122,7 +143,7 @@ msgstr ""
 
 #: ../../howto/instrumentation.rst:86
 msgid "Sufficiently modern readelf can print the metadata::"
-msgstr ""
+msgstr "Um readelf moderno o suficiente pode imprimir os metadados::"
 
 #: ../../howto/instrumentation.rst:123
 msgid ""
@@ -133,7 +154,7 @@ msgstr ""
 
 #: ../../howto/instrumentation.rst:129
 msgid "Static DTrace probes"
-msgstr ""
+msgstr "Sondas estáticas do DTtrace"
 
 #: ../../howto/instrumentation.rst:131
 msgid ""
@@ -142,52 +163,63 @@ msgid ""
 "function called \"start\". In other words, import-time function invocations "
 "are not going to be listed:"
 msgstr ""
+"O script DTrace de exemplo a seguir pode ser usado para mostrar a hierarquia "
+"de chamada/retorno de um script Python, rastreando apenas dentro da "
+"invocação de uma função chamada \"start\". Em outras palavras, invocações de "
+"função em tempo de importação não serão listadas:"
 
 #: ../../howto/instrumentation.rst:170 ../../howto/instrumentation.rst:228
 msgid "It can be invoked like this::"
-msgstr ""
+msgstr "Pode ser invocado assim::"
 
 #: ../../howto/instrumentation.rst:174 ../../howto/instrumentation.rst:234
 msgid "The output looks like this:"
 msgstr "O resultado deve ser algo assim:"
 
 #: ../../howto/instrumentation.rst:199
 msgid "Static SystemTap markers"
-msgstr ""
+msgstr "Marcadores estáticos do SystemTap"
 
 #: ../../howto/instrumentation.rst:201
 msgid ""
 "The low-level way to use the SystemTap integration is to use the static "
 "markers directly.  This requires you to explicitly state the binary file "
 "containing them."
 msgstr ""
+"A maneira de baixo nível de usar a integração do SystemTap é usar os "
+"marcadores estáticos diretamente. Isso requer que você declare "
+"explicitamente o arquivo binário que os contém."
 
 #: ../../howto/instrumentation.rst:205
 msgid ""
 "For example, this SystemTap script can be used to show the call/return "
 "hierarchy of a Python script:"
 msgstr ""
+"Por exemplo, este script SystemTap pode ser usado para mostrar a hierarquia "
+"de chamada/retorno de um script Python:"
 
 #: ../../howto/instrumentation.rst:245
 msgid "where the columns are:"
-msgstr ""
+msgstr "sendo as colunas:"
 
 #: ../../howto/instrumentation.rst:247
 msgid "time in microseconds since start of script"
-msgstr ""
+msgstr "tempo em microssegundos desde o início do script"
 
 #: ../../howto/instrumentation.rst:249
 msgid "name of executable"
-msgstr ""
+msgstr "nome do executável"
 
 #: ../../howto/instrumentation.rst:251
 msgid "PID of process"
-msgstr ""
+msgstr "PID do processo"
 
 #: ../../howto/instrumentation.rst:253
 msgid ""
 "and the remainder indicates the call/return hierarchy as the script executes."
 msgstr ""
+"e o restante indica a hierarquia de chamada/retorno conforme o script é "
+"executado."
 
 #: ../../howto/instrumentation.rst:255
 msgid ""
@@ -198,44 +230,53 @@ msgstr ""
 
 #: ../../howto/instrumentation.rst:263
 msgid "should instead read:"
-msgstr ""
+msgstr "deve ler-se em vez disso:"
 
 #: ../../howto/instrumentation.rst:269
 msgid "(assuming a debug build of CPython 3.6)"
 msgstr ""
 
 #: ../../howto/instrumentation.rst:273
 msgid "Available static markers"
-msgstr ""
+msgstr "Marcadores estáticos disponíveis"
 
 #: ../../howto/instrumentation.rst:277
 msgid ""
 "This marker indicates that execution of a Python function has begun. It is "
 "only triggered for pure-Python (bytecode) functions."
 msgstr ""
+"Este marcador indica que a execução de uma função Python começou. Ele é "
+"acionado somente para funções Python puro (bytecode)."
 
 #: ../../howto/instrumentation.rst:280
 msgid ""
 "The filename, function name, and line number are provided back to the "
 "tracing script as positional arguments, which must be accessed using "
 "``$arg1``, ``$arg2``, ``$arg3``:"
 msgstr ""
+"O nome do arquivo, o nome da função e o número da linha são fornecidos de "
+"volta ao script de rastreamento como argumentos posicionais, que devem ser "
+"acessados usando ``$arg1``, ``$arg2``, ``$arg3``:"
 
 #: ../../howto/instrumentation.rst:284
 msgid ""
 "``$arg1`` : ``(const char *)`` filename, accessible using "
 "``user_string($arg1)``"
 msgstr ""
+"``$arg1`` : nome de arquivo ``(const char *)``, acessível usando "
+"``user_string($arg1)``"
 
 #: ../../howto/instrumentation.rst:286
 msgid ""
 "``$arg2`` : ``(const char *)`` function name, accessible using "
 "``user_string($arg2)``"
 msgstr ""
+"``$arg2`` : nome da função como ``(const char *)``, acessível usando "
+"``user_string($arg2)``"
 
 #: ../../howto/instrumentation.rst:289
 msgid "``$arg3`` : ``int`` line number"
-msgstr ""
+msgstr "``$arg3`` : número da linha como ``int``"
 
 #: ../../howto/instrumentation.rst:293
 msgid ""
@@ -254,6 +295,9 @@ msgid ""
 "equivalent of line-by-line tracing with a Python profiler.  It is not "
 "triggered within C functions."
 msgstr ""
+"Este marcador indica que uma linha Python está prestes a ser executada. É o "
+"equivalente ao rastreamento linha por linha com um criador de perfil em "
+"Python. Ele não é acionado dentro de funções C."
 
 #: ../../howto/instrumentation.rst:305
 msgid "The arguments are the same as for :c:func:`function__entry`."
@@ -270,52 +314,72 @@ msgid ""
 "Fires when the Python interpreter finishes a garbage collection cycle. "
 "``arg0`` is the number of collected objects."
 msgstr ""
+"Dispara quando o interpretador Python termina um ciclo de coleta de lixo. "
+"``arg0`` é o número de objetos coletados."
 
 #: ../../howto/instrumentation.rst:319
 msgid ""
 "Fires before :mod:`importlib` attempts to find and load the module. ``arg0`` "
 "is the module name."
 msgstr ""
+"Dispara antes de :mod:`importlib` tentar encontrar e carregar o módulo. "
 "``arg0`` é o nome do módulo."
 
 #: ../../howto/instrumentation.rst:326
 msgid ""
 "Fires after :mod:`importlib`'s find_and_load function is called. ``arg0`` is "
 "the module name, ``arg1`` indicates if module was successfully loaded."
 msgstr ""
+"Dispara após a função find_and_load do :mod:`importlib` ser chamada. "
+"``arg0`` é o nome do módulo, ``arg1`` indica se o módulo foi carregado com "
+"sucesso."
 
 #: ../../howto/instrumentation.rst:335
 msgid ""
 "Fires when :func:`sys.audit` or :c:func:`PySys_Audit` is called. ``arg0`` is "
 "the event name as C string, ``arg1`` is a :c:type:`PyObject` pointer to a "
 "tuple object."
 msgstr ""
+"Dispara quando :func:`sys.audit` ou :c:func:`PySys_Audit` é chamada. "
+"``arg0`` é o nome do evento como string C, ``arg1`` é um ponteiro :c:type:"
+"`PyObject` para um objeto de tupla."
 
 #: ../../howto/instrumentation.rst:343
 msgid "SystemTap Tapsets"
-msgstr ""
+msgstr "Tapsets de SystemTap"
 
 #: ../../howto/instrumentation.rst:345
 msgid ""
 "The higher-level way to use the SystemTap integration is to use a "
 "\"tapset\": SystemTap's equivalent of a library, which hides some of the "
 "lower-level details of the static markers."
 msgstr ""
+"A maneira mais avançada de usar a integração do SystemTap é usar um "
+"\"tapset\": o equivalente do SystemTap a uma biblioteca, que oculta alguns "
+"dos detalhes de nível inferior dos marcadores estáticos."
 
 #: ../../howto/instrumentation.rst:349
 msgid "Here is a tapset file, based on a non-shared build of CPython:"
 msgstr ""
+"Aqui está um arquivo tapset, baseado em uma construção não compartilhada do "
+"CPython:"
 
 #: ../../howto/instrumentation.rst:372
 msgid ""
 "If this file is installed in SystemTap's tapset directory (e.g. ``/usr/share/"
 "systemtap/tapset``), then these additional probepoints become available:"
 msgstr ""
+"Se este arquivo for instalado no diretório de tapsets do SystemTap (por "
+"exemplo, ``/usr/share/systemtap/tapset``), estes pontos de sondagem "
+"adicionais ficarão disponíveis:"
 
 #: ../../howto/instrumentation.rst:378
 msgid ""
 "This probe point indicates that execution of a Python function has begun. It "
 "is only triggered for pure-Python (bytecode) functions."
 msgstr ""
+"Este ponto de sondagem indica que a execução de uma função Python começou. "
+"Ele é acionado somente para funções Python puro (bytecode)."
 
 #: ../../howto/instrumentation.rst:383
 msgid ""
@@ -324,6 +388,9 @@ msgid ""
 "``return``, or via an exception).  It is only triggered for pure-Python "
 "(bytecode) functions."
 msgstr ""
+"Este ponto de sondagem é o inverso de ``python.function.return``, e indica "
+"que a execução de uma função Python terminou (seja via ``return``, ou via "
+"uma exceção). Ele é acionado somente para funções Python puro (bytecode)."
 
 #: ../../howto/instrumentation.rst:390
 msgid "Examples"
@@ -335,6 +402,9 @@ msgid ""
 "example given above of tracing the Python function-call hierarchy, without "
 "needing to directly name the static markers:"
 msgstr ""
+"Este script SystemTap usa o tapset acima para implementar de forma mais "
+"limpa o exemplo dado acima de rastreamento da hierarquia de chamada de "
+"função Python, sem precisar na diretamente"
 
 #: ../../howto/instrumentation.rst:410
 msgid ""
 
@@ -48,14 +48,14 @@
 - programming.po                 269 / 350 ( 76.0% translated).
 
 
-# howto (47.66% done)
+# howto (49.70% done)
 
 - argparse.po                     83 /  84 ( 98.0% translated).
 - clinic.po                      101 / 415 ( 24.0% translated).
 - curses.po                       70 / 105 ( 66.0% translated).
 - descriptor.po                   24 /  73 ( 32.0% translated).
 - functional.po                  140 / 206 ( 67.0% translated).
-- instrumentation.po               8 /  59 ( 13.0% translated).
+- instrumentation.po              49 /  59 ( 83.0% translated).
 - logging-cookbook.po             15 / 216 (  6.0% translated).
 - logging.po                     125 / 218 ( 57.0% translated).
 - pyporting.po                    26 /  85 ( 30.0% translated).
 
@@ -1 +1 @@
-{"translation": "59.13%", "total": 47814, "updated_at": "2024-11-05T00:38:42+00:00Z"}
+{"translation": "59.21%", "total": 47814, "updated_at": "2024-11-06T00:37:15+00:00Z"}
Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-{"translation": "59.13%", "total": 47814, "updated_at": "2024-11-05T00:38:42+00:00Z"}`
	`1`	`+{"translation": "59.21%", "total": 47814, "updated_at": "2024-11-06T00:37:15+00:00Z"}`