apiref.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2022, Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.9\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-05-20 01:14+0900\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#: distutils/apiref.rst:5
msgid "API Reference"
msgstr ""

#: 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 ""

#: distutils/apiref.rst:19
msgid ":mod:`distutils.core` --- Core Distutils functionality"
msgstr ""

#: 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 ""

#: distutils/apiref.rst:33
msgid ""
"The basic do-everything function that does most everything you could ever "
"ask for from a Distutils method."
msgstr ""

#: distutils/apiref.rst:36
msgid ""
"The setup function takes a large number of arguments. These are laid out in "
"the following table."
msgstr ""

#: distutils/apiref.rst:185
msgid "argument name"
msgstr ""

#: distutils/apiref.rst:143
#: distutils/apiref.rst:185
msgid "value"
msgstr ""

#: distutils/apiref.rst:185
msgid "type"
msgstr ""

#: distutils/apiref.rst:187
msgid "*name*"
msgstr ""

#: distutils/apiref.rst:44
msgid "The name of the package"
msgstr ""

#: distutils/apiref.rst:46
#: distutils/apiref.rst:53
#: distutils/apiref.rst:58
#: distutils/apiref.rst:68
#: distutils/apiref.rst:75
#: distutils/apiref.rst:106
#: distutils/apiref.rst:278
msgid "a string"
msgstr ""

#: distutils/apiref.rst:46
msgid "*version*"
msgstr ""

#: distutils/apiref.rst:46
msgid "The version number of the package; see :mod:`distutils.version`"
msgstr ""

#: distutils/apiref.rst:50
msgid "*description*"
msgstr ""

#: distutils/apiref.rst:50
msgid "A single line describing the package"
msgstr ""

#: distutils/apiref.rst:53
msgid "*long_description*"
msgstr ""

#: distutils/apiref.rst:53
msgid "Longer description of the package"
msgstr ""

#: distutils/apiref.rst:56
msgid "*author*"
msgstr ""

#: distutils/apiref.rst:56
msgid "The name of the package author"
msgstr ""

#: distutils/apiref.rst:58
msgid "*author_email*"
msgstr ""

#: distutils/apiref.rst:58
msgid "The email address of the package author"
msgstr ""

#: distutils/apiref.rst:61
msgid "*maintainer*"
msgstr ""

#: 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 ""

#: distutils/apiref.rst:68
msgid "*maintainer_email*"
msgstr ""

#: distutils/apiref.rst:68
msgid ""
"The email address of the current maintainer, if different from the author"
msgstr ""

#: distutils/apiref.rst:72
msgid "*url*"
msgstr ""

#: distutils/apiref.rst:72
msgid "A URL for the package (homepage)"
msgstr ""

#: distutils/apiref.rst:75
msgid "*download_url*"
msgstr ""

#: distutils/apiref.rst:75
msgid "A URL to download the package"
msgstr ""

#: distutils/apiref.rst:77
msgid "*packages*"
msgstr ""

#: distutils/apiref.rst:77
msgid "A list of Python packages that distutils will manipulate"
msgstr ""

#: distutils/apiref.rst:80
#: distutils/apiref.rst:100
#: distutils/apiref.rst:207
#: distutils/apiref.rst:226
#: distutils/apiref.rst:234
#: distutils/apiref.rst:247
#: distutils/apiref.rst:267
#: distutils/apiref.rst:275
msgid "a list of strings"
msgstr ""

#: distutils/apiref.rst:80
msgid "*py_modules*"
msgstr ""

#: distutils/apiref.rst:80
msgid "A list of Python modules that distutils will manipulate"
msgstr ""

#: distutils/apiref.rst:83
msgid "*scripts*"
msgstr ""

#: distutils/apiref.rst:83
msgid "A list of standalone script files to be built and installed"
msgstr ""

#: distutils/apiref.rst:87
msgid "*ext_modules*"
msgstr ""

#: distutils/apiref.rst:87
msgid "A list of Python extensions to be built"
msgstr ""

#: distutils/apiref.rst:87
msgid "a list of instances of :class:`distutils.core.Extension`"
msgstr ""

#: distutils/apiref.rst:90
msgid "*classifiers*"
msgstr ""

#: distutils/apiref.rst:90
msgid "A list of categories for the package"
msgstr ""

#: distutils/apiref.rst:90
msgid ""
"a list of strings; valid classifiers are listed on `PyPI <https://pypi.org/"
"classifiers>`_."
msgstr ""

#: distutils/apiref.rst:93
msgid "*distclass*"
msgstr ""

#: distutils/apiref.rst:93
msgid "the :class:`Distribution` class to use"
msgstr ""

#: distutils/apiref.rst:93
msgid "a subclass of :class:`distutils.core.Distribution`"
msgstr ""

#: distutils/apiref.rst:96
msgid "*script_name*"
msgstr ""

#: distutils/apiref.rst:96
msgid "The name of the setup.py script - defaults to ``sys.argv[0]``"
msgstr ""

#: distutils/apiref.rst:100
msgid "*script_args*"
msgstr ""

#: distutils/apiref.rst:100
msgid "Arguments to supply to the setup script"
msgstr ""

#: distutils/apiref.rst:103
msgid "*options*"
msgstr ""

#: distutils/apiref.rst:103
msgid "default options for the setup script"
msgstr ""

#: distutils/apiref.rst:113
#: distutils/apiref.rst:119
msgid "a dictionary"
msgstr ""

#: distutils/apiref.rst:106
msgid "*license*"
msgstr ""

#: distutils/apiref.rst:106
msgid "The license for the package"
msgstr ""

#: distutils/apiref.rst:108
msgid "*keywords*"
msgstr ""

#: distutils/apiref.rst:108
msgid "Descriptive meta-data, see :pep:`314`"
msgstr ""

#: distutils/apiref.rst:111
msgid "a list of strings or a comma-separated string"
msgstr ""

#: distutils/apiref.rst:111
msgid "*platforms*"
msgstr ""

#: distutils/apiref.rst:113
msgid "*cmdclass*"
msgstr ""

#: distutils/apiref.rst:113
msgid "A mapping of command names to :class:`Command` subclasses"
msgstr ""

#: distutils/apiref.rst:116
msgid "*data_files*"
msgstr ""

#: distutils/apiref.rst:116
msgid "A list of data files to install"
msgstr ""

#: distutils/apiref.rst:116
msgid "a list"
msgstr ""

#: distutils/apiref.rst:119
msgid "*package_dir*"
msgstr ""

#: distutils/apiref.rst:119
msgid "A mapping of package to directory names"
msgstr ""

#: 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:562
#: distutils/apiref.rst:1601
msgid "description"
msgstr ""

#: distutils/apiref.rst:145
msgid "*init*"
msgstr ""

#: 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 ""

#: 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 ""

#: 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 ""

#: 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 ""

#: distutils/apiref.rst:169
msgid ":class:`~distutils.cmd.Command` from :mod:`distutils.cmd`"
msgstr ""

#: distutils/apiref.rst:171
msgid ":class:`~distutils.dist.Distribution` from :mod:`distutils.dist`"
msgstr ""

#: 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 ""

#: 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 ""

#: 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 ""

#: distutils/apiref.rst:612
msgid ""
"*extra_preargs* and *extra_postargs* are implementation-dependent. On "
"platforms that have the notion of a command-line (e.g. Unix, DOS/Windows), "
"they are most likely lists of strings: extra command-line arguments to "
"prepend/append to the compiler command line.  On other platforms, consult "
"the implementation class documentation.  In any event, they are intended as "
"an escape hatch for those occasions when the abstract compiler framework "
"doesn't cut the mustard."
msgstr ""

#: distutils/apiref.rst:619
msgid ""
"*depends*, if given, is a list of filenames that all targets depend on.  If "
"a source file is older than any file in depends, then the source file will "
"be recompiled.  This supports dependency tracking, but only at a coarse "
"granularity."
msgstr ""

