forked from AFPy/python-docs-fr
702 lines
21 KiB
Plaintext
702 lines
21 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
|
# Copyright (C) 2001-2023, 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.11\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2023-07-21 14:55+0200\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"
|
|
|
|
#: ../Doc/distutils/builtdist.rst:5
|
|
msgid "Creating Built Distributions"
|
|
msgstr ""
|
|
|
|
#: ../Doc/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 ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:9
|
|
msgid ""
|
|
"A \"built distribution\" is what you're probably used to thinking of either "
|
|
"as a \"binary package\" or an \"installer\" (depending on your background). "
|
|
"It's not necessarily binary, though, because it might contain only Python "
|
|
"source code and/or byte-code; and we don't call it a package, because that "
|
|
"word is already spoken for in Python. (And \"installer\" is a term specific "
|
|
"to the world of mainstream desktop systems.)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:16
|
|
msgid ""
|
|
"A built distribution is how you make life as easy as possible for installers "
|
|
"of your module distribution: for users of RPM-based Linux systems, it's a "
|
|
"binary RPM; for Windows users, it's an executable installer; for Debian-"
|
|
"based Linux users, it's a Debian package; and so forth. Obviously, no one "
|
|
"person will be able to create built distributions for every platform under "
|
|
"the sun, so the Distutils are designed to enable module developers to "
|
|
"concentrate on their specialty---writing code and creating source "
|
|
"distributions---while an intermediary species called *packagers* springs up "
|
|
"to turn source distributions into built distributions for as many platforms "
|
|
"as there are packagers."
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:26
|
|
msgid ""
|
|
"Of course, the module developer could be their own packager; or the packager "
|
|
"could be a volunteer \"out there\" somewhere who has access to a platform "
|
|
"which the original developer does not; or it could be software periodically "
|
|
"grabbing new source distributions and turning them into built distributions "
|
|
"for as many platforms as the software has access to. Regardless of who they "
|
|
"are, a packager uses the setup script and the :command:`bdist` command "
|
|
"family to generate built distributions."
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:34
|
|
msgid ""
|
|
"As a simple example, if I run the following command in the Distutils source "
|
|
"tree::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:39
|
|
msgid ""
|
|
"then the Distutils builds my module distribution (the Distutils itself in "
|
|
"this case), does a \"fake\" installation (also in the :file:`build` "
|
|
"directory), and creates the default type of built distribution for my "
|
|
"platform. The default format for built distributions is a \"dumb\" tar file "
|
|
"on Unix, and a simple executable installer on Windows. (That tar file is "
|
|
"considered \"dumb\" because it has to be unpacked in a specific location to "
|
|
"work.)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:46
|
|
msgid ""
|
|
"Thus, the above command on a Unix system creates :file:`Distutils-1.0.{plat}."
|
|
"tar.gz`; unpacking this tarball from the right place installs the Distutils "
|
|
"just as though you had downloaded the source distribution and run ``python "
|
|
"setup.py install``. (The \"right place\" is either the root of the "
|
|
"filesystem or Python's :file:`{prefix}` directory, depending on the options "
|
|
"given to the :command:`bdist_dumb` command; the default is to make dumb "
|
|
"distributions relative to :file:`{prefix}`.)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:54
|
|
msgid ""
|
|
"Obviously, for pure Python distributions, this isn't any simpler than just "
|
|
"running ``python setup.py install``\\ ---but for non-pure distributions, "
|
|
"which include extensions that would need to be compiled, it can mean the "
|
|
"difference between someone being able to use your extensions or not. And "
|
|
"creating \"smart\" built distributions, such as an RPM package or an "
|
|
"executable installer for Windows, is far more convenient for users even if "
|
|
"your distribution doesn't include any extensions."
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:62
|
|
msgid ""
|
|
"The :command:`bdist` command has a :option:`!--formats` option, similar to "
|
|
"the :command:`sdist` command, which you can use to select the types of built "
|
|
"distribution to generate: for example, ::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:68
|
|
msgid ""
|
|
"would, when run on a Unix system, create :file:`Distutils-1.0.{plat}.zip`\\ "
|
|
"---again, this archive would be unpacked from the root directory to install "
|
|
"the Distutils."
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:72
|
|
msgid "The available formats for built distributions are:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:75
|
|
msgid "Format"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:75
|
|
msgid "Description"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:75
|
|
msgid "Notes"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:77
|
|
msgid "``gztar``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:77
|
|
msgid "gzipped tar file (:file:`.tar.gz`)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:77
|
|
msgid "\\(1)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:80
|
|
msgid "``bztar``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:80
|
|
msgid "bzipped tar file (:file:`.tar.bz2`)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:83
|
|
msgid "``xztar``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:83
|
|
msgid "xzipped tar file (:file:`.tar.xz`)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:86
|
|
msgid "``ztar``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:86
|
|
msgid "compressed tar file (:file:`.tar.Z`)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:86
|
|
msgid "\\(3)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:89
|
|
msgid "``tar``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:89
|
|
msgid "tar file (:file:`.tar`)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:91
|
|
msgid "``zip``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:91
|
|
msgid "zip file (:file:`.zip`)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:91
|
|
msgid "(2),(4)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:93
|
|
msgid "``rpm``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:93
|
|
msgid "RPM"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:93
|
|
msgid "\\(5)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:95
|
|
msgid "``pkgtool``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:95
|
|
msgid "Solaris :program:`pkgtool`"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:97
|
|
msgid "``sdux``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:97
|
|
msgid "HP-UX :program:`swinstall`"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:99
|
|
msgid "``msi``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:99
|
|
msgid "Microsoft Installer."
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:102
|
|
msgid "Added support for the ``xztar`` format."
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:106
|
|
msgid "Notes:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:109
|
|
msgid "default on Unix"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:112
|
|
msgid "default on Windows"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:115
|
|
msgid "requires external :program:`compress` utility."
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:118
|
|
msgid ""
|
|
"requires either external :program:`zip` utility or :mod:`zipfile` module "
|
|
"(part of the standard Python library since Python 1.6)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:122
|
|
msgid ""
|
|
"requires external :program:`rpm` utility, version 3.0.4 or better (use ``rpm "
|
|
"--version`` to find out which version you have)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:125
|
|
msgid ""
|
|
"You don't have to use the :command:`bdist` command with the :option:`!--"
|
|
"formats` option; you can also use the command that directly implements the "
|
|
"format you're interested in. Some of these :command:`bdist` \"sub-"
|
|
"commands\" actually generate several similar formats; for instance, the :"
|
|
"command:`bdist_dumb` command generates all the \"dumb\" archive formats "
|
|
"(``tar``, ``gztar``, ``bztar``, ``xztar``, ``ztar``, and ``zip``), and :"
|
|
"command:`bdist_rpm` generates both binary and source RPMs. The :command:"
|
|
"`bdist` sub-commands, and the formats generated by each, are:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:135
|
|
msgid "Command"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:135
|
|
msgid "Formats"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:137
|
|
msgid ":command:`bdist_dumb`"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:137
|
|
msgid "tar, gztar, bztar, xztar, ztar, zip"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:139
|
|
msgid ":command:`bdist_rpm`"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:139
|
|
msgid "rpm, srpm"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:142
|
|
msgid ""
|
|
"The following sections give details on the individual :command:`bdist_\\*` "
|
|
"commands."
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:158
|
|
msgid "Creating RPM packages"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:160
|
|
msgid ""
|
|
"The RPM format is used by many popular Linux distributions, including Red "
|
|
"Hat, SuSE, and Mandrake. If one of these (or any of the other RPM-based "
|
|
"Linux distributions) is your usual environment, creating RPM packages for "
|
|
"other users of that same distribution is trivial. Depending on the "
|
|
"complexity of your module distribution and differences between Linux "
|
|
"distributions, you may also be able to create RPMs that work on different "
|
|
"RPM-based distributions."
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:167
|
|
msgid ""
|
|
"The usual way to create an RPM of your module distribution is to run the :"
|
|
"command:`bdist_rpm` command::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:172
|
|
msgid "or the :command:`bdist` command with the :option:`!--format` option::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:176
|
|
msgid ""
|
|
"The former allows you to specify RPM-specific options; the latter allows "
|
|
"you to easily specify multiple formats in one run. If you need to do both, "
|
|
"you can explicitly specify multiple :command:`bdist_\\*` commands and their "
|
|
"options::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:182
|
|
msgid ""
|
|
"Creating RPM packages is driven by a :file:`.spec` file, much as using the "
|
|
"Distutils is driven by the setup script. To make your life easier, the :"
|
|
"command:`bdist_rpm` command normally creates a :file:`.spec` file based on "
|
|
"the information you supply in the setup script, on the command line, and in "
|
|
"any Distutils configuration files. Various options and sections in the :"
|
|
"file:`.spec` file are derived from options in the setup script as follows:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:190 ../Doc/distutils/builtdist.rst:214
|
|
msgid "RPM :file:`.spec` file option or section"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:190
|
|
msgid "Distutils setup script option"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:192
|
|
msgid "Name"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:192
|
|
msgid "``name``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:194
|
|
msgid "Summary (in preamble)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:194
|
|
msgid "``description``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:196
|
|
msgid "Version"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:196
|
|
msgid "``version``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:198 ../Doc/distutils/builtdist.rst:221
|
|
msgid "Vendor"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:198
|
|
msgid ""
|
|
"``author`` and ``author_email``, or --- & ``maintainer`` and "
|
|
"``maintainer_email``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:202
|
|
msgid "Copyright"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:202
|
|
msgid "``license``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:204
|
|
msgid "Url"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:204
|
|
msgid "``url``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:206
|
|
msgid "%description (section)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:206
|
|
msgid "``long_description``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:209
|
|
msgid ""
|
|
"Additionally, there are many options in :file:`.spec` files that don't have "
|
|
"corresponding options in the setup script. Most of these are handled "
|
|
"through options to the :command:`bdist_rpm` command as follows:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:214
|
|
msgid ":command:`bdist_rpm` option"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:214
|
|
msgid "default value"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:217
|
|
msgid "Release"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:217
|
|
msgid "``release``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:217
|
|
msgid "\"1\""
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:219
|
|
msgid "Group"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:219
|
|
msgid "``group``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:219
|
|
msgid "\"Development/Libraries\""
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:221
|
|
msgid "``vendor``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:221
|
|
msgid "(see above)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:223
|
|
msgid "Packager"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:223
|
|
msgid "``packager``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:223 ../Doc/distutils/builtdist.rst:225
|
|
#: ../Doc/distutils/builtdist.rst:227 ../Doc/distutils/builtdist.rst:229
|
|
#: ../Doc/distutils/builtdist.rst:231 ../Doc/distutils/builtdist.rst:233
|
|
#: ../Doc/distutils/builtdist.rst:235 ../Doc/distutils/builtdist.rst:237
|
|
msgid "(none)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:225
|
|
msgid "Provides"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:225
|
|
msgid "``provides``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:227
|
|
msgid "Requires"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:227
|
|
msgid "``requires``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:229
|
|
msgid "Conflicts"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:229
|
|
msgid "``conflicts``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:231
|
|
msgid "Obsoletes"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:231
|
|
msgid "``obsoletes``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:233
|
|
msgid "Distribution"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:233
|
|
msgid "``distribution_name``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:235
|
|
msgid "BuildRequires"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:235
|
|
msgid "``build_requires``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:237
|
|
msgid "Icon"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:237
|
|
msgid "``icon``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:240
|
|
msgid ""
|
|
"Obviously, supplying even a few of these options on the command-line would "
|
|
"be tedious and error-prone, so it's usually best to put them in the setup "
|
|
"configuration file, :file:`setup.cfg`\\ ---see section :ref:`setup-config`. "
|
|
"If you distribute or package many Python module distributions, you might "
|
|
"want to put options that apply to all of them in your personal Distutils "
|
|
"configuration file (:file:`~/.pydistutils.cfg`). If you want to temporarily "
|
|
"disable this file, you can pass the :option:`!--no-user-cfg` option to :file:"
|
|
"`setup.py`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:248
|
|
msgid ""
|
|
"There are three steps to building a binary RPM package, all of which are "
|
|
"handled automatically by the Distutils:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:251
|
|
msgid ""
|
|
"create a :file:`.spec` file, which describes the package (analogous to the "
|
|
"Distutils setup script; in fact, much of the information in the setup "
|
|
"script winds up in the :file:`.spec` file)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:255
|
|
msgid "create the source RPM"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:257
|
|
msgid ""
|
|
"create the \"binary\" RPM (which may or may not contain binary code, "
|
|
"depending on whether your module distribution contains Python extensions)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:260
|
|
msgid ""
|
|
"Normally, RPM bundles the last two steps together; when you use the "
|
|
"Distutils, all three steps are typically bundled together."
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:263
|
|
msgid ""
|
|
"If you wish, you can separate these three steps. You can use the :option:"
|
|
"`!--spec-only` option to make :command:`bdist_rpm` just create the :file:`."
|
|
"spec` file and exit; in this case, the :file:`.spec` file will be written to "
|
|
"the \"distribution directory\"---normally :file:`dist/`, but customizable "
|
|
"with the :option:`!--dist-dir` option. (Normally, the :file:`.spec` file "
|
|
"winds up deep in the \"build tree,\" in a temporary directory created by :"
|
|
"command:`bdist_rpm`.)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:291
|
|
msgid "Cross-compiling on Windows"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:293
|
|
msgid ""
|
|
"Starting with Python 2.6, distutils is capable of cross-compiling between "
|
|
"Windows platforms. In practice, this means that with the correct tools "
|
|
"installed, you can use a 32bit version of Windows to create 64bit extensions "
|
|
"and vice-versa."
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:298
|
|
msgid ""
|
|
"To build for an alternate platform, specify the :option:`!--plat-name` "
|
|
"option to the build command. Valid values are currently 'win32', and 'win-"
|
|
"amd64'. For example, on a 32bit version of Windows, you could execute::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:304
|
|
msgid "to build a 64bit version of your extension."
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:306
|
|
msgid ""
|
|
"would create a 64bit installation executable on your 32bit version of "
|
|
"Windows."
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:308
|
|
msgid ""
|
|
"To cross-compile, you must download the Python source code and cross-compile "
|
|
"Python itself for the platform you are targeting - it is not possible from a "
|
|
"binary installation of Python (as the .lib etc file for other platforms are "
|
|
"not included.) In practice, this means the user of a 32 bit operating "
|
|
"system will need to use Visual Studio 2008 to open the :file:`PCbuild/"
|
|
"PCbuild.sln` solution in the Python source tree and build the \"x64\" "
|
|
"configuration of the 'pythoncore' project before cross-compiling extensions "
|
|
"is possible."
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:317
|
|
msgid ""
|
|
"Note that by default, Visual Studio 2008 does not install 64bit compilers or "
|
|
"tools. You may need to reexecute the Visual Studio setup process and select "
|
|
"these tools (using Control Panel->[Add/Remove] Programs is a convenient way "
|
|
"to check or modify your existing install.)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:325
|
|
msgid "The Postinstallation script"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:327
|
|
msgid ""
|
|
"Starting with Python 2.3, a postinstallation script can be specified with "
|
|
"the :option:`!--install-script` option. The basename of the script must be "
|
|
"specified, and the script filename must also be listed in the scripts "
|
|
"argument to the setup function."
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:332
|
|
msgid ""
|
|
"This script will be run at installation time on the target system after all "
|
|
"the files have been copied, with ``argv[1]`` set to :option:`!-install`, and "
|
|
"again at uninstallation time before the files are removed with ``argv[1]`` "
|
|
"set to :option:`!-remove`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:337
|
|
msgid ""
|
|
"The installation script runs embedded in the windows installer, every output "
|
|
"(``sys.stdout``, ``sys.stderr``) is redirected into a buffer and will be "
|
|
"displayed in the GUI after the script has finished."
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:341
|
|
msgid ""
|
|
"Some functions especially useful in this context are available as additional "
|
|
"built-in functions in the installation script."
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:348
|
|
msgid ""
|
|
"These functions should be called when a directory or file is created by the "
|
|
"postinstall script at installation time. It will register *path* with the "
|
|
"uninstaller, so that it will be removed when the distribution is "
|
|
"uninstalled. To be safe, directories are only removed if they are empty."
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:356
|
|
msgid ""
|
|
"This function can be used to retrieve special folder locations on Windows "
|
|
"like the Start Menu or the Desktop. It returns the full path to the folder. "
|
|
"*csidl_string* must be one of the following strings::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:376
|
|
msgid "If the folder cannot be retrieved, :exc:`OSError` is raised."
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:378
|
|
msgid ""
|
|
"Which folders are available depends on the exact Windows version, and "
|
|
"probably also the configuration. For details refer to Microsoft's "
|
|
"documentation of the :c:func:`SHGetSpecialFolderPath` function."
|
|
msgstr ""
|
|
|
|
#: ../Doc/distutils/builtdist.rst:385
|
|
msgid ""
|
|
"This function creates a shortcut. *target* is the path to the program to be "
|
|
"started by the shortcut. *description* is the description of the shortcut. "
|
|
"*filename* is the title of the shortcut that the user will see. *arguments* "
|
|
"specifies the command line arguments, if any. *workdir* is the working "
|
|
"directory for the program. *iconpath* is the file containing the icon for "
|
|
"the shortcut, and *iconindex* is the index of the icon in the file "
|
|
"*iconpath*. Again, for details consult the Microsoft documentation for the :"
|
|
"class:`IShellLink` interface."
|
|
msgstr ""
|