python
diff --git a/‎distutils/configfile.po‎
Lines changed: 74 additions & 5 deletions b/‎distutils/configfile.po‎
Lines changed: 74 additions & 5 deletions
diff --git a/‎distutils/introduction.po‎
Lines changed: 58 additions & 16 deletions b/‎distutils/introduction.po‎
Lines changed: 58 additions & 16 deletions
@@ -5,7 +5,7 @@
 #
 # Translators:
 # Claudio Rogerio Carvalho Filho <excriptbrasil@gmail.com>, 2017
-# Rafael Fontenelle <rffontenelle@gmail.com>, 2019
+# Rafael Fontenelle <rffontenelle@gmail.com>, 2020
 #
 #, fuzzy
 msgid ""
@@ -14,7 +14,7 @@ msgstr ""
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2020-05-31 09:25+0000\n"
 "PO-Revision-Date: 2017-02-16 17:40+0000\n"
-"Last-Translator: Rafael Fontenelle <rffontenelle@gmail.com>, 2019\n"
+"Last-Translator: Rafael Fontenelle <rffontenelle@gmail.com>, 2020\n"
 "Language-Team: Portuguese (Brazil) (https://www.transifex.com/python-doc/"
 "teams/5390/pt_BR/)\n"
 "MIME-Version: 1.0\n"
@@ -25,7 +25,7 @@ msgstr ""
 
 #: ../../distutils/configfile.rst:5
 msgid "Writing the Setup Configuration File"
-msgstr ""
+msgstr "Escrevendo o arquivo de configuração de instalação"
 
 #: ../../distutils/_setuptools_disclaimer.rst:3
 msgid ""
@@ -50,6 +50,16 @@ msgid ""
 "option, which the installer can then override either on the command-line or "
 "by editing the config file."
 msgstr ""
+"Frequentemente, não é possível escrever tudo o que é necessário para "
+"construir uma distribuição *a priori*: você pode precisar obter algumas "
+"informações do usuário, ou do sistema do usuário, para prosseguir. Contanto "
+"que essa informação seja bastante simples -- uma lista de diretórios para "
+"pesquisar arquivos de cabeçalho C ou bibliotecas, por exemplo -- então "
+"fornecer um arquivo de configuração, :file:`setup.cfg`, para os usuários "
+"editarem é um maneira pouco custosa e fácil de solicitá-la. Os arquivos de "
+"configuração também permitem fornecer valores padrão para qualquer opção de "
+"comando, que o instalador pode então substituir na linha de comando ou "
+"editando o arquivo de configuração."
 
 #: ../../distutils/configfile.rst:18
 msgid ""
@@ -61,28 +71,42 @@ msgid ""
 "after the contents of the setup script, but before the command-line.  This "
 "has  several useful consequences:"
 msgstr ""
+"O arquivo de configuração de instalação é um meio-termo útil entre o script "
+"de instalação -- que, idealmente, deveria ser utilizado sem que os "
+"instaladores se preocupem com seu conteúdo [#]_ -- e a linha de comando para "
+"o script de instalação, que está fora do seu controle e inteiramente a cargo "
+"do instalador. Na verdade, :file:`setup.cfg` (e quaisquer outros arquivos de "
+"configuração Distutils presentes no sistema de destino) são processados após "
+"o conteúdo do script de instalação, mas antes da linha de comando. Isso tem "
+"várias consequências úteis:"
 
 #: ../../distutils/configfile.rst:32
 msgid ""
 "installers can override some of what you put in :file:`setup.py` by editing :"
 "file:`setup.cfg`"
 msgstr ""
+"os instaladores podem substituir parte do que você colocou em :file:`setup."
+"py` editando :file:`setup.cfg`"
 
 #: ../../distutils/configfile.rst:35
 msgid ""
 "you can provide non-standard defaults for options that are not easily set "
 "in :file:`setup.py`"
 msgstr ""