#: distutils/apiref.rst:624
msgid "Raises :exc:`CompileError` on failure."
msgstr ""

#: distutils/apiref.rst:629
msgid ""
"Link a bunch of stuff together to create a static library file. The \"bunch "
"of stuff\" consists of the list of object files supplied as *objects*, the "
"extra object files supplied to :meth:`add_link_object` and/or :meth:"
"`set_link_objects`, the libraries supplied to :meth:`add_library` and/or :"
"meth:`set_libraries`, and the libraries supplied as *libraries* (if any)."
msgstr ""

#: distutils/apiref.rst:635
msgid ""
"*output_libname* should be a library name, not a filename; the filename will "
"be inferred from the library name.  *output_dir* is the directory where the "
"library file will be put."
msgstr ""

#: distutils/apiref.rst:641
msgid ""
"*debug* is a boolean; if true, debugging information will be included in the "
"library (note that on most platforms, it is the compile step where this "
"matters: the *debug* flag is included here just for consistency)."
msgstr ""

#: distutils/apiref.rst:687
msgid ""
"*target_lang* is the target language for which the given objects are being "
"compiled. This allows specific linkage time treatment of certain languages."
msgstr ""

#: distutils/apiref.rst:648
msgid "Raises :exc:`LibError` on failure."
msgstr ""

#: distutils/apiref.rst:653
msgid ""
"Link a bunch of stuff together to create an executable or shared library "
"file."
msgstr ""

#: distutils/apiref.rst:655
msgid ""
"The \"bunch of stuff\" consists of the list of object files supplied as "
"*objects*. *output_filename* should be a filename.  If *output_dir* is "
"supplied, *output_filename* is relative to it (i.e. *output_filename* can "
"provide directory components if needed)."
msgstr ""

#: distutils/apiref.rst:660
msgid ""
"*libraries* is a list of libraries to link against.  These are library "
"names, not filenames, since they're translated into filenames in a platform-"
"specific way (eg. *foo* becomes :file:`libfoo.a` on Unix and :file:`foo.lib` "
"on DOS/Windows).  However, they can include a directory component, which "
"means the linker will look in that specific directory rather than searching "
"all the normal locations."
msgstr ""

#: distutils/apiref.rst:667
msgid ""
"*library_dirs*, if supplied, should be a list of directories to search for "
"libraries that were specified as bare library names (ie. no directory "
"component).  These are on top of the system default and those supplied to :"
"meth:`add_library_dir` and/or :meth:`set_library_dirs`.  "
"*runtime_library_dirs* is a list of directories that will be embedded into "
"the shared library and used to search for other shared libraries that "
"\\*it\\* depends on at run-time.  (This may only be relevant on Unix.)"
msgstr ""

#: distutils/apiref.rst:675
msgid ""
"*export_symbols* is a list of symbols that the shared library will export. "
"(This appears to be relevant only on Windows.)"
msgstr ""

#: distutils/apiref.rst:678
msgid ""
"*debug* is as for :meth:`compile` and :meth:`create_static_lib`,  with the "
"slight distinction that it actually matters on most platforms (as opposed "
"to :meth:`create_static_lib`, which includes a *debug* flag mostly for "
"form's sake)."
msgstr ""

#: distutils/apiref.rst:683
msgid ""
"*extra_preargs* and *extra_postargs* are as for :meth:`compile`  (except of "
"course that they supply command-line arguments for the particular linker "
"being used)."
msgstr ""

#: distutils/apiref.rst:690
msgid "Raises :exc:`LinkError` on failure."
msgstr ""

#: distutils/apiref.rst:695
msgid ""
"Link an executable.  *output_progname* is the name of the file executable, "
"while *objects* are a list of object filenames to link in. Other arguments  "
"are as for the :meth:`link` method."
msgstr ""

#: distutils/apiref.rst:702
msgid ""
"Link a shared library. *output_libname* is the name of the output  library, "
"while *objects* is a list of object filenames to link in.  Other arguments "
"are as for the :meth:`link` method."
msgstr ""

#: distutils/apiref.rst:709
msgid ""
"Link a shared object. *output_filename* is the name of the shared object "
"that will be created, while *objects* is a list of object filenames  to link "
"in. Other arguments are as for the :meth:`link` method."
msgstr ""

#: distutils/apiref.rst:716
msgid ""
"Preprocess a single C/C++ source file, named in *source*. Output will be "
"written to file named *output_file*, or *stdout* if *output_file* not "
"supplied. *macros* is a list of macro definitions as for :meth:`compile`, "
"which will augment the macros set with :meth:`define_macro` and :meth:"
"`undefine_macro`. *include_dirs* is a list of directory names that will be "
"added to the  default list, in the same way as :meth:`add_include_dir`."
msgstr ""

#: distutils/apiref.rst:723
msgid "Raises :exc:`PreprocessError` on failure."
msgstr ""

#: distutils/apiref.rst:725
msgid ""
"The following utility methods are defined by the :class:`CCompiler` class, "
"for use by the various concrete subclasses."
msgstr ""

#: distutils/apiref.rst:731
msgid ""
"Returns the filename of the executable for the given *basename*.  Typically "
"for non-Windows platforms this is the same as the basename,  while Windows "
"will get a :file:`.exe` added."
msgstr ""

#: distutils/apiref.rst:738
msgid ""
"Returns the filename for the given library name on the current platform. On "
"Unix a library with *lib_type* of ``'static'`` will typically  be of the "
"form :file:`liblibname.a`, while a *lib_type* of ``'dynamic'``  will be of "
"the form :file:`liblibname.so`."
msgstr ""

#: distutils/apiref.rst:746
msgid ""
"Returns the name of the object files for the given source files. "
"*source_filenames* should be a list of filenames."
msgstr ""

#: distutils/apiref.rst:752
msgid ""
"Returns the name of a shared object file for the given file name *basename*."
msgstr ""

#: distutils/apiref.rst:757
msgid ""
"Invokes :func:`distutils.util.execute`. This method invokes a  Python "
"function *func* with the given arguments *args*, after  logging and taking "
"into account the *dry_run* flag."
msgstr ""

#: distutils/apiref.rst:764
msgid ""
"Invokes :func:`distutils.util.spawn`. This invokes an external  process to "
"run the given command."
msgstr ""

#: distutils/apiref.rst:770
msgid ""
"Invokes :func:`distutils.dir_util.mkpath`. This creates a directory  and any "
"missing ancestor directories."
msgstr ""

#: distutils/apiref.rst:776
msgid "Invokes :meth:`distutils.file_util.move_file`. Renames *src* to  *dst*."
msgstr ""

#: distutils/apiref.rst:781
msgid "Write a message using :func:`distutils.log.debug`."
msgstr ""

#: distutils/apiref.rst:786
msgid "Write a warning message *msg* to standard error."
msgstr ""

#: distutils/apiref.rst:791
msgid ""
"If the *debug* flag is set on this :class:`CCompiler` instance, print  *msg* "
"to standard output, otherwise do nothing."
msgstr ""

#: distutils/apiref.rst:803
msgid ":mod:`distutils.unixccompiler` --- Unix C Compiler"
msgstr ""

#: distutils/apiref.rst:809
msgid ""
"This module provides the :class:`UnixCCompiler` class, a subclass of :class:"
"`CCompiler` that handles the typical Unix-style command-line  C compiler:"
msgstr ""

#: distutils/apiref.rst:812
msgid "macros defined with :option:`!-Dname[=value]`"
msgstr ""

#: distutils/apiref.rst:814
msgid "macros undefined with :option:`!-Uname`"
msgstr ""

#: distutils/apiref.rst:816
msgid "include search directories specified with :option:`!-Idir`"
msgstr ""

#: distutils/apiref.rst:818
msgid "libraries specified with :option:`!-llib`"
msgstr ""

