# SOME DESCRIPTIVE TITLE.

# Copyright (C) 2001 Python Software Foundation

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

# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.

#

# Translators:

# Alireza Shabani (Revisto) <theRevisto@gmail.com>, 2025

#

#, fuzzy

msgid ""

msgstr ""

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

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

"POT-Creation-Date: 2025-07-11 14:21+0000\n"

"PO-Revision-Date: 2021-06-28 01:50+0000\n"

"Last-Translator: Alireza Shabani (Revisto) <theRevisto@gmail.com>, 2025\n"

"Language-Team: Persian (https://app.transifex.com/python-doc/teams/5390/"

"fa/)\n"

"MIME-Version: 1.0\n"

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

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

"Language: fa\n"

"Plural-Forms: nplurals=2; plural=(n > 1);\n"

#: ../../using/configure.rst:3

msgid "Configure Python"

msgstr ""

#: ../../using/configure.rst:8

msgid "Build Requirements"

msgstr ""

#: ../../using/configure.rst:10

msgid "Features and minimum versions required to build CPython:"

msgstr ""

#: ../../using/configure.rst:12

msgid ""

"A `C11 <https://en.cppreference.com/w/c/11>`_ compiler. `Optional C11 "

"features <https://en.wikipedia.org/wiki/"

"C11_(C_standard_revision)#Optional_features>`_ are not required."

msgstr ""

#: ../../using/configure.rst:17

msgid "On Windows, Microsoft Visual Studio 2017 or later is required."

msgstr ""

#: ../../using/configure.rst:19

msgid ""

"Support for `IEEE 754 <https://en.wikipedia.org/wiki/IEEE_754>`_ floating-"

"point numbers and `floating-point Not-a-Number (NaN) <https://en.wikipedia."

"org/wiki/NaN#Floating_point>`_."

msgstr ""

#: ../../using/configure.rst:23

msgid "Support for threads."

msgstr ""

#: ../../using/configure.rst:25

msgid ""

"OpenSSL 1.1.1 is the minimum version and OpenSSL 3.0.16 is the recommended "

"minimum version for the :mod:`ssl` and :mod:`hashlib` extension modules."

msgstr ""

#: ../../using/configure.rst:28

msgid "SQLite 3.15.2 for the :mod:`sqlite3` extension module."

msgstr ""

#: ../../using/configure.rst:30

msgid "Tcl/Tk 8.5.12 for the :mod:`tkinter` module."

msgstr ""

#: ../../using/configure.rst:32

msgid ""

"`libmpdec <https://www.bytereef.org/mpdecimal/doc/libmpdec/>`_ 2.5.0 for "

"the :mod:`decimal` module."

msgstr ""

#: ../../using/configure.rst:35

msgid ""

"Autoconf 2.72 and aclocal 1.16.5 are required to regenerate the :file:"

"`configure` script."

msgstr ""

#: ../../using/configure.rst:38

msgid "Tcl/Tk version 8.3.1 is now required."

msgstr ""

#: ../../using/configure.rst:41

msgid ""

"On Windows, Visual Studio 2015 or later is now required. Tcl/Tk version 8.4 "

"is now required."

msgstr ""

#: ../../using/configure.rst:45

msgid ""

"Selected C99 features are now required, like ``<stdint.h>`` and ``static "

"inline`` functions."

msgstr ""

#: ../../using/configure.rst:49

msgid "Thread support and OpenSSL 1.0.2 are now required."

msgstr ""

#: ../../using/configure.rst:52

msgid "OpenSSL 1.1.1 is now required. Require SQLite 3.7.15."

msgstr ""

#: ../../using/configure.rst:56

msgid ""

"C11 compiler, IEEE 754 and NaN support are now required. On Windows, Visual "

"Studio 2017 or later is required. Tcl/Tk version 8.5.12 is now required for "

"the :mod:`tkinter` module."

msgstr ""

#: ../../using/configure.rst:61

msgid "Autoconf 2.71, aclocal 1.16.5 and SQLite 3.15.2 are now required."

msgstr ""

