pomerge from 3.9 branch into 2.7

github-actions[bot] · github-actions[bot] · commit 719576ea91da · 2021-04-21T23:46:53.000Z
diff --git a/library/marshal.po b/library/marshal.po
@@ -20,7 +20,7 @@ msgstr ""
 
 #: ../../library/marshal.rst:3
 msgid ":mod:`marshal` --- Internal Python object serialization"
-msgstr ""
+msgstr ":mod:`marshal` --- Serialização interna de objetos Python"
 
 #: ../../library/marshal.rst:10
 msgid ""
@@ -31,6 +31,12 @@ msgid ""
 "are undocumented on purpose; it may change between Python versions (although "
 "it rarely does). [#]_"
 msgstr ""
+"Este módulo contém funções que podem ler e gravar valores Python em formato "
+"binário. O formato é específico para Python, mas independente dos problemas "
+"de arquitetura da máquina (por exemplo, você pode gravar um valor Python em "
+"um arquivo em um PC, transportar o arquivo para um Sun e lê-lo de volta lá). "
+"Os detalhes do formato não são documentados propositalmente; ele pode mudar "
+"entre as versões do Python (embora raramente mude). [#]_"
 
 #: ../../library/marshal.rst:21
 msgid ""
@@ -45,13 +51,26 @@ msgid ""
 "guaranteed, and pickle supports a substantially wider range of objects than "
 "marshal."
 msgstr ""
+"Este não é um módulo de \"persistência\" geral. Para persistência geral e "
+"transferência de objetos Python através de chamadas RPC, veja os módulos :"
+"mod:`pickle` e :mod:`shelve`. O módulo :mod:`marshal` existe principalmente "
+"para ter suporte à leitura e escrita do código \"pseudocompilado\" para "
+"módulos Python de arquivos :file:`.pyc`. Portanto, os mantenedores do Python "
+"se reservam o direito de modificar o formato do marshal de maneiras "
+"incompatíveis com versões anteriores, caso seja necessário. Se você estiver "
+"serializando e desserializando objetos Python, use o módulo :mod:`pickle` -- "
+"o desempenho é comparável, a independência de versão é garantida e pickle "
+"tem suporte a uma gama substancialmente maior de objetos do que marshal."
 
 #: ../../library/marshal.rst:33
 msgid ""
 "The :mod:`marshal` module is not intended to be secure against erroneous or "
 "maliciously constructed data.  Never unmarshal data received from an "
 "untrusted or unauthenticated source."
 msgstr ""
+"O módulo :mod:`marshal` não se destina a ser seguro contra dados errôneos ou "
+"construídos de forma maliciosa. Nunca faça o unmarshalling de dados "
+"recebidos de uma fonte não confiável ou não autenticada."
 
 #: ../../library/marshal.rst:39
 msgid ""
@@ -88,7 +107,7 @@ msgstr ""
 
 #: ../../library/marshal.rst:64
 msgid "The module defines these functions:"
-msgstr ""
+msgstr "O módulo define estas funções:"
 
 #: ../../library/marshal.rst:69
 msgid ""
@@ -105,12 +124,17 @@ msgid ""
 "written to the file.  The object will not be properly read back by :func:"
 "`load`."
 msgstr ""
+"Se o valor tem (ou contém um objeto que tem) um tipo não suportado, uma "
+"exceção :exc:`ValueError` é levantada -- mas dados de lixo também serão "
+"gravados no arquivo. O objeto não será lido corretamente por :func:`load`."
 
 #: ../../library/marshal.rst:79
 msgid ""
 "The *version* argument indicates the data format that ``dump`` should use "
 "(see below)."
 msgstr ""
+"O argumento *version* indica o formato de dados que o ``dump`` deve usar "
+"(veja abaixo)."
 
 #: ../../library/marshal.rst:86
 msgid ""
@@ -126,6 +150,8 @@ msgid ""
 "If an object containing an unsupported type was marshalled with :func:"
 "`dump`, :func:`load` will substitute ``None`` for the unmarshallable type."
 msgstr ""
+"Se um objeto contendo um tipo não suportado foi empacotado com :func:"
+"`dump`, :func:`load` irá substituir ``None`` pelo tipo não empacotável."
 
 #: ../../library/marshal.rst:100
 msgid ""
@@ -139,6 +165,8 @@ msgid ""
 "The *version* argument indicates the data format that ``dumps`` should use "
 "(see below)."
 msgstr ""
+"O argumento *version* indica o formato de dados que ``dumps`` deve usar "
+"(veja abaixo)."
 
 #: ../../library/marshal.rst:111
 msgid ""
@@ -149,7 +177,7 @@ msgstr ""
 
 #: ../../library/marshal.rst:116
 msgid "In addition, the following constants are defined:"
-msgstr ""
+msgstr "Além disso, as seguintes constantes são definidas:"
 
 #: ../../library/marshal.rst:120
 msgid ""
@@ -171,3 +199,8 @@ msgid ""
 "marshal\" means to convert some data from internal to external form (in an "
 "RPC buffer for instance) and \"unmarshalling\" for the reverse process."
 msgstr ""
+"O nome deste módulo deriva de um pouco da terminologia usada pelos designers "
+"do Modula-3 (entre outros), que usam o termo \"marshalling\" para enviar "
+"dados em um formato independente. Estritamente falando, \"to marshal\" "
+"significa converter alguns dados da forma interna para a externa (em um "
+"buffer RPC, por exemplo) e \"unmarshalling\" para o processo reverso."
