mirror of https://github.com/python/cpython
Docs: spelling and grammar fixes (#122084)
Corrected some grammar and spelling issues in documentation. Co-authored-by: Russell Keith-Magee <russell@keith-magee.com> Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
This commit is contained in:
parent
728432c804
commit
bc264eac3a
|
@ -509,7 +509,7 @@ PyConfig
|
|||
The :c:func:`PyConfig_Read` function only parses
|
||||
:c:member:`PyConfig.argv` arguments once: :c:member:`PyConfig.parse_argv`
|
||||
is set to ``2`` after arguments are parsed. Since Python arguments are
|
||||
strippped from :c:member:`PyConfig.argv`, parsing arguments twice would
|
||||
stripped from :c:member:`PyConfig.argv`, parsing arguments twice would
|
||||
parse the application options as Python options.
|
||||
|
||||
:ref:`Preinitialize Python <c-preinit>` if needed.
|
||||
|
@ -1041,7 +1041,7 @@ PyConfig
|
|||
The :c:func:`PyConfig_Read` function only parses
|
||||
:c:member:`PyConfig.argv` arguments once: :c:member:`PyConfig.parse_argv`
|
||||
is set to ``2`` after arguments are parsed. Since Python arguments are
|
||||
strippped from :c:member:`PyConfig.argv`, parsing arguments twice would
|
||||
stripped from :c:member:`PyConfig.argv`, parsing arguments twice would
|
||||
parse the application options as Python options.
|
||||
|
||||
Default: ``1`` in Python mode, ``0`` in isolated mode.
|
||||
|
|
|
@ -188,7 +188,7 @@ Python's memory management C API provides functions in three different
|
|||
:ref:`allocation domains <allocator-domains>`: "raw", "mem", and "object".
|
||||
For thread-safety, the free-threaded build requires that only Python objects
|
||||
are allocated using the object domain, and that all Python object are
|
||||
allocated using that domain. This differes from the prior Python versions,
|
||||
allocated using that domain. This differs from the prior Python versions,
|
||||
where this was only a best practice and not a hard requirement.
|
||||
|
||||
.. note::
|
||||
|
|
|
@ -4022,7 +4022,7 @@ As you can see, this output isn't ideal. That's because the underlying code
|
|||
which writes to ``sys.stderr`` makes multiple writes, each of which results in a
|
||||
separate logged line (for example, the last three lines above). To get around
|
||||
this problem, you need to buffer things and only output log lines when newlines
|
||||
are seen. Let's use a slghtly better implementation of ``LoggerWriter``:
|
||||
are seen. Let's use a slightly better implementation of ``LoggerWriter``:
|
||||
|
||||
.. code-block:: python
|
||||
|
||||
|
|
|
@ -887,7 +887,7 @@ Statements
|
|||
.. class:: AnnAssign(target, annotation, value, simple)
|
||||
|
||||
An assignment with a type annotation. ``target`` is a single node and can
|
||||
be a :class:`Name`, a :class:`Attribute` or a :class:`Subscript`.
|
||||
be a :class:`Name`, an :class:`Attribute` or a :class:`Subscript`.
|
||||
``annotation`` is the annotation, such as a :class:`Constant` or :class:`Name`
|
||||
node. ``value`` is a single optional node.
|
||||
|
||||
|
@ -1979,7 +1979,7 @@ Function and class definitions
|
|||
YieldFrom(value)
|
||||
|
||||
A ``yield`` or ``yield from`` expression. Because these are expressions, they
|
||||
must be wrapped in a :class:`Expr` node if the value sent back is not used.
|
||||
must be wrapped in an :class:`Expr` node if the value sent back is not used.
|
||||
|
||||
.. doctest::
|
||||
|
||||
|
|
|
@ -120,20 +120,20 @@ Future Object
|
|||
a :exc:`CancelledError` exception.
|
||||
|
||||
If the Future's result isn't yet available, this method raises
|
||||
a :exc:`InvalidStateError` exception.
|
||||
an :exc:`InvalidStateError` exception.
|
||||
|
||||
.. method:: set_result(result)
|
||||
|
||||
Mark the Future as *done* and set its result.
|
||||
|
||||
Raises a :exc:`InvalidStateError` error if the Future is
|
||||
Raises an :exc:`InvalidStateError` error if the Future is
|
||||
already *done*.
|
||||
|
||||
.. method:: set_exception(exception)
|
||||
|
||||
Mark the Future as *done* and set an exception.
|
||||
|
||||
Raises a :exc:`InvalidStateError` error if the Future is
|
||||
Raises an :exc:`InvalidStateError` error if the Future is
|
||||
already *done*.
|
||||
|
||||
.. method:: done()
|
||||
|
|
|
@ -1170,7 +1170,7 @@ Task Object
|
|||
a :exc:`CancelledError` exception.
|
||||
|
||||
If the Task's result isn't yet available, this method raises
|
||||
a :exc:`InvalidStateError` exception.
|
||||
an :exc:`InvalidStateError` exception.
|
||||
|
||||
.. method:: exception()
|
||||
|
||||
|
|
|
@ -322,7 +322,7 @@ Functions and classes provided:
|
|||
|
||||
.. versionchanged:: 3.12
|
||||
``suppress`` now supports suppressing exceptions raised as
|
||||
part of an :exc:`BaseExceptionGroup`.
|
||||
part of a :exc:`BaseExceptionGroup`.
|
||||
|
||||
.. function:: redirect_stdout(new_target)
|
||||
|
||||
|
|
|
@ -107,7 +107,7 @@ Functions are accessed as attributes of dll objects::
|
|||
|
||||
Note that win32 system dlls like ``kernel32`` and ``user32`` often export ANSI
|
||||
as well as UNICODE versions of a function. The UNICODE version is exported with
|
||||
an ``W`` appended to the name, while the ANSI version is exported with an ``A``
|
||||
a ``W`` appended to the name, while the ANSI version is exported with an ``A``
|
||||
appended to the name. The win32 ``GetModuleHandle`` function, which returns a
|
||||
*module handle* for a given module name, has the following C prototype, and a
|
||||
macro is used to expose one of them as ``GetModuleHandle`` depending on whether
|
||||
|
|
|
@ -92,7 +92,7 @@ another rational number, or from a string.
|
|||
|
||||
.. versionchanged:: 3.9
|
||||
The :func:`math.gcd` function is now used to normalize the *numerator*
|
||||
and *denominator*. :func:`math.gcd` always return a :class:`int` type.
|
||||
and *denominator*. :func:`math.gcd` always returns an :class:`int` type.
|
||||
Previously, the GCD type depended on *numerator* and *denominator*.
|
||||
|
||||
.. versionchanged:: 3.11
|
||||
|
|
|
@ -378,7 +378,7 @@ provides three different variants:
|
|||
|
||||
If the request was mapped to a file, it is opened. Any :exc:`OSError`
|
||||
exception in opening the requested file is mapped to a ``404``,
|
||||
``'File not found'`` error. If there was a ``'If-Modified-Since'``
|
||||
``'File not found'`` error. If there was an ``'If-Modified-Since'``
|
||||
header in the request, and the file was not modified after this time,
|
||||
a ``304``, ``'Not Modified'`` response is sent. Otherwise, the content
|
||||
type is guessed by calling the :meth:`guess_type` method, which in turn
|
||||
|
|
|
@ -22,7 +22,7 @@
|
|||
something like a data file that lives next to the ``__init__.py``
|
||||
file of the package. The purpose of this class is to help abstract
|
||||
out the accessing of such data files so that it does not matter if
|
||||
the package and its data file(s) are stored in a e.g. zip file
|
||||
the package and its data file(s) are stored e.g. in a zip file
|
||||
versus on the file system.
|
||||
|
||||
For any of methods of this class, a *resource* argument is
|
||||
|
|
|
@ -657,7 +657,7 @@ ABC hierarchy::
|
|||
something like a data file that lives next to the ``__init__.py``
|
||||
file of the package. The purpose of this class is to help abstract
|
||||
out the accessing of such data files so that it does not matter if
|
||||
the package and its data file(s) are stored in a e.g. zip file
|
||||
the package and its data file(s) are stored e.g. in a zip file
|
||||
versus on the file system.
|
||||
|
||||
For any of methods of this class, a *resource* argument is
|
||||
|
|
|
@ -457,7 +457,7 @@ attributes (see :ref:`import-mod-attrs` for module attributes):
|
|||
|
||||
.. versionchanged:: 3.8
|
||||
Functions wrapped in :func:`functools.partial` now return ``True`` if the
|
||||
wrapped function is a :term:`asynchronous generator` function.
|
||||
wrapped function is an :term:`asynchronous generator` function.
|
||||
|
||||
.. versionchanged:: 3.13
|
||||
Functions wrapped in :func:`functools.partialmethod` now return ``True``
|
||||
|
@ -938,7 +938,7 @@ function.
|
|||
|
||||
.. attribute:: Parameter.kind.description
|
||||
|
||||
Describes a enum value of :attr:`Parameter.kind`.
|
||||
Describes an enum value of :attr:`Parameter.kind`.
|
||||
|
||||
.. versionadded:: 3.8
|
||||
|
||||
|
|
|
@ -1387,7 +1387,7 @@ When an :class:`!MHMessage` instance is created based upon a
|
|||
|
||||
.. method:: get_visible()
|
||||
|
||||
Return an :class:`Message` instance whose headers are the message's
|
||||
Return a :class:`Message` instance whose headers are the message's
|
||||
visible headers and whose body is empty.
|
||||
|
||||
|
||||
|
|
|
@ -1352,7 +1352,7 @@ The whole point of creating and populating an OptionParser is to call its
|
|||
the list of arguments to process (default: ``sys.argv[1:]``)
|
||||
|
||||
``values``
|
||||
an :class:`Values` object to store option arguments in (default: a
|
||||
a :class:`Values` object to store option arguments in (default: a
|
||||
new instance of :class:`Values`) -- if you give an existing object, the
|
||||
option defaults will not be initialized on it
|
||||
|
||||
|
|
|
@ -1562,7 +1562,7 @@ or `the MSDN <https://msdn.microsoft.com/en-us/library/z0kc8e3z.aspx>`_ on Windo
|
|||
|
||||
.. function:: pwritev(fd, buffers, offset, flags=0, /)
|
||||
|
||||
Write the *buffers* contents to file descriptor *fd* at a offset *offset*,
|
||||
Write the *buffers* contents to file descriptor *fd* at an offset *offset*,
|
||||
leaving the file offset unchanged. *buffers* must be a sequence of
|
||||
:term:`bytes-like objects <bytes-like object>`. Buffers are processed in
|
||||
array order. Entire contents of the first buffer is written before
|
||||
|
@ -3805,7 +3805,7 @@ features:
|
|||
new file descriptor is :ref:`non-inheritable <fd_inheritance>`.
|
||||
|
||||
*initval* is the initial value of the event counter. The initial value
|
||||
must be an 32 bit unsigned integer. Please note that the initial value is
|
||||
must be a 32 bit unsigned integer. Please note that the initial value is
|
||||
limited to a 32 bit unsigned int although the event counter is an unsigned
|
||||
64 bit integer with a maximum value of 2\ :sup:`64`\ -\ 2.
|
||||
|
||||
|
@ -3884,7 +3884,7 @@ features:
|
|||
|
||||
.. data:: EFD_SEMAPHORE
|
||||
|
||||
Provide semaphore-like semantics for reads from a :func:`eventfd` file
|
||||
Provide semaphore-like semantics for reads from an :func:`eventfd` file
|
||||
descriptor. On read the internal counter is decremented by one.
|
||||
|
||||
.. availability:: Linux >= 2.6.30
|
||||
|
|
|
@ -1016,7 +1016,7 @@ Querying file type and status
|
|||
|
||||
.. method:: Path.stat(*, follow_symlinks=True)
|
||||
|
||||
Return a :class:`os.stat_result` object containing information about this path, like :func:`os.stat`.
|
||||
Return an :class:`os.stat_result` object containing information about this path, like :func:`os.stat`.
|
||||
The result is looked up at each call to this method.
|
||||
|
||||
This method normally follows symlinks; to stat a symlink add the argument
|
||||
|
|
|
@ -117,7 +117,7 @@ This module defines the following functions:
|
|||
when a key of a dictionary is not a string, otherwise such keys are skipped.
|
||||
|
||||
When *aware_datetime* is true and any field with type ``datetime.datetime``
|
||||
is set as a :ref:`aware object <datetime-naive-aware>`, it will convert to
|
||||
is set as an :ref:`aware object <datetime-naive-aware>`, it will convert to
|
||||
UTC timezone before writing it.
|
||||
|
||||
A :exc:`TypeError` will be raised if the object is of an unsupported type or
|
||||
|
|
|
@ -1742,7 +1742,7 @@ to speed up repeated connections from the same clients.
|
|||
IDN-encoded internationalized domain name, the *server_name_callback*
|
||||
receives a decoded U-label (``"pythön.org"``).
|
||||
|
||||
If there is an decoding error on the server name, the TLS connection will
|
||||
If there is a decoding error on the server name, the TLS connection will
|
||||
terminate with an :const:`ALERT_DESCRIPTION_INTERNAL_ERROR` fatal TLS
|
||||
alert message to the client.
|
||||
|
||||
|
|
|
@ -1126,7 +1126,7 @@ The :mod:`subprocess` module exposes the following constants.
|
|||
.. data:: NORMAL_PRIORITY_CLASS
|
||||
|
||||
A :class:`Popen` ``creationflags`` parameter to specify that a new process
|
||||
will have an normal priority. (default)
|
||||
will have a normal priority. (default)
|
||||
|
||||
.. versionadded:: 3.7
|
||||
|
||||
|
|
|
@ -1092,7 +1092,7 @@ FileHandler Objects
|
|||
|
||||
.. versionchanged:: 3.2
|
||||
This method is applicable only for local hostnames. When a remote
|
||||
hostname is given, an :exc:`~urllib.error.URLError` is raised.
|
||||
hostname is given, a :exc:`~urllib.error.URLError` is raised.
|
||||
|
||||
|
||||
.. _data-handler-objects:
|
||||
|
@ -1107,7 +1107,7 @@ DataHandler Objects
|
|||
ignores white spaces in base64 encoded data URLs so the URL may be wrapped
|
||||
in whatever source file it comes from. But even though some browsers don't
|
||||
mind about a missing padding at the end of a base64 encoded data URL, this
|
||||
implementation will raise an :exc:`ValueError` in that case.
|
||||
implementation will raise a :exc:`ValueError` in that case.
|
||||
|
||||
|
||||
.. _ftp-handler-objects:
|
||||
|
|
|
@ -39,7 +39,7 @@ iOS version compatibility
|
|||
The minimum supported iOS version is specified at compile time, using the
|
||||
:option:`--host` option to ``configure``. By default, when compiled for iOS,
|
||||
Python will be compiled with a minimum supported iOS version of 13.0. To use a
|
||||
different miniumum iOS version, provide the version number as part of the
|
||||
different minimum iOS version, provide the version number as part of the
|
||||
:option:`!--host` argument - for example,
|
||||
``--host=arm64-apple-ios15.4-simulator`` would compile an ARM64 simulator build
|
||||
with a deployment target of 15.4.
|
||||
|
|
Loading…
Reference in New Issue