summaryrefslogtreecommitdiffstats
path: root/Doc/reference
Commit message (Collapse)AuthorAgeFilesLines
* bpo-45393: help() on operator precedence has misleading entries (GH-31246)Zackery Spytz2022-05-191-2/+2
| | | | Fix the formatting for "await x" and "not x" in the operator precedence table.
* gh-80143: Add clarification for escape characters (#92292)slateny2022-05-101-3/+7
|
* gh-87304: Improve comments in language reference for imports (#92164)Robert Yang2022-05-031-3/+3
|
* gh-81548: Deprecate octal escape sequences with value larger than 0o377 ↵Serhiy Storchaka2022-04-301-0/+5
| | | | (GH-91668)
* bpo-21761: Clarify __file__/__cached__ in import reference (GH-31565)slateny2022-04-261-4/+5
| | | Automerge-Triggered-By: GH:brettcannon
* gh-89885: Improve import example in language reference (#91523)slateny2022-04-171-6/+4
| | | Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* Language reference: Remove duplicated text about iterable unpacking (GH-25212)Jiashuo Li2022-04-031-3/+1
|
* bpo-46033: Clarify for-statement execution (GH-30025)Michał D2022-04-031-11/+8
| | | | Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu> Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* bpo-24563: Link encoding names to encoding declarations (GH-32274)Terry Jan Reedy2022-04-031-3/+2
|
* bpo-14911: Corrected generator.throw() documentation (GH-32207)Dave Goncalves2022-03-312-3/+17
| | | Co-authored-by: Andrew Svetlov <andrew.svetlov@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)
* bpo-46013: Fix confusing kerning on period in docs (GH-29989)jmcb2022-03-201-1/+1
|
* Removed confusing reference to sys (GH-31638)David Gilbertson2022-03-081-3/+3
|
* Removed ambiguity in __init_subclass__ docs (GH-31540)David Gilbertson2022-03-081-1/+1
|
* bpo-45680: Improve docs on subscriptions w.r.t. `GenericAlias` objects ↵Alex Waygood2022-03-081-20/+30
| | | | (GH-29479)
* bpo-46725: Document starred expressions in for statements (GH-31481)Pablo Galindo Salgado2022-02-221-8/+13
| | | Automerge-Triggered-By: GH:pablogsal
* bpo-44977: Deprecate delegation of int to __trunc__ (GH-31031)Zackery Spytz2022-02-031-0/+3
| | | | | Calling int(a) when type(a) implements __trunc__ but not __int__ or __index__ now raises a DeprecationWarning.
* bpo-23556: [doc] Fix inaccuracy in documentation for raise without args. ↵Kinshuk Dua2022-01-271-8/+10
| | | | Improve tests for context in nested except handlers. (GH-29236)
* [doc]: Spotted errors while working on rstlint. (GH-30879)Julien Palard2022-01-271-1/+1
| | | | Also ignored some `make suspicious` false positives while assuring true positives were properly seen by rstlint.
* bpo-24650: Use full term "generator function" in yield expressions docs ↵Jacob Walls2022-01-071-2/+2
| | | | (GH-24663)
* bpo-45292: [PEP-654] exception groups and except* documentation (GH-30158)Irit Katriel2022-01-061-1/+47
|
* bpo-46095: Improve SeqIter documentation. (GH-30316)Raymond Hettinger2022-01-011-21/+0
|
* bpo-46076: Improve documentation for per-attribute docstrings with ↵Alex Waygood2021-12-191-3/+6
| | | | `__slots__` (GH-30109)
* Fix some false positives of documentation syntax problemsPablo Galindo2021-12-081-1/+1
|
* bpo-20751: Match variable name to the example. (GH-29980)Raymond Hettinger2021-12-081-4/+8
|
* bpo-45840: Improve cross-references in the data model documentation (GH-29633)Alex Waygood2021-12-051-54/+76
|
* bpo-20751: Replace method example with attribute example, matching the ↵Raymond Hettinger2021-12-041-4/+32
| | | | descriptor howto (GH-29909)
* bpo-45711: Change exc_info related APIs to derive type and traceback from ↵Irit Katriel2021-11-301-0/+6
| | | | the exception instance (GH-29780)
* bpo-45619: documentation of execution model: clarify and update binding ↵Arthur Milchior2021-11-261-9/+19
| | | | | | | | | | | summary (#29232) This does two changes that are quite related. 0. it add that variable binding can occur in pattern matching, an update of 3.10 which seems to have been omitted from the list of bindings 1. Given how long the sentence already was, with even subcases in the middle of the sentence, the commit breaks the sentence into an actual list.
* [doc] Clarify MRO precedence in descriptor super binding section (GH-29539)Jouke Witteveen2021-11-201-1/+1
| | | | A similar sentence is present in the 'Invocation from super' section of the descriptor HOWTO, where it is already correct.
* bpo-45250: fix docs regarding `__iter__` and iterators being inconsistently ↵Brett Cannon2021-11-201-14/+12
| | | | | required by CPython (GH-29170) It is now considered a historical accident that e.g. `for` loops and the `iter()` built-in function do not require the iterators they work with to define `__iter__`, only `__next__`.
* bpo-45640: [docs] Tokens are now clickable (GH-29260)Arthur Milchior2021-11-183-53/+53
| | | Co-authored-by: Łukasz Langa <lukasz@langa.pl>
* [doc] bpo-45680: Disambiguate ``__getitem__`` and ``__class_getitem__`` in ↵Alex Waygood2021-11-181-18/+146
| | | | | | | | | | | | | | the data model (GH-29389) 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.
* [doc] minor fixes to expressions.rst (GH-29444)Ethan Furman2021-11-061-3/+3
|
* bpo-45583: Correct datamodel documentation of int() (GH-29182)Arthur Milchior2021-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.
* bpo-45530: speed listobject.c's unsafe_tuple_compare() (GH-29076)Tim Peters2021-10-251-0/+2
| | | | | | | | Keep track of whether unsafe_tuple_compare() calls are resolved by the very first tuple elements, and adjust strategy accordingly. This can significantly cut the number of calls made to the full-blown PyObject_RichCompareBool(), and especially when duplicates are rare. Co-authored-by: Łukasz Langa <lukasz@langa.pl>
* bpo-45463: Clarify that global statements allows multiple names (GH-28851)Luca Chiodini2021-10-161-4/+4
| | | | | | | The global statement allows specifying a list of identifiers (https://docs.python.org/3/reference/simple_stmts.html#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.
* [docs] lexical_analysis: Expand the text on ``_`` (GH-28903)Petr Viktorin2021-10-131-4/+16
| | | | | | | | | | | | | Also: * Expand the discussion into its own entry. (Even before this, text on ``_`` was longet than the text on ``_*``.) * Briefly note the other common convention for `_`: naming unused variables. Co-authored-by: Brandt Bucher <brandtbucher@gmail.com> Co-authored-by: Ken Jin <28750310+Fidget-Spinner@users.noreply.github.com> Co-authored-by: Łukasz Langa <lukasz@langa.pl>
* Fix class pattern docs to refer to class patterns (GH-28849)Christophe Nanteuil2021-10-101-1/+1
|
* [doc] Fix typos found using codespell (GH-28744)Christian Clauss2021-10-051-1/+1
| | | Co-authored-by: Łukasz Langa <lukasz@langa.pl>
* bpo-45346: Keep docs consistent regarding true and false values (GH-28697)Raymond Hettinger2021-10-021-4/+4
|
* [docs] Improve the markup of powers (GH-28598)Serhiy Storchaka2021-09-281-1/+1
|
* [codemod] Fix non-matching bracket pairs (GH-28473)Mohamad Mansour2021-09-211-1/+1
| | | | | 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>
* bpo-45198: __set_name__ documentation not clear about its usage with ↵Raymond Hettinger2021-09-181-29/+34
| | | | non-descriptor classes (GH-28439)
* closes bpo-45190: Update Unicode data to version 14.0.0. (GH-28336)Benjamin Peterson2021-09-141-3/+3
|
* bpo-44964: Correct the note about the f_lasti field (GH-28208)Pablo Galindo Salgado2021-09-101-3/+2
|
* bpo-45104: Clarify when __init__ is called (GH-28210)Raymond Hettinger2021-09-071-1/+1
|
* bpo-44964: Add a note explaining the new semantics of f_last_i in frame ↵Pablo Galindo Salgado2021-09-071-2/+3
| | | | objects (GH-28200)
* bpo-45003: Change __div__ to __truediv__ in py3 language reference. (GH-27951)Objectivitix2021-08-261-1/+1
|
* bpo-39452: Rewrite and expand __main__.rst (#26883)Jack DeVries2021-08-241-0/+2
| | | | | | | Broadened scope of the document to explicitly discuss and differentiate between ``__main__.py`` in packages versus the ``__name__ == '__main__'`` expression (and the idioms that surround it), as well as ``import __main__``. Co-authored-by: Géry Ogam <gery.ogam@gmail.com> Co-authored-by: Éric Araujo <merwok@netwok.org> Co-authored-by: Łukasz Langa <lukasz@langa.pl>