pomerge from 3.9 branch into 3.6

Author: github-actions[bot]

c-api/refcounting.po

@@ -32,6 +32,8 @@ msgid ""
 "The macros in this section are used for managing reference counts of Python "
 "objects."
 msgstr ""
+"As macros nesta seção são usadas para gerenciar contagens de referências de "
+"objetos Python."
 
 #: ../../c-api/refcounting.rst:16
 msgid ""
@@ -65,6 +67,16 @@ msgid ""
 "update the list data structure, and then call :c:func:`Py_DECREF` for the "
 "temporary variable."
 msgstr ""
+"A função de desalocação pode fazer com que o código Python arbitrário seja "
+"invocado (por exemplo, quando uma instância de classe com um método :meth:"
+"`__del__` é desalocada). Embora as exceções em tal código não sejam "
+"propagadas, o código executado tem acesso livre a todas as variáveis globais "
+"do Python. Isso significa que qualquer objeto que é alcançável de uma "
+"variável global deve estar em um estado consistente antes de :c:func:"
+"`Py_DECREF` ser invocado. Por exemplo, o código para excluir um objeto de "
+"uma lista deve copiar uma referência ao objeto excluído em uma variável "
+"temporária, atualizar a estrutura de dados da lista e então chamar :c:func:"
+"`Py_DECREF` para a variável temporária."
 
 #: ../../c-api/refcounting.rst:47
 msgid ""
@@ -96,10 +108,17 @@ msgid ""
 "exported function versions of :c:func:`Py_XINCREF` and :c:func:`Py_XDECREF`, "
 "respectively."
 msgstr ""
+"As seguintes funções são para incorporação dinâmica de Python em tempo de "
+"execução: ``Py_IncRef(PyObject *o)``, ``Py_DecRef(PyObject *o)``. Elas são "
+"simplesmente versões de função exportadas de :c:func:`Py_XINCREF` e :c:func:"
+"`Py_XDECREF`, respectivamente."
 
 #: ../../c-api/refcounting.rst:70
 msgid ""
 "The following functions or macros are only for use within the interpreter "
 "core: :c:func:`_Py_Dealloc`, :c:func:`_Py_ForgetReference`, :c:func:"
 "`_Py_NewReference`, as well as the global variable :c:data:`_Py_RefTotal`."
 msgstr ""
+"As seguintes funções ou macros são apenas para uso dentro do núcleo do "
+"interpretador: :c:func:`_Py_Dealloc`, :c:func:`_Py_ForgetReference`, :c:func:"
+"`_Py_NewReference`, bem como a variável global :c:data:`_Py_RefTotal`."

c-api/set.po

@@ -41,6 +41,16 @@ msgid ""
 "c:func:`PyNumber_InPlaceSubtract`, :c:func:`PyNumber_InPlaceOr`, and :c:func:"
 "`PyNumber_InPlaceXor`)."
 msgstr ""
+"Esta seção detalha a API pública para os objetos :class:`set` e :class:"
+"`frozenset`. Qualquer funcionalidade não listada abaixo é melhor acessada "
+"usando o protocolo de objeto abstrato (incluindo :c:func:"
+"`PyObject_CallMethod`, :c:func:`PyObject_RichCompareBool`, :c:func:"
+"`PyObject_Hash`, :c:func:`PyObject_Repr`, :c:func:`PyObject_IsTrue`, :c:func:"
+"`PyObject_Print`, and :c:func:`PyObject_GetIter`) ou o protocolo abstrato de "
+"número (incluindo :c:func:`PyNumber_And`, :c:func:`PyNumber_Subtract`, :c:"
+"func:`PyNumber_Or`, :c:func:`PyNumber_Xor`, :c:func:`PyNumber_InPlaceAnd`, :"
+"c:func:`PyNumber_InPlaceSubtract`, :c:func:`PyNumber_InPlaceOr` e :c:func:"
+"`PyNumber_InPlaceXor`)."
 
 #: ../../c-api/set.rst:29
 msgid ""
@@ -53,6 +63,15 @@ msgid ""
 "access should be done through the documented API rather than by manipulating "
 "the values in the structure."
 msgstr ""