#: ../../using/configure.rst:64

msgid "Autoconf 2.72 is now required."

msgstr ""

#: ../../using/configure.rst:67

msgid ""

"See also :pep:`7` \"Style Guide for C Code\" and :pep:`11` \"CPython "

"platform support\"."

msgstr ""

#: ../../using/configure.rst:72

msgid "Generated files"

msgstr ""

#: ../../using/configure.rst:74

msgid ""

"To reduce build dependencies, Python source code contains multiple generated "

"files. Commands to regenerate all generated files::"

msgstr ""

#: ../../using/configure.rst:77

msgid ""

"make regen-all\n"

"make regen-stdlib-module-names\n"

"make regen-limited-abi\n"

"make regen-configure"

msgstr ""

#: ../../using/configure.rst:82

msgid ""

"The ``Makefile.pre.in`` file documents generated files, their inputs, and "

"tools used to regenerate them. Search for ``regen-*`` make targets."

msgstr ""

#: ../../using/configure.rst:86

msgid "configure script"

msgstr ""

#: ../../using/configure.rst:88

msgid ""

"The ``make regen-configure`` command regenerates the ``aclocal.m4`` file and "

"the ``configure`` script using the ``Tools/build/regen-configure.sh`` shell "

"script which uses an Ubuntu container to get the same tools versions and "

"have a reproducible output."

msgstr ""

#: ../../using/configure.rst:93

msgid "The container is optional, the following command can be run locally::"

msgstr ""

#: ../../using/configure.rst:95

msgid "autoreconf -ivf -Werror"

msgstr ""

#: ../../using/configure.rst:97

msgid ""

"The generated files can change depending on the exact ``autoconf-archive``, "

"``aclocal`` and ``pkg-config`` versions."

msgstr ""

#: ../../using/configure.rst:104

msgid "Configure Options"

msgstr ""

#: ../../using/configure.rst:106

msgid "List all :file:`configure` script options using::"

msgstr ""

#: ../../using/configure.rst:108

msgid "./configure --help"

msgstr ""

#: ../../using/configure.rst:110

msgid ""

"See also the :file:`Misc/SpecialBuilds.txt` in the Python source "

"distribution."

msgstr ""

#: ../../using/configure.rst:113

msgid "General Options"

msgstr ""

#: ../../using/configure.rst:117

msgid ""

"Support loadable extensions in the :mod:`!_sqlite` extension module (default "

"is no) of the :mod:`sqlite3` module."

msgstr ""

#: ../../using/configure.rst:120

msgid ""

"See the :meth:`sqlite3.Connection.enable_load_extension` method of the :mod:"

"`sqlite3` module."

msgstr ""

#: ../../using/configure.rst:127

msgid ""

"Disable IPv6 support (enabled by default if supported), see the :mod:"

"`socket` module."

msgstr ""

#: ../../using/configure.rst:132

msgid "Define the size in bits of Python :class:`int` digits: 15 or 30 bits."

msgstr ""

#: ../../using/configure.rst:134

msgid "By default, the digit size is 30."

msgstr ""

#: ../../using/configure.rst:136

msgid "Define the ``PYLONG_BITS_IN_DIGIT`` to ``15`` or ``30``."

msgstr ""

#: ../../using/configure.rst:138

msgid "See :data:`sys.int_info.bits_per_digit <sys.int_info>`."

msgstr ""

#: ../../using/configure.rst:142

msgid "Set the Python executable suffix to *SUFFIX*."

msgstr ""

#: ../../using/configure.rst:144

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:149

msgid ""

"The default suffix on WASM platform is one of ``.js``, ``.html`` or ``."

"wasm``."

msgstr ""

#: ../../using/configure.rst:155

msgid ""

"Select the default time zone search path for :const:`zoneinfo.TZPATH`. See "

"the :ref:`Compile-time configuration <zoneinfo_data_compile_time_config>` of "

"the :mod:`zoneinfo` module."

msgstr ""

#: ../../using/configure.rst:159

msgid ""

