# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2022, Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR , YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.12\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-08-18 00:03+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME \n"
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
"tw)\n"
"Language: zh_TW\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../using/configure.rst:3
msgid "Configure Python"
msgstr ""
#: ../../using/configure.rst:6
msgid "Build Requirements"
msgstr ""
#: ../../using/configure.rst:8
msgid "Features required to build CPython:"
msgstr ""
#: ../../using/configure.rst:10
msgid ""
"A `C11 `_ compiler. `Optional C11 "
"features `_ are not required."
msgstr ""
#: ../../using/configure.rst:15
msgid ""
"Support for `IEEE 754 `_ floating "
"point numbers and `floating point Not-a-Number (NaN) `_."
msgstr ""
#: ../../using/configure.rst:19
msgid "Support for threads."
msgstr ""
#: ../../using/configure.rst:21
msgid "OpenSSL 1.1.1 or newer for the :mod:`ssl` and :mod:`hashlib` modules."
msgstr ""
#: ../../using/configure.rst:23
msgid "On Windows, Microsoft Visual Studio 2017 or later is required."
msgstr ""
#: ../../using/configure.rst:25
msgid ""
"C11 compiler, IEEE 754 and NaN support are now required. On Windows, Visual "
"Studio 2017 or later is required."
msgstr ""
#: ../../using/configure.rst:29
msgid "OpenSSL 1.1.1 is now required."
msgstr ""
#: ../../using/configure.rst:32
msgid "Thread support and OpenSSL 1.0.2 are now required."
msgstr ""
#: ../../using/configure.rst:35
msgid ""
"Selected C99 features are now required, like ```` and ``static "
"inline`` functions."
msgstr ""
#: ../../using/configure.rst:39
msgid "On Windows, Visual Studio 2015 or later is required."
msgstr ""
#: ../../using/configure.rst:42
msgid ""
"See also :pep:`7` \"Style Guide for C Code\" and :pep:`11` \"CPython "
"platform support\"."
msgstr ""
#: ../../using/configure.rst:49
msgid "Configure Options"
msgstr ""
#: ../../using/configure.rst:51
msgid "List all ``./configure`` script options using::"
msgstr ""
#: ../../using/configure.rst:55
msgid ""
"See also the :file:`Misc/SpecialBuilds.txt` in the Python source "
"distribution."
msgstr ""
#: ../../using/configure.rst:58
msgid "General Options"
msgstr ""
#: ../../using/configure.rst:62
msgid ""
"Support loadable extensions in the :mod:`_sqlite` extension module (default "
"is no)."
msgstr ""
#: ../../using/configure.rst:65
msgid ""
"See the :meth:`sqlite3.Connection.enable_load_extension` method of the :mod:"
"`sqlite3` module."
msgstr ""
#: ../../using/configure.rst:72
msgid ""
"Disable IPv6 support (enabled by default if supported), see the :mod:"
"`socket` module."
msgstr ""
#: ../../using/configure.rst:77
msgid "Define the size in bits of Python :class:`int` digits: 15 or 30 bits."
msgstr ""
#: ../../using/configure.rst:79
msgid "By default, the digit size is 30."
msgstr ""
#: ../../using/configure.rst:81
msgid "Define the ``PYLONG_BITS_IN_DIGIT`` to ``15`` or ``30``."
msgstr " ``PYLONG_BITS_IN_DIGIT`` ``15`` ``30``\\ "
#: ../../using/configure.rst:83
msgid "See :data:`sys.int_info.bits_per_digit `."
msgstr " :data:`sys.int_info.bits_per_digit `\\ "
#: ../../using/configure.rst:87
msgid "Set the Python executable suffix to *SUFFIX*."
msgstr ""
#: ../../using/configure.rst:89
msgid ""
"The default suffix is ``.exe`` on Windows and macOS (``python.exe`` "
"executable), ``.js`` on Emscripten node, ``.html`` on Emscripten browser, ``."
"wasm`` on WASI, and an empty string on other platforms (``python`` "
"executable)."
msgstr ""
#: ../../using/configure.rst:94
msgid ""
"The default suffix on WASM platform is one of ``.js``, ``.html`` or ``."
"wasm``."
msgstr ""
#: ../../using/configure.rst:100
msgid ""
"Select the default time zone search path for :const:`zoneinfo.TZPATH`. See "
"the :ref:`Compile-time configuration ` of "
"the :mod:`zoneinfo` module."
msgstr ""
#: ../../using/configure.rst:104
msgid ""
"Default: ``/usr/share/zoneinfo:/usr/lib/zoneinfo:/usr/share/lib/zoneinfo:/"
"etc/zoneinfo``."
msgstr ""
#: ../../using/configure.rst:106
msgid "See :data:`os.pathsep` path separator."
msgstr ""
#: ../../using/configure.rst:112
msgid ""
"Build the ``_decimal`` extension module using a thread-local context rather "
"than a coroutine-local context (default), see the :mod:`decimal` module."
msgstr ""
#: ../../using/configure.rst:115
msgid "See :const:`decimal.HAVE_CONTEXTVAR` and the :mod:`contextvars` module."
msgstr ""
#: ../../using/configure.rst:121
msgid "Override order to check db backends for the :mod:`dbm` module"
msgstr ""
#: ../../using/configure.rst:123
msgid ""
"A valid value is a colon (``:``) separated string with the backend names:"
msgstr ""
#: ../../using/configure.rst:125
msgid "``ndbm``;"
msgstr ""
#: ../../using/configure.rst:126
msgid "``gdbm``;"
msgstr ""
#: ../../using/configure.rst:127
msgid "``bdb``."
msgstr ""
#: ../../using/configure.rst:131
msgid "Disable C locale coercion to a UTF-8 based locale (enabled by default)."
msgstr ""
#: ../../using/configure.rst:133
msgid "Don't define the ``PY_COERCE_C_LOCALE`` macro."
msgstr ""
#: ../../using/configure.rst:135
msgid "See :envvar:`PYTHONCOERCECLOCALE` and the :pep:`538`."
msgstr " :envvar:`PYTHONCOERCECLOCALE` :pep:`538`"
#: ../../using/configure.rst:139
msgid "Disable all freelists except the empty tuple singleton."
msgstr ""
#: ../../using/configure.rst:145
msgid "Python library directory name (default is ``lib``)."
msgstr ""
#: ../../using/configure.rst:147
msgid "Fedora and SuSE use ``lib64`` on 64-bit platforms."
msgstr ""
#: ../../using/configure.rst:149
msgid "See :data:`sys.platlibdir`."
msgstr " :data:`sys.platlibdir`\\ "
#: ../../using/configure.rst:155
msgid ""
"Directory of wheel packages used by the :mod:`ensurepip` module (none by "
"default)."
msgstr ""
#: ../../using/configure.rst:158
msgid ""
"Some Linux distribution packaging policies recommend against bundling "
"dependencies. For example, Fedora installs wheel packages in the ``/usr/"
"share/python-wheels/`` directory and don't install the :mod:`ensurepip."
"_bundled` package."
msgstr ""
#: ../../using/configure.rst:167
msgid ""
"Whether configure should use :program:`pkg-config` to detect build "
"dependencies."
msgstr ""
#: ../../using/configure.rst:170
msgid "``check`` (default): :program:`pkg-config` is optional"
msgstr ""
#: ../../using/configure.rst:171
msgid "``yes``: :program:`pkg-config` is mandatory"
msgstr ""
#: ../../using/configure.rst:172
msgid "``no``: configure does not use :program:`pkg-config` even when present"
msgstr ""
#: ../../using/configure.rst:178
msgid "Turn on internal statistics gathering."
msgstr ""
#: ../../using/configure.rst:180
msgid ""
"The statistics will be dumped to a arbitrary (probably unique) file in ``/"
"tmp/py_stats/``, or ``C:\\temp\\py_stats\\`` on Windows. If that directory "
"does not exist, results will be printed on stdout."
msgstr ""
#: ../../using/configure.rst:184
msgid "Use ``Tools/scripts/summarize_stats.py`` to read the stats."
msgstr ""
#: ../../using/configure.rst:189
msgid "WebAssembly Options"
msgstr ""
#: ../../using/configure.rst:193
msgid "Set build flavor for ``wasm32-emscripten``."
msgstr ""
#: ../../using/configure.rst:195
msgid "``browser`` (default): preload minimal stdlib, default MEMFS."
msgstr ""
#: ../../using/configure.rst:196
msgid "``node``: NODERAWFS and pthread support."
msgstr ""
#: ../../using/configure.rst:202
msgid "Turn on dynamic linking support for WASM."
msgstr ""
#: ../../using/configure.rst:204
msgid ""
"Dynamic linking enables ``dlopen``. File size of the executable increases "
"due to limited dead code elimination and additional features."
msgstr ""
#: ../../using/configure.rst:211
msgid "Turn on pthreads support for WASM."
msgstr ""
#: ../../using/configure.rst:217
msgid "Install Options"
msgstr ""
#: ../../using/configure.rst:221
msgid ""
"Install architecture-independent files in PREFIX. On Unix, it defaults to :"
"file:`/usr/local`."
msgstr ""
#: ../../using/configure.rst:224
msgid "This value can be retrived at runtime using :data:`sys.prefix`."
msgstr ""
#: ../../using/configure.rst:226
msgid ""
"As an example, one can use ``--prefix=\"$HOME/.local/\"`` to install a "
"Python in its home directory."
msgstr ""
#: ../../using/configure.rst:231
msgid ""
"Install architecture-dependent files in EPREFIX, defaults to :option:`--"
"prefix`."
msgstr ""
#: ../../using/configure.rst:233
msgid "This value can be retrived at runtime using :data:`sys.exec_prefix`."
msgstr ""
#: ../../using/configure.rst:237
msgid ""
"Don't build nor install test modules, like the :mod:`test` package or the :"
"mod:`_testcapi` extension module (built and installed by default)."
msgstr ""
#: ../../using/configure.rst:244
msgid "Select the :mod:`ensurepip` command run on Python installation:"
msgstr ""
#: ../../using/configure.rst:246
msgid ""
"``upgrade`` (default): run ``python -m ensurepip --altinstall --upgrade`` "
"command."
msgstr ""
#: ../../using/configure.rst:248
msgid "``install``: run ``python -m ensurepip --altinstall`` command;"
msgstr ""
#: ../../using/configure.rst:249
msgid "``no``: don't run ensurepip;"
msgstr ""
#: ../../using/configure.rst:255
msgid "Performance options"
msgstr ""
#: ../../using/configure.rst:257
msgid ""
"Configuring Python using ``--enable-optimizations --with-lto`` (PGO + LTO) "
"is recommended for best performance. The experimental ``--enable-bolt`` flag "
"can also be used to improve performance."
msgstr ""
#: ../../using/configure.rst:263
msgid ""
"Enable Profile Guided Optimization (PGO) using :envvar:`PROFILE_TASK` "
"(disabled by default)."
msgstr ""
#: ../../using/configure.rst:266
msgid ""
"The C compiler Clang requires ``llvm-profdata`` program for PGO. On macOS, "
"GCC also requires it: GCC is just an alias to Clang on macOS."
msgstr ""
#: ../../using/configure.rst:269
msgid ""
"Disable also semantic interposition in libpython if ``--enable-shared`` and "
"GCC is used: add ``-fno-semantic-interposition`` to the compiler and linker "
"flags."
msgstr ""
#: ../../using/configure.rst:275
msgid "Use ``-fno-semantic-interposition`` on GCC."
msgstr ""
#: ../../using/configure.rst:280
msgid ""
"Environment variable used in the Makefile: Python command line arguments for "
"the PGO generation task."
msgstr ""
#: ../../using/configure.rst:283
msgid "Default: ``-m test --pgo --timeout=$(TESTTIMEOUT)``."
msgstr ""
#: ../../using/configure.rst:289
msgid "Enable Link Time Optimization (LTO) in any build (disabled by default)."
msgstr ""
#: ../../using/configure.rst:291
msgid ""
"The C compiler Clang requires ``llvm-ar`` for LTO (``ar`` on macOS), as well "
"as an LTO-aware linker (``ld.gold`` or ``lld``)."
msgstr ""
#: ../../using/configure.rst:296
msgid "To use ThinLTO feature, use ``--with-lto=thin`` on Clang."
msgstr ""
#: ../../using/configure.rst:299
msgid ""
"Use ThinLTO as the default optimization policy on Clang if the compiler "
"accepts the flag."
msgstr ""
#: ../../using/configure.rst:304
msgid ""
"Enable usage of the `BOLT post-link binary optimizer `_ (disabled by default)."
msgstr ""
#: ../../using/configure.rst:308
msgid ""
"BOLT is part of the LLVM project but is not always included in their binary "
"distributions. This flag requires that ``llvm-bolt`` and ``merge-fdata`` are "
"available."
msgstr ""
#: ../../using/configure.rst:312
msgid ""
"BOLT is still a fairly new project so this flag should be considered "
"experimental for now. Because this tool operates on machine code its success "
"is dependent on a combination of the build environment + the other "
"optimization configure args + the CPU architecture, and not all combinations "
"are supported. BOLT versions before LLVM 16 are known to crash BOLT under "
"some scenarios. Use of LLVM 16 or newer for BOLT optimization is strongly "
"encouraged."
msgstr ""
#: ../../using/configure.rst:320
msgid ""
"The :envvar:`!BOLT_INSTRUMENT_FLAGS` and :envvar:`!BOLT_APPLY_FLAGS` :"
"program:`configure` variables can be defined to override the default set of "
"arguments for :program:`llvm-bolt` to instrument and apply BOLT data to "
"binaries, respectively."
msgstr ""
#: ../../using/configure.rst:329
msgid ""
"Enable computed gotos in evaluation loop (enabled by default on supported "
"compilers)."
msgstr ""
#: ../../using/configure.rst:334
msgid ""
"Disable the specialized Python memory allocator :ref:`pymalloc ` "
"(enabled by default)."
msgstr ""
#: ../../using/configure.rst:337
msgid "See also :envvar:`PYTHONMALLOC` environment variable."
msgstr " :envvar:`PYTHONMALLOC` "
#: ../../using/configure.rst:341
msgid ""
"Disable static documentation strings to reduce the memory footprint (enabled "
"by default). Documentation strings defined in Python are not affected."
msgstr ""
#: ../../using/configure.rst:344
msgid "Don't define the ``WITH_DOC_STRINGS`` macro."
msgstr ""
#: ../../using/configure.rst:346
msgid "See the ``PyDoc_STRVAR()`` macro."
msgstr ""
#: ../../using/configure.rst:350
msgid "Enable C-level code profiling with ``gprof`` (disabled by default)."
msgstr ""
#: ../../using/configure.rst:354
msgid ""
"Add ``-fstrict-overflow`` to the C compiler flags (by default we add ``-fno-"
"strict-overflow`` instead)."
msgstr ""
#: ../../using/configure.rst:361
msgid "Python Debug Build"
msgstr ""
#: ../../using/configure.rst:363
msgid ""
"A debug build is Python built with the :option:`--with-pydebug` configure "
"option."
msgstr ""
#: ../../using/configure.rst:366
msgid "Effects of a debug build:"
msgstr ""
#: ../../using/configure.rst:368
msgid ""
"Display all warnings by default: the list of default warning filters is "
"empty in the :mod:`warnings` module."
msgstr ""
#: ../../using/configure.rst:370
msgid "Add ``d`` to :data:`sys.abiflags`."
msgstr ""
#: ../../using/configure.rst:371
msgid "Add :func:`sys.gettotalrefcount` function."
msgstr " :func:`sys.gettotalrefcount` "
#: ../../using/configure.rst:372
msgid "Add :option:`-X showrefcount ` command line option."
msgstr " :option:`-X showrefcount ` "
#: ../../using/configure.rst:373
msgid ""
"Add :option:`-d` command line option and :envvar:`PYTHONDEBUG` environment "
"variable to debug the parser."
msgstr ""
#: ../../using/configure.rst:375
msgid ""
"Add support for the ``__lltrace__`` variable: enable low-level tracing in "
"the bytecode evaluation loop if the variable is defined."
msgstr ""
#: ../../using/configure.rst:377
msgid ""
"Install :ref:`debug hooks on memory allocators ` "
"to detect buffer overflow and other memory errors."
msgstr ""
#: ../../using/configure.rst:379
msgid "Define ``Py_DEBUG`` and ``Py_REF_DEBUG`` macros."
msgstr " ``Py_DEBUG`` ``Py_REF_DEBUG`` "
#: ../../using/configure.rst:380
msgid ""
"Add runtime checks: code surrounded by ``#ifdef Py_DEBUG`` and ``#endif``. "
"Enable ``assert(...)`` and ``_PyObject_ASSERT(...)`` assertions: don't set "
"the ``NDEBUG`` macro (see also the :option:`--with-assertions` configure "
"option). Main runtime checks:"
msgstr ""
#: ../../using/configure.rst:385
msgid "Add sanity checks on the function arguments."
msgstr ""
#: ../../using/configure.rst:386
msgid ""
"Unicode and int objects are created with their memory filled with a pattern "
"to detect usage of uninitialized objects."
msgstr ""
#: ../../using/configure.rst:388
msgid ""
"Ensure that functions which can clear or replace the current exception are "
"not called with an exception raised."
msgstr ""
#: ../../using/configure.rst:390
msgid "Check that deallocator functions don't change the current exception."
msgstr ""
#: ../../using/configure.rst:391
msgid ""
"The garbage collector (:func:`gc.collect` function) runs some basic checks "
"on objects consistency."
msgstr ""
#: ../../using/configure.rst:393
msgid ""
"The :c:macro:`Py_SAFE_DOWNCAST()` macro checks for integer underflow and "
"overflow when downcasting from wide types to narrow types."
msgstr ""
#: ../../using/configure.rst:396
msgid ""
"See also the :ref:`Python Development Mode ` and the :option:`--"
"with-trace-refs` configure option."
msgstr ""
#: ../../using/configure.rst:399
msgid ""
"Release builds and debug builds are now ABI compatible: defining the "
"``Py_DEBUG`` macro no longer implies the ``Py_TRACE_REFS`` macro (see the :"
"option:`--with-trace-refs` option), which introduces the only ABI "
"incompatibility."
msgstr ""
#: ../../using/configure.rst:407
msgid "Debug options"
msgstr ""
#: ../../using/configure.rst:411
msgid ""
":ref:`Build Python in debug mode `: define the ``Py_DEBUG`` "
"macro (disabled by default)."
msgstr ""
#: ../../using/configure.rst:416
msgid "Enable tracing references for debugging purpose (disabled by default)."
msgstr ""
#: ../../using/configure.rst:418
msgid "Effects:"
msgstr ""
#: ../../using/configure.rst:420
msgid "Define the ``Py_TRACE_REFS`` macro."
msgstr " ``Py_TRACE_REFS`` "
#: ../../using/configure.rst:421
msgid "Add :func:`sys.getobjects` function."
msgstr " :func:`sys.getobjects` "
#: ../../using/configure.rst:422
msgid "Add :envvar:`PYTHONDUMPREFS` environment variable."
msgstr " :envvar:`PYTHONDUMPREFS` "
#: ../../using/configure.rst:424
msgid ""
"This build is not ABI compatible with release build (default build) or debug "
"build (``Py_DEBUG`` and ``Py_REF_DEBUG`` macros)."
msgstr ""
#: ../../using/configure.rst:431
msgid ""
"Build with C assertions enabled (default is no): ``assert(...);`` and "
"``_PyObject_ASSERT(...);``."
msgstr ""
#: ../../using/configure.rst:434
msgid ""
"If set, the ``NDEBUG`` macro is not defined in the :envvar:`OPT` compiler "
"variable."
msgstr ""
#: ../../using/configure.rst:437
msgid ""
"See also the :option:`--with-pydebug` option (:ref:`debug build `) which also enables assertions."
msgstr ""
#: ../../using/configure.rst:444
msgid "Enable Valgrind support (default is no)."
msgstr " Valgrind "
#: ../../using/configure.rst:448
msgid "Enable DTrace support (default is no)."
msgstr " DTrace "
#: ../../using/configure.rst:450
msgid ""
"See :ref:`Instrumenting CPython with DTrace and SystemTap `."
msgstr ""
#: ../../using/configure.rst:457
msgid ""
"Enable AddressSanitizer memory error detector, ``asan`` (default is no)."
msgstr ""
#: ../../using/configure.rst:463
msgid ""
"Enable MemorySanitizer allocation error detector, ``msan`` (default is no)."
msgstr ""
#: ../../using/configure.rst:469
msgid ""
"Enable UndefinedBehaviorSanitizer undefined behaviour detector, ``ubsan`` "
"(default is no)."
msgstr ""
#: ../../using/configure.rst:476
msgid "Linker options"
msgstr ""
#: ../../using/configure.rst:480
msgid "Enable building a shared Python library: ``libpython`` (default is no)."
msgstr ""
#: ../../using/configure.rst:484
msgid ""
"Do not build ``libpythonMAJOR.MINOR.a`` and do not install ``python.o`` "
"(built and enabled by default)."
msgstr ""
#: ../../using/configure.rst:491
msgid "Libraries options"
msgstr ""
#: ../../using/configure.rst:495
msgid "Link against additional libraries (default is no)."
msgstr ""
#: ../../using/configure.rst:499
msgid ""
"Build the :mod:`pyexpat` module using an installed ``expat`` library "
"(default is no)."
msgstr ""
#: ../../using/configure.rst:504
msgid ""
"Build the ``_decimal`` extension module using an installed ``mpdec`` "
"library, see the :mod:`decimal` module (default is no)."
msgstr ""
#: ../../using/configure.rst:511
msgid "Use ``editline`` library for backend of the :mod:`readline` module."
msgstr ""
#: ../../using/configure.rst:513
msgid "Define the ``WITH_EDITLINE`` macro."
msgstr " ``WITH_EDITLINE`` "
#: ../../using/configure.rst:519
msgid "Don't build the :mod:`readline` module (built by default)."
msgstr ""
#: ../../using/configure.rst:521
msgid "Don't define the ``HAVE_LIBREADLINE`` macro."
msgstr " ``HAVE_LIBREADLINE`` "
#: ../../using/configure.rst:527
msgid ""
"Override ``libm`` math library to *STRING* (default is system-dependent)."
msgstr ""
#: ../../using/configure.rst:531
msgid "Override ``libc`` C library to *STRING* (default is system-dependent)."
msgstr ""
#: ../../using/configure.rst:535
msgid "Root of the OpenSSL directory."
msgstr ""
#: ../../using/configure.rst:541
msgid "Set runtime library directory (rpath) for OpenSSL libraries:"
msgstr ""
#: ../../using/configure.rst:543
msgid "``no`` (default): don't set rpath;"
msgstr ""
#: ../../using/configure.rst:544
msgid ""
"``auto``: auto-detect rpath from :option:`--with-openssl` and ``pkg-config``;"
msgstr ""
#: ../../using/configure.rst:546
msgid "*DIR*: set an explicit rpath."
msgstr ""
#: ../../using/configure.rst:552
msgid "Security Options"
msgstr ""
#: ../../using/configure.rst:556
msgid "Select hash algorithm for use in ``Python/pyhash.c``:"
msgstr ""
#: ../../using/configure.rst:558
msgid "``siphash13`` (default);"
msgstr ""
#: ../../using/configure.rst:559
msgid "``siphash24``;"
msgstr "``siphash24``"
#: ../../using/configure.rst:560
msgid "``fnv``."
msgstr "``fnv``"
#: ../../using/configure.rst:564
msgid "``siphash13`` is added and it is the new default."
msgstr ""
#: ../../using/configure.rst:569
msgid "Built-in hash modules:"
msgstr ""
#: ../../using/configure.rst:571
msgid "``md5``;"
msgstr "``md5``"
#: ../../using/configure.rst:572
msgid "``sha1``;"
msgstr "``sha1``"
#: ../../using/configure.rst:573
msgid "``sha256``;"
msgstr "``sha256``"
#: ../../using/configure.rst:574
msgid "``sha512``;"
msgstr "``sha512``"
#: ../../using/configure.rst:575
msgid "``sha3`` (with shake);"
msgstr ""
#: ../../using/configure.rst:576
msgid "``blake2``."
msgstr "``blake2``"
#: ../../using/configure.rst:582
msgid "Override the OpenSSL default cipher suites string:"
msgstr ""
#: ../../using/configure.rst:584
msgid "``python`` (default): use Python's preferred selection;"
msgstr ""
#: ../../using/configure.rst:585
msgid "``openssl``: leave OpenSSL's defaults untouched;"
msgstr ""
#: ../../using/configure.rst:586
msgid "*STRING*: use a custom string"
msgstr ""
#: ../../using/configure.rst:588
msgid "See the :mod:`ssl` module."
msgstr " :mod:`ssl` "
#: ../../using/configure.rst:594
msgid ""
"The settings ``python`` and *STRING* also set TLS 1.2 as minimum protocol "
"version."
msgstr ""
#: ../../using/configure.rst:598
msgid "macOS Options"
msgstr "macOS "
#: ../../using/configure.rst:600
msgid "See ``Mac/README.rst``."
msgstr " ``Mac/README.rst``"
#: ../../using/configure.rst:605
msgid ""
"Create a universal binary build. *SDKDIR* specifies which macOS SDK should "
"be used to perform the build (default is no)."
msgstr ""
#: ../../using/configure.rst:611
msgid ""
"Create a Python.framework rather than a traditional Unix install. Optional "
"*INSTALLDIR* specifies the installation path (default is no)."
msgstr ""
#: ../../using/configure.rst:616
msgid ""
"Specify the kind of universal binary that should be created. This option is "
"only valid when :option:`--enable-universalsdk` is set."
msgstr ""
#: ../../using/configure.rst:619
msgid "Options:"
msgstr ""
#: ../../using/configure.rst:621
msgid "``universal2``;"
msgstr "``universal2``"
#: ../../using/configure.rst:622
msgid "``32-bit``;"
msgstr "``32-bit``"
#: ../../using/configure.rst:623
msgid "``64-bit``;"
msgstr "``64-bit``"
#: ../../using/configure.rst:624
msgid "``3-way``;"
msgstr "``3-way``"
#: ../../using/configure.rst:625
msgid "``intel``;"
msgstr "``intel``"
#: ../../using/configure.rst:626
msgid "``intel-32``;"
msgstr "``intel-32``"
#: ../../using/configure.rst:627
msgid "``intel-64``;"
msgstr "``intel-64``"
#: ../../using/configure.rst:628
msgid "``all``."
msgstr "``all``"
#: ../../using/configure.rst:632
msgid ""
"Specify the name for the python framework on macOS only valid when :option:"
"`--enable-framework` is set (default: ``Python``)."
msgstr ""
#: ../../using/configure.rst:637
msgid "Cross Compiling Options"
msgstr ""
#: ../../using/configure.rst:639
msgid ""
"Cross compiling, also known as cross building, can be used to build Python "
"for another CPU architecture or platform. Cross compiling requires a Python "
"interpreter for the build platform. The version of the build Python must "
"match the version of the cross compiled host Python."
msgstr ""
#: ../../using/configure.rst:646
msgid ""
"configure for building on BUILD, usually guessed by :program:`config.guess`."
msgstr ""
#: ../../using/configure.rst:650
msgid "cross-compile to build programs to run on HOST (target platform)"
msgstr ""
#: ../../using/configure.rst:654
msgid "path to build ``python`` binary for cross compiling"
msgstr ""
#: ../../using/configure.rst:660
msgid "An environment variable that points to a file with configure overrides."
msgstr ""
#: ../../using/configure.rst:662
msgid "Example *config.site* file::"
msgstr ""
#: ../../using/configure.rst:670
msgid "Cross compiling example::"
msgstr ""
#: ../../using/configure.rst:679
msgid "Python Build System"
msgstr ""
#: ../../using/configure.rst:682
msgid "Main files of the build system"
msgstr ""
#: ../../using/configure.rst:684
msgid ":file:`configure.ac` => :file:`configure`;"
msgstr ":file:`configure.ac` => :file:`configure`\\ "
#: ../../using/configure.rst:685
msgid ""
":file:`Makefile.pre.in` => :file:`Makefile` (created by :file:`configure`);"
msgstr ""
#: ../../using/configure.rst:686
msgid ":file:`pyconfig.h` (created by :file:`configure`);"
msgstr ":file:`pyconfig.h` (created by :file:`configure`)\\ "
#: ../../using/configure.rst:687
msgid ""
":file:`Modules/Setup`: C extensions built by the Makefile using :file:"
"`Module/makesetup` shell script;"
msgstr ""
#: ../../using/configure.rst:691
msgid "Main build steps"
msgstr ""
#: ../../using/configure.rst:693
msgid "C files (``.c``) are built as object files (``.o``)."
msgstr ""
#: ../../using/configure.rst:694
msgid "A static ``libpython`` library (``.a``) is created from objects files."
msgstr ""
#: ../../using/configure.rst:695
msgid ""
"``python.o`` and the static ``libpython`` library are linked into the final "
"``python`` program."
msgstr ""
#: ../../using/configure.rst:697
msgid "C extensions are built by the Makefile (see :file:`Modules/Setup`)."
msgstr ""
#: ../../using/configure.rst:700
msgid "Main Makefile targets"
msgstr ""
#: ../../using/configure.rst:702
msgid "``make``: Build Python with the standard library."
msgstr ""
#: ../../using/configure.rst:703
msgid ""
"``make platform:``: build the ``python`` program, but don't build the "
"standard library extension modules."
msgstr ""
#: ../../using/configure.rst:705
msgid ""
"``make profile-opt``: build Python using Profile Guided Optimization (PGO). "
"You can use the configure :option:`--enable-optimizations` option to make "
"this the default target of the ``make`` command (``make all`` or just "
"``make``)."
msgstr ""
#: ../../using/configure.rst:709
msgid ""
"``make buildbottest``: Build Python and run the Python test suite, the same "
"way than buildbots test Python. Set ``TESTTIMEOUT`` variable (in seconds) to "
"change the test timeout (1200 by default: 20 minutes)."
msgstr ""
#: ../../using/configure.rst:712
msgid "``make install``: Build and install Python."
msgstr ""
#: ../../using/configure.rst:713
msgid ""
"``make regen-all``: Regenerate (almost) all generated files; ``make regen-"
"stdlib-module-names`` and ``autoconf`` must be run separately for the "
"remaining generated files."
msgstr ""
#: ../../using/configure.rst:716
msgid "``make clean``: Remove built files."
msgstr ""
#: ../../using/configure.rst:717
msgid ""
"``make distclean``: Same than ``make clean``, but remove also files created "
"by the configure script."
msgstr ""
#: ../../using/configure.rst:721
msgid "C extensions"
msgstr ""
#: ../../using/configure.rst:723
msgid ""
"Some C extensions are built as built-in modules, like the ``sys`` module. "
"They are built with the ``Py_BUILD_CORE_BUILTIN`` macro defined. Built-in "
"modules have no ``__file__`` attribute::"
msgstr ""
#: ../../using/configure.rst:735
msgid ""
"Other C extensions are built as dynamic libraries, like the ``_asyncio`` "
"module. They are built with the ``Py_BUILD_CORE_MODULE`` macro defined. "
"Example on Linux x86-64::"
msgstr ""
#: ../../using/configure.rst:745
msgid ""
":file:`Modules/Setup` is used to generate Makefile targets to build C "
"extensions. At the beginning of the files, C extensions are built as built-"
"in modules. Extensions defined after the ``*shared*`` marker are built as "
"dynamic libraries."
msgstr ""
#: ../../using/configure.rst:749
msgid ""
"The :c:macro:`PyAPI_FUNC()`, :c:macro:`PyAPI_DATA()` and :c:macro:"
"`PyMODINIT_FUNC` macros of :file:`Include/pyport.h` are defined differently "
"depending if the ``Py_BUILD_CORE_MODULE`` macro is defined:"
msgstr ""
#: ../../using/configure.rst:753
msgid "Use ``Py_EXPORTED_SYMBOL`` if the ``Py_BUILD_CORE_MODULE`` is defined"
msgstr ""
#: ../../using/configure.rst:754
msgid "Use ``Py_IMPORTED_SYMBOL`` otherwise."
msgstr ""
#: ../../using/configure.rst:756
msgid ""
"If the ``Py_BUILD_CORE_BUILTIN`` macro is used by mistake on a C extension "
"built as a shared library, its ``PyInit_xxx()`` function is not exported, "
"causing an :exc:`ImportError` on import."
msgstr ""
#: ../../using/configure.rst:762
msgid "Compiler and linker flags"
msgstr ""
#: ../../using/configure.rst:764
msgid ""
"Options set by the ``./configure`` script and environment variables and used "
"by ``Makefile``."
msgstr ""
#: ../../using/configure.rst:768
msgid "Preprocessor flags"
msgstr ""
#: ../../using/configure.rst:772
msgid ""
"Value of :envvar:`CPPFLAGS` variable passed to the ``./configure`` script."
msgstr ""
#: ../../using/configure.rst:778
msgid ""
"(Objective) C/C++ preprocessor flags, e.g. ``-I`` if you have "
"headers in a nonstandard directory ````."
msgstr ""
#: ../../using/configure.rst:781 ../../using/configure.rst:971
msgid ""
"Both :envvar:`CPPFLAGS` and :envvar:`LDFLAGS` need to contain the shell's "
"value to be able to build extension modules using the directories specified "
"in the environment variables."
msgstr ""
#: ../../using/configure.rst:791
msgid ""
"Extra preprocessor flags added for building the interpreter object files."
msgstr ""
#: ../../using/configure.rst:793
msgid ""
"Default: ``$(BASECPPFLAGS) -I. -I$(srcdir)/Include $(CONFIGURE_CPPFLAGS) "
"$(CPPFLAGS)``."
msgstr ""
#: ../../using/configure.rst:798
msgid "Compiler flags"
msgstr ""
#: ../../using/configure.rst:802
msgid "C compiler command."
msgstr "C "
#: ../../using/configure.rst:804
msgid "Example: ``gcc -pthread``."
msgstr ""
#: ../../using/configure.rst:808
msgid "C++ compiler command."
msgstr "C++ "
#: ../../using/configure.rst:810
msgid "Example: ``g++ -pthread``."
msgstr ""
#: ../../using/configure.rst:814
msgid "C compiler flags."
msgstr "C "
#: ../../using/configure.rst:818
msgid ""
":envvar:`CFLAGS_NODIST` is used for building the interpreter and stdlib C "
"extensions. Use it when a compiler flag should *not* be part of :envvar:"
"`CFLAGS` once Python is installed (:gh:`65320`)."
msgstr ""
#: ../../using/configure.rst:822
msgid "In particular, :envvar:`CFLAGS` should not contain:"
msgstr ""
#: ../../using/configure.rst:824
msgid ""
"the compiler flag ``-I`` (for setting the search path for include files). "
"The ``-I`` flags are processed from left to right, and any flags in :envvar:"
"`CFLAGS` would take precedence over user- and package-supplied ``-I`` flags."
msgstr ""
#: ../../using/configure.rst:829
msgid ""
"hardening flags such as ``-Werror`` because distributions cannot control "
"whether packages installed by users conform to such heightened standards."
msgstr ""
#: ../../using/configure.rst:837
msgid ""
"Options passed to the :mod:`compileall` command line when building PYC files "
"in ``make install``. Default: ``-j0``."
msgstr ""
#: ../../using/configure.rst:844
msgid "Extra C compiler flags."
msgstr " C "
#: ../../using/configure.rst:848
msgid ""
"Value of :envvar:`CFLAGS` variable passed to the ``./configure`` script."
msgstr ""
#: ../../using/configure.rst:855
msgid ""
"Value of :envvar:`CFLAGS_NODIST` variable passed to the ``./configure`` "
"script."
msgstr ""
#: ../../using/configure.rst:862
msgid "Base compiler flags."
msgstr ""
#: ../../using/configure.rst:866
msgid "Optimization flags."
msgstr ""
#: ../../using/configure.rst:870
msgid "Strict or non-strict aliasing flags used to compile ``Python/dtoa.c``."
msgstr ""
#: ../../using/configure.rst:876
msgid "Compiler flags used to build a shared library."
msgstr ""
#: ../../using/configure.rst:878
msgid "For example, ``-fPIC`` is used on Linux and on BSD."
msgstr " ``-fPIC`` Linux BSD "
#: ../../using/configure.rst:882
msgid "Extra C flags added for building the interpreter object files."
msgstr ""
#: ../../using/configure.rst:884
msgid ""
"Default: ``$(CCSHARED)`` when :option:`--enable-shared` is used, or an empty "
"string otherwise."
msgstr ""
#: ../../using/configure.rst:889
msgid ""
"Default: ``$(BASECFLAGS) $(OPT) $(CONFIGURE_CFLAGS) $(CFLAGS) "
"$(EXTRA_CFLAGS)``."
msgstr ""
#: ../../using/configure.rst:893
msgid ""
"Default: ``$(CONFIGURE_CFLAGS_NODIST) $(CFLAGS_NODIST) -I$(srcdir)/Include/"
"internal``."
msgstr ""
#: ../../using/configure.rst:899
msgid "C flags used for building the interpreter object files."
msgstr ""
#: ../../using/configure.rst:901
msgid ""
"Default: ``$(PY_CFLAGS) $(PY_CFLAGS_NODIST) $(PY_CPPFLAGS) "
"$(CFLAGSFORSHARED)``."
msgstr ""
#: ../../using/configure.rst:907
msgid "Default: ``$(PY_STDMODULE_CFLAGS) -DPy_BUILD_CORE``."
msgstr ""
#: ../../using/configure.rst:913
msgid ""
"Compiler flags to build a standard library extension module as a built-in "
"module, like the :mod:`posix` module."
msgstr ""
#: ../../using/configure.rst:916
msgid "Default: ``$(PY_STDMODULE_CFLAGS) -DPy_BUILD_CORE_BUILTIN``."
msgstr ""
#: ../../using/configure.rst:922
msgid "Purify command. Purify is a memory debugger program."
msgstr ""
#: ../../using/configure.rst:924
msgid "Default: empty string (not used)."
msgstr ""
#: ../../using/configure.rst:928
msgid "Linker flags"
msgstr ""
#: ../../using/configure.rst:932
msgid ""
"Linker command used to build programs like ``python`` and ``_testembed``."
msgstr ""
#: ../../using/configure.rst:934
msgid "Default: ``$(PURIFY) $(CC)``."
msgstr ""
#: ../../using/configure.rst:938
msgid ""
"Value of :envvar:`LDFLAGS` variable passed to the ``./configure`` script."
msgstr ""
#: ../../using/configure.rst:940
msgid ""
"Avoid assigning :envvar:`CFLAGS`, :envvar:`LDFLAGS`, etc. so users can use "
"them on the command line to append to these values without stomping the pre-"
"set values."
msgstr ""
#: ../../using/configure.rst:948
msgid ""
":envvar:`LDFLAGS_NODIST` is used in the same manner as :envvar:"
"`CFLAGS_NODIST`. Use it when a linker flag should *not* be part of :envvar:"
"`LDFLAGS` once Python is installed (:gh:`65320`)."
msgstr ""
#: ../../using/configure.rst:952
msgid "In particular, :envvar:`LDFLAGS` should not contain:"
msgstr ""
#: ../../using/configure.rst:954
msgid ""
"the compiler flag ``-L`` (for setting the search path for libraries). The ``-"
"L`` flags are processed from left to right, and any flags in :envvar:"
"`LDFLAGS` would take precedence over user- and package-supplied ``-L`` flags."
msgstr ""
#: ../../using/configure.rst:961
msgid ""
"Value of :envvar:`LDFLAGS_NODIST` variable passed to the ``./configure`` "
"script."
msgstr ""
#: ../../using/configure.rst:968
msgid ""
"Linker flags, e.g. ``-L`` if you have libraries in a nonstandard "
"directory ````."
msgstr ""
#: ../../using/configure.rst:977
msgid ""
"Linker flags to pass libraries to the linker when linking the Python "
"executable."
msgstr ""
#: ../../using/configure.rst:980
msgid "Example: ``-lrt``."
msgstr ""
#: ../../using/configure.rst:984
msgid "Command to build a shared library."
msgstr ""
#: ../../using/configure.rst:986
msgid "Default: ``@LDSHARED@ $(PY_LDFLAGS)``."
msgstr "``@LDSHARED@ $(PY_LDFLAGS)``"
#: ../../using/configure.rst:990
msgid "Command to build ``libpython`` shared library."
msgstr ""
#: ../../using/configure.rst:992
msgid "Default: ``@BLDSHARED@ $(PY_CORE_LDFLAGS)``."
msgstr "``@BLDSHARED@ $(PY_CORE_LDFLAGS)``"
#: ../../using/configure.rst:996
msgid "Default: ``$(CONFIGURE_LDFLAGS) $(LDFLAGS)``."
msgstr "``$(CONFIGURE_LDFLAGS) $(LDFLAGS)``"
#: ../../using/configure.rst:1000
msgid "Default: ``$(CONFIGURE_LDFLAGS_NODIST) $(LDFLAGS_NODIST)``."
msgstr "``$(CONFIGURE_LDFLAGS_NODIST) $(LDFLAGS_NODIST)``"
#: ../../using/configure.rst:1006
msgid "Linker flags used for building the interpreter object files."
msgstr ""