pomerge from 3.9 branch into 3.7

github-actions[bot] · github-actions[bot] · commit ba56a983a18c · 2020-12-16T01:18:28.000Z
diff --git a/c-api/intro.po b/c-api/intro.po
@@ -42,6 +42,15 @@ msgid ""
 "larger application; this technique is generally referred to as :dfn:"
 "`embedding` Python in an application."
 msgstr ""
+"A Interface de Programação de Aplicações (API) para Python fornece aos "
+"programadores C e C++ acesso ao interpretador Python em uma variedade de "
+"níveis. A API pode ser usada igualmente em C++, mas, para abreviar, "
+"geralmente é chamada de API Python/C. Existem dois motivos fundamentalmente "
+"diferentes para usar a API Python/C. A primeira razão é escrever *módulos de "
+"extensão* para propósitos específicos; esses são módulos C que estendem o "
+"interpretador Python. Este é provavelmente o uso mais comum. O segundo "
+"motivo é usar Python como um componente em uma aplicação maior; esta técnica "
+"é geralmente referida como :dfn:`incorporação` Python em uma aplicação."
 
 #: ../../c-api/intro.rst:20
 msgid ""
@@ -66,6 +75,11 @@ msgid ""
 "become familiar with writing an extension before  attempting to embed Python "
 "in a real application."
 msgstr ""
+"Muitas funções da API são úteis independentemente de você estar incorporando "
+"ou estendendo o Python; além disso, a maioria das aplicações que incorporam "
+"Python também precisará fornecer uma extensão customizada, portanto, é "
+"provavelmente uma boa ideia se familiarizar com a escrita de uma extensão "
+"antes de tentar incorporar Python em uma aplicação real."
 
 #: ../../c-api/intro.rst:34
 msgid "Coding standards"
@@ -79,6 +93,12 @@ msgid ""
 "these conventions is not necessary for your own third party extension "
 "modules, unless you eventually expect to contribute them to Python."
 msgstr ""
+"Se você estiver escrevendo código C para inclusão no CPython, **deve** "
+"seguir as diretrizes e padrões definidos na :PEP:`7`. Essas diretrizes se "
+"aplicam independentemente da versão do Python com a qual você está "
+"contribuindo. Seguir essas convenções não é necessário para seus próprios "
+"módulos de extensão de terceiros, a menos que você eventualmente espere "
+"contribuí-los para o Python."
 
 #: ../../c-api/intro.rst:46
 msgid "Include Files"
@@ -89,26 +109,36 @@ msgid ""
 "All function, type and macro definitions needed to use the Python/C API are "
 "included in your code by the following line::"
 msgstr ""
+"Todas as definições de função, tipo e macro necessárias para usar a API "
+"Python/C estão incluídas em seu código pela seguinte linha::"
 
 #: ../../c-api/intro.rst:54
 msgid ""
 "This implies inclusion of the following standard headers: ``<stdio.h>``, "
 "``<string.h>``, ``<errno.h>``, ``<limits.h>``, ``<assert.h>`` and ``<stdlib."
 "h>`` (if available)."
 msgstr ""
+"Isso implica a inclusão dos seguintes cabeçalhos padrão: ``<stdio.h>``, "
+"``<string.h>``, ``<errno.h>``, ``<limits.h>``, ``<assert.h>`` e ``<stdlib."
+"h>`` (se disponível)."
 
 #: ../../c-api/intro.rst:60
 msgid ""
 "Since Python may define some pre-processor definitions which affect the "
 "standard headers on some systems, you *must* include :file:`Python.h` before "
 "any standard headers are included."
 msgstr ""
+"Uma vez que Python pode definir algumas definições de pré-processador que "
+"afetam os cabeçalhos padrão em alguns sistemas, você *deve* incluir :file:"
+"`Python.h` antes de quaisquer cabeçalhos padrão serem incluídos."
 
 #: ../../c-api/intro.rst:64
 msgid ""
 "It is recommended to always define ``PY_SSIZE_T_CLEAN`` before including "
 "``Python.h``.  See :ref:`arg-parsing` for a description of this macro."
 msgstr ""
+"É recomendável sempre definir ``PY_SSIZE_T_CLEAN`` antes de incluir ``Python."
+"h``. Veja :ref:`arg-parsing` para uma descrição desta macro."
 
 #: ../../c-api/intro.rst:67
 msgid ""
@@ -118,6 +148,11 @@ msgid ""
 "implementation and should not be used by extension writers. Structure member "
 "names do not have a reserved prefix."
 msgstr ""