"Default: ``/usr/share/zoneinfo:/usr/lib/zoneinfo:/usr/share/lib/zoneinfo:/"

"etc/zoneinfo``."

msgstr ""

#: ../../using/configure.rst:161

msgid "See :data:`os.pathsep` path separator."

msgstr ""

#: ../../using/configure.rst:167

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:170

msgid "See :const:`decimal.HAVE_CONTEXTVAR` and the :mod:`contextvars` module."

msgstr ""

#: ../../using/configure.rst:176

msgid "Override order to check db backends for the :mod:`dbm` module"

msgstr ""

#: ../../using/configure.rst:178

msgid ""

"A valid value is a colon (``:``) separated string with the backend names:"

msgstr ""

#: ../../using/configure.rst:180

msgid "``ndbm``;"

msgstr ""

#: ../../using/configure.rst:181

msgid "``gdbm``;"

msgstr ""

#: ../../using/configure.rst:182

msgid "``bdb``."

msgstr ""

#: ../../using/configure.rst:186

msgid "Disable C locale coercion to a UTF-8 based locale (enabled by default)."

msgstr ""

#: ../../using/configure.rst:188

msgid "Don't define the ``PY_COERCE_C_LOCALE`` macro."

msgstr ""

#: ../../using/configure.rst:190

msgid "See :envvar:`PYTHONCOERCECLOCALE` and the :pep:`538`."

msgstr ""

#: ../../using/configure.rst:194

msgid "Python library directory name (default is ``lib``)."

msgstr ""

#: ../../using/configure.rst:196

msgid "Fedora and SuSE use ``lib64`` on 64-bit platforms."

msgstr ""

#: ../../using/configure.rst:198

msgid "See :data:`sys.platlibdir`."

msgstr ""

#: ../../using/configure.rst:204

msgid ""

"Directory of wheel packages used by the :mod:`ensurepip` module (none by "

"default)."

msgstr ""

#: ../../using/configure.rst:207

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:216

msgid ""

"Whether configure should use :program:`pkg-config` to detect build "

"dependencies."

msgstr ""

#: ../../using/configure.rst:219

msgid "``check`` (default): :program:`pkg-config` is optional"

msgstr ""

#: ../../using/configure.rst:220

msgid "``yes``: :program:`pkg-config` is mandatory"

msgstr ""

#: ../../using/configure.rst:221

msgid "``no``: configure does not use :program:`pkg-config` even when present"

msgstr ""

#: ../../using/configure.rst:227

msgid "Turn on internal Python performance statistics gathering."

msgstr ""

#: ../../using/configure.rst:229

msgid ""

"By default, statistics gathering is off. Use ``python3 -X pystats`` command "

"or set ``PYTHONSTATS=1`` environment variable to turn on statistics "

"gathering at Python startup."

msgstr ""

#: ../../using/configure.rst:233

msgid ""

"At Python exit, dump statistics if statistics gathering was on and not "

"cleared."

msgstr ""

#: ../../using/configure.rst:236 ../../using/configure.rst:759

msgid "Effects:"

msgstr ""

#: ../../using/configure.rst:238

msgid "Add :option:`-X pystats <-X>` command line option."

msgstr ""

#: ../../using/configure.rst:239

msgid "Add :envvar:`!PYTHONSTATS` environment variable."

msgstr ""

#: ../../using/configure.rst:240

msgid "Define the ``Py_STATS`` macro."

msgstr ""

#: ../../using/configure.rst:241

msgid "Add functions to the :mod:`sys` module:"

msgstr ""

#: ../../using/configure.rst:243

msgid ":func:`!sys._stats_on`: Turns on statistics gathering."

msgstr ""

#: ../../using/configure.rst:244

msgid ":func:`!sys._stats_off`: Turns off statistics gathering."

msgstr ""

#: ../../using/configure.rst:245

msgid ":func:`!sys._stats_clear`: Clears the statistics."

msgstr ""

#: ../../using/configure.rst:246

msgid ""

":func:`!sys._stats_dump`: Dump statistics to file, and clears the statistics."

msgstr ""