#: distutils/apiref.rst:820
msgid "library search directories specified with :option:`!-Ldir`"
msgstr ""

#: distutils/apiref.rst:822
msgid ""
"compile handled by :program:`cc` (or similar) executable with :option:`!-c` "
"option: compiles :file:`.c` to :file:`.o`"
msgstr ""

#: distutils/apiref.rst:825
msgid ""
"link static library handled by :program:`ar` command (possibly with :program:"
"`ranlib`)"
msgstr ""

#: distutils/apiref.rst:828
msgid "link shared library handled by :program:`cc` :option:`!-shared`"
msgstr ""

#: distutils/apiref.rst:832
msgid ":mod:`distutils.msvccompiler` --- Microsoft Compiler"
msgstr ""

#: distutils/apiref.rst:839
msgid ""
"This module provides :class:`MSVCCompiler`, an implementation of the "
"abstract :class:`CCompiler` class for Microsoft Visual Studio. Typically, "
"extension modules need to be compiled with the same compiler that was used "
"to compile Python. For Python 2.3 and earlier, the compiler was Visual "
"Studio 6. For Python 2.4 and 2.5, the compiler is Visual Studio .NET 2003."
msgstr ""

#: distutils/apiref.rst:845
msgid ""
":class:`MSVCCompiler` will normally choose the right compiler, linker etc. "
"on its own. To override this choice, the environment variables "
"*DISTUTILS_USE_SDK* and *MSSdk* must be both set. *MSSdk* indicates that the "
"current environment has been setup by the SDK's ``SetEnv.Cmd`` script, or "
"that the environment variables had been registered when the SDK was "
"installed; *DISTUTILS_USE_SDK* indicates that the distutils user has made an "
"explicit choice to override the compiler selection by :class:`MSVCCompiler`."
msgstr ""

#: distutils/apiref.rst:855
msgid ":mod:`distutils.bcppcompiler` --- Borland Compiler"
msgstr ""

#: distutils/apiref.rst:860
msgid ""
"This module provides :class:`BorlandCCompiler`, a subclass of the abstract :"
"class:`CCompiler` class for the Borland C++ compiler."
msgstr ""

#: distutils/apiref.rst:865
msgid ":mod:`distutils.cygwincompiler` --- Cygwin Compiler"
msgstr ""

#: distutils/apiref.rst:870
msgid ""
"This module provides the :class:`CygwinCCompiler` class, a subclass of :"
"class:`UnixCCompiler` that handles the Cygwin port of the GNU C compiler to "
"Windows.  It also contains the Mingw32CCompiler class which handles the "
"mingw32 port of GCC (same as cygwin in no-cygwin mode)."
msgstr ""

#: distutils/apiref.rst:877
msgid ":mod:`distutils.archive_util` ---  Archiving utilities"
msgstr ""

#: distutils/apiref.rst:883
msgid ""
"This module provides a few functions for creating archive files, such as "
"tarballs or zipfiles."
msgstr ""

#: distutils/apiref.rst:889
msgid ""
"Create an archive file (eg. ``zip`` or ``tar``).  *base_name*  is the name "
"of the file to create, minus any format-specific extension;  *format* is the "
"archive format: one of ``zip``, ``tar``, ``gztar``, ``bztar``, ``xztar``, or "
"``ztar``. *root_dir* is a directory that will be the root directory of the "
"archive; ie. we typically ``chdir`` into *root_dir* before  creating the "
"archive.  *base_dir* is the directory where we start  archiving from; ie. "
"*base_dir* will be the common prefix of all files and directories in the "
"archive.  *root_dir* and *base_dir* both default to the current directory. "
"Returns the name of the archive file."
msgstr ""

#: distutils/apiref.rst:899
msgid "Added support for the ``xztar`` format."
msgstr ""

#: distutils/apiref.rst:905
msgid ""
"'Create an (optional compressed) archive as a tar file from all files in and "
"under *base_dir*. *compress* must be ``'gzip'`` (the default), ``'bzip2'``, "
"``'xz'``, ``'compress'``, or ``None``.  For the ``'compress'`` method the "
"compression utility named by :program:`compress` must be on the default "
"program search path, so this is probably Unix-specific.  The output tar file "
"will be named :file:`base_dir.tar`, possibly plus the appropriate "
"compression extension (``.gz``, ``.bz2``, ``.xz`` or ``.Z``).  Return the "
"output filename."
msgstr ""

#: distutils/apiref.rst:914
msgid "Added support for the ``xz`` compression."
msgstr ""

#: distutils/apiref.rst:920
msgid ""
"Create a zip file from all files in and under *base_dir*.  The output zip "
"file will be named *base_name* + :file:`.zip`.  Uses either the  :mod:"
"`zipfile` Python module (if available) or the InfoZIP :file:`zip`  utility "
"(if installed and found on the default search path).  If neither  tool is "
"available, raises :exc:`DistutilsExecError`.   Returns the name of the "
"output zip file."
msgstr ""

#: distutils/apiref.rst:928
msgid ":mod:`distutils.dep_util` --- Dependency checking"
msgstr ""

#: distutils/apiref.rst:934
msgid ""
"This module provides functions for performing simple, timestamp-based "
"dependency of files and groups of files; also, functions based entirely  on "
"such timestamp dependency analysis."
msgstr ""

#: distutils/apiref.rst:941
msgid ""
"Return true if *source* exists and is more recently modified than *target*, "
"or if *source* exists and *target* doesn't. Return false if both exist and "
"*target* is the same age or newer  than *source*. Raise :exc:"
"`DistutilsFileError` if *source* does not exist."
msgstr ""

#: distutils/apiref.rst:949
msgid ""
"Walk two filename lists in parallel, testing if each source is newer than "
"its corresponding target.  Return a pair of lists (*sources*, *targets*) "
"where source is newer than target, according to the semantics of :func:"
"`newer`."
msgstr ""

#: distutils/apiref.rst:958
msgid ""
"Return true if *target* is out-of-date with respect to any file listed in "
"*sources*.  In other words, if *target* exists and is newer than every file "
"in *sources*, return false; otherwise return true. *missing* controls what "
"we do when a source file is missing; the default (``'error'``) is to blow up "
"with an :exc:`OSError` from  inside :func:`os.stat`; if it is ``'ignore'``, "
"we silently drop any missing source files; if it is ``'newer'``, any missing "
"source files make us assume that *target* is out-of-date (this is handy in "
"\"dry-run\" mode: it'll make you pretend to carry out commands that wouldn't "
"work because inputs are missing, but that doesn't matter because you're not "
"actually going to run the commands)."
msgstr ""

#: distutils/apiref.rst:971
msgid ":mod:`distutils.dir_util` --- Directory tree operations"
msgstr ""

#: distutils/apiref.rst:977
msgid ""
"This module provides functions for operating on directories and trees of "
"directories."
msgstr ""

#: distutils/apiref.rst:983
msgid ""
"Create a directory and any missing ancestor directories.  If the directory "
"already exists (or if *name* is the empty string, which means the current "
"directory, which of course exists), then do nothing.  Raise :exc:"
"`DistutilsFileError` if unable to create some directory along the way (eg. "
"some sub-path exists, but is a file rather than a directory).  If *verbose* "
"is true, print a one-line summary of each mkdir to stdout.  Return the list "
"of directories actually created."
msgstr ""

#: distutils/apiref.rst:994
msgid ""
"Create all the empty directories under *base_dir* needed to put *files* "
"there. *base_dir* is just the name of a directory which doesn't necessarily "
"exist yet; *files* is a list of filenames to be interpreted relative to "
"*base_dir*. *base_dir* + the directory portion of every file in *files* will "
"be created if it doesn't already exist.  *mode*, *verbose* and *dry_run* "
"flags  are as for :func:`mkpath`."
msgstr ""

