summaryrefslogtreecommitdiffstats
path: root/Doc/reference
Commit message (Collapse)AuthorAgeFilesLines
* bpo-45393: help() on operator precedence has misleading entries (GH-31246) ↵Miss Islington (bot)2022-05-191-2/+2
| | | | | | | (GH-92967) (cherry picked from commit fb082c2fc5a925085b179e63ca10b7f60b356d2f) Co-authored-by: Zackery Spytz <zspytz@gmail.com>
* gh-80143: Add clarification for escape characters (GH-92292) (GH-92630)Miss Islington (bot)2022-05-161-3/+7
| | | | | (cherry picked from commit 549567c6e70da4846c105a18a1a89e7dd09680d7) Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>
* gh-87304: Improve comments in language reference for imports (GH-92164)Miss Islington (bot)2022-05-031-3/+3
| | | | | (cherry picked from commit ee2205b208389611e8a278ac1bc74b34f4994fd2) Co-authored-by: Robert Yang <35813883+robert861212@users.noreply.github.com>
* gh-89885: Improve import example in language reference (GH-91523) (#91649)Miss Islington (bot)2022-04-171-6/+4
| | | | | | Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com> (cherry picked from commit d5a69571f586080af4c29671c47f9c4bc671af7f) Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>
* Language reference: Remove duplicated text about iterable unpacking (GH-25212)Miss Islington (bot)2022-04-031-3/+1
| | | | | (cherry picked from commit 4f5d56f8f33196f5ed8ffad0ab2f012afda2f9b3) Co-authored-by: Jiashuo Li <4003950+jiasli@users.noreply.github.com>
* bpo-24563: Link encoding names to encoding declarations (GH-32274)Miss Islington (bot)2022-04-031-3/+2
| | | | | (cherry picked from commit 01be5d6446abbdd95d0c18bd19a58a62b05568d8) Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
* bpo-14911: Corrected generator.throw() documentation (GH-32207)Miss Islington (bot)2022-03-312-3/+17
| | | | | | Co-authored-by: Andrew Svetlov <andrew.svetlov@gmail.com> (cherry picked from commit 8be7c2bc5ad5e295f0f855bb31db412eef2c7c92) Co-authored-by: Dave Goncalves <davegoncalves@gmail.com>
* bpo-12029: [doc] clarify that except does not match virtual subclasses of ↵Irit Katriel2022-03-212-5/+7
| | | | | the specified exception type (GH-32027) (GH-32035) (cherry picked from commit 45833b50f0ccf2abb01304c900afee05b6d01b9e)
* bpo-46013: Fix confusing kerning on period in docs (GH-29989) (GH-32006)Miss Islington (bot)2022-03-201-1/+1
| | | | | | | (cherry picked from commit 3af68fc77c528d4e7749046cf6e41fd79902e6e6) Co-authored-by: jmcb <joel.mcbride1@live.com> Co-authored-by: jmcb <joel.mcbride1@live.com>
* Removed confusing reference to sys (GH-31638)Miss Islington (bot)2022-03-081-3/+3
| | | | | (cherry picked from commit 28f84c72b6cee145f9c00e9b999656e9a2517e49) Co-authored-by: David Gilbertson <gilbertson.david@gmail.com>
* Removed ambiguity in __init_subclass__ docs (GH-31540)Miss Islington (bot)2022-03-081-1/+1
| | | | | (cherry picked from commit ab014978aef303ac60465c9010505d798dc34df8) Co-authored-by: David Gilbertson <gilbertson.david@gmail.com>
* bpo-45680: Improve docs on subscriptions w.r.t. `GenericAlias` objects ↵Miss Islington (bot)2022-03-081-20/+30
| | | | | | | (GH-29479) (cherry picked from commit 50731297a9b6d57eec3b3f89522785b23f7b3e71) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* bpo-23556: [doc] Fix inaccuracy in documentation for raise without args. ↵Miss Islington (bot)2022-01-271-8/+10
| | | | | | | Improve tests for context in nested except handlers. (GH-29236) (cherry picked from commit 08c0ed2d9c0d01ad1a5adc0787bc75e4e90cbb85) Co-authored-by: Kinshuk Dua <kinshukdua@gmail.com>
* bpo-24650: Use full term "generator function" in yield expressions docs ↵Miss Islington (bot)2022-01-071-2/+2
| | | | | | | (GH-24663) (cherry picked from commit 273cb8e7577d143830404f6779946a0bedb58758) Co-authored-by: Jacob Walls <jacobtylerwalls@gmail.com>
* bpo-46076: Improve documentation for per-attribute docstrings with ↵Miss Islington (bot)2021-12-191-3/+6
| | | | `__slots__` (GH-30109) (GH-30207)
* [3.9] bpo-45840: Improve cross-references in the data model documentation ↵Alex Waygood2021-12-131-53/+75
| | | | | (GH-29633) (GH-30081) Backport of GH-29633 to the 3.9 branch
* [doc] Clarify MRO precedence in descriptor super binding section (GH-29539) ↵Miss Islington (bot)2021-12-111-1/+1
| | | | | | | | | (GH-29670) A similar sentence is present in the 'Invocation from super' section of the descriptor HOWTO, where it is already correct. (cherry picked from commit ee49484c0f0d0d79e8fc40835da10b78f89ae503) Co-authored-by: Jouke Witteveen <j.witteveen@gmail.com>
* [3.9] [doc] bpo-45680: Disambiguate ``__getitem__`` and ↵Miss Islington (bot)2021-11-181-18/+146
| | | | | | | | | | | | | | | | | ``__class_getitem__`` in the data model (GH-29389) (GH-29619) The documentation explaining Python's data model does not adequately explain the differences between ``__getitem__`` and ``__class_getitem__``, nor does it explain when each is called. There is an attempt at explaining ``__class_getitem__`` in the documentation for ``GenericAlias`` objects, but this does not give sufficient clarity into how the method works. Moreover, it is the wrong place for that information to be found; the explanation of ``__class_getitem__`` should be in the documentation explaining the data model. This PR has been split off from GH-29335. (cherry picked from commit 31b3a70edb1216bdc8fab3b2eafd8ddb00487f41) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com> Co-authored-by: Łukasz Langa <lukasz@langa.pl>
* bpo-45583: Correct datamodel documentation of int() (GH-29182) (GH-29286)Miss Islington (bot)2021-10-281-2/+2
| | | | | | | It should be noted that this part of the documentation is redundant with function.rst's documentation of int. This one was correctly updated with Python 3.8. (cherry picked from commit d9c1868c25ec6466e8d8ae21fe9315a8a03836ab) Co-authored-by: Arthur Milchior <arthur@milchior.fr>
* [3.9]bpo-45463: Clarify that global statements allows multiple names ↵Miss Islington (bot)2021-10-161-4/+4
| | | | | | | | | | | | | | (GH-28851) (GH-28990) The global statement allows specifying a list of identifiers (https://docs.python.org/3/reference/simple_stmts.htmlGH-the-global-statement). The "Execution model" chapter described the global statement as if it only allowed one single name. Pluralize "name" in the appropriate places. (cherry picked from commit 4ecd119b007cb766b8bede2dc78b70d29cd932dd) Co-authored-by: Luca Chiodini <luca@chiodini.org> Co-authored-by: Luca Chiodini <luca@chiodini.org>
* [3.9] [docs] Improve the markup of powers (GH-28598) (GH-28608)Łukasz Langa2021-09-281-1/+1
| | | | | (cherry picked from commit 4f05f15d7b25ef8b690cb94fdc4c8cb5521a4e27) Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
* [3.9] [codemod] Fix non-matching bracket pairs (GH-28473) (GH-28512)Łukasz Langa2021-09-221-1/+0
| | | | | | | | Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu> Co-authored-by: Serhiy Storchaka <storchaka@gmail.com> Co-authored-by: Łukasz Langa <lukasz@langa.pl>. (cherry picked from commit 8f943ca25732d548cf9f0b0393ba8d582fb93e29) Co-authored-by: Mohamad Mansour <66031317+mohamadmansourX@users.noreply.github.com>
* bpo-45104: Clarify when __init__ is called (GH-28210) (GH-28212)Miss Islington (bot)2021-09-071-1/+1
| | | | | (cherry picked from commit fa15df77f02ba4a66ba0b71989381a426038be01) Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
* bpo-45003: Change __div__ to __truediv__ in py3 language reference. ↵Miss Islington (bot)2021-08-261-1/+1
| | | | | | | | (GH-27951) (GH-27962) (cherry picked from commit 806e25fd3173a80021e6df87b81263b5f6056f38) Co-authored-by: Objectivitix <79152594+Objectivitix@users.noreply.github.com>
* bpo-41911: Update docs for various expressions (GH-27470) (GH-27491)Miss Islington (bot)2021-07-301-7/+34
| | | | | | Co-authored-by: Łukasz Langa <lukasz@langa.pl> (cherry picked from commit 4bd9caafb64589288e5171087070bde726178c58) Co-authored-by: andrei kulakov <andrei.avk@gmail.com>
* bpo-8264: Document hasattr and getattr behavior for private attributes ↵Miss Islington (bot)2021-05-221-0/+2
| | | | | | | | | | (GH-23513) (GH-26238) Clarify ``getattr`` and ``setattr`` requirements for accessing name-mangled attributes Co-Authored-By: Catalin Iacob <iacobcatalin@gmail.com> (cherry picked from commit 2edaf6a4fb7e20324dde1423232f07211347f092) Co-authored-by: Ken Jin <28750310+Fidget-Spinner@users.noreply.github.com>
* Update doc as relative import can be used with star import (GH-25667) (GH-26122)Miss Islington (bot)2021-05-141-1/+1
| | | | | | | (cherry picked from commit 3d4b5f1019123a7d74801500eb18ec8fa12136bc) Co-authored-by: Saiyang Gou <gousaiyang@163.com> Co-authored-by: Saiyang Gou <gousaiyang@163.com>
* bpo-42800: Add audit events for f_code and tb_frame (GH-24182)Steve Dower2021-05-031-0/+6
| | | | | | | | Accessing the following attributes will now fire PEP 578 style audit hooks as (object.__getattr__, obj, name): * PyTracebackObject: tb_frame * PyFrameObject: f_code * PyGenObject: gi_code, gi_frame * PyCoroObject: cr_code, cr_frame * PyAsyncGenObject: ag_code, ag_frame
* bpo-43990: Fix the footnote ordering in the operator precedence docs ↵Miss Islington (bot)2021-05-021-3/+3
| | | | (GH-25805) (GH-25819)
* Fix a typo in datamodel reference document (GH-24930)Miss Islington (bot)2021-04-251-1/+1
| | | | | (cherry picked from commit a1a5e3c4c83c3e3fe24c96ae22dfdedc7e23a1bb) Co-authored-by: Géry Ogam <gery.ogam@gmail.com>
* bpo-43837: Reverse order of precedence table to show tightly binding ↵Miss Islington (bot)2021-04-191-29/+29
| | | | operators first (GH-25469) (GH-25472)
* Fix description of behaviour of an exception class in 'from' clause ↵Miss Islington (bot)2021-04-111-4/+7
| | | | | | | | | (GH-24303) (GH-25341) (cherry picked from commit 79650d0118b0a8861428b9dd063089de405cf137) Co-authored-by: Mark Dickinson <mdickinson@enthought.com> Co-authored-by: Mark Dickinson <mdickinson@enthought.com>
* [3.9] bpo-39702: Remove dotted_name from decorator documentation (GH-25234) ↵Miss Islington (bot)2021-04-081-1/+0
| | | | | | | | | | (GH-25290) (cherry picked from commit 1e051a21b7106a93c30b74aad7e1f40d6c0c477b) Co-authored-by: Saiyang Gou <gousaiyang@163.com> Automerge-Triggered-By: GH:brandtbucher
* [3.9] bpo-36540: Improve doc of function definition regarding ↵Saiyang Gou2021-04-071-2/+8
| | | | | | | positional-only arguments (GH-25235) (GH-25259) (cherry picked from commit 58d72cab89cf9652acc0bf0007aa20b2bcc98499) Co-authored-by: Saiyang Gou <gousaiyang@163.com>
* bpo-43755: Update docs to reflect that lambda is not allowed in `comp_if` ↵Miss Islington (bot)2021-04-071-3/+1
| | | | since 3.9 (GH-25231) (GH-25233)
* bpo-27646: Say that 'yield from' expression can be any iterable (GH-24595)Miss Islington (bot)2021-02-211-2/+2
| | | | | | 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 <tjreedy@udel.edu>
* [3.9] [doc] Fix a few margins due to bad markup (GH-23619). (GH-23859)Andre Delfino2020-12-221-1/+0
| | | | | (cherry picked from commit 96a09df64483b70c4215c7025a19b9d2f1636c55) Co-authored-by: Andre Delfino <adelfino@gmail.com>
* bpo-42669: Document that `except` rejects nested tuples (GH-23822) (GH-23870)Miss Islington (bot)2020-12-201-1/+2
| | | | | | | | | | | | | | | | | | 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 <cjwatson@debian.org> Co-authored-by: Colin Watson <cjwatson@debian.org>
* [3.9] bpo-41879: Doc: Fix description of async for statement (GH-23548) ↵Miss Islington (bot)2020-12-131-4/+4
| | | | | | | | | (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 4b8cdfcb22fbeaab9d954cb693a7fb3362a382b6) Co-authored-by: Nick Gaya <nicholasgaya+github@gmail.com>
* bpo-42198: Link to GenericAlias in typing and expressions (GH-23030)Miss Skeleton (bot)2020-10-301-7/+1
| | | | | | Follow up to 7cdf30fff39ea97f403b5472096349998d190e30 and 4173320920706b49a004bdddd8d7108e8984e3fc. This addresses the point "1. Update links in typing, subscription and union to point to GenericAlias." in the bpo for this PR. (cherry picked from commit 9129af6050b747f288baa9d4e7d43031647ed222) Co-authored-by: kj <28750310+Fidget-Spinner@users.noreply.github.com>
* bpo-6761: Enhance __call__ documentation (GH-7987)Miss Skeleton (bot)2020-10-271-1/+1
| | | | | (cherry picked from commit 95f710c55714153f0c8cce48f8215bb3d866ac1d) Co-authored-by: Andre Delfino <adelfino@gmail.com>
* bpo-29981: Add examples and update index for set, dict, and generator ↵Miss Skeleton (bot)2020-10-251-0/+4
| | | | | | | | comprehensions'(GH-20272) Co-authored-by: Rémi Lapeyre <remi.lapeyre@henki.fr> (cherry picked from commit 2d55aa9e37c9c84f4f6a8135d0326da0bcd8f38b) Co-authored-by: Florian Dahlitz <f2dahlitz@freenet.de>
* bpo-41910: specify the default implementations of object.__eq__ and ↵Miss Skeleton (bot)2020-10-221-6/+8
| | | | | | | object.__ne__ (GH-22874) (#22876) See Objects/typeobject.c:object_richcompare() for the implementation of this in CPython. Co-authored-by: Brett Cannon <brett@python.org>
* bpo-35181: Correct importlib documentation for some module attributes (GH-15190)Miss Skeleton (bot)2020-10-211-15/+3
| | | | | | | | | | | | | | | | | | @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 <gery.ogam@gmail.com>
* Fix bpo-39416: Change "Numeric" to lower case; an english word, not a class ↵Miss Skeleton (bot)2020-10-211-1/+1
| | | | | | | | | | | | | | | | | name (GH-22867) This is a trivial fix to [bpo-39416](), which didn't come up until it was already committed ``` Change "Numeric" to "numeric". I believe this is trivial enough to not need an issue or a NEWS entry, although I'm unclear on what branches the original pull request received backports. ``` Automerge-Triggered-By: GH:merwok (cherry picked from commit f8b1ccd63c94bcde1c15d56d24add89861b6ceee) Co-authored-by: kpinc <kop@karlpinc.com>
* [3.9] bpo-39416: Document some restrictions on the default string ↵Miss Skeleton (bot)2020-10-211-0/+18
| | | | | | | | | | | | | | | | | | | | | | representations of numeric classes (GH-18111) (GH-22860) [[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 <kop@karlpinc.com> Automerge-Triggered-By: GH:merwok
* Doc: Fix a typo/error in the docs for cached bytecode (GH-22445)Miss Skeleton (bot)2020-10-211-1/+1
| | | | | (cherry picked from commit cb115e36e1aba04b90b0ecac6f043e60064ac65b) Co-authored-by: Zackery Spytz <zspytz@gmail.com>
* Doc: Remove old Python version from future stmt (GH-21802)Miss Skeleton (bot)2020-10-211-2/+2
| | | | | (cherry picked from commit eba109a28f48b20b05f08abbe6604eebb07788f9) Co-authored-by: Andre Delfino <adelfino@gmail.com>
* [3.9] bpo-42010: [docs] Clarify subscription of types (GH-22822) (GH-22840)Miss Skeleton (bot)2020-10-201-2/+13
| | | | | | | | (cherry picked from commit 7cdf30fff39ea97f403b5472096349998d190e30) Co-authored-by: kj <28750310+Fidget-Spinner@users.noreply.github.com> Automerge-Triggered-By: GH:gvanrossum
* bpo-41192: Add documentation of undocumented audit events (GH-22831)Miss Skeleton (bot)2020-10-201-0/+18
| | | | (cherry picked from commit 3f7e990fd49dbabc1dde41ce58c1bdda9f56ead7)
generated by cgit v0.12 at 2026-01-01 11:30:17 (GMT)