#: ../../using/configure.rst:248

msgid ""

"The statistics will be dumped to a arbitrary (probably unique) file in ``/"

"tmp/py_stats/`` (Unix) or ``C:\\temp\\py_stats\\`` (Windows). If that "

"directory does not exist, results will be printed on stderr."

msgstr ""

#: ../../using/configure.rst:252

msgid "Use ``Tools/scripts/summarize_stats.py`` to read the stats."

msgstr ""

#: ../../using/configure.rst:254

msgid "Statistics:"

msgstr ""

#: ../../using/configure.rst:256

msgid "Opcode:"

msgstr ""

#: ../../using/configure.rst:258

msgid "Specialization: success, failure, hit, deferred, miss, deopt, failures;"

msgstr ""

#: ../../using/configure.rst:259

msgid "Execution count;"

msgstr ""

#: ../../using/configure.rst:260

msgid "Pair count."

msgstr ""

#: ../../using/configure.rst:262

msgid "Call:"

msgstr ""

#: ../../using/configure.rst:264

msgid "Inlined Python calls;"

msgstr ""

#: ../../using/configure.rst:265

msgid "PyEval calls;"

msgstr ""

#: ../../using/configure.rst:266

msgid "Frames pushed;"

msgstr ""

#: ../../using/configure.rst:267

msgid "Frame object created;"

msgstr ""

#: ../../using/configure.rst:268

msgid ""

"Eval calls: vector, generator, legacy, function VECTORCALL, build class, "

"slot, function \"ex\", API, method."

msgstr ""

#: ../../using/configure.rst:271

msgid "Object:"

msgstr ""

#: ../../using/configure.rst:273

msgid "incref and decref;"

msgstr ""

#: ../../using/configure.rst:274

msgid "interpreter incref and decref;"

msgstr ""

#: ../../using/configure.rst:275

msgid "allocations: all, 512 bytes, 4 kiB, big;"

msgstr ""

#: ../../using/configure.rst:276

msgid "free;"

msgstr ""

#: ../../using/configure.rst:277

msgid "to/from free lists;"

msgstr ""

#: ../../using/configure.rst:278

msgid "dictionary materialized/dematerialized;"

msgstr ""

#: ../../using/configure.rst:279

msgid "type cache;"

msgstr ""

#: ../../using/configure.rst:280

msgid "optimization attempts;"

msgstr ""

#: ../../using/configure.rst:281

msgid "optimization traces created/executed;"

msgstr ""

#: ../../using/configure.rst:282

msgid "uops executed."

msgstr ""

#: ../../using/configure.rst:284

msgid "Garbage collector:"

msgstr ""

#: ../../using/configure.rst:286

msgid "Garbage collections;"

msgstr ""

#: ../../using/configure.rst:287

msgid "Objects visited;"

msgstr ""

#: ../../using/configure.rst:288

msgid "Objects collected."

msgstr ""

#: ../../using/configure.rst:296

msgid ""

"Enables support for running Python without the :term:`global interpreter "

"lock` (GIL): free threading build."

msgstr ""

#: ../../using/configure.rst:299

msgid ""

"Defines the ``Py_GIL_DISABLED`` macro and adds ``\"t\"`` to :data:`sys."

"abiflags`."

msgstr ""

#: ../../using/configure.rst:302

msgid "See :ref:`whatsnew313-free-threaded-cpython` for more detail."

msgstr ""

#: ../../using/configure.rst:308

msgid ""

"Indicate how to integrate the :ref:`experimental just-in-time compiler "

"<whatsnew314-jit-compiler>`."

msgstr ""

#: ../../using/configure.rst:310

msgid "``no``: Don't build the JIT."

msgstr ""

#: ../../using/configure.rst:311

msgid ""

"``yes``: Enable the JIT. To disable it at runtime, set the environment "

"variable :envvar:`PYTHON_JIT=0 <PYTHON_JIT>`."

msgstr ""

#: ../../using/configure.rst:313

msgid ""

"``yes-off``: Build the JIT, but disable it by default. To enable it at "

