# SOME DESCRIPTIVE TITLE.

# Copyright (C) 2001-2024, Python Software Foundation

# This file is distributed under the same license as the Python package.

# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.

#

# Translators:

# And Past <andrepgs@gmail.com>, 2020

# Marco Rougeth <marco@rougeth.com>, 2020

# Hildeberto Abreu Magalhães <hildeberto@gmail.com>, 2020

# Claudio Rogerio Carvalho Filho <excriptbrasil@gmail.com>, 2020

# Ricardo Cappellano <rcappellano@gmail.com>, 2020

# Augusta Carla Klug <augustaklug@gmail.com>, 2021

# Leandro Cavalcante Damascena <leandro.damascena@gmail.com>, 2024

# Rafael Fontenelle <rffontenelle@gmail.com>, 2024

#

#, fuzzy

msgid ""

msgstr ""

"Project-Id-Version: Python 3.8\n"

"Report-Msgid-Bugs-To: \n"

"POT-Creation-Date: 2024-08-31 13:50+0000\n"

"PO-Revision-Date: 2020-05-30 11:52+0000\n"

"Last-Translator: Rafael Fontenelle <rffontenelle@gmail.com>, 2024\n"

"Language-Team: Portuguese (Brazil) (https://app.transifex.com/python-doc/"

"teams/5390/pt_BR/)\n"

"Language: pt_BR\n"

"MIME-Version: 1.0\n"

"Content-Type: text/plain; charset=UTF-8\n"

"Content-Transfer-Encoding: 8bit\n"

"Plural-Forms: nplurals=3; plural=(n == 0 || n == 1) ? 0 : n != 0 && n % "

"1000000 == 0 ? 1 : 2;\n"

#: ../../distutils/apiref.rst:5

msgid "API Reference"

msgstr "Referência da API"

#: ../../distutils/apiref.rst:11

msgid "`New and changed setup.py arguments in setuptools`_"

msgstr ""

#: ../../distutils/apiref.rst:10

msgid ""

"The ``setuptools`` project adds new capabilities to the ``setup`` function "

"and other APIs, makes the API consistent across different Python versions, "

"and is hence recommended over using ``distutils`` directly."

msgstr ""

#: ../../distutils/_setuptools_disclaimer.rst:3

msgid ""

"This document is being retained solely until the ``setuptools`` "

"documentation at https://setuptools.readthedocs.io/en/latest/setuptools.html "

"independently covers all of the relevant information currently included here."

msgstr ""

"Este documento está sendo mantido apenas até que a documentação do "

"``setuptools`` em https://setuptools.readthedocs.io/en/latest/"

"setuptools.html cubra independentemente todas as informações relevantes "

"atualmente incluídas aqui."

#: ../../distutils/apiref.rst:19

msgid ":mod:`distutils.core` --- Core Distutils functionality"

msgstr ":mod:`distutils.core` --- funcionalidade principal Distutils"

#: ../../distutils/apiref.rst:25

msgid ""

"The :mod:`distutils.core` module is the only module that needs to be "

"installed to use the Distutils. It provides the :func:`setup` (which is "

"called from the setup script). Indirectly provides "

"the :class:`distutils.dist.Distribution` and :class:`distutils.cmd.Command` "

"class."

msgstr ""

"O módulo :mod:`distutils.core` é o único módulo que necessita ser instalado "

"para usar Distutils. Provê a função :func:`setup` (que é chamada do script "

"setup). Indiretamente provê as classes :class:`distutils.dist.Distribution` "

"e :class:`distutils.cmd.Command`."

#: ../../distutils/apiref.rst:33

msgid ""

"The basic do-everything function that does most everything you could ever "

"ask for from a Distutils method."

msgstr ""

"A função faz-tudo básica, que faz quase tudo que você poderia querer de um "

"método Distutils."

#: ../../distutils/apiref.rst:36

msgid ""

"The setup function takes a large number of arguments. These are laid out in "

"the following table."

msgstr ""

"A função setup recebe um grande número de argumentos. São apresentados na "

"tabela a seguir."

#: ../../distutils/apiref.rst:42 ../../distutils/apiref.rst:185

msgid "argument name"

msgstr "nome do argumento"

#: ../../distutils/apiref.rst:42 ../../distutils/apiref.rst:143

#: ../../distutils/apiref.rst:185

msgid "value"

msgstr "valor"

#: ../../distutils/apiref.rst:42 ../../distutils/apiref.rst:185

