Stowage/cpython
2
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-12-31 04:23:37 +00:00
Code Issues Projects Releases Packages Wiki Activity

Docs: Avoid the deprecated `.. cmdoption::` directive (#110292)

Browse source
This commit is contained in:
Adam Turner 2023-10-03 18:38:12 +01:00 • committed by GitHub
parent d67edcf0b3
commit 77e9aae383
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
18 changed files with 243 additions and 243 deletions
Download patch file Download diff file Expand all files Collapse all files

60
Doc/using/cmdline.rst
View file

@ -59,7 +59,7 @@ all consecutive arguments will end up in :data:`sys.argv` -- note that the first
element, subscript zero (``sys.argv[0]``), is a string reflecting the program's
source.
.. cmdoption:: -c <command>
.. option:: -c <command>
Execute the Python code in *command*. *command* can be one or more
statements separated by newlines, with significant leading whitespace as in
@ -72,7 +72,7 @@ source.
.. audit-event:: cpython.run_command command cmdoption-c
.. cmdoption:: -m <module-name>
.. option:: -m <module-name>
Search :data:`sys.path` for the named module and execute its contents as
the :mod:`__main__` module.
@ -188,35 +188,35 @@ automatically enabled, if available on your platform (see
Generic options
~~~~~~~~~~~~~~~
.. cmdoption:: -?
-h
--help
.. option:: -?
-h
--help
Print a short description of all command line options and corresponding
environment variables and exit.
.. cmdoption:: --help-env
.. option:: --help-env
Print a short description of Python-specific environment variables
and exit.
.. versionadded:: 3.11
.. cmdoption:: --help-xoptions
.. option:: --help-xoptions
Print a description of implementation-specific :option:`-X` options
and exit.
.. versionadded:: 3.11
.. cmdoption:: --help-all
.. option:: --help-all
Print complete usage information and exit.
.. versionadded:: 3.11
.. cmdoption:: -V
--version
.. option:: -V
--version
Print the Python version number and exit. Example output could be:
@ -240,7 +240,7 @@ Generic options
Miscellaneous options
~~~~~~~~~~~~~~~~~~~~~
.. cmdoption:: -b
.. option:: -b
Issue a warning when comparing :class:`bytes` or :class:`bytearray` with
:class:`str` or :class:`bytes` with :class:`int`. Issue an error when the
@ -249,13 +249,13 @@ Miscellaneous options
.. versionchanged:: 3.5
Affects comparisons of :class:`bytes` with :class:`int`.
.. cmdoption:: -B
.. option:: -B
If given, Python won't try to write ``.pyc`` files on the
import of source modules. See also :envvar:`PYTHONDONTWRITEBYTECODE`.
.. cmdoption:: --check-hash-based-pycs default|always|never
.. option:: --check-hash-based-pycs default|always|never
Control the validation behavior of hash-based ``.pyc`` files. See
:ref:`pyc-invalidation`. When set to ``default``, checked and unchecked
@ -269,7 +269,7 @@ Miscellaneous options
option.
.. cmdoption:: -d
.. option:: -d
Turn on parser debugging output (for expert only).
See also the :envvar:`PYTHONDEBUG` environment variable.
@ -278,7 +278,7 @@ Miscellaneous options
it's ignored.
.. cmdoption:: -E
.. option:: -E
Ignore all :envvar:`PYTHON*` environment variables, e.g.
:envvar:`PYTHONPATH` and :envvar:`PYTHONHOME`, that might be set.
@ -286,7 +286,7 @@ Miscellaneous options
See also the :option:`-P` and :option:`-I` (isolated) options.
.. cmdoption:: -i
.. option:: -i
When a script is passed as first argument or the :option:`-c` option is used,
enter interactive mode after executing the script or the command, even when
@ -297,7 +297,7 @@ Miscellaneous options
raises an exception. See also :envvar:`PYTHONINSPECT`.
.. cmdoption:: -I
.. option:: -I
Run Python in isolated mode. This also implies :option:`-E`, :option:`-P`
and :option:`-s` options.
@ -310,7 +310,7 @@ Miscellaneous options
.. versionadded:: 3.4
.. cmdoption:: -O
.. option:: -O
Remove assert statements and any code conditional on the value of
:const:`__debug__`. Augment the filename for compiled
@ -321,7 +321,7 @@ Miscellaneous options
Modify ``.pyc`` filenames according to :pep:`488`.
.. cmdoption:: -OO
.. option:: -OO
Do :option:`-O` and also discard docstrings. Augment the filename
for compiled (:term:`bytecode`) files by adding ``.opt-2`` before the
@ -331,7 +331,7 @@ Miscellaneous options
Modify ``.pyc`` filenames according to :pep:`488`.
.. cmdoption:: -P
.. option:: -P
Don't prepend a potentially unsafe path to :data:`sys.path`:
@ -348,14 +348,14 @@ Miscellaneous options
.. versionadded:: 3.11
.. cmdoption:: -q
.. option:: -q
Don't display the copyright and version messages even in interactive mode.
.. versionadded:: 3.2
.. cmdoption:: -R
.. option:: -R
Turn on hash randomization. This option only has an effect if the
:envvar:`PYTHONHASHSEED` environment variable is set to ``0``, since hash
@ -381,7 +381,7 @@ Miscellaneous options
.. versionadded:: 3.2.3
.. cmdoption:: -s
.. option:: -s
Don't add the :data:`user site-packages directory <site.USER_SITE>` to
:data:`sys.path`.
@ -391,7 +391,7 @@ Miscellaneous options
:pep:`370` -- Per user site-packages directory
.. cmdoption:: -S
.. option:: -S
Disable the import of the module :mod:`site` and the site-dependent
manipulations of :data:`sys.path` that it entails. Also disable these
@ -399,7 +399,7 @@ Miscellaneous options
:func:`site.main` if you want them to be triggered).
.. cmdoption:: -u
.. option:: -u
Force the stdout and stderr streams to be unbuffered. This option has no
effect on the stdin stream.
@ -410,7 +410,7 @@ Miscellaneous options
The text layer of the stdout and stderr streams now is unbuffered.
.. cmdoption:: -v
.. option:: -v
Print a message each time a module is initialized, showing the place
(filename or built-in module) from which it is loaded. When given twice
@ -425,7 +425,7 @@ Miscellaneous options
.. _using-on-warnings:
.. cmdoption:: -W arg
.. option:: -W arg
Warning control. Python's warning machinery by default prints warning
messages to :data:`sys.stderr`.
@ -484,13 +484,13 @@ Miscellaneous options
details.
.. cmdoption:: -x
.. option:: -x
Skip the first line of the source, allowing use of non-Unix forms of
``#!cmd``. This is intended for a DOS specific hack only.
.. cmdoption:: -X
.. option:: -X
Reserved for various implementation-specific options. CPython currently
defines the following possible values:
@ -597,7 +597,7 @@ Miscellaneous options
Options you shouldn't use
~~~~~~~~~~~~~~~~~~~~~~~~~
.. cmdoption:: -J
.. option:: -J
Reserved for use by Jython_.

200
Doc/using/configure.rst
View file

@ -97,7 +97,7 @@ See also the :file:`Misc/SpecialBuilds.txt` in the Python source distribution.
General Options
---------------
.. cmdoption:: --enable-loadable-sqlite-extensions
.. option:: --enable-loadable-sqlite-extensions
Support loadable extensions in the :mod:`!_sqlite` extension module (default
is no) of the :mod:`sqlite3` module.
@ -107,12 +107,12 @@ General Options
.. versionadded:: 3.6
.. cmdoption:: --disable-ipv6
.. option:: --disable-ipv6
Disable IPv6 support (enabled by default if supported), see the
:mod:`socket` module.
.. cmdoption:: --enable-big-digits=[15|30]
.. option:: --enable-big-digits=[15|30]
Define the size in bits of Python :class:`int` digits: 15 or 30 bits.
@ -122,7 +122,7 @@ General Options
See :data:`sys.int_info.bits_per_digit <sys.int_info>`.
.. cmdoption:: --with-suffix=SUFFIX
.. option:: --with-suffix=SUFFIX
Set the Python executable suffix to *SUFFIX*.
@ -135,7 +135,7 @@ General Options
The default suffix on WASM platform is one of ``.js``, ``.html``
or ``.wasm``.
.. cmdoption:: --with-tzpath=<list of absolute paths separated by pathsep>
.. option:: --with-tzpath=<list of absolute paths separated by pathsep>
Select the default time zone search path for :const:`zoneinfo.TZPATH`.
See the :ref:`Compile-time configuration
@ -147,7 +147,7 @@ General Options
.. versionadded:: 3.9
.. cmdoption:: --without-decimal-contextvar
.. option:: --without-decimal-contextvar
Build the ``_decimal`` extension module using a thread-local context rather
than a coroutine-local context (default), see the :mod:`decimal` module.
@ -156,7 +156,7 @@ General Options
.. versionadded:: 3.9
.. cmdoption:: --with-dbmliborder=<list of backend names>
.. option:: --with-dbmliborder=<list of backend names>
Override order to check db backends for the :mod:`dbm` module
@ -166,7 +166,7 @@ General Options
* ``gdbm``;
* ``bdb``.
.. cmdoption:: --without-c-locale-coercion
.. option:: --without-c-locale-coercion
Disable C locale coercion to a UTF-8 based locale (enabled by default).
@ -174,13 +174,13 @@ General Options
See :envvar:`PYTHONCOERCECLOCALE` and the :pep:`538`.
.. cmdoption:: --without-freelists
.. option:: --without-freelists
Disable all freelists except the empty tuple singleton.
.. versionadded:: 3.11
.. cmdoption:: --with-platlibdir=DIRNAME
.. option:: --with-platlibdir=DIRNAME
Python library directory name (default is ``lib``).
@ -190,7 +190,7 @@ General Options
.. versionadded:: 3.9
.. cmdoption:: --with-wheel-pkg-dir=PATH
.. option:: --with-wheel-pkg-dir=PATH
Directory of wheel packages used by the :mod:`ensurepip` module
(none by default).
@ -202,7 +202,7 @@ General Options
.. versionadded:: 3.10
.. cmdoption:: --with-pkg-config=[check|yes|no]
.. option:: --with-pkg-config=[check|yes|no]
Whether configure should use :program:`pkg-config` to detect build
dependencies.
@ -213,7 +213,7 @@ General Options
.. versionadded:: 3.11
.. cmdoption:: --enable-pystats
.. option:: --enable-pystats
Turn on internal Python performance statistics gathering.
@ -280,7 +280,7 @@ General Options
.. versionadded:: 3.11
.. cmdoption:: --disable-gil
.. option:: --disable-gil
Enables **experimental** support for running Python without the
:term:`global interpreter lock` (GIL).
@ -289,12 +289,12 @@ General Options
.. versionadded:: 3.13
.. cmdoption:: PKG_CONFIG
.. option:: PKG_CONFIG
Path to ``pkg-config`` utility.
.. cmdoption:: PKG_CONFIG_LIBDIR
.. cmdoption:: PKG_CONFIG_PATH
.. option:: PKG_CONFIG_LIBDIR
.. option:: PKG_CONFIG_PATH
``pkg-config`` options.
@ -302,19 +302,19 @@ General Options
C compiler options
------------------
.. cmdoption:: CC
.. option:: CC
C compiler command.
.. cmdoption:: CFLAGS
.. option:: CFLAGS
C compiler flags.
.. cmdoption:: CPP
.. option:: CPP
C preprocessor command.
.. cmdoption:: CPPFLAGS
.. option:: CPPFLAGS
C preprocessor flags, e.g. :samp:`-I{include_dir}`.
@ -322,15 +322,15 @@ C compiler options
Linker options
--------------
.. cmdoption:: LDFLAGS
.. option:: LDFLAGS
Linker flags, e.g. :samp:`-L{library_directory}`.
.. cmdoption:: LIBS
.. option:: LIBS
Libraries to pass to the linker, e.g. :samp:`-l{library}`.
.. cmdoption:: MACHDEP
.. option:: MACHDEP
Name for machine-dependent library files.
@ -340,80 +340,80 @@ Options for third-party dependencies
.. versionadded:: 3.11
.. cmdoption:: BZIP2_CFLAGS
.. cmdoption:: BZIP2_LIBS
.. option:: BZIP2_CFLAGS
.. option:: BZIP2_LIBS
C compiler and linker flags to link Python to ``libbz2``, used by :mod:`bz2`
module, overriding ``pkg-config``.
.. cmdoption:: CURSES_CFLAGS
.. cmdoption:: CURSES_LIBS
.. option:: CURSES_CFLAGS
.. option:: CURSES_LIBS
C compiler and linker flags for ``libncurses`` or ``libncursesw``, used by
:mod:`curses` module, overriding ``pkg-config``.
.. cmdoption:: GDBM_CFLAGS
.. cmdoption:: GDBM_LIBS
.. option:: GDBM_CFLAGS
.. option:: GDBM_LIBS
C compiler and linker flags for ``gdbm``.
.. cmdoption:: LIBB2_CFLAGS
.. cmdoption:: LIBB2_LIBS
.. option:: LIBB2_CFLAGS
.. option:: LIBB2_LIBS
C compiler and linker flags for ``libb2`` (:ref:`BLAKE2 <hashlib-blake2>`),
used by :mod:`hashlib` module, overriding ``pkg-config``.
.. cmdoption:: LIBEDIT_CFLAGS
.. cmdoption:: LIBEDIT_LIBS
.. option:: LIBEDIT_CFLAGS
.. option:: LIBEDIT_LIBS
C compiler and linker flags for ``libedit``, used by :mod:`readline` module,
overriding ``pkg-config``.
.. cmdoption:: LIBFFI_CFLAGS
.. cmdoption:: LIBFFI_LIBS
.. option:: LIBFFI_CFLAGS
.. option:: LIBFFI_LIBS
C compiler and linker flags for ``libffi``, used by :mod:`ctypes` module,
overriding ``pkg-config``.
.. cmdoption:: LIBLZMA_CFLAGS
.. cmdoption:: LIBLZMA_LIBS
.. option:: LIBLZMA_CFLAGS
.. option:: LIBLZMA_LIBS
C compiler and linker flags for ``liblzma``, used by :mod:`lzma` module,
overriding ``pkg-config``.
.. cmdoption:: LIBREADLINE_CFLAGS
.. cmdoption:: LIBREADLINE_LIBS
.. option:: LIBREADLINE_CFLAGS
.. option:: LIBREADLINE_LIBS
C compiler and linker flags for ``libreadline``, used by :mod:`readline`
module, overriding ``pkg-config``.
.. cmdoption:: LIBSQLITE3_CFLAGS
.. cmdoption:: LIBSQLITE3_LIBS
.. option:: LIBSQLITE3_CFLAGS
.. option:: LIBSQLITE3_LIBS
C compiler and linker flags for ``libsqlite3``, used by :mod:`sqlite3`
module, overriding ``pkg-config``.
.. cmdoption:: LIBUUID_CFLAGS
.. cmdoption:: LIBUUID_LIBS
.. option:: LIBUUID_CFLAGS
.. option:: LIBUUID_LIBS
C compiler and linker flags for ``libuuid``, used by :mod:`uuid` module,
overriding ``pkg-config``.
.. cmdoption:: PANEL_CFLAGS
.. cmdoption:: PANEL_LIBS
.. option:: PANEL_CFLAGS
.. option:: PANEL_LIBS
C compiler and Linker flags for PANEL, overriding ``pkg-config``.
C compiler and linker flags for ``libpanel`` or ``libpanelw``, used by
:mod:`curses.panel` module, overriding ``pkg-config``.
.. cmdoption:: TCLTK_CFLAGS
.. cmdoption:: TCLTK_LIBS
.. option:: TCLTK_CFLAGS
.. option:: TCLTK_LIBS
C compiler and linker flags for TCLTK, overriding ``pkg-config``.
.. cmdoption:: ZLIB_CFLAGS
.. cmdoption:: ZLIB_LIBS
.. option:: ZLIB_CFLAGS
.. option:: ZLIB_LIBS
C compiler and linker flags for ``libzlib``, used by :mod:`gzip` module,
overriding ``pkg-config``.
@ -422,7 +422,7 @@ Options for third-party dependencies
WebAssembly Options
-------------------
.. cmdoption:: --with-emscripten-target=[browser|node]
.. option:: --with-emscripten-target=[browser|node]
Set build flavor for ``wasm32-emscripten``.
@ -431,7 +431,7 @@ WebAssembly Options
.. versionadded:: 3.11
.. cmdoption:: --enable-wasm-dynamic-linking
.. option:: --enable-wasm-dynamic-linking
Turn on dynamic linking support for WASM.
@ -440,7 +440,7 @@ WebAssembly Options
.. versionadded:: 3.11
.. cmdoption:: --enable-wasm-pthreads
.. option:: --enable-wasm-pthreads
Turn on pthreads support for WASM.
@ -450,7 +450,7 @@ WebAssembly Options
Install Options
---------------
.. cmdoption:: --prefix=PREFIX
.. option:: --prefix=PREFIX
Install architecture-independent files in PREFIX. On Unix, it
defaults to :file:`/usr/local`.
@ -460,20 +460,20 @@ Install Options
As an example, one can use ``--prefix="$HOME/.local/"`` to install
a Python in its home directory.
.. cmdoption:: --exec-prefix=EPREFIX
.. option:: --exec-prefix=EPREFIX
Install architecture-dependent files in EPREFIX, defaults to :option:`--prefix`.
This value can be retrieved at runtime using :data:`sys.exec_prefix`.
.. cmdoption:: --disable-test-modules
.. option:: --disable-test-modules
Don't build nor install test modules, like the :mod:`test` package or the
:mod:`!_testcapi` extension module (built and installed by default).
.. versionadded:: 3.10
.. cmdoption:: --with-ensurepip=[upgrade|install|no]
.. option:: --with-ensurepip=[upgrade|install|no]
Select the :mod:`ensurepip` command run on Python installation:
@ -492,7 +492,7 @@ 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.
.. cmdoption:: --enable-optimizations
.. option:: --enable-optimizations
Enable Profile Guided Optimization (PGO) using :envvar:`PROFILE_TASK`
(disabled by default).
@ -521,7 +521,7 @@ also be used to improve performance.
.. versionchanged:: 3.13
Task failure is no longer ignored silently.
.. cmdoption:: --with-lto=[full|thin|no|yes]
.. option:: --with-lto=[full|thin|no|yes]
Enable Link Time Optimization (LTO) in any build (disabled by default).
@ -536,7 +536,7 @@ also be used to improve performance.
.. versionchanged:: 3.12
Use ThinLTO as the default optimization policy on Clang if the compiler accepts the flag.
.. cmdoption:: --enable-bolt
.. option:: --enable-bolt
Enable usage of the `BOLT post-link binary optimizer
<https://github.com/llvm/llvm-project/tree/main/bolt>`_ (disabled by
@ -561,32 +561,32 @@ also be used to improve performance.
.. versionadded:: 3.12
.. cmdoption:: BOLT_APPLY_FLAGS
.. option:: BOLT_APPLY_FLAGS
Arguments to ``llvm-bolt`` when creating a `BOLT optimized binary
<https://github.com/facebookarchive/BOLT>`_.
.. versionadded:: 3.12
.. cmdoption:: BOLT_INSTRUMENT_FLAGS
.. option:: BOLT_INSTRUMENT_FLAGS
Arguments to ``llvm-bolt`` when instrumenting binaries.
.. versionadded:: 3.12
.. cmdoption:: --with-computed-gotos
.. option:: --with-computed-gotos
Enable computed gotos in evaluation loop (enabled by default on supported
compilers).
.. cmdoption:: --without-pymalloc
.. option:: --without-pymalloc
Disable the specialized Python memory allocator :ref:`pymalloc <pymalloc>`
(enabled by default).
See also :envvar:`PYTHONMALLOC` environment variable.
.. cmdoption:: --without-doc-strings
.. option:: --without-doc-strings
Disable static documentation strings to reduce the memory footprint (enabled
by default). Documentation strings defined in Python are not affected.
@ -595,11 +595,11 @@ also be used to improve performance.
See the ``PyDoc_STRVAR()`` macro.
.. cmdoption:: --enable-profiling
.. option:: --enable-profiling
Enable C-level code profiling with ``gprof`` (disabled by default).
.. cmdoption:: --with-strict-overflow
.. option:: --with-strict-overflow
Add ``-fstrict-overflow`` to the C compiler flags (by default we add
``-fno-strict-overflow`` instead).
@ -655,12 +655,12 @@ See also the :ref:`Python Development Mode <devmode>` and the
Debug options
-------------
.. cmdoption:: --with-pydebug
.. option:: --with-pydebug
:ref:`Build Python in debug mode <debug-build>`: define the ``Py_DEBUG``
macro (disabled by default).
.. cmdoption:: --with-trace-refs
.. option:: --with-trace-refs
Enable tracing references for debugging purpose (disabled by default).
@ -681,7 +681,7 @@ Debug options
.. versionadded:: 3.8
.. cmdoption:: --with-assertions
.. option:: --with-assertions
Build with C assertions enabled (default is no): ``assert(...);`` and
``_PyObject_ASSERT(...);``.
@ -694,11 +694,11 @@ Debug options
.. versionadded:: 3.6
.. cmdoption:: --with-valgrind
.. option:: --with-valgrind
Enable Valgrind support (default is no).
.. cmdoption:: --with-dtrace
.. option:: --with-dtrace
Enable DTrace support (default is no).
@ -707,19 +707,19 @@ Debug options
.. versionadded:: 3.6
.. cmdoption:: --with-address-sanitizer
.. option:: --with-address-sanitizer
Enable AddressSanitizer memory error detector, ``asan`` (default is no).
.. versionadded:: 3.6
.. cmdoption:: --with-memory-sanitizer
.. option:: --with-memory-sanitizer
Enable MemorySanitizer allocation error detector, ``msan`` (default is no).
.. versionadded:: 3.6
.. cmdoption:: --with-undefined-behavior-sanitizer
.. option:: --with-undefined-behavior-sanitizer
Enable UndefinedBehaviorSanitizer undefined behaviour detector, ``ubsan``
(default is no).
@ -730,11 +730,11 @@ Debug options
Linker options
--------------
.. cmdoption:: --enable-shared
.. option:: --enable-shared
Enable building a shared Python library: ``libpython`` (default is no).
.. cmdoption:: --without-static-libpython
.. option:: --without-static-libpython
Do not build ``libpythonMAJOR.MINOR.a`` and do not install ``python.o``
(built and enabled by default).
@ -745,23 +745,23 @@ Linker options
Libraries options
-----------------
.. cmdoption:: --with-libs='lib1 ...'
.. option:: --with-libs='lib1 ...'
Link against additional libraries (default is no).
.. cmdoption:: --with-system-expat
.. option:: --with-system-expat
Build the :mod:`!pyexpat` module using an installed ``expat`` library
(default is no).
.. cmdoption:: --with-system-libmpdec
.. option:: --with-system-libmpdec
Build the ``_decimal`` extension module using an installed ``mpdec``
library, see the :mod:`decimal` module (default is no).
.. versionadded:: 3.3
.. cmdoption:: --with-readline=readline|editline
.. option:: --with-readline=readline|editline
Designate a backend library for the :mod:`readline` module.
@ -770,7 +770,7 @@ Libraries options
.. versionadded:: 3.10
.. cmdoption:: --without-readline
.. option:: --without-readline
Don't build the :mod:`readline` module (built by default).
@ -778,21 +778,21 @@ Libraries options
.. versionadded:: 3.10
.. cmdoption:: --with-libm=STRING
.. option:: --with-libm=STRING
Override ``libm`` math library to *STRING* (default is system-dependent).
.. cmdoption:: --with-libc=STRING
.. option:: --with-libc=STRING
Override ``libc`` C library to *STRING* (default is system-dependent).
.. cmdoption:: --with-openssl=DIR
.. option:: --with-openssl=DIR
Root of the OpenSSL directory.
.. versionadded:: 3.7
.. cmdoption:: --with-openssl-rpath=[no|auto|DIR]
.. option:: --with-openssl-rpath=[no|auto|DIR]
Set runtime library directory (rpath) for OpenSSL libraries:
@ -807,7 +807,7 @@ Libraries options
Security Options
----------------
.. cmdoption:: --with-hash-algorithm=[fnv|siphash13|siphash24]
.. option:: --with-hash-algorithm=[fnv|siphash13|siphash24]
Select hash algorithm for use in ``Python/pyhash.c``:
@ -820,7 +820,7 @@ Security Options
.. versionadded:: 3.11
``siphash13`` is added and it is the new default.
.. cmdoption:: --with-builtin-hashlib-hashes=md5,sha1,sha256,sha512,sha3,blake2
.. option:: --with-builtin-hashlib-hashes=md5,sha1,sha256,sha512,sha3,blake2
Built-in hash modules:
@ -833,7 +833,7 @@ Security Options
.. versionadded:: 3.9
.. cmdoption:: --with-ssl-default-suites=[python|openssl|STRING]
.. option:: --with-ssl-default-suites=[python|openssl|STRING]
Override the OpenSSL default cipher suites string:
@ -855,19 +855,19 @@ macOS Options
See ``Mac/README.rst``.
.. cmdoption:: --enable-universalsdk
.. cmdoption:: --enable-universalsdk=SDKDIR
.. option:: --enable-universalsdk
.. option:: --enable-universalsdk=SDKDIR
Create a universal binary build. *SDKDIR* specifies which macOS SDK should
be used to perform the build (default is no).
.. cmdoption:: --enable-framework
.. cmdoption:: --enable-framework=INSTALLDIR
.. option:: --enable-framework
.. option:: --enable-framework=INSTALLDIR
Create a Python.framework rather than a traditional Unix install. Optional
*INSTALLDIR* specifies the installation path (default is no).
.. cmdoption:: --with-universal-archs=ARCH
.. option:: --with-universal-archs=ARCH
Specify the kind of universal binary that should be created. This option is
only valid when :option:`--enable-universalsdk` is set.
@ -883,7 +883,7 @@ See ``Mac/README.rst``.
* ``intel-64``;
* ``all``.
.. cmdoption:: --with-framework-name=FRAMEWORK
.. option:: --with-framework-name=FRAMEWORK
Specify the name for the python framework on macOS only valid when
:option:`--enable-framework` is set (default: ``Python``).
@ -897,21 +897,21 @@ 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.
.. cmdoption:: --build=BUILD
.. option:: --build=BUILD
configure for building on BUILD, usually guessed by :program:`config.guess`.
.. cmdoption:: --host=HOST
.. option:: --host=HOST
cross-compile to build programs to run on HOST (target platform)
.. cmdoption:: --with-build-python=path/to/python
.. option:: --with-build-python=path/to/python
path to build ``python`` binary for cross compiling
.. versionadded:: 3.11
.. cmdoption:: CONFIG_SITE=file
.. option:: CONFIG_SITE=file
An environment variable that points to a file with configure overrides.
@ -922,7 +922,7 @@ the version of the cross compiled host Python.
ac_cv_file__dev_ptmx=yes
ac_cv_file__dev_ptc=no
.. cmdoption:: HOSTRUNNER
.. option:: HOSTRUNNER
Program to run CPython for the host platform for cross-compilation.