Ned Batchelder
987b712b4a
Replace the esoteric term 'datum' when describing dict comprehensions ( #106119 )
2023-07-02 20:22:40 -07:00
Jelle Zijlstra
060277d96b
gh-103921: Document PEP 695 ( #104642 )
...
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2023-05-26 10:48:17 -07:00
Adam Turner
f5088006ca
GH-97950: Use new-style index directive ('builtin') ( #104164 )
...
* Uncomment builtin removal in pairindextypes
* Use new-style index directive ('builtin') - C API
* Use new-style index directive ('builtin') - Extending
* Use new-style index directive ('builtin') - Library
* Use new-style index directive ('builtin') - Reference
* Use new-style index directive ('builtin') - Tutorial
2023-05-06 06:54:08 +03:00
Adam Turner
55d50d147c
GH-97950: Use new-style index directive ('statement') ( #104162 )
2023-05-04 13:48:45 +03: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
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
jmcb
728e42fcf5
doc: Formatting and typo fixes ( #98974 )
2022-11-06 20:55:55 -08: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
Robert Yang
ee2205b208
gh-87304: Improve comments in language reference for imports ( #92164 )
2022-05-03 16:08:05 -06:00
Jiashuo Li
4f5d56f8f3
Language reference: Remove duplicated text about iterable unpacking (GH-25212)
2022-04-02 19:41:16 -07:00
Kinshuk Dua
08c0ed2d9c
bpo-23556: [doc] Fix inaccuracy in documentation for raise without args. Improve tests for context in nested except handlers. (GH-29236)
2022-01-27 10:24:48 +00:00
Irit Katriel
8a45ca542a
bpo-45711: Change exc_info related APIs to derive type and traceback from the exception instance (GH-29780)
2021-11-30 22:37:04 +00:00
Saiyang Gou
3d4b5f1019
Update doc as relative import can be used with star import (GH-25667)
2021-05-13 22:37:19 -07:00
Pablo Galindo
b0544ba77c
bpo-38605: Revert making 'from __future__ import annotations' the default (GH-25490)
...
This reverts commits 044a1048ca
and 1be456ae9d
, adapting the code to changes that happened after it.
2021-04-21 12:41:19 +01:00
Mark Dickinson
79650d0118
Fix description of behaviour of an exception class in 'from' clause (GH-24303)
2021-04-11 09:33:59 +01:00
Saiyang Gou
1be456ae9d
bpo-38605: Update "Future statements" docs since PEP 563 is always enabled (GH-25236)
...
Update documentation section for "Future statements" to reflect that `from __future__ import annotations` is on by default, and no features require using the future statement now.
2021-04-06 22:02:20 -07:00
Andre Delfino
c56f9df049
[doc] Mention with and except clauses in globals() (GH-13232)
2020-12-19 16:48:06 +01:00
Andre Delfino
eba109a28f
Doc: Remove old Python version from future stmt (GH-21802)
2020-10-21 14:45:13 +09: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
Steve Dower
894e30ce0b
bpo-38434: Fixes some audit event documentation (GH-16932)
2019-10-26 13:02:30 -07:00
Ivan Levkivskyi
8bcf2629a2
More updates to the annotated assignments docs (GH-13794)
2019-06-04 11:37:46 +01:00
Ivan Levkivskyi
82eac26a73
Update the annotated assignment docs (GH-13757)
2019-06-03 00:41:00 +01:00
Andre Delfino
5861cddf76
Don't use the LHS/RHS acronym in Simple statements (GH-12996)
...
Prefer the full wording instead, as it is more meaningful for someone not familiar with the terms.
Also, LFS/RHS is not used anywhere else in the documentation, while left/right-hand side mentions are common.
2019-05-03 07:59:05 -07:00
Joannah Nanjekye
70bf713617
bpo-30840: Document relative imports ( #12831 )
...
* document relative imports
* 📜 🤖 Added by blurb_it.
* fix indentation error
* remove indentation
* Document relative imports
* Document relative imports
* remove from ...package
* Document relative imports
* remove trailing space
* Document relative imports
* Document relative imports
2019-04-25 01:14:44 +10:00
Cheryl Sabella
b7105c9c96
bpo-35566: Add links to annotation glossary term (GH-11291)
2018-12-23 21:09:09 -08:00
Serhiy Storchaka
2b57c43f21
bpo-35506: Remove redundant and incorrect links from keywords. (GH-11174)
2018-12-19 08:09:46 +02:00
Julien Palard
082875dcd6
bpo-33878: Doc: Fix missing case by simplifying. (GH-7762)
...
The documentation was not covering multiple targets enclosed by
parenthesis nor multiple targets enclosed by brackets, adding them all
would be heavy, an else cover them all and is lighter to read.
2018-11-12 00:59:39 +01:00
Andrés Delfino
cdb96f45b6
Add future_stmt to simple_stmt production list. (GH-8239)
2018-11-07 19:32:18 +02:00
Andrés Delfino
ea6a28c9f7
Mark -c and -O as command line options in reStructuredText. (GH-10103)
2018-11-07 19:06:45 +02:00
Serhiy Storchaka
913876d824
bpo-35054: Add yet more index entries for symbols. (GH-10121)
2018-10-28 13:41:26 +02:00
Serhiy Storchaka
ddb961d2ab
bpo-35054: Add more index entries for symbols. (GH-10064)
2018-10-26 09:00:49 +03:00
Andrés Delfino
0f14fc1a7c
bpo-33726, doc: Add short descriptions to PEP references in seealso (GH-7294)
2018-10-20 01:31:15 +02:00
Andrés Delfino
caccca78e4
bpo-33702: Add some missing links in production lists and do a little polish (GH-7259)
2018-07-07 23:24:46 +03:00
Serhiy Storchaka
fe2bbb1869
bpo-32489: Allow 'continue' in 'finally' clause. (GH-5822)
2018-03-18 09:56:52 +02:00
Guido van Rossum
95e4d58913
String annotations [PEP 563] ( #4390 )
...
* Document `from __future__ import annotations`
* Provide plumbing and tests for `from __future__ import annotations`
* Implement unparsing the AST back to string form
This is required for PEP 563 and as such only implements a part of the
unparsing process that covers expressions.
2018-01-26 08:20:18 -08:00
kms70847
8d59aca4a9
Fix typo in Simple Statements documentation (GH-3809)
...
Replace "restriction" with "restrictions".
2017-09-28 12:54:48 -07:00
Mariatta
9efad1e5ae
bpo-17188: add missing periods at the end of sentences (GH-1875)
2017-05-30 15:26:42 -07:00
csabella
763557eac0
bpo-17188: DOC: Document 'from None' in raise statement ( #1671 )
...
Original patch by Dennis Mårtensson.
2017-05-20 02:48:28 -04:00
Jim Fasarakis-Hilliard
f34c685020
Fix a trivial typo in global section ( #1497 )
2017-05-08 04:36:29 -07:00
Yury Selivanov
03660041d2
Issue #28091 : Document PEP 525 & PEP 530.
...
Patch by Eric Appelt.
2016-12-15 17:36:05 -05:00
Guido van Rossum
015d874626
Issue #28076 : Variable annotations should be mangled for private names.
...
By Ivan Levkivskyi.
2016-09-11 09:45:24 -07:00
Guido van Rossum
6cff8744a0
Issue #27999 : Make "global after use" a SyntaxError, and ditto for nonlocal.
...
Patch by Ivan Levkivskyi.
2016-09-09 09:36:26 -07:00
Yury Selivanov
f8cb8a16a3
Issue #27985 : Implement PEP 526 -- Syntax for Variable Annotations.
...
Patch by Ivan Levkivskyi.
2016-09-08 20:50:03 -07:00
Martin Panter
99cb0cda15
Issue #24136 : Merge unpacking doc from 3.5
2016-06-12 01:55:03 +00:00
Martin Panter
0c0da48aed
Issue #24136 : Document generalized unpacking, PEP 448
...
Based on patches by Konstantin Molchanov and Neil Girdhar.
2016-06-12 01:46:50 +00:00
Martin Panter
7d7a11b5d7
Issue #23275 : Backport target list assignment documentation fixes
2016-06-08 12:44:30 +00:00
Berker Peksag
094c9c921c
Issue #23275 : Allow () = iterable assignment syntax
...
Documentation updates by Martin Panter.
2016-05-18 08:44:29 +03:00
Ned Deily
cec95813b2
Issue #27049 : fix doc typo
2016-05-17 21:44:46 -04:00
Serhiy Storchaka
dba903993a
Issue #23921 : Standardized documentation whitespace formatting.
...
Original patch by James Edwards.
2016-05-10 12:01:23 +03:00