msgid "type"

msgstr "tipo"

#: ../../distutils/apiref.rst:44 ../../distutils/apiref.rst:187

msgid "*name*"

msgstr "*name*"

#: ../../distutils/apiref.rst:44

msgid "The name of the package"

msgstr "O nome do pacote"

#: ../../distutils/apiref.rst:44 ../../distutils/apiref.rst:46

#: ../../distutils/apiref.rst:50 ../../distutils/apiref.rst:53

#: ../../distutils/apiref.rst:56 ../../distutils/apiref.rst:58

#: ../../distutils/apiref.rst:61 ../../distutils/apiref.rst:68

#: ../../distutils/apiref.rst:72 ../../distutils/apiref.rst:75

#: ../../distutils/apiref.rst:96 ../../distutils/apiref.rst:106

#: ../../distutils/apiref.rst:187 ../../distutils/apiref.rst:278

msgid "a string"

msgstr "uma string"

#: ../../distutils/apiref.rst:46

msgid "*version*"

msgstr "*version*"

#: ../../distutils/apiref.rst:46

msgid "The version number of the package; see :mod:`distutils.version`"

msgstr "O número da versão do pacote; veja :mod:`distutils.version`"

#: ../../distutils/apiref.rst:50

msgid "*description*"

msgstr "*description*"

#: ../../distutils/apiref.rst:50

msgid "A single line describing the package"

msgstr "Um resumo descrevendo o pacote"

#: ../../distutils/apiref.rst:53

msgid "*long_description*"

msgstr "*long_description*"

#: ../../distutils/apiref.rst:53

msgid "Longer description of the package"

msgstr "Descrição mais longa do pacote"

#: ../../distutils/apiref.rst:56

msgid "*author*"

msgstr "*author*"

#: ../../distutils/apiref.rst:56

msgid "The name of the package author"

msgstr "O nome do autor do pacote"

#: ../../distutils/apiref.rst:58

msgid "*author_email*"

msgstr "*author_email*"

#: ../../distutils/apiref.rst:58

msgid "The email address of the package author"

msgstr "O endereço de e-mail do autor do pacote"

#: ../../distutils/apiref.rst:61

msgid "*maintainer*"

msgstr "*maintainer*"

#: ../../distutils/apiref.rst:61

msgid ""

"The name of the current maintainer, if different from the author. Note that "

"if the maintainer is provided, distutils will use it as the author "

"in :file:`PKG-INFO`"

msgstr ""

"O nome do mantenedor atual, se for diferente do autor. Observe que s o "

"mantenedor for fornecido, distutils vai usá-lo como autor, no "

"arquivo :file:`PKG-INFO`"

#: ../../distutils/apiref.rst:68

msgid "*maintainer_email*"

msgstr "*maintainer_email*"

#: ../../distutils/apiref.rst:68

msgid ""

"The email address of the current maintainer, if different from the author"

msgstr "O endereço de e-mail do mantenedor atual, se diferente do autor"

#: ../../distutils/apiref.rst:72

msgid "*url*"

msgstr "*url*"

#: ../../distutils/apiref.rst:72

msgid "A URL for the package (homepage)"

msgstr "Uma URL para o pacote (homepage)"

#: ../../distutils/apiref.rst:75

msgid "*download_url*"

msgstr "*download_url*"

#: ../../distutils/apiref.rst:75

msgid "A URL to download the package"

msgstr "Uma URL para baixar o pacote"

#: ../../distutils/apiref.rst:77

msgid "*packages*"

msgstr "*packages*"

#: ../../distutils/apiref.rst:77

msgid "A list of Python packages that distutils will manipulate"

msgstr "Uma lista de pacotes Python que distutils vai manipular"

#: ../../distutils/apiref.rst:77 ../../distutils/apiref.rst:80

#: ../../distutils/apiref.rst:83 ../../distutils/apiref.rst:100

#: ../../distutils/apiref.rst:193 ../../distutils/apiref.rst:207

#: ../../distutils/apiref.rst:223 ../../distutils/apiref.rst:226

#: ../../distutils/apiref.rst:230 ../../distutils/apiref.rst:234

#: ../../distutils/apiref.rst:240 ../../distutils/apiref.rst:247

#: ../../distutils/apiref.rst:258 ../../distutils/apiref.rst:267

#: ../../distutils/apiref.rst:275

msgid "a list of strings"

msgstr "uma lista de strings"

#: ../../distutils/apiref.rst:80