#: distutils/apiref.rst:1004
msgid ""
"Copy an entire directory tree *src* to a new location *dst*.  Both *src* and "
"*dst* must be directory names.  If *src* is not a directory, raise :exc:"
"`DistutilsFileError`.  If *dst* does  not exist, it is created with :func:"
"`mkpath`.  The end result of the  copy is that every file in *src* is copied "
"to *dst*, and  directories under *src* are recursively copied to *dst*. "
"Return the list of files that were copied or might have been copied, using "
"their output name. The return value is unaffected by *update* or *dry_run*: "
"it is simply the list of all files under *src*, with the names changed to be "
"under *dst*."
msgstr ""

#: distutils/apiref.rst:1014
msgid ""
"*preserve_mode* and *preserve_times* are the same as for :func:`distutils."
"file_util.copy_file`; note that they only apply to regular files, not to "
"directories.  If *preserve_symlinks* is true, symlinks will be copied as "
"symlinks (on platforms that support them!); otherwise (the default), the "
"destination of the symlink will be copied.  *update* and *verbose* are the "
"same as for :func:`copy_file`."
msgstr ""

#: distutils/apiref.rst:1022
msgid ""
"Files in *src* that begin with :file:`.nfs` are skipped (more information on "
"these files is available in answer D2 of the `NFS FAQ page <http://nfs."
"sourceforge.net/#section_d>`_)."
msgstr ""

#: distutils/apiref.rst:1026
msgid "NFS files are ignored."
msgstr ""

#: distutils/apiref.rst:1031
msgid ""
"Recursively remove *directory* and all files and directories underneath it. "
"Any errors are ignored (apart from being reported to ``sys.stdout`` if "
"*verbose* is true)."
msgstr ""

#: distutils/apiref.rst:1037
msgid ":mod:`distutils.file_util` --- Single file operations"
msgstr ""

#: distutils/apiref.rst:1043
msgid ""
"This module contains some utility functions for operating on individual "
"files."
msgstr ""

#: distutils/apiref.rst:1048
msgid ""
"Copy file *src* to *dst*. If *dst* is a directory, then *src* is copied "
"there with the same name; otherwise, it must be a filename. (If the file "
"exists, it will be ruthlessly clobbered.) If *preserve_mode* is true (the "
"default), the file's mode (type and permission bits, or whatever is "
"analogous on the current platform) is copied. If *preserve_times* is true "
"(the default), the last-modified and last-access times are copied as well. "
"If *update* is true, *src* will only be copied if *dst* does not exist, or "
"if *dst* does exist but is older than *src*."
msgstr ""

#: distutils/apiref.rst:1057
msgid ""
"*link* allows you to make hard links (using :func:`os.link`) or symbolic "
"links (using :func:`os.symlink`) instead of copying: set it to ``'hard'`` or "
"``'sym'``; if it is ``None`` (the default), files are copied. Don't set "
"*link* on systems that don't support it: :func:`copy_file` doesn't check if "
"hard or symbolic linking is available.  It uses :func:`_copy_file_contents` "
"to copy file contents."
msgstr ""

#: distutils/apiref.rst:1064
msgid ""
"Return a tuple ``(dest_name, copied)``: *dest_name* is the actual  name of "
"the output file, and *copied* is true if the file was copied  (or would have "
"been copied, if *dry_run* true)."
msgstr ""

#: distutils/apiref.rst:1078
msgid ""
"Move file *src* to *dst*. If *dst* is a directory, the file will be moved "
"into it with the same name; otherwise, *src* is just renamed to *dst*.  "
"Returns the new full name of the file."
msgstr ""

#: distutils/apiref.rst:1084
msgid ""
"Handles cross-device moves on Unix using :func:`copy_file`.  What about "
"other systems?"
msgstr ""

#: distutils/apiref.rst:1090
msgid ""
"Create a file called *filename* and write *contents* (a sequence of strings "
"without line terminators) to it."
msgstr ""

#: distutils/apiref.rst:1095
msgid ":mod:`distutils.util` --- Miscellaneous other utility functions"
msgstr ""

#: distutils/apiref.rst:1101
msgid ""
"This module contains other assorted bits and pieces that don't fit into  any "
"other utility module."
msgstr ""

#: distutils/apiref.rst:1107
msgid ""
"Return a string that identifies the current platform.  This is used mainly "
"to distinguish platform-specific build directories and platform-specific "
"built distributions.  Typically includes the OS name and version and the "
"architecture (as supplied by 'os.uname()'), although the exact information "
"included depends on the OS; e.g., on Linux, the kernel version isn't "
"particularly important."
msgstr ""

#: distutils/apiref.rst:1114
msgid "Examples of returned values:"
msgstr ""

#: distutils/apiref.rst:1116
msgid "``linux-i586``"
msgstr ""

#: distutils/apiref.rst:1117
msgid "``linux-alpha``"
msgstr ""

#: distutils/apiref.rst:1118
msgid "``solaris-2.6-sun4u``"
msgstr ""

#: distutils/apiref.rst:1120
msgid "For non-POSIX platforms, currently just returns ``sys.platform``."
msgstr ""

#: distutils/apiref.rst:1122
msgid ""
"For macOS systems the OS version reflects the minimal version on which "
"binaries will run (that is, the value of ``MACOSX_DEPLOYMENT_TARGET`` during "
"the build of Python), not the OS version of the current system."
msgstr ""

#: distutils/apiref.rst:1126
msgid ""
"For universal binary builds on macOS the architecture value reflects the "
"universal binary status instead of the architecture of the current "
"processor. For 32-bit universal binaries the architecture is ``fat``, for 64-"
"bit universal binaries the architecture is ``fat64``, and for 4-way "
"universal binaries the architecture is ``universal``. Starting from Python "
"2.7 and Python 3.2 the architecture ``fat3`` is used for a 3-way universal "
"build (ppc, i386, x86_64) and ``intel`` is used for a universal build with "
"the i386 and x86_64 architectures"
msgstr ""

#: distutils/apiref.rst:1135
msgid "Examples of returned values on macOS:"
msgstr ""

#: distutils/apiref.rst:1137
msgid "``macosx-10.3-ppc``"
msgstr ""

#: distutils/apiref.rst:1139
msgid "``macosx-10.3-fat``"
msgstr ""

#: distutils/apiref.rst:1141
msgid "``macosx-10.5-universal``"
msgstr ""

#: distutils/apiref.rst:1143
msgid "``macosx-10.6-intel``"
msgstr ""

#: distutils/apiref.rst:1145
msgid ""
"For AIX, Python 3.9 and later return a string starting with \"aix\", "
"followed by additional fields (separated by ``'-'``) that represent the "
"combined values of AIX Version, Release and Technology Level (first field), "
"Build Date (second field), and bit-size (third field). Python 3.8 and "
"earlier returned only a single additional field with the AIX Version and "
"Release."
msgstr ""

#: distutils/apiref.rst:1151
msgid "Examples of returned values on AIX:"
msgstr ""

#: distutils/apiref.rst:1153
msgid ""
"``aix-5307-0747-32`` # 32-bit build on AIX ``oslevel -s``: 5300-07-00-0000"
msgstr ""

#: distutils/apiref.rst:1155
msgid ""
"``aix-7105-1731-64`` # 64-bit build on AIX ``oslevel -s``: 7100-05-01-1731"
msgstr ""

#: distutils/apiref.rst:1157
msgid "``aix-7.2``          # Legacy form reported in Python 3.8 and earlier"
msgstr ""

#: distutils/apiref.rst:1159
msgid ""
"The AIX platform string format now also includes the technology level, build "
"date, and ABI bit-size."
msgstr ""

#: distutils/apiref.rst:1166
msgid ""
"Return 'pathname' as a name that will work on the native filesystem, i.e. "
"split it on '/' and put it back together again using the current directory "
"separator. Needed because filenames in the setup script are always supplied "
"in Unix style, and have to be converted to the local convention before we "
"can actually use them in the filesystem.  Raises :exc:`ValueError` on non-"
"Unix-ish systems if *pathname* either  starts or ends with a slash."
msgstr ""