+"Este subtipo de :c:type:`PyObject` é usado para manter os dados internos "
+"para ambos os objetos :class:`set` e :class:`frozenset`. É como um :c:type:"
+"`PyDictObject` em que tem um tamanho fixo para conjuntos pequenos (muito "
+"parecido com o armazenamento de tupla) e apontará para um bloco de memória "
+"de tamanho variável separado para conjuntos de tamanho médio e grande (muito "
+"parecido com lista armazenamento). Nenhum dos campos desta estrutura deve "
+"ser considerado público e está sujeito a alterações. Todo o acesso deve ser "
+"feito por meio da API documentada, em vez de manipular os valores na "
+"estrutura."
 
 #: ../../c-api/set.rst:40
 msgid ""
@@ -67,41 +86,56 @@ msgid ""
 "This is an instance of :c:type:`PyTypeObject` representing the Python :class:"
 "`frozenset` type."
 msgstr ""
+"Esta é uma instância de :c:type:`PyTypeObject` representando o tipo Python :"
+"class:`frozenset`."
 
 #: ../../c-api/set.rst:49
 msgid ""
 "The following type check macros work on pointers to any Python object. "
 "Likewise, the constructor functions work with any iterable Python object."
 msgstr ""
+"As macros de verificação de tipo a seguir funcionam em ponteiros para "
+"qualquer objeto Python. Da mesma forma, as funções construtoras funcionam "
+"com qualquer objeto Python iterável."
 
 #: ../../c-api/set.rst:55
 msgid ""
 "Return true if *p* is a :class:`set` object or an instance of a subtype."
 msgstr ""
+"Retorna verdadeiro se *p* for um objeto :class:`set` ou uma instância de um "
+"subtipo."
 
 #: ../../c-api/set.rst:59
 msgid ""
 "Return true if *p* is a :class:`frozenset` object or an instance of a "
 "subtype."
 msgstr ""
+"Retorna verdadeiro se *p* for um objeto :class:`frozenset` ou uma instância "
+"de um subtipo."
 
 #: ../../c-api/set.rst:64
 msgid ""
 "Return true if *p* is a :class:`set` object, a :class:`frozenset` object, or "
 "an instance of a subtype."
 msgstr ""
+"Retorna verdadeiro se *p* for um objeto :class:`set`, um objeto :class:"
+"`frozenset` ou uma instância de um subtipo."
 
 #: ../../c-api/set.rst:70
 msgid ""
 "Return true if *p* is a :class:`set` object or a :class:`frozenset` object "
 "but not an instance of a subtype."
 msgstr ""
+"Retorna verdadeiro se *p* for um objeto :class:`set` ou um objeto :class:"
+"`frozenset`, mas não uma instância de um subtipo."
 
 #: ../../c-api/set.rst:76
 msgid ""
 "Return true if *p* is a :class:`frozenset` object but not an instance of a "
 "subtype."
 msgstr ""
+"Retorna verdadeiro se *p* for um objeto :class:`frozenset`, mas não uma "
+"instância de um subtipo."
 
 #: ../../c-api/set.rst:82
 msgid ""
@@ -125,17 +159,23 @@ msgid ""
 "The following functions and macros are available for instances of :class:"
 "`set` or :class:`frozenset` or instances of their subtypes."
 msgstr ""
+"As seguintes funções e macros estão disponíveis para instâncias de :class:"
+"`set` ou :class:`frozenset` ou instâncias de seus subtipos."
 
 #: ../../c-api/set.rst:105
 msgid ""
 "Return the length of a :class:`set` or :class:`frozenset` object. Equivalent "
 "to ``len(anyset)``.  Raises a :exc:`PyExc_SystemError` if *anyset* is not a :"
 "class:`set`, :class:`frozenset`, or an instance of a subtype."
 msgstr ""