msgid "*py_modules*"

msgstr "*py_modules*"

#: ../../distutils/apiref.rst:80

msgid "A list of Python modules that distutils will manipulate"

msgstr "Uma lista de módulos Python que distutils vai manipular"

#: ../../distutils/apiref.rst:83

msgid "*scripts*"

msgstr "*scripts*"

#: ../../distutils/apiref.rst:83

msgid "A list of standalone script files to be built and installed"

msgstr "Uma lista de arquivos script que serão construídos e instalados"

#: ../../distutils/apiref.rst:87

msgid "*ext_modules*"

msgstr "*ext_modules*"

#: ../../distutils/apiref.rst:87

msgid "A list of Python extensions to be built"

msgstr "Uma lista de extensões Python que serão construídas"

#: ../../distutils/apiref.rst:87

msgid "a list of instances of :class:`distutils.core.Extension`"

msgstr "uma lista de instâncias da classe :class:`distutils.core.Extension`"

#: ../../distutils/apiref.rst:90

msgid "*classifiers*"

msgstr "*classifiers*"

#: ../../distutils/apiref.rst:90

msgid "A list of categories for the package"

msgstr "Uma lista de categorias para o pacote"

#: ../../distutils/apiref.rst:90

msgid ""

"a list of strings; valid classifiers are listed on `PyPI <https://pypi.org/"

"classifiers>`_."

msgstr ""

"uma lista de strings; classificadores válidos são listados no `PyPI <https://"

"pypi.org/classifiers>`_."

#: ../../distutils/apiref.rst:93

msgid "*distclass*"

msgstr "*distclass*"

#: ../../distutils/apiref.rst:93

msgid "the :class:`Distribution` class to use"

msgstr "a classe :class:`Distribution` a ser usada"

#: ../../distutils/apiref.rst:93

msgid "a subclass of :class:`distutils.core.Distribution`"

msgstr "uma subclasse de :class:`distutils.core.Distribution`"

#: ../../distutils/apiref.rst:96

msgid "*script_name*"

msgstr "*script_name*"

#: ../../distutils/apiref.rst:96

msgid "The name of the setup.py script - defaults to ``sys.argv[0]``"

msgstr "O nome do script setup.py - padrão é ``sys.argv[0]``"

#: ../../distutils/apiref.rst:100

msgid "*script_args*"

msgstr "*script_args*"

#: ../../distutils/apiref.rst:100

msgid "Arguments to supply to the setup script"

msgstr "Argumentos fornecidos ao script setup"

#: ../../distutils/apiref.rst:103

msgid "*options*"

msgstr "*options*"

#: ../../distutils/apiref.rst:103

msgid "default options for the setup script"

msgstr "opções padrão para o script setup"

#: ../../distutils/apiref.rst:103 ../../distutils/apiref.rst:113

#: ../../distutils/apiref.rst:119

msgid "a dictionary"

msgstr "um dicionário"

#: ../../distutils/apiref.rst:106

msgid "*license*"

msgstr "*license*"

#: ../../distutils/apiref.rst:106

msgid "The license for the package"

msgstr "A licença para o pacote"

#: ../../distutils/apiref.rst:108

msgid "*keywords*"

msgstr "*keywords*"

#: ../../distutils/apiref.rst:108

msgid "Descriptive meta-data, see :pep:`314`"

msgstr "Metadados descritivos, veja :pep:`314`"

#: ../../distutils/apiref.rst:108 ../../distutils/apiref.rst:111

msgid "a list of strings or a comma-separated string"

msgstr "uma lista de strings ou strings separadas por vírgula"

#: ../../distutils/apiref.rst:111

msgid "*platforms*"

msgstr "*platforms*"

#: ../../distutils/apiref.rst:113

msgid "*cmdclass*"

msgstr "*cmdclass*"

#: ../../distutils/apiref.rst:113

msgid "A mapping of command names to :class:`Command` subclasses"

msgstr "Um mapeamento de nomes de comando para subclasses :class:`Command`"

#: ../../distutils/apiref.rst:116

msgid "*data_files*"

msgstr "*data_files*"

#: ../../distutils/apiref.rst:116

msgid "A list of data files to install"

msgstr "Uma lista de arquivos de dados para instalar"

#: ../../distutils/apiref.rst:116

msgid "a list"

msgstr "uma lista"

#: ../../distutils/apiref.rst:119

msgid "*package_dir*"

msgstr "*package_dir*"

#: ../../distutils/apiref.rst:119

msgid "A mapping of package to directory names"

msgstr "Um mapeamento do pacote para nomes de diretórios"

#: ../../distutils/apiref.rst:127

msgid ""

"Run a setup script in a somewhat controlled environment, and return "

"the :class:`distutils.dist.Distribution` instance that drives things. This "

"is useful if you need to find out the distribution meta-data (passed as "

"keyword args from *script* to :func:`setup`), or the contents of the config "

"files or command-line."

msgstr ""

#: ../../distutils/apiref.rst:133

msgid ""

"*script_name* is a file that will be read and run with :func:`exec`. "

"``sys.argv[0]`` will be replaced with *script* for the duration of the "

"call. *script_args* is a list of strings; if supplied, ``sys.argv[1:]`` "

"will be replaced by *script_args* for the duration of the call."

msgstr ""

#: ../../distutils/apiref.rst:138

msgid ""

"*stop_after* tells :func:`setup` when to stop processing; possible values:"

msgstr ""

#: ../../distutils/apiref.rst:143 ../../distutils/apiref.rst:562

#: ../../distutils/apiref.rst:1583

msgid "description"

msgstr "description"

#: ../../distutils/apiref.rst:145

msgid "*init*"

msgstr "*init*"

#: ../../distutils/apiref.rst:145

msgid ""

"Stop after the :class:`Distribution` instance has been created and "

"populated with the keyword arguments to :func:`setup`"

msgstr ""

#: ../../distutils/apiref.rst:149

msgid "*config*"

msgstr "*config*"

#: ../../distutils/apiref.rst:149

msgid ""

"Stop after config files have been parsed (and their data stored in "

"the :class:`Distribution` instance)"

msgstr ""

#: ../../distutils/apiref.rst:153

msgid "*commandline*"

msgstr "*commandline*"

#: ../../distutils/apiref.rst:153

msgid ""

"Stop after the command-line (``sys.argv[1:]`` or *script_args*) have been "

"parsed (and the data stored in the :class:`Distribution` instance.)"

msgstr ""

#: ../../distutils/apiref.rst:158

msgid "*run*"

msgstr "*run*"

#: ../../distutils/apiref.rst:158

msgid ""

"Stop after all commands have been run (the same as if :func:`setup` had "

"been called in the usual way). This is the default value."

msgstr ""

#: ../../distutils/apiref.rst:164

msgid ""

"In addition, the :mod:`distutils.core` module exposed a number of classes "

"that live elsewhere."

msgstr ""

#: ../../distutils/apiref.rst:167

msgid ":class:`~distutils.extension.Extension` from :mod:`distutils.extension`"

msgstr ""

":class:`~distutils.extension.Extension` from :mod:`distutils.extension`"

#: ../../distutils/apiref.rst:169

msgid ":class:`~distutils.cmd.Command` from :mod:`distutils.cmd`"

msgstr ":class:`~distutils.cmd.Command` from :mod:`distutils.cmd`"

#: ../../distutils/apiref.rst:171

msgid ":class:`~distutils.dist.Distribution` from :mod:`distutils.dist`"

msgstr ":class:`~distutils.dist.Distribution` from :mod:`distutils.dist`"

#: ../../distutils/apiref.rst:173

msgid ""

"A short description of each of these follows, but see the relevant module "

"for the full reference."

msgstr ""

#: ../../distutils/apiref.rst:179

msgid ""

"The Extension class describes a single C or C++ extension module in a setup "

"script. It accepts the following keyword arguments in its constructor:"

msgstr ""

#: ../../distutils/apiref.rst:187

msgid ""

"the full name of the extension, including any packages --- ie. *not* a "

"filename or pathname, but Python dotted name"

msgstr ""

#: ../../distutils/apiref.rst:193

msgid "*sources*"

msgstr ""

#: ../../distutils/apiref.rst:193

msgid ""

"list of source filenames, relative to the distribution root (where the setup "

"script lives), in Unix form (slash-separated) for portability. Source files "

"may be C, C++, SWIG (.i), platform-specific resource files, or whatever else "

"is recognized by the :command:`build_ext` command as source for a Python "

"extension."

msgstr ""

#: ../../distutils/apiref.rst:207

msgid "*include_dirs*"

msgstr ""

#: ../../distutils/apiref.rst:207

msgid ""

"list of directories to search for C/C++ header files (in Unix form for "

"portability)"

msgstr ""

#: ../../distutils/apiref.rst:211

