mirror of
https://github.com/python/cpython.git
synced 2025-07-24 03:35:53 +00:00
[doc] Fix typos found using codespell (GH-28744)
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
This commit is contained in:
parent
4c8d543823
commit
241bda785a
16 changed files with 22 additions and 22 deletions
|
@ -185,7 +185,7 @@ Object Calling API
|
||||||
Various functions are available for calling a Python object.
|
Various functions are available for calling a Python object.
|
||||||
Each converts its arguments to a convention supported by the called object –
|
Each converts its arguments to a convention supported by the called object –
|
||||||
either *tp_call* or vectorcall.
|
either *tp_call* or vectorcall.
|
||||||
In order to do as litle conversion as possible, pick one that best fits
|
In order to do as little conversion as possible, pick one that best fits
|
||||||
the format of data you have available.
|
the format of data you have available.
|
||||||
|
|
||||||
The following table summarizes the available functions;
|
The following table summarizes the available functions;
|
||||||
|
|
|
@ -22,7 +22,7 @@ There are two kinds of configuration:
|
||||||
* The :ref:`Isolated Configuration <init-isolated-conf>` can be used to embed
|
* The :ref:`Isolated Configuration <init-isolated-conf>` can be used to embed
|
||||||
Python into an application. It isolates Python from the system. For example,
|
Python into an application. It isolates Python from the system. For example,
|
||||||
environments variables are ignored, the LC_CTYPE locale is left unchanged and
|
environments variables are ignored, the LC_CTYPE locale is left unchanged and
|
||||||
no signal handler is registred.
|
no signal handler is registered.
|
||||||
|
|
||||||
The :c:func:`Py_RunMain` function can be used to write a customized Python
|
The :c:func:`Py_RunMain` function can be used to write a customized Python
|
||||||
program.
|
program.
|
||||||
|
@ -706,7 +706,7 @@ PyConfig
|
||||||
* Otherwise, use the :term:`locale encoding`:
|
* Otherwise, use the :term:`locale encoding`:
|
||||||
``nl_langinfo(CODESET)`` result.
|
``nl_langinfo(CODESET)`` result.
|
||||||
|
|
||||||
At Python statup, the encoding name is normalized to the Python codec
|
At Python startup, the encoding name is normalized to the Python codec
|
||||||
name. For example, ``"ANSI_X3.4-1968"`` is replaced with ``"ascii"``.
|
name. For example, ``"ANSI_X3.4-1968"`` is replaced with ``"ascii"``.
|
||||||
|
|
||||||
See also the :c:member:`~PyConfig.filesystem_errors` member.
|
See also the :c:member:`~PyConfig.filesystem_errors` member.
|
||||||
|
|
|
@ -714,7 +714,7 @@ Why don't generators support the with statement?
|
||||||
For technical reasons, a generator used directly as a context manager
|
For technical reasons, a generator used directly as a context manager
|
||||||
would not work correctly. When, as is most common, a generator is used as
|
would not work correctly. When, as is most common, a generator is used as
|
||||||
an iterator run to completion, no closing is needed. When it is, wrap
|
an iterator run to completion, no closing is needed. When it is, wrap
|
||||||
it as "contextlib.closing(generator)" in the 'with' statment.
|
it as "contextlib.closing(generator)" in the 'with' statement.
|
||||||
|
|
||||||
|
|
||||||
Why are colons required for the if/while/def/class statements?
|
Why are colons required for the if/while/def/class statements?
|
||||||
|
|
|
@ -1920,7 +1920,7 @@ and classes for traversing abstract syntax trees:
|
||||||
If source contains a null character ('\0'), :exc:`ValueError` is raised.
|
If source contains a null character ('\0'), :exc:`ValueError` is raised.
|
||||||
|
|
||||||
.. warning::
|
.. warning::
|
||||||
Note that succesfully parsing souce code into an AST object doesn't
|
Note that successfully parsing source code into an AST object doesn't
|
||||||
guarantee that the source code provided is valid Python code that can
|
guarantee that the source code provided is valid Python code that can
|
||||||
be executed as the compilation step can raise further :exc:`SyntaxError`
|
be executed as the compilation step can raise further :exc:`SyntaxError`
|
||||||
exceptions. For instance, the source ``return 42`` generates a valid
|
exceptions. For instance, the source ``return 42`` generates a valid
|
||||||
|
|
|
@ -154,7 +154,7 @@ The modern interface provides:
|
||||||
This version does not allow the digit 0 (zero) to the letter O (oh) and digit
|
This version does not allow the digit 0 (zero) to the letter O (oh) and digit
|
||||||
1 (one) to either the letter I (eye) or letter L (el) mappings, all these
|
1 (one) to either the letter I (eye) or letter L (el) mappings, all these
|
||||||
characters are included in the Extended Hex Alphabet and are not
|
characters are included in the Extended Hex Alphabet and are not
|
||||||
interchangable.
|
interchangeable.
|
||||||
|
|
||||||
.. versionadded:: 3.10
|
.. versionadded:: 3.10
|
||||||
|
|
||||||
|
|
|
@ -725,7 +725,7 @@ iterations of the loop.
|
||||||
of the stack and sets the ``f_lasti`` attribute of the frame with that value.
|
of the stack and sets the ``f_lasti`` attribute of the frame with that value.
|
||||||
Then pops the next exception from the stack uses it to restore the current exception.
|
Then pops the next exception from the stack uses it to restore the current exception.
|
||||||
Finally it re-raises the originally popped exception.
|
Finally it re-raises the originally popped exception.
|
||||||
Used in excpetion handler cleanup.
|
Used in exception handler cleanup.
|
||||||
|
|
||||||
.. versionadded:: 3.11
|
.. versionadded:: 3.11
|
||||||
|
|
||||||
|
|
|
@ -651,8 +651,8 @@ Data Types
|
||||||
|
|
||||||
---------------
|
---------------
|
||||||
|
|
||||||
Utilites and Decorators
|
Utilities and Decorators
|
||||||
-----------------------
|
------------------------
|
||||||
|
|
||||||
.. class:: auto
|
.. class:: auto
|
||||||
|
|
||||||
|
|
|
@ -50,7 +50,7 @@ You can control how files are opened by providing an opening hook via the
|
||||||
*openhook* parameter to :func:`fileinput.input` or :class:`FileInput()`. The
|
*openhook* parameter to :func:`fileinput.input` or :class:`FileInput()`. The
|
||||||
hook must be a function that takes two arguments, *filename* and *mode*, and
|
hook must be a function that takes two arguments, *filename* and *mode*, and
|
||||||
returns an accordingly opened file-like object. If *encoding* and/or *errors*
|
returns an accordingly opened file-like object. If *encoding* and/or *errors*
|
||||||
are specified, they will be passed to the hook as aditional keyword arguments.
|
are specified, they will be passed to the hook as additional keyword arguments.
|
||||||
This module provides a :func:`hook_compressed` to support compressed files.
|
This module provides a :func:`hook_compressed` to support compressed files.
|
||||||
|
|
||||||
The following function is the primary interface of this module:
|
The following function is the primary interface of this module:
|
||||||
|
|
|
@ -255,7 +255,7 @@ function::
|
||||||
Package distributions
|
Package distributions
|
||||||
---------------------
|
---------------------
|
||||||
|
|
||||||
A convience method to resolve the distribution or
|
A convenience method to resolve the distribution or
|
||||||
distributions (in the case of a namespace package) for top-level
|
distributions (in the case of a namespace package) for top-level
|
||||||
Python packages or modules::
|
Python packages or modules::
|
||||||
|
|
||||||
|
|
|
@ -1249,7 +1249,7 @@ The :mod:`test.support.threading_helper` module provides support for threading t
|
||||||
Context manager catching :class:`threading.Thread` exception using
|
Context manager catching :class:`threading.Thread` exception using
|
||||||
:func:`threading.excepthook`.
|
:func:`threading.excepthook`.
|
||||||
|
|
||||||
Attributes set when an exception is catched:
|
Attributes set when an exception is caught:
|
||||||
|
|
||||||
* ``exc_type``
|
* ``exc_type``
|
||||||
* ``exc_value``
|
* ``exc_value``
|
||||||
|
@ -1458,7 +1458,7 @@ The :mod:`test.support.os_helper` module provides support for os tests.
|
||||||
.. function:: unlink(filename)
|
.. function:: unlink(filename)
|
||||||
|
|
||||||
Call :func:`os.unlink` on *filename*. On Windows platforms, this is
|
Call :func:`os.unlink` on *filename*. On Windows platforms, this is
|
||||||
wrapped with a wait loop that checks for the existence fo the file.
|
wrapped with a wait loop that checks for the existence of the file.
|
||||||
|
|
||||||
|
|
||||||
:mod:`test.support.import_helper` --- Utilities for import tests
|
:mod:`test.support.import_helper` --- Utilities for import tests
|
||||||
|
|
|
@ -243,7 +243,7 @@ Standard names are defined for the following types:
|
||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
A future version of Python may stop setting this attribute by default.
|
A future version of Python may stop setting this attribute by default.
|
||||||
To guard against this potential change, preferrably read from the
|
To guard against this potential change, preferably read from the
|
||||||
:attr:`__spec__` attribute instead or use
|
:attr:`__spec__` attribute instead or use
|
||||||
``getattr(module, "__loader__", None)`` if you explicitly need to use
|
``getattr(module, "__loader__", None)`` if you explicitly need to use
|
||||||
this attribute.
|
this attribute.
|
||||||
|
@ -268,7 +268,7 @@ Standard names are defined for the following types:
|
||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
A future version of Python may stop setting this attribute by default.
|
A future version of Python may stop setting this attribute by default.
|
||||||
To guard against this potential change, preferrably read from the
|
To guard against this potential change, preferably read from the
|
||||||
:attr:`__spec__` attribute instead or use
|
:attr:`__spec__` attribute instead or use
|
||||||
``getattr(module, "__package__", None)`` if you explicitly need to use
|
``getattr(module, "__package__", None)`` if you explicitly need to use
|
||||||
this attribute.
|
this attribute.
|
||||||
|
|
|
@ -605,7 +605,7 @@ the module.
|
||||||
|
|
||||||
``__file__`` is optional (if set, value must be a string). It indicates
|
``__file__`` is optional (if set, value must be a string). It indicates
|
||||||
the pathname of the file from which the module was loaded (if
|
the pathname of the file from which the module was loaded (if
|
||||||
loaded from a file), or the pathname of the shared libray file
|
loaded from a file), or the pathname of the shared library file
|
||||||
for extension modules loaded dynamically from a shared library.
|
for extension modules loaded dynamically from a shared library.
|
||||||
It might be missing for certain types of modules, such as C
|
It might be missing for certain types of modules, such as C
|
||||||
modules that are statically linked into the interpreter, and the
|
modules that are statically linked into the interpreter, and the
|
||||||
|
|
|
@ -256,7 +256,7 @@ def hide_comments(lines):
|
||||||
"""Tool to remove comments from given lines.
|
"""Tool to remove comments from given lines.
|
||||||
|
|
||||||
It yields empty lines in place of comments, so line numbers are
|
It yields empty lines in place of comments, so line numbers are
|
||||||
still meaningfull.
|
still meaningful.
|
||||||
"""
|
"""
|
||||||
in_multiline_comment = False
|
in_multiline_comment = False
|
||||||
for line in lines:
|
for line in lines:
|
||||||
|
|
|
@ -477,7 +477,7 @@ Miscellaneous options
|
||||||
* ``-X no_debug_ranges`` disables the inclusion of the tables mapping extra
|
* ``-X no_debug_ranges`` disables the inclusion of the tables mapping extra
|
||||||
location information (end line, start column offset and end column offset)
|
location information (end line, start column offset and end column offset)
|
||||||
to every instruction in code objects. This is useful when smaller code
|
to every instruction in code objects. This is useful when smaller code
|
||||||
objects and pyc files are desired as well as supressing the extra visual
|
objects and pyc files are desired as well as suppressing the extra visual
|
||||||
location indicators when the interpreter displays tracebacks. See also
|
location indicators when the interpreter displays tracebacks. See also
|
||||||
:envvar:`PYTHONNODEBUGRANGES`.
|
:envvar:`PYTHONNODEBUGRANGES`.
|
||||||
* ``-X frozen_modules`` determines whether or not frozen modules are
|
* ``-X frozen_modules`` determines whether or not frozen modules are
|
||||||
|
@ -959,7 +959,7 @@ conflict.
|
||||||
If this variable is set, it disables the inclusion of the tables mapping
|
If this variable is set, it disables the inclusion of the tables mapping
|
||||||
extra location information (end line, start column offset and end column
|
extra location information (end line, start column offset and end column
|
||||||
offset) to every instruction in code objects. This is useful when smaller
|
offset) to every instruction in code objects. This is useful when smaller
|
||||||
code objects and pyc files are desired as well as supressing the extra visual
|
code objects and pyc files are desired as well as suppressing the extra visual
|
||||||
location indicators when the interpreter displays tracebacks.
|
location indicators when the interpreter displays tracebacks.
|
||||||
|
|
||||||
.. versionadded:: 3.11
|
.. versionadded:: 3.11
|
||||||
|
|
|
@ -553,7 +553,7 @@ Built-in modules have no ``__file__`` attribute::
|
||||||
File "<stdin>", line 1, in <module>
|
File "<stdin>", line 1, in <module>
|
||||||
AttributeError: module 'sys' has no attribute '__file__'
|
AttributeError: module 'sys' has no attribute '__file__'
|
||||||
|
|
||||||
Other C extensions are built as dynamic libraires, like the ``_asyncio`` module.
|
Other C extensions are built as dynamic libraries, like the ``_asyncio`` module.
|
||||||
They are built with the ``Py_BUILD_CORE_MODULE`` macro defined.
|
They are built with the ``Py_BUILD_CORE_MODULE`` macro defined.
|
||||||
Example on Linux x86-64::
|
Example on Linux x86-64::
|
||||||
|
|
||||||
|
|
|
@ -1583,7 +1583,7 @@ Deprecated
|
||||||
|
|
||||||
* Currently Python accepts numeric literals immediately followed by keywords,
|
* Currently Python accepts numeric literals immediately followed by keywords,
|
||||||
for example ``0in x``, ``1or x``, ``0if 1else 2``. It allows confusing
|
for example ``0in x``, ``1or x``, ``0if 1else 2``. It allows confusing
|
||||||
and ambigious expressions like ``[0x1for x in y]`` (which can be
|
and ambiguous expressions like ``[0x1for x in y]`` (which can be
|
||||||
interpreted as ``[0x1 for x in y]`` or ``[0x1f or x in y]``). Starting in
|
interpreted as ``[0x1 for x in y]`` or ``[0x1f or x in y]``). Starting in
|
||||||
this release, a deprecation warning is raised if the numeric literal is
|
this release, a deprecation warning is raised if the numeric literal is
|
||||||
immediately followed by one of keywords :keyword:`and`, :keyword:`else`,
|
immediately followed by one of keywords :keyword:`and`, :keyword:`else`,
|
||||||
|
@ -1920,7 +1920,7 @@ Changes in the Python API
|
||||||
if the *globals* dictionary has no ``"__builtins__"`` key, rather than using
|
if the *globals* dictionary has no ``"__builtins__"`` key, rather than using
|
||||||
``{"None": None}`` as builtins: same behavior as :func:`eval` and
|
``{"None": None}`` as builtins: same behavior as :func:`eval` and
|
||||||
:func:`exec` functions. Defining a function with ``def function(...): ...``
|
:func:`exec` functions. Defining a function with ``def function(...): ...``
|
||||||
in Python is not affected, globals cannot be overriden with this syntax: it
|
in Python is not affected, globals cannot be overridden with this syntax: it
|
||||||
also inherits the current builtins.
|
also inherits the current builtins.
|
||||||
(Contributed by Victor Stinner in :issue:`42990`.)
|
(Contributed by Victor Stinner in :issue:`42990`.)
|
||||||
|
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue