Wei-Hsiang (Matt) Wang
d47d7e1124
[3.12] gh-123517: Remove unnecessary :meth: parentheses (gh-123518) (GH-123576)
2024-09-02 16:02:39 +02:00
Serhiy Storchaka
39dea212f4
[3.12] gh-121905: Consistently use "floating-point" instead of "floating point" (GH-121907) (GH-122013)
...
(cherry picked from commit 1a0c7b9ba4
2024-07-19 09:08:33 +00:00
Miss Islington (bot)
20d145512a
[3.12] gh-120452: improve documentation about private name mangling (GH-120451) ( #121716 )
...
gh-120452: improve documentation about private name mangling (GH-120451)
(cherry picked from commit f4d6e45c1e
2024-07-13 15:11:33 +00:00
Miss Islington (bot)
b93386e1c4
[3.12] gh-114104: clarify asynchronous comprehension docs to match runtime behavior (GH-121175) ( #121235 )
...
gh-114104: clarify asynchronous comprehension docs to match runtime behavior (GH-121175)
(cherry picked from commit 91313afdb3
2024-07-01 16:41:18 +00:00
Miss Islington (bot)
21a953613c
[3.12] doc: Mention the missing reflected special methods for all binary operations (GH-119931) ( #120064 )
...
doc: Mention the missing reflected special methods for all binary operations (GH-119931)
(cherry picked from commit bf5e1065f4
2024-06-29 12:12:46 +05:30
Miss Islington (bot)
240e5f613b
[3.12] Docs: mark up NotImplemented using the :data: role throughout the docs (GH-116135) ( #116147 )
...
(cherry picked from commit dbe44f150c
2024-02-29 20:53:51 +00:00
Miss Islington (bot)
b3d01fc56d
[3.12] Clarify one-item tuple (GH-114745) ( #114757 )
...
A 'single tuple' means 'one tuple, of whatever length.
Remove the unneeded and slightly distracting parenthetical 'singleton' comment.
(cherry picked from commit a1332a99cf
2024-01-30 18:50:28 +00:00
Miss Islington (bot)
f9979212f8
[3.12] gh-101100: Fix Sphinx warnings in reference/expressions.rst (GH-114194) ( #114436 )
...
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2024-01-22 18:50:20 +02:00
Miss Islington (bot)
74a6b7f639
[3.12] gh-114070: fix token reference warnings in expressions.rst (GH-114169) ( #114192 )
...
Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>
2024-01-17 16:46:02 +00:00
Miss Islington (bot)
b478c5e50c
[3.12] gh-112331: Fix reference manual description of attribute lookup mechanics (gh-112375) ( #112412 )
2023-11-25 22:26:31 +00:00
Miss Islington (bot)
3b7e308a24
[3.12] gh-111944: Add assignment expression parentheses requirements (GH-111977) ( #112010 )
...
Augment the list of places where parentheses are
required around assignnment statements. In particular,
'a := 0' and 'a = b := 1' are syntax errors.
(cherry picked from commit 9a2f25d374
2023-11-13 00:17:54 +00:00
Miss Islington (bot)
cdcab408a0
[3.12] GH-101100: Fix reference warnings for `__getitem__` (GH-110118) ( #111073 )
...
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2023-10-19 18:33:03 +03:00
Miss Islington (bot)
dbbe0eebf0
[3.12] gh-110631: Fix reST indentation in Doc/reference (GH-110708) ( #110740 )
...
gh-110631: Fix reST indentation in `Doc/reference` (GH-110708)
Fix wrong indentation in the Doc/reference dir.
(cherry picked from commit 41d8ec5a1b
2023-10-11 23:13:21 +02:00
Serhiy Storchaka
d514e1439f
[3.12] gh-101100: Sphinx warnings: pick the low hanging fruits (GH-107386) (GH-107419)
...
(cherry picked from commit f2d07d3289
2023-07-29 09:16:27 +03:00
Miss Islington (bot)
5e856049b1
[3.12] Replace the esoteric term 'datum' when describing dict comprehensions (GH-106119) ( #106348 )
...
Replace the esoteric term 'datum' when describing dict comprehensions (GH-106119)
(cherry picked from commit 987b712b4a
2023-07-03 03:23:27 +00:00
Adam Turner
3e7995ca11
GH-97950: Use new-style index directive ('exception') ( #104160 )
2023-05-04 13:30:24 +03:00
Adam Turner
6ab463684b
GH-97950: Use new-style index directive ('object') ( #104158 )
...
* Uncomment object removal in pairindextypes
* Use new-style index directive ('object') - C API
* Use new-style index directive ('object') - Library
* Use new-style index directive ('object') - Reference
* Use new-style index directive ('object') - Tutorial
2023-05-04 13:04:41 +03:00
Adam Turner
b0ce2db118
GH-97950: Use new-style index directive ('operator') ( #104156 )
2023-05-04 12:03:11 +03:00
Adam Turner
33ca322c50
GH-97950: Use new-style index directive ('keyword') ( #104153 )
...
* Uncomment keyword removal in pairindextypes
* Use new-style index directive ('keyword') - Reference
2023-05-04 10:44:12 +02:00
Kumar Aditya
7feb6d2f85
fix grammer -> grammar typo in expressions.rst (GH-100683)
...
Automerge-Triggered-By: GH:AlexWaygood
2023-01-02 03:49:06 -08:00
ram vikram singh
1aab269d4a
gh-100201: Document behavior with a bare yield statement ( #100416 )
...
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
2023-01-01 21:06:13 +05:30
Gerardwx
d578aaea62
Python documents state elsewhere that a comma is not an operator, so … (GH-98736)
...
…calling it an operator here is confusing. See https://docs.python.org/3/reference/lexical_analysis.html#operators and https://docs.python.org/3/faq/programming.html#id22 .
2022-10-26 23:33:42 -07:00
Hugo van Kemenade
296313002f
gh-97913 Docs: Add walrus operator to the index ( #97921 )
...
* Add walrus operator to the index
* Add named expression to the index
Co-authored-by: Mariatta Wijaya <Mariatta@users.noreply.github.com>
* Fix indentation and add missing newline
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: Mariatta Wijaya <Mariatta@users.noreply.github.com>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
2022-10-08 08:54:16 +02:00
Hugo van Kemenade
fa2d43e518
Docs: Fix backtick errors found by sphinx-lint ( #97998 )
...
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
2022-10-06 18:01:30 -07:00
Terry Jan Reedy
2b5f1360ea
gh-86482: Document assignment expression need for ()s ( #23291 )
...
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2022-10-06 12:24:17 -07:00
Ofey Chan
83a3de4e06
gh-96348: Deprecate the 3-arg signature of coroutine.throw and generator.throw (GH-96428)
2022-09-30 09:43:02 +01:00
Andrew Kay
d582edf0be
Fix docs on conditional expression grouping (GH-96447)
2022-09-27 21:57:32 -05:00
Jeff Allen
9d432b4a18
gh-96397: Document that keywords in calls need not be identifiers ( #96393 )
...
This represents the official SC stance, see
https://github.com/python/steering-council/issues/142#issuecomment-1252172695
2022-09-22 11:10:15 -07:00
luzpaz
830513754d
gh-93675: Fix typos in Doc/ (GH-93676)
...
Closes #93675
2022-06-21 21:10:45 +02:00
Zackery Spytz
fb082c2fc5
bpo-45393: help() on operator precedence has misleading entries (GH-31246)
...
Fix the formatting for "await x" and "not x" in the operator
precedence table.
2022-05-19 17:05:04 +02:00
Dave Goncalves
8be7c2bc5a
bpo-14911: Corrected generator.throw() documentation (GH-32207)
...
Co-authored-by: Andrew Svetlov <andrew.svetlov@gmail.com>
2022-03-31 16:56:48 +03:00
Alex Waygood
50731297a9
bpo-45680: Improve docs on subscriptions w.r.t. GenericAlias objects (GH-29479)
2022-03-07 19:49:28 -08:00
Jacob Walls
273cb8e757
bpo-24650: Use full term "generator function" in yield expressions docs (GH-24663)
2022-01-07 18:39:40 +00:00
Arthur Milchior
32959108f9
bpo-45640: [docs] Tokens are now clickable (GH-29260)
...
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2021-11-18 17:06:38 +01:00
Ethan Furman
6ecead106a
[doc] minor fixes to expressions.rst (GH-29444)
2021-11-06 10:26:43 -07:00
Tim Peters
51ed2c56a1
bpo-45530: speed listobject.c's unsafe_tuple_compare() (GH-29076)
...
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>
2021-10-24 22:27:24 -05:00
Objectivitix
806e25fd31
bpo-45003: Change __div__ to __truediv__ in py3 language reference. (GH-27951)
2021-08-26 08:49:02 +03:00
andrei kulakov
4bd9caafb6
bpo-41911: Update docs for various expressions (GH-27470)
...
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2021-07-30 18:52:44 +02:00
Serhiy Storchaka
054e9c84ac
bpo-33346: Allow async comprehensions inside implicit async comprehensions (GH-6766)
...
Co-authored-by: Pablo Galindo <pablogsal@gmail.com>
2021-07-13 22:27:50 +01:00
Zackery Spytz
7d2b83e9f0
bpo-43990: Fix the footnote ordering in the operator precedence docs (GH-25805)
...
Footnotes 5 and 6 were in the wrong order.
2021-05-02 10:29:15 -07:00
Ammar Askar
68ba0c67ca
bpo-43837: Reverse order of precedence table to show tightly binding operators first (GH-25469)
2021-04-19 08:22:03 -07:00
Saiyang Gou
0fdf11e8e9
bpo-43755: Update docs to reflect that lambda is not allowed in comp_if since 3.9 (GH-25231)
2021-04-06 23:15:37 +01:00
Terry Jan Reedy
2f9ef514fb
bpo-27646: Say that 'yield from' expression can be any iterable (GH-24595)
...
Previously, the doc at least strongly implied that it had to be an iterator.
2021-02-20 21:33:25 -05:00
Ken Jin
2edaf6a4fb
bpo-8264: Document hasattr and getattr behavior for private attributes (GH-23513)
...
Clarify ``getattr`` and ``setattr`` requirements for accessing name-mangled attributes
Co-Authored-By: Catalin Iacob <iacobcatalin@gmail.com>
2021-02-02 13:06:57 -08:00
Joongi Kim
6e8dcdaaa4
bpo-41229: Update docs for explicit aclose()-required cases and add contextlib.aclosing() method (GH-21545)
...
This is a PR to:
* Add `contextlib.aclosing` which ia analogous to `contextlib.closing` but for async-generators with an explicit test case for [bpo-41229]()
* Update the docs to describe when we need explicit `aclose()` invocation.
which are motivated by the following issues, articles, and examples:
* [bpo-41229]()
* https://github.com/njsmith/async_generator
* https://vorpus.org/blog/some-thoughts-on-asynchronous-api-design-in-a-post-asyncawait-world/#cleanup-in-generators-and-async-generators
* https://www.python.org/dev/peps/pep-0533/
* ef7bf0cea7/src/aiotools/context.py (L152)https://www.python.org/dev/peps/pep-0533/ ), its acceptance (`__aiterclose__()`) would make this little addition of `contextlib.aclosing()` unnecessary for most use cases, but until then this could serve as a good counterpart and analogy to `contextlib.closing()`. The same applies for `contextlib.closing` with `__iterclose__()`.
Also, still there are other use cases, e.g., when working with non-generator objects with `aclose()` methods.
2020-11-02 00:02:48 -08:00
kj
9129af6050
bpo-42198: Link to GenericAlias in typing and expressions (GH-23030)
...
Follow up to 7cdf30fff34173320920
2020-10-29 21:01:17 -07:00
kj
7cdf30fff3
bpo-42010: [docs] Clarify subscription of types (GH-22822)
2020-10-20 16:38:08 -07:00
Florian Dahlitz
2d55aa9e37
bpo-29981: Add examples and update index for set, dict, and generator comprehensions'(GH-20272)
...
Co-authored-by: Rémi Lapeyre <remi.lapeyre@henki.fr>
2020-10-20 17:27:07 -04:00
Victor Stinner
8af239eacf
bpo-41762: Fix usage of productionlist markup in the doc (GH-22281)
...
Use an unique identifier for the different grammars documented using
the Sphinx productionlist markup.
productionlist markups of the same grammar, like "expressions" or
"compound statements", use the same identifier "python-grammar".
2020-09-18 09:10:15 +02:00
Shankar Jha
f117cef25b
bpo-39868: Add documentation for Assignment Expressions (walrus, PEP 572) ( #18851 )
2020-07-25 16:33:48 -07:00