msgid "*define_macros*"

msgstr ""

#: ../../distutils/apiref.rst:211

msgid ""

"list of macros to define; each macro is defined using a 2-tuple ``(name, "

"value)``, where *value* is either the string to define it to or ``None`` to "

"define it without a particular value (equivalent of ``#define FOO`` in "

"source or :option:`!-DFOO` on Unix C compiler command line)"

msgstr ""

#: ../../distutils/apiref.rst:211

msgid "a list of tuples"

msgstr ""

#: ../../distutils/apiref.rst:223

msgid "*undef_macros*"

msgstr ""

#: ../../distutils/apiref.rst:223

msgid "list of macros to undefine explicitly"

msgstr ""

#: ../../distutils/apiref.rst:226

msgid "*library_dirs*"

msgstr ""

#: ../../distutils/apiref.rst:226

msgid "list of directories to search for C/C++ libraries at link time"

msgstr ""

#: ../../distutils/apiref.rst:230

msgid "*libraries*"

msgstr ""

#: ../../distutils/apiref.rst:230

msgid "list of library names (not filenames or paths) to link against"

msgstr ""

#: ../../distutils/apiref.rst:234

msgid "*runtime_library_dirs*"

msgstr ""

#: ../../distutils/apiref.rst:234

msgid ""

"list of directories to search for C/C++ libraries at run time (for shared "

"extensions, this is when the extension is loaded)"

msgstr ""

#: ../../distutils/apiref.rst:240

msgid "*extra_objects*"

msgstr ""

#: ../../distutils/apiref.rst:240

msgid ""

"list of extra files to link with (eg. object files not implied by 'sources', "

"static library that must be explicitly specified, binary resource files, "

"etc.)"

msgstr ""

#: ../../distutils/apiref.rst:247

msgid "*extra_compile_args*"

msgstr ""

#: ../../distutils/apiref.rst:247

msgid ""

"any extra platform- and compiler-specific information to use when compiling "

"the source files in 'sources'. For platforms and compilers where a command "

"line makes sense, this is typically a list of command-line arguments, but "

"for other platforms it could be anything."

msgstr ""

#: ../../distutils/apiref.rst:258

msgid "*extra_link_args*"

msgstr ""

#: ../../distutils/apiref.rst:258

msgid ""

"any extra platform- and compiler-specific information to use when linking "

"object files together to create the extension (or to create a new static "

"Python interpreter). Similar interpretation as for 'extra_compile_args'."

msgstr ""

#: ../../distutils/apiref.rst:267

msgid "*export_symbols*"

msgstr ""

#: ../../distutils/apiref.rst:267

msgid ""

"list of symbols to be exported from a shared extension. Not used on all "

"platforms, and not generally necessary for Python extensions, which "

"typically export exactly one symbol: ``init`` + extension_name."

msgstr ""

#: ../../distutils/apiref.rst:275

msgid "*depends*"

msgstr ""

#: ../../distutils/apiref.rst:275

msgid "list of files that the extension depends on"

msgstr ""

#: ../../distutils/apiref.rst:278

msgid "*language*"

msgstr ""

#: ../../distutils/apiref.rst:278

msgid ""

"extension language (i.e. ``'c'``, ``'c++'``, ``'objc'``). Will be detected "

"from the source extensions if not provided."

msgstr ""

#: ../../distutils/apiref.rst:284

msgid "*optional*"

msgstr ""

#: ../../distutils/apiref.rst:284

msgid ""

"specifies that a build failure in the extension should not abort the build "

"process, but simply skip the extension."

msgstr ""

#: ../../distutils/apiref.rst:284

msgid "a boolean"

msgstr "um valor booleano"

#: ../../distutils/apiref.rst:292

msgid ""

"On Unix, C extensions are no longer linked to libpython except on Android "

"and Cygwin."

msgstr ""

#: ../../distutils/apiref.rst:298

msgid ""

"A :class:`Distribution` describes how to build, install and package up a "

"Python software package."

msgstr ""

#: ../../distutils/apiref.rst:301

msgid ""

"See the :func:`setup` function for a list of keyword arguments accepted by "

"the Distribution constructor. :func:`setup` creates a Distribution instance."

msgstr ""

#: ../../distutils/apiref.rst:304

msgid ""

":class:`~distutils.core.Distribution` now warns if ``classifiers``, "

"``keywords`` and ``platforms`` fields are not specified as a list or a "

"string."

msgstr ""

#: ../../distutils/apiref.rst:311

