delta/cpython-git.git/Doc/reference, branch v3.8.9

bpo-27646: Say that 'yield from' expression can be any iterable (GH-24595)

2021-02-21T02:42:24+00:00

Previously, the doc at least strongly implied that it had to be an iterator.
(cherry picked from commit 2f9ef514fb24b6a95bd3272885f197752810c107)

Co-authored-by: Terry Jan Reedy

[3.8] [doc] Fix a few margins due to bad markup (GH-23619). (GH-23860)

2020-12-22T02:55:19+00:00

(cherry picked from commit 96a09df64483b70c4215c7025a19b9d2f1636c55)

Co-authored-by: Andre Delfino

bpo-42669: Document that `except` rejects nested tuples (GH-23822) (GH-23871)

2020-12-20T21:18:40+00:00

In Python 2, it was possible to use `except` with a nested tuple, and occasionally natural.  For example, `zope.formlib.interfaces.InputErrors` is a tuple of several exception classes, and one might reasonably think to do something like this:

    try:
        self.getInputValue()
        return True
    except (InputErrors, SomethingElse):
        return False

As of Python 3.0, this raises `TypeError: catching classes that do not inherit from BaseException is not allowed` instead: one must instead either break it up into multiple `except` clauses or flatten the tuple.  However, the reference documentation was never updated to match this new restriction.  Make it clear that the definition is no longer recursive.

Automerge-Triggered-By: GH:ericvsmith
(cherry picked from commit c95f8bc2700b42f4568886505a819816c9b0ba28)

Co-authored-by: Colin Watson 

Co-authored-by: Colin Watson

[3.8] bpo-39416: change word case to not imply ABC (GH-22867) (GH-22869)

2020-12-16T03:18:17+00:00

follow-up to bpo-39416

Co-authored-by: kpinc

bpo-6761: Enhance call documentation (GH-7987)

2020-10-27T16:28:00+00:00

(cherry picked from commit 95f710c55714153f0c8cce48f8215bb3d866ac1d)

Co-authored-by: Andre Delfino

bpo-29981: Add examples and update index for set, dict, and generator comprehensions'(GH-20272)

2020-10-25T02:53:18+00:00

Co-authored-by: Rémi Lapeyre 
(cherry picked from commit 2d55aa9e37c9c84f4f6a8135d0326da0bcd8f38b)

Co-authored-by: Florian Dahlitz

bpo-41910: specify the default implementations of object.eq and object.ne (GH-22874) (#22877)

2020-10-22T00:07:59+00:00

See Objects/typeobject.c:object_richcompare() for the implementation of this in CPython.

Co-authored-by: Brett Cannon

bpo-35181: Correct importlib documentation for some module attributes (GH-15190)

2020-10-21T21:27:10+00:00

@ericsnowcurrently This PR will change the following:

In the library documentation importlib.rst:

- `module.__package__` can be `module.__name__` for packages;
- `spec.parent` can be `spec.__name__` for packages;
- `spec.loader` is not `None` for namespaces packages.

In the language documentation import.rst:

- `spec.loader` is not `None` for namespace packages.

Automerge-Triggered-By: GH:warsaw
(cherry picked from commit 27f1bd8787d24ac53cc3dc6ea5eb00b8a3499839)

Co-authored-by: Géry Ogam

[3.8] bpo-39416: Document some restrictions on the default string representations of numeric classes (GH-18111) (GH-22861)

2020-10-21T18:56:20+00:00

[[bpo-39416]()](): Document string representations of the Numeric classes

This is a change to the specification of the Python language.

The idea here is to put sane minimal limits on the Python language's default
representations of its Numeric classes.  That way "Marty's Robotic Massage Parlor
and Python Interpreter" implementation of Python won't do anything too
crazy.

Some discussion in the email thread:
Subject: Documenting Python's float.__str__()
https://mail.python.org/archives/list/python-dev@python.org/thread/FV22TKT3S2Q3P7PNN6MCXI6IX3HRRNAL/
(cherry picked from commit c60394c7fc9cc09b16e9675a3eeb5844b6d8523f)


Co-authored-by: kpinc 

Automerge-Triggered-By: GH:merwok

Doc: Fix a typo/error in the docs for cached bytecode (GH-22445)

2020-10-21T08:46:22+00:00

(cherry picked from commit cb115e36e1aba04b90b0ecac6f043e60064ac65b)

Co-authored-by: Zackery Spytz