"runtime, set the environment variable :envvar:`PYTHON_JIT=1 <PYTHON_JIT>`."

msgstr ""

#: ../../using/configure.rst:315

msgid ""

"``interpreter``: Enable the \"JIT interpreter\" (only useful for those "

"debugging the JIT itself). To disable it at runtime, set the environment "

"variable :envvar:`PYTHON_JIT=0 <PYTHON_JIT>`."

msgstr ""

#: ../../using/configure.rst:319

msgid ""

"``--enable-experimental-jit=no`` is the default behavior if the option is "

"not provided, and ``--enable-experimental-jit`` is shorthand for ``--enable-"

"experimental-jit=yes``. See :file:`Tools/jit/README.md` for more "

"information, including how to install the necessary build-time dependencies."

msgstr ""

#: ../../using/configure.rst:326

msgid ""

"When building CPython with JIT enabled, ensure that your system has Python "

"3.11 or later installed."

msgstr ""

#: ../../using/configure.rst:332

msgid "Path to ``pkg-config`` utility."

msgstr ""

#: ../../using/configure.rst:337

msgid "``pkg-config`` options."

msgstr ""

#: ../../using/configure.rst:341

msgid "C compiler options"

msgstr ""

#: ../../using/configure.rst:345 ../../using/configure.rst:1326

msgid "C compiler command."

msgstr ""

#: ../../using/configure.rst:349 ../../using/configure.rst:1338

msgid "C compiler flags."

msgstr ""

#: ../../using/configure.rst:353

msgid "C preprocessor command."

msgstr ""

#: ../../using/configure.rst:357

msgid "C preprocessor flags, e.g. :samp:`-I{include_dir}`."

msgstr ""

#: ../../using/configure.rst:361 ../../using/configure.rst:830

msgid "Linker options"

msgstr ""

#: ../../using/configure.rst:365

msgid "Linker flags, e.g. :samp:`-L{library_directory}`."

msgstr ""

#: ../../using/configure.rst:369

msgid "Libraries to pass to the linker, e.g. :samp:`-l{library}`."

msgstr ""

#: ../../using/configure.rst:373

msgid "Name for machine-dependent library files."

msgstr ""

#: ../../using/configure.rst:377

msgid "Options for third-party dependencies"

msgstr ""

#: ../../using/configure.rst:384

msgid ""

"C compiler and linker flags to link Python to ``libbz2``, used by :mod:`bz2` "

"module, overriding ``pkg-config``."

msgstr ""

#: ../../using/configure.rst:390

msgid ""

"C compiler and linker flags for ``libncurses`` or ``libncursesw``, used by :"

"mod:`curses` module, overriding ``pkg-config``."

msgstr ""

#: ../../using/configure.rst:396

msgid "C compiler and linker flags for ``gdbm``."

msgstr ""

#: ../../using/configure.rst:401

msgid ""

"C compiler and linker flags for ``libb2`` (:ref:`BLAKE2 <hashlib-blake2>`), "

"used by :mod:`hashlib` module, overriding ``pkg-config``."

msgstr ""

#: ../../using/configure.rst:407

msgid ""

"C compiler and linker flags for ``libedit``, used by :mod:`readline` module, "

"overriding ``pkg-config``."

msgstr ""

#: ../../using/configure.rst:413

msgid ""

"C compiler and linker flags for ``libffi``, used by :mod:`ctypes` module, "

"overriding ``pkg-config``."

msgstr ""

#: ../../using/configure.rst:419

msgid ""

"C compiler and linker flags for ``libmpdec``, used by :mod:`decimal` module, "

"overriding ``pkg-config``."

msgstr ""

#: ../../using/configure.rst:424

msgid ""

"These environment variables have no effect unless :option:`--with-system-"

"libmpdec` is specified."

msgstr ""

#: ../../using/configure.rst:430

msgid ""

"C compiler and linker flags for ``liblzma``, used by :mod:`lzma` module, "

"overriding ``pkg-config``."

msgstr ""

#: ../../using/configure.rst:436

msgid ""