msgid ""

"A :class:`Command` class (or rather, an instance of one of its subclasses) "

"implement a single distutils command."

msgstr ""

#: ../../distutils/apiref.rst:316

msgid ":mod:`distutils.ccompiler` --- CCompiler base class"

msgstr ""

#: ../../distutils/apiref.rst:322

msgid ""

"This module provides the abstract base class for the :class:`CCompiler` "

"classes. A :class:`CCompiler` instance can be used for all the compile and "

"link steps needed to build a single project. Methods are provided to set "

"options for the compiler --- macro definitions, include directories, link "

"path, libraries and the like."

msgstr ""

#: ../../distutils/apiref.rst:328

msgid "This module provides the following functions."

msgstr ""

#: ../../distutils/apiref.rst:333

msgid ""

"Generate linker options for searching library directories and linking with "

"specific libraries. *libraries* and *library_dirs* are, respectively, lists "

"of library names (not filenames!) and search directories. Returns a list of "

"command-line options suitable for use with some compiler (depending on the "

"two format strings passed in)."

msgstr ""

#: ../../distutils/apiref.rst:342

msgid ""

"Generate C pre-processor options (:option:`!-D`, :option:`!-U`, :option:`!-"

"I`) as used by at least two types of compilers: the typical Unix compiler "

"and Visual C++. *macros* is the usual thing, a list of 1- or 2-tuples, where "

"``(name,)`` means undefine (:option:`!-U`) macro *name*, and ``(name, "

"value)`` means define (:option:`!-D`) macro *name* to *value*. "

"*include_dirs* is just a list of directory names to be added to the header "

"file search path (:option:`!-I`). Returns a list of command-line options "

"suitable for either Unix compilers or Visual C++."

msgstr ""

#: ../../distutils/apiref.rst:354

msgid "Determine the default compiler to use for the given platform."

msgstr ""

#: ../../distutils/apiref.rst:356

msgid ""

"*osname* should be one of the standard Python OS names (i.e. the ones "

"returned by ``os.name``) and *platform* the common value returned by "

"``sys.platform`` for the platform in question."

msgstr ""

#: ../../distutils/apiref.rst:360

msgid ""

"The default values are ``os.name`` and ``sys.platform`` in case the "

"parameters are not given."

msgstr ""

#: ../../distutils/apiref.rst:366

msgid ""

"Factory function to generate an instance of some CCompiler subclass for the "

"supplied platform/compiler combination. *plat* defaults to ``os.name`` (eg. "

"``'posix'``, ``'nt'``), and *compiler* defaults to the default compiler for "

"that platform. Currently only ``'posix'`` and ``'nt'`` are supported, and "

"the default compilers are \"traditional Unix interface\" "

"(:class:`UnixCCompiler` class) and Visual C++ (:class:`MSVCCompiler` "

"class). Note that it's perfectly possible to ask for a Unix compiler object "

"under Windows, and a Microsoft compiler object under Unix---if you supply a "

"value for *compiler*, *plat* is ignored."

msgstr ""

#: ../../distutils/apiref.rst:382

msgid ""

"Print list of available compilers (used by the :option:`!--help-compiler` "

"options to :command:`build`, :command:`build_ext`, :command:`build_clib`)."

msgstr ""

#: ../../distutils/apiref.rst:388

msgid ""

"The abstract base class :class:`CCompiler` defines the interface that must "

"be implemented by real compiler classes. The class also has some utility "

"methods used by several compiler classes."

msgstr ""

#: ../../distutils/apiref.rst:392

msgid ""

"The basic idea behind a compiler abstraction class is that each instance can "

"be used for all the compile/link steps in building a single project. Thus, "

"attributes common to all of those compile and link steps --- include "

"directories, macros to define, libraries to link against, etc. --- are "

"attributes of the compiler instance. To allow for variability in how "

"individual files are treated, most of those attributes may be varied on a "

"per-compilation or per-link basis."

msgstr ""

#: ../../distutils/apiref.rst:400

msgid ""

"The constructor for each subclass creates an instance of the Compiler "

"object. Flags are *verbose* (show verbose output), *dry_run* (don't actually "

"execute the steps) and *force* (rebuild everything, regardless of "

"dependencies). All of these flags default to ``0`` (off). Note that you "

"probably don't want to instantiate :class:`CCompiler` or one of its "

"subclasses directly - use the :func:`distutils.CCompiler.new_compiler` "

"factory function instead."

msgstr ""