#: distutils/apiref.rst:1176
msgid ""
"Return *pathname* with *new_root* prepended.  If *pathname* is relative, "
"this is equivalent to ``os.path.join(new_root,pathname)`` Otherwise, it "
"requires making *pathname* relative and then joining the two, which is "
"tricky on DOS/Windows."
msgstr ""

#: distutils/apiref.rst:1183
msgid ""
"Ensure that 'os.environ' has all the environment variables we guarantee that "
"users can use in config files, command-line options, etc.  Currently this "
"includes:"
msgstr ""

#: distutils/apiref.rst:1187
msgid ":envvar:`HOME` - user's home directory (Unix only)"
msgstr ""

#: distutils/apiref.rst:1188
msgid ""
":envvar:`PLAT` - description of the current platform, including hardware and "
"OS (see :func:`get_platform`)"
msgstr ""

#: distutils/apiref.rst:1194
msgid ""
"Perform shell/Perl-style variable substitution on *s*.  Every occurrence of "
"``$`` followed by a name is considered a variable, and variable is "
"substituted by the value found in the *local_vars* dictionary, or in ``os."
"environ`` if it's not in *local_vars*. *os.environ* is first checked/"
"augmented to guarantee that it contains certain values: see :func:"
"`check_environ`.  Raise :exc:`ValueError` for any variables not found in "
"either *local_vars* or ``os.environ``."
msgstr ""

#: distutils/apiref.rst:1201
msgid ""
"Note that this is not a fully-fledged string interpolation function. A valid "
"``$variable`` can consist only of upper and lower case letters, numbers and "
"an underscore. No { } or ( ) style quoting is available."
msgstr ""

#: distutils/apiref.rst:1208
msgid ""
"Split a string up according to Unix shell-like rules for quotes and "
"backslashes. In short: words are delimited by spaces, as long as those "
"spaces are not escaped by a backslash, or inside a quoted string. Single and "
"double quotes are equivalent, and the quote characters can be backslash-"
"escaped.  The backslash is stripped from any two-character escape sequence, "
"leaving only the escaped character.  The quote characters are stripped from "
"any quoted string.  Returns a list of words."
msgstr ""

#: distutils/apiref.rst:1221
msgid ""
"Perform some action that affects the outside world (for instance, writing to "
"the filesystem).  Such actions are special because they are disabled by the "
"*dry_run* flag.  This method takes  care of all that bureaucracy for you; "
"all you have to do is supply the function to call and an argument tuple for "
"it (to embody the \"external action\" being performed), and an optional "
"message to print."
msgstr ""

#: distutils/apiref.rst:1230
msgid "Convert a string representation of truth to true (1) or false (0)."
msgstr ""

#: distutils/apiref.rst:1232
msgid ""
"True values are ``y``, ``yes``, ``t``, ``true``, ``on``  and ``1``; false "
"values are ``n``, ``no``, ``f``, ``false``,  ``off`` and ``0``.  Raises :exc:"
"`ValueError` if *val*  is anything else."
msgstr ""

#: distutils/apiref.rst:1239
msgid ""
"Byte-compile a collection of Python source files to :file:`.pyc` files in a :"
"file:`__pycache__` subdirectory (see :pep:`3147` and :pep:`488`). *py_files* "
"is a list of files to compile; any files that don't end in :file:`.py` are "
"silently skipped.  *optimize* must be one of the following:"
msgstr ""

#: distutils/apiref.rst:1244
msgid "``0`` - don't optimize"
msgstr ""

#: distutils/apiref.rst:1245
msgid "``1`` - normal optimization (like ``python -O``)"
msgstr ""

#: distutils/apiref.rst:1246
msgid "``2`` - extra optimization (like ``python -OO``)"
msgstr ""

#: distutils/apiref.rst:1248
msgid "If *force* is true, all files are recompiled regardless of timestamps."
msgstr ""

#: distutils/apiref.rst:1250
msgid ""
"The source filename encoded in each :term:`bytecode` file defaults to the "
"filenames listed in *py_files*; you can modify these with *prefix* and "
"*basedir*. *prefix* is a string that will be stripped off of each source "
"filename, and *base_dir* is a directory name that will be prepended (after "
"*prefix* is stripped).  You can supply either or both (or neither) of "
"*prefix* and *base_dir*, as you wish."
msgstr ""

#: distutils/apiref.rst:1257
msgid ""
"If *dry_run* is true, doesn't actually do anything that would affect the "
"filesystem."
msgstr ""

#: distutils/apiref.rst:1260
msgid ""
"Byte-compilation is either done directly in this interpreter process with "
"the standard :mod:`py_compile` module, or indirectly by writing a temporary "
"script and executing it.  Normally, you should let :func:`byte_compile` "
"figure out to use direct compilation or not (see the source for details).  "
"The *direct* flag is used by the script generated in indirect mode; unless "
"you know what you're doing, leave it set to ``None``."
msgstr ""

#: distutils/apiref.rst:1267
msgid ""
"Create ``.pyc`` files with an :func:`import magic tag <imp.get_tag>` in "
"their name, in a :file:`__pycache__` subdirectory instead of files without "
"tag in the current directory."
msgstr ""

#: distutils/apiref.rst:1272
msgid "Create ``.pyc`` files according to :pep:`488`."
msgstr ""

#: distutils/apiref.rst:1278
msgid ""
"Return a version of *header* escaped for inclusion in an :rfc:`822` header, "
"by ensuring there are 8 spaces space after each newline. Note that it does "
"no other modification of the string."
msgstr ""

#: distutils/apiref.rst:1288
msgid ":mod:`distutils.dist` --- The Distribution class"
msgstr ""

#: distutils/apiref.rst:1295
msgid ""
"This module provides the :class:`~distutils.core.Distribution` class, which "
"represents the module distribution being built/installed/distributed."
msgstr ""

#: distutils/apiref.rst:1300
msgid ":mod:`distutils.extension` --- The Extension class"
msgstr ""

#: distutils/apiref.rst:1307
msgid ""
"This module provides the :class:`Extension` class, used to describe C/C++ "
"extension modules in setup scripts."
msgstr ""

#: distutils/apiref.rst:1315
msgid ":mod:`distutils.debug` --- Distutils debug mode"
msgstr ""

#: distutils/apiref.rst:1321
msgid "This module provides the DEBUG flag."
msgstr ""

#: distutils/apiref.rst:1325
msgid ":mod:`distutils.errors` --- Distutils exceptions"
msgstr ""

#: distutils/apiref.rst:1331
msgid ""
"Provides exceptions used by the Distutils modules.  Note that Distutils "
"modules may raise standard exceptions; in particular, SystemExit is usually "
"raised for errors that are obviously the end-user's fault (eg. bad command-"
"line arguments)."
msgstr ""

#: distutils/apiref.rst:1335
msgid ""
"This module is safe to use in ``from ... import *`` mode; it only exports "
"symbols whose names start with ``Distutils`` and end with ``Error``."
msgstr ""

#: distutils/apiref.rst:1340
msgid ""
":mod:`distutils.fancy_getopt` --- Wrapper around the standard getopt module"
msgstr ""

#: distutils/apiref.rst:1346
msgid ""
"This module provides a wrapper around the standard :mod:`getopt`  module "
"that provides the following additional features:"
msgstr ""

#: distutils/apiref.rst:1349
msgid "short and long options are tied together"
msgstr ""

#: distutils/apiref.rst:1351
msgid ""
"options have help strings, so :func:`fancy_getopt` could potentially  create "
"a complete usage summary"
msgstr ""

#: distutils/apiref.rst:1354
msgid "options set attributes of a passed-in object"
msgstr ""

#: distutils/apiref.rst:1356
msgid ""
"boolean options can have \"negative aliases\" --- eg. if :option:`!--quiet` "
"is the \"negative alias\" of :option:`!--verbose`, then :option:`!--quiet` "
"on the command line sets *verbose* to false."
msgstr ""