+"Todos os nomes visíveis ao usuário definidos por Python.h (exceto aqueles "
+"definidos pelos cabeçalhos padrão incluídos) têm um dos prefixos ``Py`` ou "
+"``_Py``. Nomes começando com ``_Py`` são para uso interno pela implementação "
+"Python e não devem ser usados por escritores de extensão. Os nomes dos "
+"membros da estrutura não têm um prefixo reservado."
 
 #: ../../c-api/intro.rst:74
 msgid ""
@@ -126,6 +161,10 @@ msgid ""
 "future Python versions, which may define additional names beginning with one "
 "of these prefixes."
 msgstr ""
+"O código do usuário nunca deve definir nomes que começam com ``Py`` ou "
+"``_Py``. Isso confunde o leitor e coloca em risco a portabilidade do código "
+"do usuário para versões futuras do Python, que podem definir nomes "
+"adicionais começando com um desses prefixos."
 
 #: ../../c-api/intro.rst:79
 msgid ""
@@ -138,6 +177,14 @@ msgid ""
 "`{prefix}/include`, where :envvar:`prefix` is the installation directory "
 "specified to the installer."
 msgstr ""
+"Os arquivos de cabeçalho são normalmente instalados com Python. No Unix, "
+"eles estão localizados nos diretórios :file:`{prefix}/include/pythonversion/"
+"` e :file:`{exec_prefix}/include/pythonversion/`, onde :envvar:`prefix` e :"
+"envvar:`exec_prefix` são definidos pelos parâmetros correspondentes ao "
+"script :program:`configure` e *version* do Python é ``'%d.%d' % sys."
+"version_info[:2]``. No Windows, os cabeçalhos são instalados em :file:"
+"`{prefix}/include`, onde :envvar:`prefix` é o diretório de instalação "
+"especificado para o instalador."
 
 #: ../../c-api/intro.rst:88
 msgid ""
@@ -148,13 +195,23 @@ msgid ""
 "envvar:`prefix` include the platform specific headers from :envvar:"
 "`exec_prefix`."
 msgstr ""
+"Para incluir os cabeçalhos, coloque os dois diretórios (se diferentes) no "
+"caminho de pesquisa do compilador para as inclusões. *Não* coloque os "
+"diretórios pais no caminho de busca e então use ``#include <pythonX.Y/Python."
+"h>``; isto irá quebrar em compilações multiplataforma, uma vez que os "
+"cabeçalhos independentes da plataforma em :envvar:`prefix` incluem os "
+"cabeçalhos específicos da plataforma de :envvar:`exec_prefix`."
 
 #: ../../c-api/intro.rst:95
 msgid ""
 "C++ users should note that although the API is defined entirely using C, the "
 "header files properly declare the entry points to be ``extern \"C\"``. As a "
 "result, there is no need to do anything special to use the API from C++."
 msgstr ""
+"Os usuários de C++ devem notar que embora a API seja definida inteiramente "
+"usando C, os arquivos de cabeçalho declaram apropriadamente os pontos de "
+"entrada como ``extern \"C\"``. Como resultado, não há necessidade de fazer "
+"nada especial para usar a API do C++."
 
 #: ../../c-api/intro.rst:101
 msgid "Useful macros"
@@ -167,6 +224,10 @@ msgid ""
 "Others of a more general utility are defined here.  This is not necessarily "
 "a complete listing."
 msgstr ""
+"Diversas macros úteis são definidas nos arquivos de cabeçalho do Python. "
+"Muitas são definidas mais próximas de onde são úteis (por exemplo, :c:macro:"
+"`Py_RETURN_NONE`). Outras de utilidade mais geral são definidas aqui. Esta "
+"não é necessariamente uma lista completa."
 
 #: ../../c-api/intro.rst:110
 msgid ""
@@ -192,22 +253,29 @@ msgstr "Retorna o valor máximo entre ``x`` e ``y``."
 msgid ""
 "Convert ``x`` to a C string.  E.g. ``Py_STRINGIFY(123)`` returns ``\"123\"``."
 msgstr ""
+"Converte ``x`` para uma string C. Por exemplo, ``Py_STRINGIFY(123)`` retorna "
+"``\"123\"``."
 
 #: ../../c-api/intro.rst:144
 msgid "Return the size of a structure (``type``) ``member`` in bytes."