#: ../../distutils/apiref.rst:407

msgid ""

"The following methods allow you to manually alter compiler options for the "

"instance of the Compiler class."

msgstr ""

#: ../../distutils/apiref.rst:413

msgid ""

"Add *dir* to the list of directories that will be searched for header files. "

"The compiler is instructed to search directories in the order in which they "

"are supplied by successive calls to :meth:`add_include_dir`."

msgstr ""

#: ../../distutils/apiref.rst:420

msgid ""

"Set the list of directories that will be searched to *dirs* (a list of "

"strings). Overrides any preceding calls to :meth:`add_include_dir`; "

"subsequent calls to :meth:`add_include_dir` add to the list passed "

"to :meth:`set_include_dirs`. This does not affect any list of standard "

"include directories that the compiler may search by default."

msgstr ""

#: ../../distutils/apiref.rst:429

msgid ""

"Add *libname* to the list of libraries that will be included in all links "

"driven by this compiler object. Note that *libname* should \\*not\\* be the "

"name of a file containing a library, but the name of the library itself: the "

"actual filename will be inferred by the linker, the compiler, or the "

"compiler class (depending on the platform)."

msgstr ""

#: ../../distutils/apiref.rst:435

msgid ""

"The linker will be instructed to link against libraries in the order they "

"were supplied to :meth:`add_library` and/or :meth:`set_libraries`. It is "

"perfectly valid to duplicate library names; the linker will be instructed to "

"link against libraries as many times as they are mentioned."

msgstr ""

#: ../../distutils/apiref.rst:443

msgid ""

"Set the list of libraries to be included in all links driven by this "

"compiler object to *libnames* (a list of strings). This does not affect any "

"standard system libraries that the linker may include by default."

msgstr ""

#: ../../distutils/apiref.rst:450

msgid ""

"Add *dir* to the list of directories that will be searched for libraries "

"specified to :meth:`add_library` and :meth:`set_libraries`. The linker will "

"be instructed to search for libraries in the order they are supplied "

"to :meth:`add_library_dir` and/or :meth:`set_library_dirs`."

msgstr ""

#: ../../distutils/apiref.rst:458

msgid ""

"Set the list of library search directories to *dirs* (a list of strings). "

"This does not affect any standard library search path that the linker may "

"search by default."

msgstr ""

#: ../../distutils/apiref.rst:465

msgid ""

"Add *dir* to the list of directories that will be searched for shared "

"libraries at runtime."

msgstr ""

#: ../../distutils/apiref.rst:471

msgid ""

"Set the list of directories to search for shared libraries at runtime to "

"*dirs* (a list of strings). This does not affect any standard search path "

"that the runtime linker may search by default."

msgstr ""

#: ../../distutils/apiref.rst:478

msgid ""

"Define a preprocessor macro for all compilations driven by this compiler "

"object. The optional parameter *value* should be a string; if it is not "

"supplied, then the macro will be defined without an explicit value and the "

"exact outcome depends on the compiler used."

msgstr ""

#: ../../distutils/apiref.rst:488

msgid ""

"Undefine a preprocessor macro for all compilations driven by this compiler "

"object. If the same macro is defined by :meth:`define_macro` and undefined "

"by :meth:`undefine_macro` the last call takes precedence (including multiple "

"redefinitions or undefinitions). If the macro is redefined/undefined on a "

"per-compilation basis (ie. in the call to :meth:`compile`), then that takes "

"precedence."

msgstr ""

#: ../../distutils/apiref.rst:498

msgid ""

"Add *object* to the list of object files (or analogues, such as explicitly "

"named library files or the output of \"resource compilers\") to be included "

"in every link driven by this compiler object."

msgstr ""

#: ../../distutils/apiref.rst:505

msgid ""

"Set the list of object files (or analogues) to be included in every link to "

"*objects*. This does not affect any standard object files that the linker "

"may include by default (such as system libraries)."

msgstr ""

#: ../../distutils/apiref.rst:509

msgid ""

"The following methods implement methods for autodetection of compiler "

"options, providing some functionality similar to GNU :program:`autoconf`."

msgstr ""

#: ../../distutils/apiref.rst:515

msgid ""

"Detect the language of a given file, or list of files. Uses the instance "

"attributes :attr:`language_map` (a dictionary), and :attr:`language_order` "

"(a list) to do the job."

msgstr ""

#: ../../distutils/apiref.rst:522

msgid ""

"Search the specified list of directories for a static or shared library file "

