Ethan Furman
62e40d8450
Enum: add extended AutoNumber example (GH-22349)
2020-09-22 00:05:27 -07:00
Ethan Furman
0063ff4e58
bpo-41816: add `StrEnum` (GH-22337)
...
`StrEnum` ensures that its members were already strings, or intended to
be strings.
2020-09-21 17:23:13 -07:00
Andre Delfino
778ad926cb
[doc] Teach 0-args form of super in Programming FAQ (GH-22176)
2020-09-20 10:09:50 -07:00
Mark Dickinson
c8c70e7876
Add missing whatsnew entry for TestCase.assertNoLogs (GH-22317)
2020-09-19 21:38:11 +01:00
Vladimir Matveev
2b05361bf7
bpo-41756: Introduce PyGen_Send C API (GH-22196)
...
The new API allows to efficiently send values into native generators
and coroutines avoiding use of StopIteration exceptions to signal
returns.
ceval loop now uses this method instead of the old "private"
_PyGen_Send C API. This translates to 1.6x increased performance
of 'await' calls in micro-benchmarks.
Aside from CPython core improvements, this new API will also allow
Cython to generate more efficient code, benefiting high-performance
IO libraries like uvloop.
2020-09-18 18:38:38 -07:00
Victor Stinner
8394500cca
bpo-35293: Travis CI uses "make venv" for the doc (GH-22307)
...
Doc/requirements.txt becomes the reference for packages and package
versions needed to build the Python documentation.
* Doc/Makefile now uses Doc/requirements.txt
* .travis.yml now uses "make env" of Doc/Makefile
2020-09-18 16:23:18 +02:00
Dong-hee Na
6595cb0af4
bpo-35293: Remove RemovedInSphinx40Warning (GH-22198)
...
* bpo-35293: Remove RemovedInSphinx40Warning
* Update Misc/NEWS.d/next/Documentation/2020-09-12-17-37-13.bpo-35293._cOwPD.rst
Co-authored-by: Victor Stinner <vstinner@python.org>
* bpo-35293: Apply Victor's review
Co-authored-by: Victor Stinner <vstinner@python.org>
2020-09-18 18:22:36 +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
Serhiy Storchaka
27201cddf3
Remove duplicated words words (GH-22298)
2020-09-18 09:54:42 +03:00
Terry Jan Reedy
5a8364780b
bpo-41808: Add What's New 3.9 entry missing from master ( #22294 )
...
Entry was added by bpo-40939, #21012 and #21039 .
2020-09-17 21:56:58 -04:00
Serhiy Storchaka
a33f2c2bae
bpo-27032, bpo-37328: Document removing HTMLParser.unescape(). (GH-22288)
2020-09-17 11:49:01 +03:00
Ethan Furman
7219e27087
Enum: make `Flag` and `IntFlag` members iterable (GH-22221)
2020-09-16 13:01:00 -07:00
Pablo Galindo
a5634c4067
bpo-41746: Add type information to asdl_seq objects (GH-22223)
...
* Add new capability to the PEG parser to type variable assignments. For instance:
```
| a[asdl_stmt_seq*]=';'.small_stmt+ [';'] NEWLINE { a }
```
* Add new sequence types from the asdl definition (automatically generated)
* Make `asdl_seq` type a generic aliasing pointer type.
* Create a new `asdl_generic_seq` for the generic case using `void*`.
* The old `asdl_seq_GET`/`ast_seq_SET` macros now are typed.
* New `asdl_seq_GET_UNTYPED`/`ast_seq_SET_UNTYPED` macros for dealing with generic sequences.
* Changes all possible `asdl_seq` types to use specific versions everywhere.
2020-09-16 19:42:00 +01:00
Andre Delfino
83f6dcd207
[doc] Minor improvements to is_typeddict (GH-22280)
...
1. The check is on the type
2. Add link to TypeDict
2020-09-16 08:06:23 -07:00
Patrick Reader
0705ec8a14
bpo-41792: Add is_typeddict function to typing.py (GH-22254)
...
Closes issue41792.
Also closes https://github.com/python/typing/issues/751 .
2020-09-15 21:58:32 -07:00
Tim Burke
47f6ec4c09
Doc: Fix broken manpage link (GH-21937)
...
sigprocmask is in section 2, not 3.
2020-09-15 20:26:06 -03:00
Andre Delfino
ac0333e1e1
Fix all Python Cookbook links ( #22205 )
2020-09-15 21:13:26 +01:00
Mandeep
5531269f69
Improve the description of difflib in the documentation (GH-22253)
...
From "can produce difference information in various formats ..."
to " can produce information about file differences in various formats ..."
Automerge-Triggered-By: @Mariatta
2020-09-15 12:20:49 -07:00
Neeraj Samtani
7bcc6456ad
bpo-41776: Revise example of "continue" in the tutorial documentation (GH-22234)
...
Revise example of "continue" in the tutorial documentation
2020-09-15 09:39:29 -04:00
Ethan Furman
542e1df2b0
bpo-40721: add note about enum member name case (GH-22231)
...
* UPPER_CASE preferred as enum members are constants
2020-09-14 13:32:44 -07:00
Zackery Spytz
8f2b991eef
bpo-41646: Mention path-like objects support in the docs for shutil.copy() (GH-22208)
2020-09-14 20:28:46 +01:00
abdo
efcbe786cf
Fix a typo in locale Docs ( #22233 )
2020-09-14 20:36:34 +03:00
Raymond Hettinger
457d4e97de
bpo-41513: Add docs and tests for hypot() (GH-22238)
2020-09-13 23:33:41 -07:00
Emmanuel Arias
94bfdee25d
bpo-41778: Change a punctuation on documentation. (GH-22229)
...
On this paragrapah the clarification about IIS7 seems there's not
connection beacuase is in other sentence. Move the punctuation
to connect both the last sentence with the information in the
parenthesis.
I think the NEWS is not necessary here.
Automerge-Triggered-By: @ericvsmith
2020-09-13 14:05:44 -07:00
Sergey Fedoseev
b48389d950
bpo-33239: Fix default value of 'buffering' parameter in docs of tempfile.* functions (GH-21763)
...
`None` doesn't work:
```python
>>> import tempfile
>>> tempfile.TemporaryFile(buffering=None)
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
File "/home/sergey/tmp/cpython-dev/Lib/tempfile.py", line 607, in TemporaryFile
return _io.open(fd, mode, buffering=buffering,
TypeError: 'NoneType' object cannot be interpreted as an integer
```
Automerge-Triggered-By: @vsajip
2020-09-13 10:59:01 -07:00
Norbert Cyran
c75330605d
bpo-41672: Fix type mismatches in imaplib docs (GH-22207)
2020-09-12 16:58:56 +09:00
Stargirl Flowers
fb27187203
[doc] struct: update note about network byte order form to be more helpful (GH-22201)
...
Update the sentence to provide some context on why network byte order is defined as big endian.
2020-09-11 08:20:12 -07:00
Benjamin Peterson
3304cbd990
Doc: Fix alphabetical ordering of removeprefix/suffix. (GH-22194)
2020-09-11 08:59:02 +09:00
Mark Roseman
06d0b8b67e
bpo-37149: Change Shipman tkinter link from archive.org to TkDocs (GH-22188)
...
The new link responds much faster and begins with a short explanation of the status of the doc.
2020-09-10 16:04:20 -04:00
Bar Harel
1e874d5bec
Update logging documentation to tidy up formatting (GH-22173)
2020-09-10 11:50:23 +01: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
Andre Delfino
7a797a3967
Add missing colon to IDLE doc markup (GH-22007)
2020-09-09 18:17:14 -04:00
Vinay Sajip
76553e5d2e
Add minor clarification in logging documentation. (GH-22167)
2020-09-09 11:21:22 +01:00
Hai Shi
1e2f051a61
bpo-41726: Update the refcounts info of PyType_FromModuleAndSpec in refcounts.dat (GH-22112)
...
Update refcounts info of PyType_FromModuleAndSpec in refcounts.dat
2020-09-09 11:48:44 +02:00
Andre Delfino
594f0ce73b
[doc] Fix padding in timeit (GH-22152)
...
Compare -p and -u options help in rendered output to see the difference.
2020-09-08 16:39:19 -07:00
Erlend Egeberg Aasland
207c321f13
bpo-40744: Drop support for SQLite pre 3.7.3 (GH-20909)
...
Remove code required to support SQLite pre 3.7.3.
Co-written-by: Berker Peksag <berker.peksag@gmail.com>
Co-written-by: Sergey Fedoseev <fedoseev.sergey@gmail.com>
2020-09-07 22:26:54 +01:00
Andre Delfino
5bfd60fc2b
[doc] Add link to Generic in typing (GH-22125)
2020-09-06 22:29:38 -07:00
Zackery Spytz
5371a464ce
closes bpo-41723: Fix an error in the py_compile documentation. (GH-22110)
2020-09-05 22:39:23 -05:00
Andre Delfino
2623868ede
[doc] Fix padding in some typing definitions (GH-22114)
...
Automerge-Triggered-By: @gvanrossum
2020-09-05 16:40:25 -07:00
johnthagen
1264d0465a
Fix documented Python version for venv --upgrade-deps (GH-22113)
...
Fixes incorrect Python version added for `venv` `--upgrade-deps` in #13100 . This feature was added in Python 3.9 not 3.8.
Relates to:
-
- 1cba1c9aba
Automerge-Triggered-By: @vsajip
2020-09-05 13:53:47 -07:00
Zackery Spytz
51b84f8e96
bpo-38585: Remove references to defusedexpat (GH-22095)
...
defusedexpat is not maintained.
2020-09-04 13:57:48 -07:00
Serhiy Storchaka
306cfb3a37
bpo-40486: Specify what happens if directory content change diring iteration (GH-22025)
2020-09-04 21:19:30 +03:00
Vinay Sajip
cdbff3527c
[doc] Update documentation on logging optimization. (GH-22075)
2020-09-03 19:44:12 +01:00
Mario Šaško
8516060076
[doc] Fix a typo in the graphlib docs ( #22030 )
2020-09-03 11:00:10 +01:00
Todd
e223d06a8b
bpo-39883: Use BSD0 license for code in docs (GH-17635)
...
The PSF board approved this use.
2020-09-02 22:22:36 -07:00
Pablo Galindo
5a4a963a6c
Fix invalid escape sequences in the peg_highlight Sphinx extension (GH-22047)
2020-09-02 15:29:38 +01:00
Victor Stinner
51fece1bb8
bpo-41685: Don't pin setuptools version anymore in Doc/Makefile (GH-22062)
...
setuptools 50.0.2 is now compatible with Python 3.10:
https://github.com/pypa/setuptools/pull/2361
2020-09-02 13:11:21 +02:00
Victor Stinner
c0d5c131d9
bpo-40204: Update Sphinx to version 3.2.1 in Doc/Makefile (GH-22043)
2020-09-02 12:29:31 +02:00
Andre Delfino
1d25f5bf7b
Remove reference to Boa Constructor. (GH-22012)
2020-09-01 22:22:55 -05:00
Andre Delfino
dea82b6731
[doc] Remove references to PyChecker. (GH-22011)
2020-09-01 22:21:12 -05:00