#: distutils/apiref.rst:1362
msgid ""
"Wrapper function. *options* is a list of ``(long_option, short_option, "
"help_string)`` 3-tuples as described in the constructor for :class:"
"`FancyGetopt`. *negative_opt* should be a dictionary mapping option names to "
"option names, both the key and value should be in the *options* list. "
"*object* is an object which will be used to store values (see the :meth:"
"`getopt` method of the :class:`FancyGetopt` class). *args* is the argument "
"list. Will use ``sys.argv[1:]`` if you  pass ``None`` as *args*."
msgstr ""

#: distutils/apiref.rst:1373
msgid "Wraps *text* to less than *width* wide."
msgstr ""

#: distutils/apiref.rst:1378
msgid ""
"The option_table is a list of 3-tuples: ``(long_option, short_option, "
"help_string)``"
msgstr ""

#: distutils/apiref.rst:1381
msgid ""
"If an option takes an argument, its *long_option* should have ``'='`` "
"appended; *short_option* should just be a single character, no ``':'`` in "
"any case. *short_option* should be ``None`` if a *long_option*  doesn't have "
"a corresponding *short_option*. All option tuples must have long options."
msgstr ""

#: distutils/apiref.rst:1386
msgid "The :class:`FancyGetopt` class provides the following methods:"
msgstr ""

#: distutils/apiref.rst:1391
msgid "Parse command-line options in args. Store as attributes on *object*."
msgstr ""

#: distutils/apiref.rst:1393
msgid ""
"If *args* is ``None`` or not supplied, uses ``sys.argv[1:]``.  If *object* "
"is ``None`` or not supplied, creates a new :class:`OptionDummy` instance, "
"stores option values there, and returns a tuple ``(args, object)``.  If "
"*object* is supplied, it is modified in place and :func:`getopt` just "
"returns *args*; in both cases, the returned *args* is a modified copy of the "
"passed-in *args* list, which is left untouched."
msgstr ""

#: distutils/apiref.rst:1405
msgid ""
"Returns the list of ``(option, value)`` tuples processed by the previous run "
"of :meth:`getopt`  Raises :exc:`RuntimeError` if :meth:`getopt` hasn't been "
"called yet."
msgstr ""

#: distutils/apiref.rst:1412
msgid ""
"Generate help text (a list of strings, one per suggested line of output) "
"from the option table for this :class:`FancyGetopt` object."
msgstr ""

#: distutils/apiref.rst:1415
msgid "If supplied, prints the supplied *header* at the top of the help."
msgstr ""

#: distutils/apiref.rst:1419
msgid ":mod:`distutils.filelist` --- The FileList class"
msgstr ""

#: distutils/apiref.rst:1426
msgid ""
"This module provides the :class:`FileList` class, used for poking about the "
"filesystem and building lists of files."
msgstr ""

#: distutils/apiref.rst:1431
msgid ":mod:`distutils.log` --- Simple :pep:`282`-style logging"
msgstr ""

#: distutils/apiref.rst:1438
msgid ":mod:`distutils.spawn` --- Spawn a sub-process"
msgstr ""

#: distutils/apiref.rst:1444
msgid ""
"This module provides the :func:`spawn` function, a front-end to  various "
"platform-specific functions for launching another program in a  sub-process. "
"Also provides :func:`find_executable` to search the path for a given "
"executable name."
msgstr ""

#: distutils/apiref.rst:1451
msgid ":mod:`distutils.sysconfig` --- System configuration information"
msgstr ""

#: distutils/apiref.rst:1460
msgid ""
"The :mod:`distutils.sysconfig` module provides access to Python's low-level "
"configuration information.  The specific configuration variables available "
"depend heavily on the platform and configuration. The specific variables "
"depend on the build process for the specific version of Python being run; "
"the variables are those found in the :file:`Makefile` and configuration "
"header that are installed with Python on Unix systems.  The configuration "
"header is called :file:`pyconfig.h` for Python versions starting with 2.2, "
"and :file:`config.h` for earlier versions of Python."
msgstr ""

#: distutils/apiref.rst:1469
msgid ""
"Some additional functions are provided which perform some useful "
"manipulations for other parts of the :mod:`distutils` package."
msgstr ""

#: distutils/apiref.rst:1475
msgid "The result of ``os.path.normpath(sys.prefix)``."
msgstr ""

#: distutils/apiref.rst:1480
msgid "The result of ``os.path.normpath(sys.exec_prefix)``."
msgstr ""

#: distutils/apiref.rst:1485
msgid ""
"Return the value of a single variable.  This is equivalent to "
"``get_config_vars().get(name)``."
msgstr ""

#: distutils/apiref.rst:1491
msgid ""
"Return a set of variable definitions.  If there are no arguments, this "
"returns a dictionary mapping names of configuration variables to values.  If "
"arguments are provided, they should be strings, and the return value will be "
"a sequence giving the associated values. If a given name does not have a "
"corresponding value, ``None`` will be included for that variable."
msgstr ""

#: distutils/apiref.rst:1500
msgid ""
"Return the full path name of the configuration header.  For Unix, this will "
"be the header generated by the :program:`configure` script; for other "
"platforms the header will have been supplied directly by the Python source "
"distribution.  The file is a platform-specific text file."
msgstr ""

#: distutils/apiref.rst:1508
msgid ""
"Return the full path name of the :file:`Makefile` used to build Python.  For "
"Unix, this will be a file generated by the :program:`configure` script; the "
"meaning for other platforms will vary.  The file is a platform-specific text "
"file, if it exists. This function is only useful on POSIX platforms."
msgstr ""

#: distutils/apiref.rst:1516
msgid ""
"Return the directory for either the general or platform-dependent C include "
"files.  If *plat_specific* is true, the platform-dependent include directory "
"is returned; if false or omitted, the platform-independent directory is "
"returned. If *prefix* is given, it is used as either the prefix instead of :"
"const:`PREFIX`, or as the exec-prefix instead of :const:`EXEC_PREFIX` if "
"*plat_specific* is true."
msgstr ""

#: distutils/apiref.rst:1526
msgid ""
"Return the directory for either the general or platform-dependent library "
"installation.  If *plat_specific* is true, the platform-dependent include "
"directory is returned; if false or omitted, the platform-independent "
"directory is returned.  If *prefix* is given, it is used as either the "
"prefix instead of :const:`PREFIX`, or as the exec-prefix instead of :const:"
"`EXEC_PREFIX` if *plat_specific* is true.  If *standard_lib* is true, the "
"directory for the standard library is returned rather than the directory for "
"the installation of third-party extensions."
msgstr ""

#: distutils/apiref.rst:1535
msgid ""
"The following function is only intended for use within the :mod:`distutils` "
"package."
msgstr ""

#: distutils/apiref.rst:1541
msgid ""
"Do any platform-specific customization of a :class:`distutils.ccompiler."
"CCompiler` instance."
msgstr ""

#: distutils/apiref.rst:1544
msgid ""
"This function is only needed on Unix at this time, but should be called "
"consistently to support forward-compatibility.  It inserts the information "
"that varies across Unix flavors and is stored in Python's :file:`Makefile`.  "
"This information includes the selected compiler, compiler and linker "
"options, and the extension used by the linker for shared objects."
msgstr ""

#: distutils/apiref.rst:1550
msgid ""
"This function is even more special-purpose, and should only be used from "
"Python's own build procedures."
msgstr ""

#: distutils/apiref.rst:1556
msgid ""
"Inform the :mod:`distutils.sysconfig` module that it is being used as part "
"of the build process for Python.  This changes a lot of relative locations "
"for files, allowing them to be located in the build area rather than in an "
"installed Python."
msgstr ""

#: distutils/apiref.rst:1563
msgid ":mod:`distutils.text_file` --- The TextFile class"
msgstr ""