"*lib* and return the full path to that file. If *debug* is true, look for a "

"debugging version (if that makes sense on the current platform). Return "

"``None`` if *lib* wasn't found in any of the specified directories."

msgstr ""

#: ../../distutils/apiref.rst:530

msgid ""

"Return a boolean indicating whether *funcname* is supported on the current "

"platform. The optional arguments can be used to augment the compilation "

"environment by providing additional include files and paths and libraries "

"and paths."

msgstr ""

#: ../../distutils/apiref.rst:538

msgid ""

"Return the compiler option to add *dir* to the list of directories searched "

"for libraries."

msgstr ""

#: ../../distutils/apiref.rst:544

msgid ""

"Return the compiler option to add *lib* to the list of libraries linked into "

"the shared library or executable."

msgstr ""

#: ../../distutils/apiref.rst:550

msgid ""

"Return the compiler option to add *dir* to the list of directories searched "

"for runtime libraries."

msgstr ""

#: ../../distutils/apiref.rst:556

msgid ""

"Define the executables (and options for them) that will be run to perform "

"the various stages of compilation. The exact set of executables that may be "

"specified here depends on the compiler class (via the 'executables' class "

"attribute), but most will have:"

msgstr ""

#: ../../distutils/apiref.rst:562

msgid "attribute"

msgstr "atributo"

#: ../../distutils/apiref.rst:564

msgid "*compiler*"

msgstr ""

#: ../../distutils/apiref.rst:564

msgid "the C/C++ compiler"

msgstr ""

#: ../../distutils/apiref.rst:566

msgid "*linker_so*"

msgstr ""

#: ../../distutils/apiref.rst:566

msgid "linker used to create shared objects and libraries"

msgstr ""

#: ../../distutils/apiref.rst:569

msgid "*linker_exe*"

msgstr ""

#: ../../distutils/apiref.rst:569

msgid "linker used to create binary executables"

msgstr ""

#: ../../distutils/apiref.rst:571

msgid "*archiver*"

msgstr ""

#: ../../distutils/apiref.rst:571

msgid "static library creator"

msgstr ""

#: ../../distutils/apiref.rst:574

msgid ""

"On platforms with a command-line (Unix, DOS/Windows), each of these is a "

"string that will be split into executable name and (optional) list of "

"arguments. (Splitting the string is done similarly to how Unix shells "

"operate: words are delimited by spaces, but quotes and backslashes can "

"override this. See :func:`distutils.util.split_quoted`.)"

msgstr ""

#: ../../distutils/apiref.rst:580

msgid "The following methods invoke stages in the build process."

msgstr ""

#: ../../distutils/apiref.rst:585

msgid ""

"Compile one or more source files. Generates object files (e.g. transforms "

"a :file:`.c` file to a :file:`.o` file.)"

msgstr ""

#: ../../distutils/apiref.rst:588

msgid ""

"*sources* must be a list of filenames, most likely C/C++ files, but in "

"reality anything that can be handled by a particular compiler and compiler "

"class (eg. :class:`MSVCCompiler` can handle resource files in *sources*). "

"Return a list of object filenames, one per source filename in *sources*. "

"Depending on the implementation, not all source files will necessarily be "

"compiled, but all corresponding object filenames will be returned."

msgstr ""

#: ../../distutils/apiref.rst:595

msgid ""

"If *output_dir* is given, object files will be put under it, while retaining "

"their original path component. That is, :file:`foo/bar.c` normally compiles "

"to :file:`foo/bar.o` (for a Unix implementation); if *output_dir* is "

"*build*, then it would compile to :file:`build/foo/bar.o`."

msgstr ""

#: ../../distutils/apiref.rst:600

msgid ""

"*macros*, if given, must be a list of macro definitions. A macro definition "

"is either a ``(name, value)`` 2-tuple or a ``(name,)`` 1-tuple. The former "

"defines a macro; if the value is ``None``, the macro is defined without an "

"explicit value. The 1-tuple case undefines a macro. Later definitions/"

"redefinitions/undefinitions take precedence."

msgstr ""

#: ../../distutils/apiref.rst:606

msgid ""

"*include_dirs*, if given, must be a list of strings, the directories to add "

"to the default include file search path for this compilation only."

msgstr ""

#: ../../distutils/apiref.rst:609

msgid ""

"*debug* is a boolean; if true, the compiler will be instructed to output "

"debug symbols in (or alongside) the object file(s)."

msgstr ""