+"Retorna o comprimento de um objeto :class:`set` ou :class:`frozenset`. "
+"Equivalente a ``len(anyset)``. Levanta um :exc:`PyExc_SystemError` se "
+"*anyset* não for um :class:`set`, :class:`frozenset`, ou uma instância de um "
+"subtipo."
 
 #: ../../c-api/set.rst:112
 msgid "Macro form of :c:func:`PySet_Size` without error checking."
-msgstr ""
+msgstr "Forma macro de :c:func:`PySet_Size` sem verificação de erros."
 
 #: ../../c-api/set.rst:117
 msgid ""
@@ -146,6 +186,12 @@ msgid ""
 "`PyExc_SystemError` if *anyset* is not a :class:`set`, :class:`frozenset`, "
 "or an instance of a subtype."
 msgstr ""
+"Retorna ``1`` se encontrado, ``0`` se não encontrado, e ``-1`` se um erro é "
+"encontrado. Ao contrário do método Python :meth:`__contains__`, esta função "
+"não converte automaticamente conjuntos não hasheáveis em frozensets "
+"temporários. Levanta um :exc:`TypeError` se a *key* não for hasheável. "
+"Levanta :exc:`PyExc_SystemError` se *anyset* não é um :class:`set`, :class:"
+"`frozenset`, ou uma instância de um subtipo."
 
 #: ../../c-api/set.rst:126
 msgid ""
@@ -157,12 +203,23 @@ msgid ""
 "grow.  Raise a :exc:`SystemError` if *set* is not an instance of :class:"
 "`set` or its subtype."
 msgstr ""
+"Adiciona *key* a uma instância de :class:`set`. Também funciona com "
+"instâncias de :class:`frozenset` (como :c:func:`PyTuple_SetItem`, ele pode "
+"ser usado para preencher os valores de novos conjuntos de congelamentos "
+"antes que eles sejam expostos a outro código). Retorna ``0`` em caso de "
+"sucesso ou ``-1`` em caso de falha. Levanta um :exc:`TypeError` se a *key* "
+"não for hasheável. Levanta uma :exc:`MemoryError` se não houver espaço para "
+"crescer. Levanta uma :exc:`SystemError` se *set* não for uma instância de :"
+"class:`set` ou seu subtipo."
 
 #: ../../c-api/set.rst:135
 msgid ""
 "The following functions are available for instances of :class:`set` or its "
 "subtypes but not for instances of :class:`frozenset` or its subtypes."
 msgstr ""
+"As seguintes funções estão disponíveis para instâncias de :class:`set` ou "
+"seus subtipos, mas não para instâncias de :class:`frozenset` ou seus "
+"subtipos."
 
 #: ../../c-api/set.rst:141
 msgid ""
@@ -174,6 +231,13 @@ msgid ""
 "`PyExc_SystemError` if *set* is not an instance of :class:`set` or its "
 "subtype."
 msgstr ""
+"Retorna ``1`` se encontrado e removido, ``0`` se não encontrado (nenhuma "
+"ação realizada) e ``-1`` se um erro for encontrado. Não levanta :exc:"
+"`KeyError` para chaves ausentes. Levanta uma :exc:`TypeError` se a *key* não "
+"for hasheável. Ao contrário do método Python :meth:`~set.discard`, esta "
+"função não converte automaticamente conjuntos não hasheáveis em frozensets "
+"temporários. Levanta :exc:`PyExc_SystemError` se *set* não é uma instância "
+"de :class:`set` ou seu subtipo."
 
 #: ../../c-api/set.rst:151
 msgid ""

c-api/slice.po

@@ -54,22 +54,30 @@ msgid ""
 "assuming a sequence of length *length*. Treats indices greater than *length* "
 "as errors."
 msgstr ""
+"Recupera os índices de início, parada e intermediário do objeto de fatia "
+"*slice*, presumindo uma sequência de comprimento *length*. Trata índices "
+"maiores que *length* como erros."
 
 #: ../../c-api/slice.rst:35
 msgid ""
 "Returns ``0`` on success and ``-1`` on error with no exception set (unless "
 "one of the indices was not :const:`None` and failed to be converted to an "
 "integer, in which case ``-1`` is returned with an exception set)."
 msgstr ""