#: distutils/apiref.rst:1569
msgid ""
"This module provides the :class:`TextFile` class, which gives an interface  "
"to text files that (optionally) takes care of stripping comments, ignoring  "
"blank lines, and joining lines with backslashes."
msgstr ""

#: distutils/apiref.rst:1576
msgid ""
"This class provides a file-like object that takes care of all  the things "
"you commonly want to do when processing a text file  that has some line-by-"
"line syntax: strip comments (as long as ``#``  is your comment character), "
"skip blank lines, join adjacent lines by escaping the newline (ie. backslash "
"at end of line), strip leading and/or trailing whitespace.  All of these are "
"optional and independently controllable."
msgstr ""

#: distutils/apiref.rst:1583
msgid ""
"The class provides a :meth:`warn` method so you can generate  warning "
"messages that report physical line number, even if the  logical line in "
"question spans multiple physical lines.  Also  provides :meth:`unreadline` "
"for implementing line-at-a-time lookahead."
msgstr ""

#: distutils/apiref.rst:1588
msgid ""
":class:`TextFile` instances are create with either *filename*, *file*, or "
"both. :exc:`RuntimeError` is raised if both are ``None``. *filename* should "
"be a string, and *file* a file object (or something that provides :meth:"
"`readline` and :meth:`close`  methods).  It is recommended that you supply "
"at least *filename*,  so that :class:`TextFile` can include it in warning "
"messages.  If *file* is not supplied, :class:`TextFile` creates its own "
"using the :func:`open` built-in function."
msgstr ""

#: distutils/apiref.rst:1596
msgid ""
"The options are all boolean, and affect the values returned by :meth:"
"`readline`"
msgstr ""

#: distutils/apiref.rst:1601
msgid "option name"
msgstr ""

#: distutils/apiref.rst:1601
msgid "default"
msgstr ""

#: distutils/apiref.rst:1603
msgid "*strip_comments*"
msgstr ""

#: distutils/apiref.rst:1603
msgid ""
"strip from ``'#'`` to end-of-line, as well as any whitespace leading up to "
"the ``'#'``\\ ---unless it is escaped by a backslash"
msgstr ""

#: distutils/apiref.rst:1612
#: distutils/apiref.rst:1617
msgid "true"
msgstr ""

#: distutils/apiref.rst:1609
msgid "*lstrip_ws*"
msgstr ""

#: distutils/apiref.rst:1609
msgid "strip leading whitespace from each line before returning it"
msgstr ""

#: distutils/apiref.rst:1627
#: distutils/apiref.rst:1638
msgid "false"
msgstr ""

#: distutils/apiref.rst:1612
msgid "*rstrip_ws*"
msgstr ""

#: distutils/apiref.rst:1612
msgid ""
"strip trailing whitespace (including line terminator!) from each line before "
"returning it."
msgstr ""

#: distutils/apiref.rst:1617
msgid "*skip_blanks*"
msgstr ""

#: distutils/apiref.rst:1617
msgid ""
"skip lines that are empty \\*after\\* stripping comments and whitespace.  "
"(If both lstrip_ws and rstrip_ws are false, then some lines may consist of "
"solely whitespace: these will \\*not\\* be skipped, even if *skip_blanks* is "
"true.)"
msgstr ""

#: distutils/apiref.rst:1627
msgid "*join_lines*"
msgstr ""

#: distutils/apiref.rst:1627
msgid ""
"if a backslash is the last non-newline character on a line after stripping "
"comments and whitespace, join the following line to it to form one logical "
"line; if N consecutive lines end with a backslash, then N+1 physical lines "
"will be joined to form one logical line."
msgstr ""

#: distutils/apiref.rst:1638
msgid "*collapse_join*"
msgstr ""

#: distutils/apiref.rst:1638
msgid ""
"strip leading whitespace from lines that are joined to their predecessor; "
"only matters if ``(join_lines and not lstrip_ws)``"
msgstr ""

#: distutils/apiref.rst:1645
msgid ""
"Note that since *rstrip_ws* can strip the trailing newline, the semantics "
"of :meth:`readline` must differ from those of the built-in file object's :"
"meth:`readline` method!  In particular, :meth:`readline`  returns ``None`` "
"for end-of-file: an empty string might just be a  blank line (or an all-"
"whitespace line), if *rstrip_ws* is true  but *skip_blanks* is not."
msgstr ""

#: distutils/apiref.rst:1654
msgid ""
"Open a new file *filename*.  This overrides any *file* or *filename* "
"constructor arguments."
msgstr ""

#: distutils/apiref.rst:1660
msgid ""
"Close the current file and forget everything we know about it (including the "
"filename and the current line number)."
msgstr ""

#: distutils/apiref.rst:1666
msgid ""
"Print (to stderr) a warning message tied to the current logical line in the "
"current file.  If the current logical line in the file spans multiple "
"physical lines, the warning refers to the whole range, such as ``\"lines "
"3-5\"``.  If *line* is supplied,  it overrides the current line number; it "
"may be a list or tuple  to indicate a range of physical lines, or an integer "
"for a  single physical line."
msgstr ""

#: distutils/apiref.rst:1676
msgid ""
"Read and return a single logical line from the current file (or from an "
"internal buffer if lines have previously been \"unread\" with :meth:"
"`unreadline`).  If the *join_lines* option  is true, this may involve "
"reading multiple physical lines concatenated into a single string.  Updates "
"the current line number,  so calling :meth:`warn` after :meth:`readline` "
"emits a warning  about the physical line(s) just read.  Returns ``None`` on "
"end-of-file,  since the empty string can occur if *rstrip_ws* is true but  "
"*strip_blanks* is not."
msgstr ""

#: distutils/apiref.rst:1687
msgid ""
"Read and return the list of all logical lines remaining in the current file. "
"This updates the current line number to the last line of the file."
msgstr ""

#: distutils/apiref.rst:1693
msgid ""
"Push *line* (a string) onto an internal buffer that will be checked by "
"future :meth:`readline` calls.  Handy for implementing a parser with line-at-"
"a-time lookahead. Note that lines that are \"unread\" with :meth:"
"`unreadline` are not subsequently re-cleansed (whitespace  stripped, or "
"whatever) when read with :meth:`readline`. If multiple calls are made to :"
"meth:`unreadline` before a call to :meth:`readline`, the lines will be "
"returned most in most recent first order."
msgstr ""

#: distutils/apiref.rst:1702
msgid ":mod:`distutils.version` --- Version number classes"
msgstr ""

#: distutils/apiref.rst:1717
msgid ":mod:`distutils.cmd` --- Abstract base class for Distutils commands"
msgstr ""

#: distutils/apiref.rst:1724
msgid "This module supplies the abstract base class :class:`Command`."
msgstr ""

#: distutils/apiref.rst:1729
msgid ""
"Abstract base class for defining command classes, the \"worker bees\" of the "
"Distutils.  A useful analogy for command classes is to think of them as "
"subroutines with local variables called *options*.  The options are declared "
"in :meth:`initialize_options` and defined (given their final values) in :"
"meth:`finalize_options`, both of which must be defined by every command "
"class.  The distinction between the two is necessary because option values "
"might come from the outside world (command line, config file, ...), and any "
"options dependent on other options must be computed after these outside "
"influences have been processed --- hence :meth:`finalize_options`.  The body "
"of the subroutine, where it does all its work based on the values of its "
"options, is the :meth:`run` method, which must also be implemented by every "
"command class."
msgstr ""

#: distutils/apiref.rst:1742
msgid ""
"The class constructor takes a single argument *dist*, a :class:`~distutils."
"core.Distribution` instance."
msgstr ""

#: distutils/apiref.rst:1747
msgid "Creating a new Distutils command"
msgstr ""

#: distutils/apiref.rst:1749
msgid "This section outlines the steps to create a new Distutils command."
msgstr ""

