mirror of
https://github.com/python/cpython.git
synced 2024-11-23 18:04:37 +08:00
Revert #22251
This commit is contained in:
Berker Peksag
parent
9ce69672f3
commit
9c1dba2758
@ -983,7 +983,6 @@ done. This can be done using the :c:func:`PyErr_Fetch` and
|
||||
}
|
||||
|
||||
.. note::
|
||||
|
||||
There are limitations to what you can safely do in a deallocator function.
|
||||
First, if your type supports garbage collection (using :c:member:`~PyTypeObject.tp_traverse`
|
||||
and/or :c:member:`~PyTypeObject.tp_clear`), some of the object's members can have been
|
||||
@ -998,7 +997,6 @@ done. This can be done using the :c:func:`PyErr_Fetch` and
|
||||
:c:member:`~PyTypeObject.tp_finalize` type method.
|
||||
|
||||
.. seealso::
|
||||
|
||||
:pep:`442` explains the new finalization scheme.
|
||||
|
||||
.. index::
|
||||
|
||||
@ -697,9 +697,7 @@ quoted using :func:`urllib.parse.urlencode`. For example, to send
|
||||
>>> urllib.parse.urlencode({'name': 'Guy Steele, Jr.'})
|
||||
'name=Guy+Steele%2C+Jr.'
|
||||
|
||||
.. seealso::
|
||||
|
||||
:ref:`urllib-howto` for extensive examples.
|
||||
.. seealso:: :ref:`urllib-howto` for extensive examples.
|
||||
|
||||
|
||||
What module should I use to help with generating HTML?
|
||||
|
||||
@ -1894,7 +1894,6 @@ the populated namespace and the list of remaining argument strings.
|
||||
(Namespace(bar='BAR', foo=True), ['--badger', 'spam'])
|
||||
|
||||
.. warning::
|
||||
|
||||
:ref:`Prefix matching <prefix-matching>` rules apply to
|
||||
:meth:`parse_known_args`. The parser may consume an option even if it's just
|
||||
a prefix of one of its known options, instead of leaving it in the remaining
|
||||
|
||||
@ -197,9 +197,7 @@ Creating connections
|
||||
the transport; if *ssl* is :const:`True`, a context with some
|
||||
unspecified default settings is used.
|
||||
|
||||
.. seealso::
|
||||
|
||||
:ref:`SSL/TLS security considerations <ssl-security>`
|
||||
.. seealso:: :ref:`SSL/TLS security considerations <ssl-security>`
|
||||
|
||||
* *server_hostname*, is only for use together with *ssl*,
|
||||
and sets or overrides the hostname that the target server's certificate
|
||||
|
||||
@ -407,7 +407,6 @@ even more), and eventually :meth:`resume_writing` is called once when the
|
||||
buffer size reaches the low-water mark.
|
||||
|
||||
.. note::
|
||||
|
||||
If the buffer size equals the high-water mark,
|
||||
:meth:`pause_writing` is not called -- it must go strictly over.
|
||||
Conversely, :meth:`resume_writing` is called when the buffer size is
|
||||
@ -416,7 +415,6 @@ buffer size reaches the low-water mark.
|
||||
mark is zero.
|
||||
|
||||
.. note::
|
||||
|
||||
On BSD systems (OS X, FreeBSD, etc.) flow control is not supported
|
||||
for :class:`DatagramProtocol`, because send failures caused by
|
||||
writing too many packets cannot be detected easily. The socket
|
||||
|
||||
@ -269,7 +269,6 @@ and it stores the result into the future. The
|
||||
the future.
|
||||
|
||||
.. note::
|
||||
|
||||
The :meth:`~BaseEventLoop.run_until_complete` method uses internally the
|
||||
:meth:`~Future.add_done_callback` method to be notified when the future is
|
||||
done.
|
||||
|
||||
@ -405,9 +405,7 @@ Currently the email package provides only one concrete content manager,
|
||||
``message/rfc822``, use ``8bit`` if *cte* is not specified. For all
|
||||
other values of *subtype*, use ``7bit``.
|
||||
|
||||
.. note::
|
||||
|
||||
A *cte* of ``binary`` does not actually work correctly yet.
|
||||
.. note:: A *cte* of ``binary`` does not actually work correctly yet.
|
||||
The ``Message`` object as modified by ``set_content`` is correct, but
|
||||
:class:`~email.generator.BytesGenerator` does not serialize it
|
||||
correctly.
|
||||
|
||||
@ -864,9 +864,7 @@ supports sending logging messages to a Web server, using either ``GET`` or
|
||||
:meth:`mapLogRecord` method is used to convert the record to the
|
||||
dictionary to be sent.
|
||||
|
||||
.. note::
|
||||
|
||||
Since preparing a record for sending it to a Web server is not
|
||||
.. note:: Since preparing a record for sending it to a Web server is not
|
||||
the same as a generic formatting operation, using
|
||||
:meth:`~logging.Handler.setFormatter` to specify a
|
||||
:class:`~logging.Formatter` for a :class:`HTTPHandler` has no effect.
|
||||
|
||||
@ -851,7 +851,6 @@ Miscellaneous
|
||||
:exc:`NotImplementedError`.
|
||||
|
||||
.. seealso::
|
||||
|
||||
:func:`os.cpu_count`
|
||||
|
||||
.. function:: current_process()
|
||||
|
||||
@ -57,7 +57,6 @@ Notes on the availability of these functions:
|
||||
``'ce'``, ``'java'``.
|
||||
|
||||
.. seealso::
|
||||
|
||||
:attr:`sys.platform` has a finer granularity. :func:`os.uname` gives
|
||||
system-dependent version information.
|
||||
|
||||
|
||||
@ -32,18 +32,15 @@ Pure paths are useful in some special cases; for example:
|
||||
useful since those simply don't have any OS-accessing operations.
|
||||
|
||||
.. note::
|
||||
|
||||
This module has been included in the standard library on a
|
||||
:term:`provisional basis <provisional package>`. Backwards incompatible
|
||||
changes (up to and including removal of the package) may occur if deemed
|
||||
necessary by the core developers.
|
||||
|
||||
.. seealso::
|
||||
|
||||
:pep:`428`: The pathlib module -- object-oriented filesystem paths.
|
||||
|
||||
.. seealso::
|
||||
|
||||
For low-level path manipulation on strings, you can also use the
|
||||
:mod:`os.path` module.
|
||||
|
||||
|
||||
@ -141,7 +141,6 @@ to read the pickle produced.
|
||||
brought by protocol 4.
|
||||
|
||||
.. note::
|
||||
|
||||
Serialization is a more primitive notion than persistence; although
|
||||
:mod:`pickle` reads and writes file objects, it does not handle the issue of
|
||||
naming persistent objects, nor the (even more complicated) issue of concurrent
|
||||
|
||||
@ -259,7 +259,6 @@ purposes.
|
||||
default CA certificates.
|
||||
|
||||
.. note::
|
||||
|
||||
The protocol, options, cipher and other settings may change to more
|
||||
restrictive values anytime without prior deprecation. The values
|
||||
represent a fair balance between compatibility and security.
|
||||
@ -268,7 +267,6 @@ purposes.
|
||||
:class:`SSLContext` and apply the settings yourself.
|
||||
|
||||
.. note::
|
||||
|
||||
If you find that when certain older clients or servers attempt to connect
|
||||
with a :class:`SSLContext` created by this function that they get an
|
||||
error stating "Protocol or cipher suite mismatch", it may be that they
|
||||
@ -934,7 +932,6 @@ to speed up repeated connections from the same clients.
|
||||
interoperability.
|
||||
|
||||
.. seealso::
|
||||
|
||||
:func:`create_default_context` lets the :mod:`ssl` module choose
|
||||
security settings for a given purpose.
|
||||
|
||||
|
||||
@ -135,9 +135,7 @@ However, for reading convenience, most of the examples show sorted sequences.
|
||||
This is suited for when your data is discrete, and you don't mind that the
|
||||
median may not be an actual data point.
|
||||
|
||||
.. seealso::
|
||||
|
||||
:func:`median_low`, :func:`median_high`, :func:`median_grouped`
|
||||
.. seealso:: :func:`median_low`, :func:`median_high`, :func:`median_grouped`
|
||||
|
||||
|
||||
.. function:: median_low(data)
|
||||
|
||||
@ -3872,7 +3872,6 @@ pairs within braces, for example: ``{'jack': 4098, 'sjoerd': 4127}`` or ``{4098:
|
||||
:ref:`documentation of view objects <dict-views>`.
|
||||
|
||||
.. seealso::
|
||||
|
||||
:class:`types.MappingProxyType` can be used to create a read-only view
|
||||
of a :class:`dict`.
|
||||
|
||||
|
||||
@ -798,7 +798,6 @@ always available.
|
||||
|
||||
|
||||
.. seealso::
|
||||
|
||||
Module :mod:`site` This describes how to use .pth files to extend
|
||||
:data:`sys.path`.
|
||||
|
||||
|
||||
@ -41,7 +41,6 @@ message by calling :func:`formatwarning`, which is also available for use by
|
||||
custom implementations.
|
||||
|
||||
.. seealso::
|
||||
|
||||
:func:`logging.captureWarnings` allows you to handle all warnings with
|
||||
the standard logging infrastructure.
|
||||
|
||||
|
||||
@ -107,7 +107,6 @@ source.
|
||||
python -mtimeit -h # for details
|
||||
|
||||
.. seealso::
|
||||
|
||||
:func:`runpy.run_module`
|
||||
Equivalent functionality directly available to Python code
|
||||
|
||||
@ -159,9 +158,7 @@ automatically enabled, if available on your platform (see
|
||||
.. versionchanged:: 3.4
|
||||
Automatic enabling of tab-completion and history editing.
|
||||
|
||||
.. seealso::
|
||||
|
||||
:ref:`tut-invoking`
|
||||
.. seealso:: :ref:`tut-invoking`
|
||||
|
||||
|
||||
Generic options
|
||||
@ -365,7 +362,6 @@ Miscellaneous options
|
||||
thus equivalent to an omitted line number.
|
||||
|
||||
.. seealso::
|
||||
|
||||
:mod:`warnings` -- the warnings module
|
||||
|
||||
:pep:`230` -- Warning framework
|
||||
|
||||
Loading…
Reference in New Issue
Block a user