Commit Graph

23556 Commits

Author SHA1 Message Date
Miss Islington (bot) fa12749bcd
Bring Python into the new year. (GH-24036)
(cherry picked from commit de6f20a6de)

Co-authored-by: Dong-hee Na <donghee.na@python.org>
2021-01-01 09:27:48 -08:00
Miss Islington (bot) 8333d421c0
bpo-42781: Document the mechanics of cached_property from a user viewpoint (GH-24031) (#24035) 2020-12-31 17:36:14 -08:00
Miss Islington (bot) 55fadffb0b
Fixes a typo in importlib.metadata. (GH-23921) (#24029)
Signed-off-by: Tao He <sighingnow@gmail.com>
(cherry picked from commit 3631d6deab)

Co-authored-by: Tao He <sighingnow@gmail.com>

Co-authored-by: Tao He <sighingnow@gmail.com>
2020-12-31 12:27:17 -08:00
Andre Delfino 7a7f3e0d6a
[3.9] bpo-41224: Add versionadded for Symbol.is_annotated (GH-23861). (GH-24017)
(cherry picked from commit 2edfc86f69)
2020-12-31 15:10:10 +02:00
Miss Islington (bot) cc7f745e80
bpo-42700: Swap descriptions in pyexpat.errors (GH-23876)
The descriptions of the `codes` and `messages` dictionaries in
`xml.parsers.expat.errors` were swapped, and this commit swaps them
back. For example, `codes` maps string descriptions of errors to numeric
error codes, not the other way around.
(cherry picked from commit 84402eb110)

Co-authored-by: Michael Wayne Goodman <goodman.m.w@gmail.com>
2020-12-29 04:55:33 -08:00
Miss Islington (bot) 1ceb097cec
[doc] Fix missing commas in signatures (GH-23693)
* Fix star in signatures

* Fix comma in signatures
(cherry picked from commit 60eccd0956)

Co-authored-by: Andre Delfino <adelfino@gmail.com>
2020-12-29 04:28:58 -08:00
Miss Islington (bot) 0b43778b3c
bpo-42770: Fix a typo in the email.headerregistry docs (GH-23982)
Automerge-Triggered-By: GH:zware
(cherry picked from commit c56988b88f)

Co-authored-by: Zackery Spytz <zspytz@gmail.com>
2020-12-28 20:37:20 -08:00
Miss Islington (bot) 9f6a37cc07
bpo-42755: Fix sqlite3.Connection.backup docs (GH-23965)
The `pages` argument default value now reflects the implementation.
(cherry picked from commit abba83b4b9)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>
2020-12-27 14:56:41 -08:00
Miss Islington (bot) ed48e9e286
Add convolve() to the itertools recipes (GH-23928) (GH-23949) 2020-12-25 20:23:35 -08:00
Miss Islington (bot) 7acfe41257
bpo-42388: Fix subprocess.check_output input=None when text=True (GH-23467)
When the modern text= spelling of the universal_newlines= parameter was added
for Python 3.7, check_output's special case around input=None was overlooked.
So it behaved differently with universal_newlines=True vs text=True.  This
reconciles the behavior to be consistent and adds a test to guarantee it.

Also clarifies the existing check_output documentation.

Co-authored-by: Alexey Izbyshev <izbyshev@ispras.ru>
(cherry picked from commit 64abf37344)

Co-authored-by: Gregory P. Smith <greg@krypto.org>
2020-12-24 21:18:37 -08:00
Miss Islington (bot) 1e1bacf9e6
BPO-42703: Fix incorrect documentation links for asyncio.Event (GH-23881)
(cherry picked from commit d90ff37681)

Co-authored-by: Matt Fowler <matt.fow@gmail.com>
2020-12-23 03:13:51 -08:00
Miss Islington (bot) 4ec2149708
bpo-29030: Document interaction between *choices* and *metavar*. (GH-23884) (GH-23894) 2020-12-22 10:19:24 -08:00
Andre Delfino 7c48859eeb
[3.9] [doc] Fix a few margins due to bad markup (GH-23619). (GH-23859)
(cherry picked from commit 96a09df644)

Co-authored-by: Andre Delfino <adelfino@gmail.com>
2020-12-21 18:53:50 -08:00
Andre Delfino e89993cff4
[3.9] [doc] Fix erroneous backslashes in signatures and names (GH-23658) (GH-23827)
The issue being resolved is shown in the 3.10 docs (if you select docs for older versions you won't see a visual glitch).

The newer sphinx version that produces the 3.10 docs doesn't treat the backslash to escape things in some situations it previously did..
(cherry picked from commit dcc997cd28)

Co-authored-by: Andre Delfino <adelfino@gmail.com>
2020-12-21 18:52:19 -08:00
Miss Islington (bot) 409ce4a09e
bpo-42669: Document that `except` rejects nested tuples (GH-23822) (GH-23870)
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 c95f8bc270)

Co-authored-by: Colin Watson <cjwatson@debian.org>

Co-authored-by: Colin Watson <cjwatson@debian.org>
2020-12-20 16:18:08 -05:00
Miss Islington (bot) 40b4c405f9
bpo-42572: Improve argparse docs for the type parameter. (GH-23849) (GH-23869) 2020-12-20 10:51:20 -08:00
Miss Islington (bot) a34ab8188e
bpo-41724: Explain when the conversion is not possible with detect_types enabled (GH-23855) (GH-23862)
* Explain when the conversion is not possible with detect_types enabled
(cherry picked from commit 09a36cdfb7)

Co-authored-by: sblondon <sblondon@users.noreply.github.com>

Co-authored-by: sblondon <sblondon@users.noreply.github.com>
2020-12-19 19:02:25 -05:00
kj 597ebc8cf6
[3.9] bpo-42675: Document collections.abc.Callable changes (GH-23839) (#23852) 2020-12-19 14:32:06 -08:00
Miss Islington (bot) d458d8dab0
bpo-42559: Not that getrandbits() is non-negative. (GH-23843) (GH-23851) 2020-12-18 19:10:06 -08:00
Miss Islington (bot) 782665885c
bpo-34805: Guarantee that __subclasses__() is in definition order. (GH-23844) (GH-23850) 2020-12-18 17:17:32 -08:00
Miss Islington (bot) eef33e6d49
bpo-42670: Fix a missing word in the itertools.product() docs (GH-23823) (GH-23824) 2020-12-18 16:55:52 -08:00
Miss Islington (bot) 4b412e830d
bpo-36769: Document that fnmatch.filter supports any kind of iterable (GH-13039)
(cherry picked from commit e8d2264210)

Co-authored-by: Andre Delfino <adelfino@gmail.com>
2020-12-18 11:34:27 -08:00
Miss Islington (bot) 14619924c3
bpo-17140: Document multiprocessing's ThreadPool (GH-23812)
Up until now, the `multiprocessing.pool.ThreadPool` class has gone
undocumented, despite being a public class in multiprocessing that is
included in `multiprocessing.pool.__all__`.
(cherry picked from commit 84ebcf271a)

Co-authored-by: Matt Wozniski <mwozniski@bloomberg.net>
2020-12-18 05:27:02 -08:00
Miss Islington (bot) b812e236df
bpo-39096: Format specification documentation fixes for numeric types (GH-23575)
(cherry picked from commit 886b2e5c7a)

Co-authored-by: Mark Dickinson <mdickinson@enthought.com>
2020-12-18 01:49:19 -08:00
Miss Islington (bot) 2fba8445a4
Fix indentation for get_stats_profile() docs (GH-23618)
The existing method is indented one too many times which
makes it look like a sub-method of print_callees().
(cherry picked from commit a6ba2b9015)

Co-authored-by: Matthew Suozzo <msuozzo@google.com>
2020-12-17 01:18:39 +02:00
Miss Islington (bot) aba12b67c1
[3.9] bpo-42517: [Enum] deprecate private name members (GH-23722) (GH-23748)
private names will raise a DeprecationWarning; in 3.10 they will become normal attributes
2020-12-14 15:56:58 -08:00
Miss Islington (bot) be9e4402db
[3.9] bpo-41879: Doc: Fix description of async for statement (GH-23548) (GH-23749)
Fix the wording in the documentation of `async for` to correctly describe asynchronous iterables.  This fix is relevant for version 3.7 onward.
(cherry picked from commit 4b8cdfcb22)


Co-authored-by: Nick Gaya <nicholasgaya+github@gmail.com>
2020-12-12 20:24:31 -08:00
Andre Delfino c1a3f9a9cb
[3.9] [doc] Link to issue regarding logging.disable level param default value GH-23732
(cherry picked from commit 2a35137328)

Co-authored-by: Andre Delfino <adelfino@gmail.com>
2020-12-10 06:20:04 -08:00
Miss Islington (bot) facca72eae
bpo-38843: Document behavior of default when the attribute is already set (GH-23653) (#23668)
(cherry picked from commit 752cdf21eb)

Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>

Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
2020-12-06 21:17:09 -08:00
Miss Islington (bot) 3689c25a10
bpo-42523: Fix supported versions in "Using Python on Windows" (GH-23603)
(cherry picked from commit db68544122)

Co-authored-by: Zackery Spytz <zspytz@gmail.com>
2020-12-03 09:46:58 -08:00
Miss Islington (bot) ed4614386f
bpo-37221: PyCode_New() didn't change in Python 3.8 (GH-23595)
(cherry picked from commit 1867b462de)

Co-authored-by: Victor Stinner <vstinner@python.org>
2020-12-01 07:54:54 -08:00
Miss Islington (bot) 4a44f53aa8
[3.9] bpo-17852: Doc: Fix the tutorial about closing files (GH-23135) (GH-23527)
Co-authored-by: Inada Naoki <songofacandy@gmail.com>
(cherry picked from commit c8aaf71dde)


Co-authored-by: Volker-Weissmann <39418860+Volker-Weissmann@users.noreply.github.com>
2020-12-01 02:53:42 -08:00
Miss Islington (bot) aef482f7cf
Fix bz2 examples markup (GH-23580)
(cherry picked from commit 80a429eae9)

Co-authored-by: Andre Delfino <adelfino@gmail.com>
2020-12-01 02:04:23 -08:00
Julien Palard 7e80c0f40e
[3.9] [doc] Fix smtplib and xml.dom.minidom mark-up (GH-22769) (GH-23380) 2020-12-01 08:58:36 +01:00
Miss Islington (bot) aab9390334
bpo-42501: Revise the usage note for Enums with the choices (GH-23563) (GH-23573) 2020-11-30 13:21:08 -08:00
Miss Islington (bot) a83119d7be
bpo-42450: Minor updates to the itertools recipes (GH-23555) (GH-23562) 2020-11-29 11:14:10 -08:00
Miss Islington (bot) cf47b3969e
bpo-39096: Improve description of 'e', 'f' and 'g' presentation types (GH-23537) (GH-23550)
* Improve description of 'e', 'f' and 'g' presentation types

* Drop the 'E' from Scientific 'E' notation; remove >= 0 qualifications

* Fix false statement that the alternate form is valid for Decimal

* Nitpick: remove the Harvard/Oxford comma

* Add note that the decimal point is also removed if no digits follow it, except in alternate form
(cherry picked from commit c642374b3e)

Co-authored-by: Mark Dickinson <mdickinson@enthought.com>

Co-authored-by: Mark Dickinson <mdickinson@enthought.com>
2020-11-29 09:58:01 +00:00
Miss Islington (bot) cfb2f79634
Fix dis markup (GH-23524)
(cherry picked from commit fa840cc81d)

Co-authored-by: Andre Delfino <adelfino@gmail.com>
2020-11-28 14:06:05 -08:00
Miss Islington (bot) 5d54dfadcf
Fix multiprocessing markup (GH-23525)
(cherry picked from commit 4b44472966)

Co-authored-by: Andre Delfino <adelfino@gmail.com>
2020-11-28 14:05:37 -08:00
Miss Islington (bot) cc5eb935c7
bpo-42489: Fix the signature for list.sort() in the tutorial (GH-23538)
(cherry picked from commit d41ec65ab7)

Co-authored-by: Zackery Spytz <zspytz@gmail.com>
2020-11-28 07:14:23 -08:00
Miss Islington (bot) dca61e770d
Typo: fix inverted sense of statement (GH-23288) (GH-23512) 2020-11-25 12:14:32 -08:00
Miss Islington (bot) 0aedcff34c
Add more tests to the descriptor howto guide (GH-23506) (GH-23510) 2020-11-25 02:16:32 -08:00
Miss Islington (bot) 543724b972
Add doctests to the descriptor HowTo (GH-23500) (GH-23505) 2020-11-24 22:47:17 -08:00
Miss Islington (bot) b6416052f7
Typo (GH-23482) (#23483)
(cherry picked from commit 989af25616)

Co-authored-by: Jesús Cea <jcea@jcea.es>

Co-authored-by: Jesús Cea <jcea@jcea.es>
2020-11-24 01:11:13 +01:00
Miss Islington (bot) 2019e4ff98
Descriptor HowTo: Improve the fidelity of the member object simulation (GH-23475) (GH-23479) 2020-11-23 11:31:45 -08:00
Ned Deily 5aa6c99da1
bpo-41100: Update Whatsnew and installer ReadME for 3.9.1 (GH-23472) 2020-11-22 23:43:04 -05:00
Miss Islington (bot) 41d1ebb33e
Doc: fix typo in typing.Type docs (GH-23460)
(cherry picked from commit 5ef53a88f3)

Co-authored-by: John Belmonte <john@neggie.net>
2020-11-22 07:16:48 -08:00
Miss Islington (bot) 4f87126969
bpo-42391: Clarify documentation of TestCase.assertIs (GH-23348)
Removing 'evaluate' makes it more consistent with other assertX entries.
(cherry picked from commit bd8c22e1fa)

Co-authored-by: Ram Rachum <ram@rachum.com>
2020-11-21 22:24:21 -08:00
Miss Islington (bot) 89d74d0acd
Clarify that Set._from_iterable is not required to be a classmethod. (GH-23272) (GH-23450) 2020-11-21 12:20:26 -08:00
Miss Islington (bot) 3b5b1c82a3
Fix wrong availability for signal.SIGCHLD (GH-23285) (#23425)
I believe this is a mistake. SIGCHLD is only available on Unix systems, not Windows.
(cherry picked from commit 4c24b08cd3)

Co-authored-by: Zhang Maiyun <myzhang1029@hotmail.com>

Co-authored-by: Zhang Maiyun <myzhang1029@hotmail.com>
2020-11-21 13:22:46 +02:00