+"você pode fornecer valores iniciais fora do padrão para opções que não são "
+"facilmente definidas em :file:`setup.py`"
 
 #: ../../distutils/configfile.rst:38
 msgid ""
 "installers can override anything in :file:`setup.cfg` using the command-line "
 "options to :file:`setup.py`"
 msgstr ""
+"os instaladores podem substituir qualquer coisa em :file:`setup.cfg` usando "
+"as opções de linha de comando para :file:`setup.py`"
 
 #: ../../distutils/configfile.rst:41
 msgid "The basic syntax of the configuration file is simple:"
-msgstr ""
+msgstr "A sintaxe básica do arquivo de configuração é simples:"
 
 #: ../../distutils/configfile.rst:49
 msgid ""
@@ -94,18 +118,29 @@ msgid ""
 "of the line.  Long option values can be split across multiple lines simply "
 "by indenting the continuation lines."
 msgstr ""
+"sendo *command* um dos comandos Distutils (por exemplo :command:`build_py`, :"
+"command:`install`) e *option* uma das opções as quais o comando tem suporte. "
+"Qualquer número de opções pode ser fornecido para cada comando e qualquer "
+"número de seções de comando pode ser incluído no arquivo. As linhas em "
+"branco são ignoradas, assim como os comentários, que vão de um caractere "
+"``'#'`` até o final da linha. Valores de opção longas podem ser divididos em "
+"várias linhas simplesmente identando as linhas de continuação."
 
 #: ../../distutils/configfile.rst:57
 msgid ""
 "You can find out the list of options supported by a particular command with "
 "the universal :option:`!--help` option, e.g."
 msgstr ""
+"Você pode descobrir a lista de opções suportadas por um comando específico "
+"com a opção universal :option:`!--help`, por exemplo."
 
 #: ../../distutils/configfile.rst:75
 msgid ""
 "Note that an option spelled :option:`!--foo-bar` on the command-line  is "
 "spelled ``foo_bar`` in configuration files."
 msgstr ""
+"Note que uma opção escrita :option:`!--foo-bar` na linha de comando é "
+"escrita ``foo_bar`` nos arquivos de configuração."
 
 #: ../../distutils/configfile.rst:80
 msgid ""
@@ -116,6 +151,12 @@ msgid ""
 "You can always use the :option:`!--inplace` option on the command-line to "
 "ensure this:"
 msgstr ""
+"Por exemplo, digamos que você queira que suas extensões sejam construídas "
+"\"no local\" -- isto é, você tem uma extensão :mod:`pkg.ext`, e deseja o "
+"arquivo de extensão compilado (:file:`ext.so` no Unix, digamos) para serem "
+"colocados no mesmo diretório fonte de seus módulos Python puros :mod:`pkg."
+"mod1` e :mod:`pkg.mod2`. Você sempre pode usar a opção :option:`!--inplace` "
+"na linha de comando para garantir isso:"
 
 #: ../../distutils/configfile.rst:90
 msgid ""
@@ -124,6 +165,10 @@ msgid ""
 "to \"set and forget\" this option, by encoding it in :file:`setup.cfg`, the "
 "configuration file for this distribution:"
 msgstr ""
+"Mas isso requer que você sempre especifique o comando :command:`build_ext` "
+"explicitamente, e que lembre-se de fornecer :option:`!--inplace`. Uma "
+"maneira mais fácil é \"definir e esquecer\" esta opção, codificando-a em :"
+"file:`setup.cfg`, o arquivo de configuração para esta distribuição:"
 
 #: ../../distutils/configfile.rst:100
 msgid ""
@@ -137,6 +182,15 @@ msgid ""
 "extensions that expect to be built in their installation directory is almost "
 "always a bad idea, though.)"
 msgstr ""