"C compiler and linker flags for ``libreadline``, used by :mod:`readline` "

"module, overriding ``pkg-config``."

msgstr ""

#: ../../using/configure.rst:442

msgid ""

"C compiler and linker flags for ``libsqlite3``, used by :mod:`sqlite3` "

"module, overriding ``pkg-config``."

msgstr ""

#: ../../using/configure.rst:448

msgid ""

"C compiler and linker flags for ``libuuid``, used by :mod:`uuid` module, "

"overriding ``pkg-config``."

msgstr ""

#: ../../using/configure.rst:454

msgid ""

"C compiler and linker flags for ``libzstd``, used by :mod:`compression.zstd` "

"module, overriding ``pkg-config``."

msgstr ""

#: ../../using/configure.rst:462

msgid "C compiler and linker flags for PANEL, overriding ``pkg-config``."

msgstr ""

#: ../../using/configure.rst:464

msgid ""

"C compiler and linker flags for ``libpanel`` or ``libpanelw``, used by :mod:"

"`curses.panel` module, overriding ``pkg-config``."

msgstr ""

#: ../../using/configure.rst:470

msgid "C compiler and linker flags for TCLTK, overriding ``pkg-config``."

msgstr ""

#: ../../using/configure.rst:475

msgid ""

"C compiler and linker flags for ``libzlib``, used by :mod:`gzip` module, "

"overriding ``pkg-config``."

msgstr ""

#: ../../using/configure.rst:480

msgid "WebAssembly Options"

msgstr ""

#: ../../using/configure.rst:484

msgid "Turn on dynamic linking support for WASM."

msgstr ""

#: ../../using/configure.rst:486

msgid ""

"Dynamic linking enables ``dlopen``. File size of the executable increases "

"due to limited dead code elimination and additional features."

msgstr ""

#: ../../using/configure.rst:493

msgid "Turn on pthreads support for WASM."

msgstr ""

#: ../../using/configure.rst:499

msgid "Install Options"

msgstr ""

#: ../../using/configure.rst:503

msgid ""

"Install architecture-independent files in PREFIX. On Unix, it defaults to :"

"file:`/usr/local`."

msgstr ""

#: ../../using/configure.rst:506

msgid "This value can be retrieved at runtime using :data:`sys.prefix`."

msgstr ""

#: ../../using/configure.rst:508

msgid ""

"As an example, one can use ``--prefix=\"$HOME/.local/\"`` to install a "

"Python in its home directory."

msgstr ""

#: ../../using/configure.rst:513

msgid ""

"Install architecture-dependent files in EPREFIX, defaults to :option:`--"

"prefix`."

msgstr ""

#: ../../using/configure.rst:515

msgid "This value can be retrieved at runtime using :data:`sys.exec_prefix`."

msgstr ""

#: ../../using/configure.rst:519

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:526

msgid "Select the :mod:`ensurepip` command run on Python installation:"

msgstr ""

#: ../../using/configure.rst:528

msgid ""

"``upgrade`` (default): run ``python -m ensurepip --altinstall --upgrade`` "

"command."

msgstr ""

#: ../../using/configure.rst:530

msgid "``install``: run ``python -m ensurepip --altinstall`` command;"

msgstr ""

#: ../../using/configure.rst:531

msgid "``no``: don't run ensurepip;"

msgstr ""

#: ../../using/configure.rst:537

msgid "Performance options"

msgstr ""

#: ../../using/configure.rst:539

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:545

msgid ""

"Enable Profile Guided Optimization (PGO) using :envvar:`PROFILE_TASK` "

"(disabled by default)."

msgstr ""

#: ../../using/configure.rst:548

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:551

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:557

msgid ""

"During the build, you may encounter compiler warnings about profile data not "

"being available for some source files. These warnings are harmless, as only "

"a subset of the code is exercised during profile data acquisition. To "

"disable these warnings on Clang, manually suppress them by adding ``-Wno-"

"profile-instr-unprofiled`` to :envvar:`CFLAGS`."

msgstr ""

#: ../../using/configure.rst:566