+"Retorna ``0`` em caso de sucesso e ``-1`` em caso de erro sem exceção "
+"definida (a menos que um dos índices não fosse :const:`None` e falhou ao ser "
+"convertido para um inteiro, neste caso ``-1`` é retornado com uma exceção "
+"definida)."
 
 #: ../../c-api/slice.rst:39
 msgid "You probably do not want to use this function."
-msgstr ""
+msgstr "Você provavelmente não deseja usar esta função."
 
 #: ../../c-api/slice.rst:41 ../../c-api/slice.rst:56
 msgid ""
 "The parameter type for the *slice* parameter was ``PySliceObject*`` before."
 msgstr ""
+"O tipo de parâmetro para o parâmetro *slice* era antes de ``PySliceObject*``."
 
 #: ../../c-api/slice.rst:48
 msgid ""
@@ -79,18 +87,28 @@ msgid ""
 "bounds indices are clipped in a manner consistent with the handling of "
 "normal slices."
 msgstr ""
+"Substituição utilizável para :c:func:`PySlice_GetIndices`. Recupera os "
+"índices de início, parada e intermediário do objeto de fatia *slice* "
+"presumindo uma sequência de comprimento *length* e armazena o comprimento da "
+"fatia em *slicelength*. Índices fora dos limites são cortados de maneira "
+"consistente com o tratamento de fatias normais."
 
 #: ../../c-api/slice.rst:54
 msgid "Returns ``0`` on success and ``-1`` on error with exception set."
 msgstr ""
+"Retorna ``0`` em caso de sucesso e ``-1`` em caso de erro com exceção "
+"definida."
 
 #: ../../c-api/slice.rst:62
 msgid "Ellipsis Object"
-msgstr ""
+msgstr "Objeto Ellipsis"
 
 #: ../../c-api/slice.rst:67
 msgid ""
 "The Python ``Ellipsis`` object.  This object has no methods.  It needs to be "
 "treated just like any other object with respect to reference counts.  Like :"
 "c:data:`Py_None` it is a singleton object."
 msgstr ""
+"O objeto Python ``Ellipsis``. Este objeto não possui métodos. Ele precisa "
+"ser tratado como qualquer outro objeto no que diz respeito às contagens de "
+"referências. Como :c:data:`Py_None`, é um objeto singleton."

library/asyncio-task.po

@@ -803,6 +803,9 @@ msgid ""
 "If no future raises an exception then it is equivalent to :const:"
 "`ALL_COMPLETED`."
 msgstr ""
+"A função irá retornar quando qualquer futuro encerrar levantando uma "
+"exceção. Se nenhum futuro levantar uma exceção, então é equivalente a :const:"
+"`ALL_COMPLETED`."
 
 #: ../../library/asyncio-task.rst:695
 msgid ":const:`ALL_COMPLETED`"

library/codeop.po

@@ -40,28 +40,39 @@ msgid ""
 "include such a loop in your program you probably want to use the :mod:`code` "
 "module instead."
 msgstr ""
+"O módulo :mod:`codeop` fornece utilitários sobre os quais o loop de leitura-"
+"execução-exibição do Python pode ser emulado, como é feito no módulo :mod:"
+"`code`. Como resultado, você provavelmente não deseja usar o módulo "
+"diretamente; se você deseja incluir tal loop em seu programa, você "
+"provavelmente deseja usar o módulo :mod:`code`."
 
 #: ../../library/codeop.rst:20
 msgid "There are two parts to this job:"
-msgstr ""
+msgstr "Há duas partes para esta tarefa:"
 
 #: ../../library/codeop.rst:22
 msgid ""
 "Being able to tell if a line of input completes a Python  statement: in "
 "short, telling whether to print '``>>>``' or '``...``' next."
 msgstr ""
+"Ser capaz de dizer se uma linha de entrada completa uma instrução Python: em "
+"suma, dizer se deve exibir '``>>>``' ou '``...``' em seguida."
 
 #: ../../library/codeop.rst:25
 msgid ""
 "Remembering which future statements the user has entered, so  subsequent "
 "input can be compiled with these in effect."
 msgstr ""