+"Isso afetará todas as construções desta distribuição de módulo, quer você "
+"especifique explicitamente ou não :command:`build_ext`. Se você incluir um :"
+"file:`setup.cfg` em sua distribuição fonte, isso também afetará as "
+"construções do usuário final -- o que provavelmente é uma má ideia para esta "
+"opção, já que sempre construir extensões no local interromperia a instalação "
+"da distribuição de módulo. Em certos casos peculiares, porém, os módulos são "
+"construídos diretamente em seu diretório de instalação, portanto, esta é uma "
+"capacidade útil. (Distribuir extensões que esperam ser construídas em seu "
+"diretório de instalação é quase sempre uma má ideia, no entanto.)"
 
 #: ../../distutils/configfile.rst:109
 msgid ""
@@ -149,22 +203,35 @@ msgid ""
 "very tedious to do on the command-line for every run.  Hence, here is a "
 "snippet from the Distutils' own :file:`setup.cfg`:"
 msgstr ""
+"Outro exemplo: certos comandos aceitam muitas opções que não mudam de "
+"execução para execução; por exemplo, :command:`bdist_rpm` precisa saber tudo "
+"o que é necessário para gerar um arquivo \"spec\" para criar uma "
+"distribuição RPM. Algumas dessas informações vêm do script de configuração e "
+"outras são geradas automaticamente pelo Distutils (como a lista de arquivos "
+"instalados). Mas algumas delas devem ser fornecidas como opções para :"
+"command:`bdist_rpm`, o que seria muito tedioso de fazer na linha de comando "
+"para cada execução. Portanto, aqui está um trecho de código do :file:`setup."
+"cfg` do próprio Distutils:"
 
 #: ../../distutils/configfile.rst:129
 msgid ""
 "Note that the ``doc_files`` option is simply a whitespace-separated string "
 "split across multiple lines for readability."
 msgstr ""
+"Note que a opção ``doc_files`` é simplesmente uma string separada por "
+"espaços em branco dividida em várias linhas para facilitar a leitura."
 
 #: ../../distutils/configfile.rst:136
 msgid ":ref:`inst-config-syntax` in \"Installing Python Modules\""
-msgstr ""
+msgstr ":ref:`inst-config-syntax` em \"Instalando Módulos Python\""
 
 #: ../../distutils/configfile.rst:136
 msgid ""
 "More information on the configuration files is available in the manual for "
 "system administrators."
 msgstr ""
+"Mais informações sobre os arquivos de configuração estão disponíveis no "
+"manual para administradores de sistema."
 
 #: ../../distutils/configfile.rst:141
 msgid "Footnotes"
@@ -175,3 +242,5 @@ msgid ""
 "This ideal probably won't be achieved until auto-configuration is fully "
 "supported by the Distutils."
 msgstr ""
+"Este ideal provavelmente não será alcançado até que a configuração "
+"automática seja totalmente suportada pelo Distutils."
@@ -104,13 +104,12 @@ msgstr ""
 "plataformas, portanto, nem sempre é possível esperar que eles criem uma "
 "infinidade de distribuições construídas. Espera-se que uma classe de "
 "intermediários, chamada *empacotadores*, surja para atender a essa "
-"necessidade. Os empacotadores pegam as distribuições de código-fonte "
-"lançadas pelos desenvolvedores do módulo, as compilam em uma ou mais "
-"plataformas e lançam as distribuições compiladas resultantes. Assim, os "
-"usuários das plataformas mais populares poderão instalar as distribuições "
-"mais populares de módulos Python da maneira mais natural possível para sua "
-"plataforma, sem precisar executar um único script de configuração ou "
-"compilar uma linha de código."
+"necessidade. Os empacotadores pegam as distribuições fonte lançadas pelos "
+"desenvolvedores do módulo, as compilam em uma ou mais plataformas e lançam "
+"as distribuições compiladas resultantes. Assim, os usuários das plataformas "
+"mais populares poderão instalar as distribuições mais populares de módulos "
+"Python da maneira mais natural possível para sua plataforma, sem precisar "
+"executar um único script de configuração ou compilar uma linha de código."
 
 #: ../../distutils/introduction.rst:49
 msgid "A Simple Example"