msgid "Use ``-fno-semantic-interposition`` on GCC."

msgstr ""

#: ../../using/configure.rst:571

msgid ""

"Environment variable used in the Makefile: Python command line arguments for "

"the PGO generation task."

msgstr ""

#: ../../using/configure.rst:574

msgid "Default: ``-m test --pgo --timeout=$(TESTTIMEOUT)``."

msgstr ""

#: ../../using/configure.rst:578

msgid "Task failure is no longer ignored silently."

msgstr ""

#: ../../using/configure.rst:583

msgid "Enable Link Time Optimization (LTO) in any build (disabled by default)."

msgstr ""

#: ../../using/configure.rst:585

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:590

msgid "To use ThinLTO feature, use ``--with-lto=thin`` on Clang."

msgstr ""

#: ../../using/configure.rst:593

msgid ""

"Use ThinLTO as the default optimization policy on Clang if the compiler "

"accepts the flag."

msgstr ""

#: ../../using/configure.rst:598

msgid ""

"Enable usage of the `BOLT post-link binary optimizer <https://github.com/"

"llvm/llvm-project/tree/main/bolt>`_ (disabled by default)."

msgstr ""

#: ../../using/configure.rst:602

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:606

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:614

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:623

msgid ""

"Arguments to ``llvm-bolt`` when creating a `BOLT optimized binary <https://"

"github.com/facebookarchive/BOLT>`_."

msgstr ""

#: ../../using/configure.rst:630

msgid "Arguments to ``llvm-bolt`` when instrumenting binaries."

msgstr ""

#: ../../using/configure.rst:636

msgid ""

"Enable computed gotos in evaluation loop (enabled by default on supported "

"compilers)."

msgstr ""

#: ../../using/configure.rst:641

msgid ""

"Enable interpreters using tail calls in CPython. If enabled, enabling PGO (:"

"option:`--enable-optimizations`) is highly recommended. This option "

"specifically requires a C compiler with proper tail call support, and the "

"`preserve_none <https://clang.llvm.org/docs/AttributeReference.html#preserve-"

"none>`_ calling convention. For example, Clang 19 and newer supports this "

"feature."

msgstr ""

#: ../../using/configure.rst:651

msgid ""

"Disable the fast :ref:`mimalloc <mimalloc>` allocator (enabled by default)."

msgstr ""

#: ../../using/configure.rst:654 ../../using/configure.rst:661

msgid "See also :envvar:`PYTHONMALLOC` environment variable."

msgstr ""

#: ../../using/configure.rst:658

msgid ""

"Disable the specialized Python memory allocator :ref:`pymalloc <pymalloc>` "

"(enabled by default)."

msgstr ""

#: ../../using/configure.rst:665

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:668

msgid "Don't define the ``WITH_DOC_STRINGS`` macro."

msgstr ""

#: ../../using/configure.rst:670

msgid "See the ``PyDoc_STRVAR()`` macro."

msgstr ""

#: ../../using/configure.rst:674

msgid "Enable C-level code profiling with ``gprof`` (disabled by default)."

msgstr ""

#: ../../using/configure.rst:678

msgid ""

"Add ``-fstrict-overflow`` to the C compiler flags (by default we add ``-fno-"

"strict-overflow`` instead)."

msgstr ""

#: ../../using/configure.rst:683

msgid ""

"Deactivate remote debugging support described in :pep:`768` (enabled by "

"default). When this flag is provided the code that allows the interpreter to "

"schedule the execution of a Python file in a separate process as described "

"in :pep:`768` is not compiled. This includes both the functionality to "

"schedule code to be executed and the functionality to receive code to be "

"executed."

msgstr ""

#: ../../using/configure.rst:691

msgid ""

"This macro is defined by default, unless Python is configured with :option:"

"`--without-remote-debug`."

msgstr ""

#: ../../using/configure.rst:694

msgid ""

"Note that even if the macro is defined, remote debugging may not be "

"available (for example, on an incompatible platform)."

msgstr ""

#: ../../using/configure.rst:703