Andre Delfino
eba109a28f
Doc: Remove old Python version from future stmt (GH-21802)
2020-10-21 14:45:13 +09: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
Saiyang Gou
3f7e990fd4
bpo-41192: Add documentation of undocumented audit events (GH-21308)
2020-10-20 15:23:15 -04:00
Andre Delfino
8adf8d1ec4
[doc] Remove mention of async and await as soft keywords (GH-22144)
2020-10-12 14:52:30 +01:00
Batuhan Taskaya
044a1048ca
bpo-38605: Make 'from __future__ import annotations' the default (GH-20434)
...
The hard part was making all the tests pass; there are some subtle issues here, because apparently the future import wasn't tested very thoroughly in previous Python versions.
For example, `inspect.signature()` returned type objects normally (except for forward references), but strings with the future import. We changed it to try and return type objects by calling `typing.get_type_hints()`, but fall back on returning strings if that function fails (which it may do if there are future references in the annotations that require passing in a specific namespace to resolve).
2020-10-06 13:03:02 -07:00
Brett Cannon
d02d824e05
bpo-41584: clarify when the reflected method of a binary arithemtic operator is called ( #22505 )
2020-10-05 09:42:21 -07: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
Andre Delfino
788b79fa7b
[doc] Remove superfluous comment about equal in f-strings (GH-22006)
...
Automerge-Triggered-By: @kushaldas
2020-09-09 23:33:13 -07:00
Victor Stinner
1abeda80f7
bpo-40204: Fix duplicated productionlist names in the doc (GH-21900)
...
Sphinx 3 disallows having more than one productionlist markup with
the same name. Simply remove names in this case, since names are not
shown anyway. For example, fix the Sphinx 3 warning:
Doc/reference/introduction.rst:96: duplicate token description
of *:name, other instance in reference/expressions
2020-08-17 08:41:42 +02:00
Victor Stinner
bb0b08540c
bpo-40204: Fix reference to terms in the doc (GH-21865)
...
Sphinx 3 requires to refer to terms with the exact case.
For example, fix the Sphinx 3 warning:
Doc/library/pkgutil.rst:71: WARNING: term Loader not found in case
sensitive match.made a reference to loader instead.
2020-08-14 12:20:05 +02:00
amaajemyfren
13efaec2e0
bpo-41045: Document debug feature of f-strings ('=') (GH-21509)
...
Co-Authored-By: Rishi <rishi93dev@gmail.com>
Automerge-Triggered-By: @gvanrossum
2020-07-27 15:31:02 -07:00
Pablo Galindo
72cabb2aa6
bpo-40939: Use the new grammar for the grammar specification documentation (GH-19969)
...
(We censor the heck out of actions and some other stuff using a custom "highlighter".)
Co-authored-by: Guido van Rossum <guido@python.org>
2020-07-27 11:20:36 -07:00
Shankar Jha
f117cef25b
bpo-39868: Add documentation for Assignment Expressions (walrus, PEP 572) ( #18851 )
2020-07-25 16:33:48 -07:00
Andre Delfino
b9f6ac9d46
Stick with the phrase "default parameter value" (GH-21590)
2020-07-22 20:58:19 -03:00
Géry Ogam
e2fb8a2c42
Update lexical_analysis.rst (GH-17508)
...
Use Sphinx role markup for `str.format`.
Automerge-Triggered-By: @csabella
2020-06-12 05:54:29 -07:00
Matteo Bertucci
af23f0d3cf
bpo-40439: Update broken link in lexical analysis docs (GH-20184)
...
Automerge-Triggered-By: @csabella
2020-05-22 18:12:09 -07:00
Heshy Roskes
ef33712baa
Fix typo in object.__format__ docs (GH-19504)
2020-04-25 21:57:09 -04:00
Mark Dickinson
810f68f128
Fix misinformation about NaN != NaN comparison (GH-19357)
2020-04-05 10:25:24 +01:00
Mathieu Dupuy
c49016e67c
fix comma location in various places (GH-19233)
2020-03-30 14:28:25 -07:00
Javad Mokhtari
5f9c131c09
bpo-40045: Make "dunder" method documentation easier to locate ( #19153 )
...
* issue 40045
* Update lexical_analysis.rst
Make "dunder" method documentation easier(GH-19153)
Co-authored-by: Joannah Nanjekye <33177550+nanjekyejoannah@users.noreply.github.com>
2020-03-27 16:02:51 -03:00
Lahfa Samy
59c644eaa7
bpo-39879: Update datamodel docs to include dict ordering (GH-19006)
...
Co-authored-by: furkanonder <furkantahaonder@gmail.com>
2020-03-26 09:54:04 -05:00
Benjamin Peterson
51796e5d26
Update some www.unicode.org URLs to use HTTPS. (GH-18912)
2020-03-10 21:10:59 -07:00
Benjamin Peterson
051b9d08d1
closes bpo-39926: Update Unicode to 13.0.0. (GH-18910)
2020-03-10 20:41:34 -07:00
Brandt Bucher
8f13053692
bpo-39702: Update the Language Reference (PEP 614) (GH-18802)
2020-03-07 10:23:49 -08:00
Caleb Donovick
e59334ebc9
bpo-17422: slightly more precise language (GH-18682)
2020-03-06 10:20:48 -08:00
Brandt Bucher
8bae21962b
bpo-39868: Update Language Reference for PEP 572. ( #18793 )
2020-03-05 21:19:22 -08:00
MojoVampire
469325c30e
bpo-35712: Make using NotImplemented in a boolean context issue a deprecation warning (GH-13195)
2020-03-03 20:50:17 +02:00
ananthan-123
fbe2e0bb8a
bpo-17422: Language reference should specify restrictions on class namespace ( #18559 )
...
The language reference now specifies restrictions on class namespaces. Adapted from a patch by Ethan Furman.
2020-02-22 09:56:01 -08:00
Serhiy Storchaka
f632736023
bpo-39545: Document changes in the support of await in f-strings. (GH-18456)
...
https://bugs.python.org/issue39545
2020-02-13 15:57:35 -08:00
Bonifacio de Oliveira
d47d0c8e9f
Improve grammar in the import system reference documentation (GH-18209)
...
Replaced the period with a comma.
Automerge-Triggered-By: @Mariatta
2020-01-29 18:23:50 -08:00
alclarks
7de617455e
bpo-15243: Document __prepare__ as classmethod (GH-17124)
2020-01-25 21:49:58 +03:00
Géry Ogam
1d1b97ae64
bpo-39048: Look up __aenter__ before __aexit__ in async with (GH-17609)
...
* Reorder the __aenter__ and __aexit__ checks for async with
* Add assertions for async with body being skipped
* Swap __aexit__ and __aenter__ loading in the documentation
2020-01-14 21:58:29 +10:00
HongWeipeng
abc0c4fa99
Fix the parameter list of object. _rpow_ (#GH-16477)
2020-01-05 17:20:29 -05:00
Géry Ogam
226e6e7d43
bpo-39037: Fix lookup order of magic methods in with statement documentation (GH-17608)
...
* __enter__ is now looked up before __exit__ to give a more intuitive error message
* add pseudo-code equivalent for the with statement
* fix pseudo-code for the async with statement to use a finally clause
* use SUITE rather than BLOCK for consistency with the language grammar
Patch by Géry Ogam.
2019-12-30 15:24:51 +10:00
Oleg Höfling
cbd0408b54
links in importlib.metadata.rst replaced with sphinx references (GH-17730)
...
The importlib.metadata documentation uses hardcoded links to internal
pages. This results in minor rendering issues. This change replaces
the hardcoded links with suitable Sphinx roles.
Signed-off-by: Oleg Höfling <oleg.hoefling@gmail.com>
2019-12-29 12:26:35 -05:00
Batuhan Taşkaya
d587272fe3
bpo-38316: Fix co_stacksize documentation (GH-16983)
2019-12-15 23:02:47 +01:00
Tal Einat
02519f75d1
bpo-38524: clarify example a bit and improve formatting (GH-17406)
2019-11-28 07:22:09 +02:00
Florian Dahlitz
1bddf890e5
bpo-38524: document implicit and explicit calling of descriptors' __set_name__ (GH-17364)
2019-11-27 10:46:40 +02:00
alclarks
4544e78ec4
bpo-25866: Minor cleanups to "sequence" in docs (GH-17177)
2019-11-17 14:00:43 -08:00
Shu
2d56af7a94
Fix minor typos. (GH-17095)
2019-11-12 19:12:11 -08:00
Shu
fc6b1bf869
Clarify amount of dots between package and subpackage (GH-17092)
2019-11-08 12:26:35 -08:00
Géry Ogam
4c155f738d
bpo-38336: Remove the __set__ method restriction on data descriptors for attribute lookup precedence (GH-16520)
2019-10-29 00:04:01 -07:00
Steve Dower
894e30ce0b
bpo-38434: Fixes some audit event documentation (GH-16932)
2019-10-26 13:02:30 -07:00
Julien Palard
a45b0efdea
Doc: Add -m reference in context of code execution (GH-16045)
2019-09-12 14:19:06 +01:00
Emily Morehouse
6357c95716
bpo-35224: Additional documentation for Assignment Expressions (GH-15935)
...
Add or update assignment expression documentation for:
- FAQ - Design
- Reference - Expressions
- Reference - Lexical Analysis
https://bugs.python.org/issue35224
Automerge-Triggered-By: @matrixise
2019-09-11 07:37:12 -07:00
Andre Delfino
dc26997109
bpo-33459: Fix "tuple displays" term in Expressions.rst (GH-6760)
...
https://bugs.python.org/issue33459
Automerge-Triggered-By: @matrixise
2019-09-11 06:16:11 -07:00
Steve Dower
a39a4c7439
bpo-37913: Link to NotImplemented from new docs (GH-15860)
2019-09-10 15:25:12 +01:00
Jeroen Demeyer
009ef2955d
bpo-37913: document that __length_hint__ can return NotImplemented (GH-15383)
2019-09-10 15:01:13 +01:00
Raymond Hettinger
0dac68f1e5
bpo-36743: __get__ is sometimes called without the owner argument ( #12992 )
2019-08-29 01:27:42 -07:00