@@ -188,7 +187,7 @@ msgid ""
 "script, :file:`setup.py`, containing the above code, and run this command "
 "from a terminal::"
 msgstr ""
-"Para criar uma distribuição de fontes para este módulo, você deve criar um "
+"Para criar uma distribuição fonte para este módulo, você deve criar um "
 "script de instalação, :file:`setup.py`, contendo o código acima, e executar "
 "este comando a partir de um terminal::"
 
@@ -304,7 +303,7 @@ msgstr ""
 
 #: ../../distutils/introduction.rst:147
 msgid "General Python terminology"
-msgstr ""
+msgstr "Terminologia geral do Python"
 
 #: ../../distutils/introduction.rst:149
 msgid ""
@@ -313,6 +312,10 @@ msgid ""
 "everyone is operating from a common starting point, we offer the following "
 "glossary of common Python terms:"
 msgstr ""
+"Se você está lendo este documento, provavelmente tem uma boa ideia do que "
+"são módulos, extensões e assim por diante. No entanto, apenas para ter "
+"certeza de que todos estão operando de um ponto de partida comum, oferecemos "
+"o seguinte glossário de termos comuns do Python:"
 
 #: ../../distutils/introduction.rst:157
 msgid "module"
@@ -324,17 +327,23 @@ msgid ""
 "some other code.  Three types of modules concern us here: pure Python "
 "modules, extension modules, and packages."
 msgstr ""
+"a unidade básica de reutilização de código em Python: um bloco de código "
+"importado por algum outro código. Três tipos de módulos nos importam aqui: "
+"módulos Python puros, módulos de extensão e pacotes."
 
 #: ../../distutils/introduction.rst:162
 msgid "pure Python module"
-msgstr ""
+msgstr "pure Python module (módulo Python puro)"
 
 #: ../../distutils/introduction.rst:160
 msgid ""
 "a module written in Python and contained in a single :file:`.py` file (and "
 "possibly associated :file:`.pyc` files).  Sometimes referred to as a \"pure "
 "module.\""
 msgstr ""
+"um módulo escrito em Python e contido em um único arquivo :file:`.py` (e "
+"possivelmente arquivos :file:`.pyc` associados). Às vezes referido como um "
+"\"módulo puro\"."
 
 #: ../../distutils/introduction.rst:170
 msgid "extension module"
@@ -350,6 +359,13 @@ msgid ""
 "(Note that currently, the Distutils only handles C/C++ extensions for "
 "Python.)"
 msgstr ""
+"um módulo escrito na linguagem de baixo nível da implementação Python: C/C++ "
+"para Python, Java para Jython. Normalmente contido em um único arquivo pré-"
+"compilado carregável dinamicamente, por exemplo, um arquivo de objeto "
+"compartilhado (:file:`.so`) para extensões Python no Unix, uma DLL (dada a "
+"extensão :file:`.pyd`) para extensões Python no Windows ou um arquivo de "
+"classe Java para extensões Jython. (Observe que, atualmente, o Distutils só "
+"lida com extensões C/C++ para Python.)"
 
 #: ../../distutils/introduction.rst:175
 msgid "package"
@@ -361,10 +377,13 @@ msgid ""
 "the filesystem and distinguished from other directories by the presence of a "
 "file :file:`__init__.py`."
 msgstr ""
+"um módulo que contém outros módulos; tipicamente contido em um diretório no "
+"sistema de arquivos e diferenciado de outros diretórios pela presença de um "
+"arquivo :file:`__init__.py`."
 
 #: ../../distutils/introduction.rst:185
 msgid "root package"
-msgstr ""
+msgstr "root package (pacote raiz)"
 
 #: ../../distutils/introduction.rst:178
 msgid ""