+"Lembrar quais instruções futuras o usuário inseriu, para que as entradas "
+"subsequentes possam ser compiladas com essas declarações em vigor."
 
 #: ../../library/codeop.rst:28
 msgid ""
 "The :mod:`codeop` module provides a way of doing each of these things, and a "
 "way of doing them both."
 msgstr ""
+"O módulo :mod:`codeop` fornece uma maneira de fazer cada uma dessas coisas e "
+"uma maneira de fazer as duas coisas."
 
 #: ../../library/codeop.rst:31
 msgid "To do just the former:"
@@ -75,13 +86,21 @@ msgid ""
 "``'<input>'``. Returns ``None`` if *source* is *not* valid Python code, but "
 "is a prefix of valid Python code."
 msgstr ""
+"Tenta compilar *source*, que deve ser uma string de código Python e retornar "
+"um objeto código se *source* for um código Python válido. Nesse caso, o "
+"atributo de nome de arquivo do objeto código será *filename*, cujo padrão é "
+"``'<input>'``. Retorna ``None`` se *source* *não* é um código Python válido, "
+"mas é um prefixo de código Python válido."
 
 #: ../../library/codeop.rst:41
 msgid ""
 "If there is a problem with *source*, an exception will be raised. :exc:"
 "`SyntaxError` is raised if there is invalid Python syntax, and :exc:"
 "`OverflowError` or :exc:`ValueError` if there is an invalid literal."
 msgstr ""
+"Se houver um problema com *source*, uma exceção será levantada. :exc:"
+"`SyntaxError` é levantada se houver sintaxe Python inválida, e :exc:"
+"`OverflowError` ou :exc:`ValueError` se houver um literal inválido."
 
 #: ../../library/codeop.rst:45
 msgid ""
@@ -98,6 +117,12 @@ msgid ""
 "backslash followed by two newlines may be followed by arbitrary garbage. "
 "This will be fixed once the API for the parser is better."
 msgstr ""
+"É possível (mas não provável) que o analisador sintático pare de analisar "
+"com um resultado bem-sucedido antes de chegar ao final da fonte; neste caso, "
+"os símbolos finais podem ser ignorados em vez de causar um erro. Por "
+"exemplo, uma barra invertida seguida por duas novas linhas pode ser seguida "
+"por lixo arbitrário. Isso será corrigido quando a API para o analisador for "
+"melhor."
 
 #: ../../library/codeop.rst:60
 msgid ""
@@ -107,6 +132,11 @@ msgid ""
 "the instance 'remembers' and compiles all subsequent program texts with the "
 "statement in force."
 msgstr ""
+"Instâncias desta classe têm métodos :meth:`__call__` idênticos em assinatura "
+"à função embutida :func:`compile`, mas com a diferença de que se a instância "
+"compilar o texto do programa contendo uma instrução :mod:`__future__`, a "
+"instância se \"lembra\" e compila todos os textos de programa subsequentes "
+"com a instrução em vigor."
 
 #: ../../library/codeop.rst:69
 msgid ""
@@ -115,3 +145,7 @@ msgid ""
 "program text containing a ``__future__`` statement, the instance 'remembers' "
 "and compiles all subsequent program texts with the statement in force."
 msgstr ""
+"Instâncias desta classe têm métodos :meth:`__call__` idênticos em assinatura "
+"a :func:`compile_command`; a diferença é que se a instância compila o texto "
+"do programa contendo uma instrução ``__future__``, a instância se \"lembra\" "
+"e compila todos os textos do programa subsequentes com a instrução em vigor."

library/concurrent.futures.po

@@ -430,6 +430,9 @@ msgid ""
 "If no future raises an exception then it is equivalent to :const:"
 "`ALL_COMPLETED`."
 msgstr ""
+"A função irá retornar quando qualquer futuro encerrar levantando uma "
+"exceção. Se nenhum futuro levantar uma exceção, então é equivalente a :const:"
+"`ALL_COMPLETED`."
 
 #: ../../library/concurrent.futures.rst:399
 msgid ":const:`ALL_COMPLETED`"