#: distutils/apiref.rst:1751
msgid ""
"A new command lives in a module in the :mod:`distutils.command` package. "
"There is a sample template in that directory called :file:"
"`command_template`.  Copy this file to a new module with the same name as "
"the new command you're implementing.  This module should implement a class "
"with the same name as the module (and the command).  So, for instance, to "
"create the command ``peel_banana`` (so that users can run ``setup.py "
"peel_banana``), you'd copy :file:`command_template` to :file:`distutils/"
"command/peel_banana.py`, then edit it so that it's implementing the class :"
"class:`peel_banana`, a subclass of :class:`distutils.cmd.Command`."
msgstr ""

#: distutils/apiref.rst:1761
msgid "Subclasses of :class:`Command` must define the following methods."
msgstr ""

#: distutils/apiref.rst:1765
msgid ""
"Set default values for all the options that this command supports.  Note "
"that these defaults may be overridden by other commands, by the setup "
"script, by config files, or by the command-line.  Thus, this is not the "
"place to code dependencies between options; generally, :meth:"
"`initialize_options` implementations are just a bunch of ``self.foo = None`` "
"assignments."
msgstr ""

#: distutils/apiref.rst:1774
msgid ""
"Set final values for all the options that this command supports. This is "
"always called as late as possible, ie.  after any option assignments from "
"the command-line or from other commands have been done.  Thus, this is the "
"place to code option dependencies: if *foo* depends on *bar*, then it is "
"safe to set *foo* from *bar* as long as *foo* still has the same value it "
"was assigned in :meth:`initialize_options`."
msgstr ""

#: distutils/apiref.rst:1784
msgid ""
"A command's raison d'etre: carry out the action it exists to perform, "
"controlled by the options initialized in :meth:`initialize_options`, "
"customized by other commands, the setup script, the command-line, and config "
"files, and finalized in :meth:`finalize_options`.  All terminal output and "
"filesystem interaction should be done by :meth:`run`."
msgstr ""

#: distutils/apiref.rst:1793
msgid ""
"*sub_commands* formalizes the notion of a \"family\" of commands, e.g. "
"``install`` as the parent with sub-commands ``install_lib``, "
"``install_headers``, etc.  The parent of a family of commands defines "
"*sub_commands* as a class attribute; it's a list of 2-tuples "
"``(command_name, predicate)``, with *command_name* a string and *predicate* "
"a function, a string or ``None``.  *predicate* is a method of the parent "
"command that determines whether the corresponding command is applicable in "
"the current situation.  (E.g. ``install_headers`` is only applicable if we "
"have any C header files to install.)  If *predicate* is ``None``, that "
"command is always applicable."
msgstr ""

#: distutils/apiref.rst:1804
msgid ""
"*sub_commands* is usually defined at the *end* of a class, because "
"predicates can be methods of the class, so they must already have been "
"defined.  The canonical example is the :command:`install` command."
msgstr ""

#: distutils/apiref.rst:1810
msgid ":mod:`distutils.command` --- Individual Distutils commands"
msgstr ""

#: distutils/apiref.rst:1821
msgid ":mod:`distutils.command.bdist` --- Build a binary installer"
msgstr ""

#: distutils/apiref.rst:1831
msgid ""
":mod:`distutils.command.bdist_packager` --- Abstract base class for packagers"
msgstr ""

#: distutils/apiref.rst:1841
msgid ":mod:`distutils.command.bdist_dumb` --- Build a \"dumb\" installer"
msgstr ""

#: distutils/apiref.rst:1851
msgid ""
":mod:`distutils.command.bdist_msi` --- Build a Microsoft Installer binary "
"package"
msgstr ""

#: distutils/apiref.rst:1887
msgid "Use bdist_wheel (wheel packages) instead."
msgstr ""

#: distutils/apiref.rst:1861
msgid "Builds a `Windows Installer`_ (.msi) binary package."
msgstr ""

#: distutils/apiref.rst:1865
msgid ""
"In most cases, the ``bdist_msi`` installer is a better choice than the "
"``bdist_wininst`` installer, because it provides better support for Win64 "
"platforms, allows administrators to perform non-interactive installations, "
"and allows installation through group policies."
msgstr ""

#: distutils/apiref.rst:1872
msgid ""
":mod:`distutils.command.bdist_rpm` --- Build a binary distribution as a "
"Redhat RPM and SRPM"
msgstr ""

#: distutils/apiref.rst:1882
msgid ":mod:`distutils.command.bdist_wininst` --- Build a Windows installer"
msgstr ""

#: distutils/apiref.rst:1895
msgid ":mod:`distutils.command.sdist` --- Build a source distribution"
msgstr ""

#: distutils/apiref.rst:1905
msgid ":mod:`distutils.command.build` --- Build all files of a package"
msgstr ""

#: distutils/apiref.rst:1915
msgid ""
":mod:`distutils.command.build_clib` --- Build any C libraries in a package"
msgstr ""

#: distutils/apiref.rst:1925
msgid ""
":mod:`distutils.command.build_ext` --- Build any extensions in a package"
msgstr ""

#: distutils/apiref.rst:1935
msgid ""
":mod:`distutils.command.build_py` --- Build the .py/.pyc files of a package"
msgstr ""

#: distutils/apiref.rst:1945
msgid ""
"Alternative implementation of build_py which also runs the 2to3 conversion "
"library on each .py file that is going to be installed. To use this in a "
"setup.py file for a distribution that is designed to run with both Python 2."
"x and 3.x, add::"
msgstr ""

#: distutils/apiref.rst:1955
msgid "to your setup.py, and later::"
msgstr ""

#: distutils/apiref.rst:1959
msgid "to the invocation of setup()."
msgstr ""

#: distutils/apiref.rst:1963
msgid ""
":mod:`distutils.command.build_scripts` --- Build the scripts of a package"
msgstr ""

#: distutils/apiref.rst:1973
msgid ":mod:`distutils.command.clean` --- Clean a package build area"
msgstr ""

#: distutils/apiref.rst:1978
msgid ""
"This command removes the temporary files created by :command:`build` and its "
"subcommands, like intermediary compiled object files.  With the ``--all`` "
"option, the complete build directory will be removed."
msgstr ""

#: distutils/apiref.rst:1982
msgid ""
"Extension modules built :ref:`in place <distutils-build-ext-inplace>` will "
"not be cleaned, as they are not in the build directory."
msgstr ""

#: distutils/apiref.rst:1987
msgid ":mod:`distutils.command.config` --- Perform package configuration"
msgstr ""

#: distutils/apiref.rst:1997
msgid ":mod:`distutils.command.install` --- Install a package"
msgstr ""

#: distutils/apiref.rst:2007
msgid ""
":mod:`distutils.command.install_data` --- Install data files from a package"
msgstr ""

#: distutils/apiref.rst:2017
msgid ""
":mod:`distutils.command.install_headers` --- Install C/C++ header files from "
"a package"
msgstr ""

#: distutils/apiref.rst:2027
msgid ""
":mod:`distutils.command.install_lib` --- Install library files from a package"
msgstr ""

#: distutils/apiref.rst:2037
msgid ""
":mod:`distutils.command.install_scripts` --- Install script files from a "
"package"
msgstr ""

#: distutils/apiref.rst:2047
msgid ""
":mod:`distutils.command.register` --- Register a module with the Python "
"Package Index"
msgstr ""

#: distutils/apiref.rst:2053
msgid ""
"The ``register`` command registers the package with the Python Package  "
"Index. This is described in more detail in :pep:`301`."
msgstr ""

#: distutils/apiref.rst:2060
msgid ":mod:`distutils.command.check` --- Check the meta-data of a package"
msgstr ""

#: distutils/apiref.rst:2066
msgid ""
"The ``check`` command performs some tests on the meta-data of a package. For "
"example, it verifies that all required meta-data are provided as the "
"arguments passed to the :func:`setup` function."
msgstr ""