@@ -376,20 +395,30 @@ msgid ""
 "package can be found in many directories: in fact, every directory listed in "
 "``sys.path`` contributes modules to the root package."
 msgstr ""
+"a raiz da hierarquia de pacotes. (Este não é realmente um pacote, uma vez "
+"que não possui um arquivo :file:`__init__.py`. Mas temos que chamá-lo de "
+"alguma coisa.) A grande maioria da biblioteca padrão está no pacote raiz, "
+"assim como muitos módulos pequenos e independentes de terceiros que não "
+"pertencem a uma coleção de módulos maior. Ao contrário dos pacotes "
+"regulares, os módulos no pacote raiz podem ser encontrados em muitos "
+"diretórios: na verdade, cada diretório listado em ``sys.path`` contribui com "
+"módulos para o pacote raiz."
 
 #: ../../distutils/introduction.rst:190
 msgid "Distutils-specific terminology"
-msgstr ""
+msgstr "Terminologia específica do Distutils"
 
 #: ../../distutils/introduction.rst:192
 msgid ""
 "The following terms apply more specifically to the domain of distributing "
 "Python modules using the Distutils:"
 msgstr ""
+"Os termos a seguir se aplicam mais especificamente ao domínio de "
+"distribuição de módulos Python usando Distutils:"
 
 #: ../../distutils/introduction.rst:201
 msgid "module distribution"
-msgstr ""
+msgstr "module distribution (distribuição de módulo)"
 
 #: ../../distutils/introduction.rst:196
 msgid ""
@@ -399,34 +428,47 @@ msgid ""
 "called a *package*, except that term is already taken in the Python context: "
 "a single module distribution may contain zero, one, or many Python packages.)"
 msgstr ""
+"uma coleção de módulos Python distribuídos juntos como um único recurso para "
+"download e devem ser instalados *em massa*. Exemplos de algumas "
+"distribuições de módulos bem conhecidas são NumPy, SciPy, Pillow ou mxBase. "
+"(Isso seria chamado de *pacote*, exceto que o termo já é usado no contexto "
+"Python: uma distribuição de módulo único pode conter zero, um ou muitos "
+"pacotes Python.)"
 
 #: ../../distutils/introduction.rst:205
 msgid "pure module distribution"
-msgstr ""
+msgstr "pure module distribution (distribuição de módulo pura)"
 
 #: ../../distutils/introduction.rst:204
 msgid ""
 "a module distribution that contains only pure Python modules and packages. "
 "Sometimes referred to as a \"pure distribution.\""
 msgstr ""
+"uma distribuição de módulo que contém apenas módulos e pacotes Python puros. "
+"Às vezes chamada de \"distribuição pura\"."
 
 #: ../../distutils/introduction.rst:209
 msgid "non-pure module distribution"
-msgstr ""
+msgstr "non-pure module distribution (distribuição de módulo não pura)"
 
 #: ../../distutils/introduction.rst:208
 msgid ""
 "a module distribution that contains at least one extension module.  "
 "Sometimes referred to as a \"non-pure distribution.\""
 msgstr ""
+"uma distribuição de módulo que contém pelo menos um módulo de extensão. Às "
+"vezes chamada de \"distribuição não pura\"."
 
 #: ../../distutils/introduction.rst:213
 msgid "distribution root"
-msgstr ""
+msgstr "distribution root (raiz da distribuição)"
 
 #: ../../distutils/introduction.rst:212
 msgid ""
 "the top-level directory of your source tree (or  source distribution); the "
 "directory where :file:`setup.py` exists.  Generally  :file:`setup.py` will "
 "be run from this directory."
 msgstr ""
+"o diretório de nível superior de sua árvore de fontes (ou distribuição "
+"fonte); o diretório onde existe :file:`setup.py`. Geralmente, :file:`setup."
+"py` vai ser executado a partir deste diretório."