-msgstr ""
+msgstr "Retorna o tamanho do ``member`` de uma estrutura (``type``) em bytes."
 
 #: ../../c-api/intro.rst:150
 msgid ""
 "Argument must be a character or an integer in the range [-128, 127] or [0, "
 "255].  This macro returns ``c`` cast to an ``unsigned char``."
 msgstr ""
+"O argumento deve ser um caractere ou um número inteiro no intervalo [-128, "
+"127] ou [0, 255]. Esta macro retorna ``c`` convertido em um ``unsigned "
+"char``."
 
 #: ../../c-api/intro.rst:155
 msgid ""
 "Like ``getenv(s)``, but returns ``NULL`` if :option:`-E` was passed on the "
 "command line (i.e. if ``Py_IgnoreEnvironmentFlag`` is set)."
 msgstr ""
+"Como ``getenv(s)``, mas retorna ``NULL`` se :option:`-E` foi passada na "
+"linha de comando (isto é, se ``Py_IgnoreEnvironmentFlag`` estiver definida)."
 
 #: ../../c-api/intro.rst:160
 msgid ""
@@ -220,12 +288,16 @@ msgid ""
 "Creates a variable with name ``name`` that can be used in docstrings. If "
 "Python is built without docstrings, the value will be empty."
 msgstr ""
+"Cria uma variável com o nome ``name`` que pode ser usada em docstrings. Se o "
+"Python for compilado sem docstrings, o valor estará vazio."
 
 #: ../../c-api/intro.rst:170
 msgid ""
 "Use :c:macro:`PyDoc_STRVAR` for docstrings to support building Python "
 "without docstrings, as specified in :pep:`7`."
 msgstr ""
+"Use :c:macro:`PyDoc_STRVAR` para docstrings para ter suporte à compilação do "
+"Python sem docstrings, conforme especificado em :pep:`7`."
 
 #: ../../c-api/intro.rst:173 ../../c-api/intro.rst:191
 msgid "Example::"
@@ -236,12 +308,16 @@ msgid ""
 "Creates a docstring for the given input string or an empty string if "
 "docstrings are disabled."
 msgstr ""
+"Cria uma docstring para a string de entrada fornecida ou uma string vazia se "
+"docstrings estiverem desabilitadas."
 
 #: ../../c-api/intro.rst:188
 msgid ""
 "Use :c:macro:`PyDoc_STR` in specifying docstrings to support building Python "
 "without docstrings, as specified in :pep:`7`."
 msgstr ""
+"Use :c:macro:`PyDoc_STR` ao especificar docstrings para ter suporte à "
+"compilação do Python sem docstrings, conforme especificado em :pep:`7`."
 
 #: ../../c-api/intro.rst:202
 msgid "Objects, Types and Reference Counts"
@@ -272,6 +348,13 @@ msgid ""
 "``PyList_Check(a)`` is true if (and only if) the object pointed to by *a* is "
 "a Python list."
 msgstr ""
+"Todos os objetos Python (mesmo inteiros Python) têm um :dfn:`tipo` e uma :"
+"dfn:`contagem de referências`. O tipo de um objeto determina que tipo de "
+"objeto ele é (por exemplo, um número inteiro, uma lista ou uma função "
+"definida pelo usuário; existem muitos mais, conforme explicado em :ref:"
+"`types`). Para cada um dos tipos conhecidos, há uma macro para verificar se "
+"um objeto é desse tipo; por exemplo, ``PyList_Check(a)`` é verdadeiro se (e "
+"somente se) o objeto apontado por *a* for uma lista Python."
 
 #: ../../c-api/intro.rst:228
 msgid "Reference Counts"
diff --git a/extending/extending.po b/extending/extending.po
@@ -110,6 +110,9 @@ msgid ""
 "standard headers on some systems, you *must* include :file:`Python.h` before "
 "any standard headers are included."
 msgstr ""
+"Uma vez que Python pode definir algumas definições de pré-processador que "
+"afetam os cabeçalhos padrão em alguns sistemas, você *deve* incluir :file:"
+"`Python.h` antes de quaisquer cabeçalhos padrão serem incluídos."
 
 #: ../../extending/extending.rst:72
 msgid ""
diff --git a/library/asyncio-queue.po b/library/asyncio-queue.po
@@ -116,6 +116,8 @@ msgstr ""
 msgid ""
 "Return an item if one is immediately available, else raise :exc:`QueueEmpty`."
 msgstr ""
+"Retorna um item se houver um imediatamente disponível, caso contrário "
+"levanta :exc:`QueueEmpty`."
 
 #: ../../library/asyncio-queue.rst:64
 msgid "Block until all items in the queue have been received and processed."
