216f45e4fe
gh-98348: Mention ReferenceError in weakref.proxy documentation ( #98355 )
2022-10-25 20:48:24 -07:00
268129a74f
docs: Change links to label refs ( #98454 )
...
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-10-25 20:26:28 -07:00
0ca6a4d640
gh-77753: Add example for values that compare equal in stdtypes ( #98497 )
...
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2022-10-25 19:54:27 -07:00
4196ee5c8b
gh-84747: Add `async for` comment for StreamReader ( #98633 )
2022-10-25 19:16:18 -07:00
45644905ea
fix a typo in whatsnew/3.11 ( #98603 )
2022-10-25 16:42:54 -07:00
faea6a131a
Fix typos in deprecation section of 3.11 What's New ( #98628 )
2022-10-25 16:35:53 -07:00
5d8bf2b106
gh-97937: dis docs: add adaptive=False ( #97939 )
...
Co-authored-by: Shantanu <12621235+hauntsaninja@users.noreply.github.com>
Co-authored-by: Brandt Bucher <brandtbucher@gmail.com>
2022-10-25 15:58:04 -07:00
be0cf82ae4
gh-98602: [typing docs] Use quotes for forward reference in TypeVarTuple example ( #98605 )
2022-10-25 16:32:52 +01:00
5076108872
gh-98623: Fix base classes in `typing.rst` ( #98626 )
2022-10-25 07:06:13 -07:00
dd13b23e49
gh-95913: Prepare Improved Modules in 3.11 WhatsNew for final edits ( #98631 )
...
* Add two line breaks and ref target labels to remaining subsections
* Fix a few out of order Improved Modules
* Fix a few minor textual formatting issues in sections
* Fix remaining Sphinx warnings in the Improved Modules section
2022-10-25 06:19:44 -07:00
e3b9dd8e87
gh-98507: [typing docs] Rephrase "now supports `[]`" to "now supports subscripting" ( #98508 )
2022-10-24 19:10:25 +01:00
2fdcc6f2cb
GH-91635: clarify docs about closing of transport in asyncio ( #98563 )
2022-10-24 10:52:02 -07:00
1a217f9ffc
gh-98500: Fix typing docs for `*View` classes ( #98511 )
2022-10-24 10:47:32 -07:00
c5a9d3f67f
gh-95913: Fix grammar for SpooledTemporaryFile 3.11 whatsnew entry ( #98604 )
...
Followup from #98312 .
2022-10-24 09:45:43 -07:00
c237076379
gh-97909: Mark up members of PyMemberDef (GH-98473)
...
Co-authored-by: T <tnie@tuta.io>
2022-10-24 16:13:38 +02:00
e19c2b979f
gh-95913: Fix, sort & expand pending removal sect in 3.11 WhatsNew (GH-98583)
...
* Fix names/references of pending removal APIs
* Sort list of APIs pending removal alphabetically
* Add missing modules/submodules pending removal in 3.12
* Add table of unittest deprecated aliases to 3.11 What's New
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Co-authored-by: Petr Viktorin <encukou@gmail.com>
2022-10-24 15:35:28 +02:00
f3f8b6fca5
gh-95913: Add io support for SpooledTemporaryFile in 3.11 Whatsnew ( #98312 )
2022-10-24 06:05:14 -07:00
dfb5d272e6
gh-95913: Edit & expand Deprecated section of 3.11 WhatsNew ( #98581 )
...
* Refine Sphinx syntax and grammar/phrasing in Deprecated section items
* Organize into lang/builtins, modules & stdlib sections
* Convert PEP 594 module list into a grid to not waste as much space
* Add importlib.resources deprecated functions to section
2022-10-24 05:58:27 -07:00
22739a0e05
gh-95913: Edit, expand & format Bytecode sect in 3.11 WhatsNew (GH-98559)
2022-10-24 13:51:25 +01:00
e81fad6b8a
gh-95913: Edit, link and sort 3.11 WhatsNew Build section ( #98588 )
2022-10-24 13:34:05 +01:00
43bef54a32
gh-95913: Edit, sort & expand 3.11 WhatsNew Porting section ( #98585 )
2022-10-24 13:33:31 +01:00
8dbec4dbe5
gh-95913: Edit, xref & sort 3.11 WhatsNew Removed section ( #98584 )
2022-10-24 13:33:16 +01:00
e2dc223004
gh-95913 Add string section to Whatsnew with new Template methods ( #98311 )
2022-10-24 13:33:04 +01:00
75a6fadf36
gh-91524: Speed up the regular expression substitution ( #91525 )
...
Functions re.sub() and re.subn() and corresponding re.Pattern methods
are now 2-3 times faster for replacement strings containing group references.
Closes #91524
Primarily authored by serhiy-storchaka Serhiy Storchaka
Minor-cleanups-by: Gregory P. Smith [Google] <greg@krypto.org>
2022-10-23 15:57:30 -07:00
b6d5d5b60a
gh-98561: Fix a typo in typing (GH-98562)
2022-10-23 22:05:08 +08:00
833f275840
no-issue: typo fix in c-api/tuple.rst (gh-98560)
2022-10-23 19:46:56 +09:00
f58631be11
gh-95913: Edit & expand Optimizations in 3.11 WhatsNew ( #98426 )
2022-10-22 20:14:11 +01:00
8f30267ab4
gh-95913: Copyedit & xref FrameInfo in Whatsnew inspect section ( #98304 )
2022-10-22 20:12:04 +01:00
327fc1c6fa
[Enum docs]: fix order of arguments to isinstance() ( #98542 )
2022-10-22 12:29:00 +01:00
d9407b174c
gh-51511: Note that codecs.open()'s encoding parameter affects automatic conversion to binary mode ( #94370 )
2022-10-21 16:01:05 -07:00
4c1145bb37
bpo-2716: add license for audioop module ( #19972 )
2022-10-21 15:43:20 -07:00
3e95ffc7ae
gh-98298: [Enum] document ReprEnum, global_enum, and show_flag_values (GH-98455)
...
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-10-21 15:36:41 -07:00
82ccbf69a8
gh-91051: allow setting a callback hook on PyType_Modified (GH-97875)
2022-10-21 14:41:51 +01:00
8367ca136e
gh-98172: [doc] mention that except* handles naked exceptions (GH-98496)
2022-10-21 11:35:20 +01:00
a956c2fd55
[doc] Improve logging cookbook example. (GH-98481)
2022-10-20 12:46:03 +01:00
a371a7e03e
gh-95023: Added os.setns and os.unshare functions ( #95046 )
...
Added os.setns and os.unshare to easily switch between namespaces
on Linux.
Co-authored-by: Christian Heimes <christian@python.org>
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
Co-authored-by: Victor Stinner <vstinner@python.org>
2022-10-20 11:08:54 +02:00
52fcba6512
Doc: Remove title text from internal links ( #98409 )
...
Rely on the title of the linked internal page instead of putting the title. Sphinx will render with the title correctly, and this will reduce work for translators
2022-10-19 08:36:07 -07:00
1a6bacb31f
[doc] Refresh the venv introduction documentation, and correct the statement about VIRTUAL_ENV (GH-98350)
...
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-10-19 15:49:34 +01:00
50553004fe
Docs: Bump sphinx-lint and fix unbalanced inline literal markup ( #98441 )
...
Bump sphinx-lint and fix unbalanced inline literal markup
2022-10-19 14:00:28 +02:00
ed827d5608
gh-95913: Edit zipfile Whatsnew section & add new APIs ( #98314 )
...
* Link ZipFile in What's New entry discussing it
* Add entry for new ZipFile.mkdir method
* Add entry for new zipfile.Path.stem/suffix/suffixes methods
* Add missing line breaks between zipfile bullet list items
2022-10-19 06:33:50 +02:00
251b8ccd2a
gh-95913: Add WhatsNew section for new logging APIs ( #98320 )
...
* Add entry for new logging.getLevelNamesMapping function
* Add entry for SysLogHandler.createSocket to whatsnew
* Add missing line break between logging bullet list items
2022-10-19 06:25:58 +02:00
a53f637368
Fix markup indentation (GH-98424)
...
Fix markup
2022-10-18 20:14:41 -05:00
fcae1954a2
gh-95914: Add links to 3.11 WhatsNew Summary items ( #98416 )
...
Add links to Summary items to where readers can learn more
2022-10-19 01:10:35 +02:00
f4ead4874b
General improvements to the itertools docs (GH-98408)
2022-10-18 14:09:34 -05:00
db03c8066a
gh-98393: os module reject bytes-like, only accept bytes ( #98394 )
...
The os module and the PyUnicode_FSDecoder() function no longer accept
bytes-like paths, like bytearray and memoryview types: only the exact
bytes type is accepted for bytes strings.
2022-10-18 17:52:31 +02:00
2eb503e4dd
Doc: Found some remaining default roles. (GH-98392)
2022-10-18 15:46:18 +02:00
0bbea545e3
Doc: missing underscore in hyperlink. (GH-98391)
2022-10-18 15:28:19 +02:00
73e5180faf
gh-95913: Copyedit, xref and organize enum section ( #98295 )
...
* Whatsnew: Convert literals in enum section to actual x-references
* Whatsnew: Rewrite enum section for clear and consistant phrasing
* Whatsnew: Combine directly related enum items instead of seperating them
* gh-98250: Describe __str__/__format__ changes more clearly/accurately
* Tweak enum section language per feedback from Ethan
2022-10-18 11:26:24 +02:00
0a0c7e5a7a
gh-95913: Prepare remaining Whatsnew sections for editing ( #98342 )
...
* Add line breaks & ref targets to Whatsnew to prepare for future changes
* Use standard heading underbar symbols for H4 sections
* Flatten Porting subsection; clarify scope of/link Python->CAPI sections
* Move C API pending deprecations to C API section, to match the others
2022-10-18 10:41:57 +02:00
de3ece769a
GH-98363: Add itertools.batched() (GH-98364)
2022-10-17 18:53:45 -05:00
70732d8a4c
Move random selection recipes from itertools.rst to random.rst (GH-98369)
2022-10-17 17:30:49 -05:00
5fe0431474
gh-95913: Move subinterpreter exper removal to 3.11 WhatsNew (GH-98345)
...
Part of #95913
Forward port of #93306 , which was a backport of #93185 , to address #84694
This adds the What's New entry for the removal of the subinterpreter-related env variable, build-time flag, etc. As @ericsnowcurrently was author of the original changes, I added him as a co-author to the commit.
This addition to the Python 3.11 What's New document were only made to the Python 3.11 branch during the backport process, and not added to the version in `main`. Forward-porting it ensures the docs retain these additions for the future, rather than being lost in a legacy Python versions, allows it to be be edited as part of #95913 , and avoids merge conflicts with routine back-ports of PRs touching it.
I've pulled in the addition exactly as-is with no modifications; any editing will be done in future PRs (and therefore can be reviewed and backported accordingly).
The one other such addition is forward-ported in #98344
2022-10-17 12:59:22 -07:00
aafc53c0a6
gh-95914: Add What's New item describing PEP 670 changes ( #98315 )
2022-10-17 21:16:37 +02:00
1863302d61
gh-97669: Create Tools/build/ directory ( #97963 )
...
Create Tools/build/ directory. Move the following scripts from
Tools/scripts/ to Tools/build/:
* check_extension_modules.py
* deepfreeze.py
* freeze_modules.py
* generate_global_objects.py
* generate_levenshtein_examples.py
* generate_opcode_h.py
* generate_re_casefix.py
* generate_sre_constants.py
* generate_stdlib_module_names.py
* generate_token.py
* parse_html5_entities.py
* smelly.py
* stable_abi.py
* umarshal.py
* update_file.py
* verify_ensurepip_wheels.py
Update references to these scripts.
2022-10-17 12:01:00 +02:00
bb38b39b33
gh-95913: Forward-port int/str security change to 3.11 What's New in main ( #98344 )
...
Add int/str security change from issue gh-95778 PRs gh-96499 / gh-95800
Co-authored-by: Gregory P. Smith <greg@krypto.org> [Google]
2022-10-16 18:43:13 -07:00
ae19217867
GH-91415: Mention alphabetical sort ordering in the Sorting HOWTO (GH-98336)
2022-10-16 14:34:25 -05:00
5c9302d03a
gh-85525: Remove extra row in doc ( #98337 )
...
* remove extra row
* 📜 🤖 Added by blurb_it.
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
2022-10-16 13:43:31 -04:00
79fd6ccdbe
gh-85299: Add note warning about entry point guard for asyncio example ( #93457 )
2022-10-16 10:04:43 -07:00
f6b1e4048d
gh-98307: Add docstring and documentation for SysLogHandler.createSocket (GH-98319)
...
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-10-16 09:15:46 +01:00
660f10248b
GH-94597: Deprecate child watcher getters and setters ( #98215 )
...
This is the next step for deprecating child watchers.
Until we've removed the API completely we have to use it, so this PR is mostly suppressing a lot of warnings when using the API internally.
Once the child watcher API is totally removed, the two child watcher implementations we actually use and need (Pidfd and Thread) will be turned into internal helpers.
2022-10-15 16:09:30 -07:00
3a639bbeac
Improve speed. Reduce auxiliary memory to 16.6% of the main array. (GH-98294)
2022-10-15 16:05:28 -05:00
11c25a402d
[doc] Update logging cookbook with an example of custom handling of levels. (GH-98290)
...
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2022-10-15 21:23:06 +01:00
02389658a4
docs(typing): harmonize "See PEP x for more details" ( #97927 )
2022-10-15 12:17:51 -07:00
f4370318d6
Faster sieve() recipe ( #98287 )
2022-10-15 12:43:58 -05:00
146f168fbf
gh-98227: executionmodel.rst: except* can also bind names ( #98256 )
...
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2022-10-15 09:04:08 -07:00
4e2bd58af4
gh-96258: move Py_REFCNT and Py_SET_REFCNT to reference counting page ( #96259 )
2022-10-15 07:56:14 -07:00
bf786e6901
gh-85455: Add missing doc strings and improve docs ( #21573 )
...
* Add missing doc strings and improve docs
* Use imperative form
* Modify docstring wording
2022-10-15 09:31:06 -04:00
05c042e707
gh-85525: Indicate supported sound header formats ( #21575 )
...
* Indicate supported sound header formats
* modify file names
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2022-10-15 09:30:05 -04:00
3c4cbd177f
gh-91485: Doc: Using Python syntax to document builtin Python functions. (GH-96579)
2022-10-15 12:19:35 +02:00
4414586172
Mark all targets in `Doc/Makefile` as `PHONY` (GH-98189)
2022-10-12 21:40:47 +02:00
e9569ec43e
gh-96265: Formatting changes for faq/general ( #98129 )
...
* Some formatting changes for general faq
* Use list for Python versioning
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
* New line for list, list for a/b/rc
* Line wrap for 80 chars
* More line wrap
* Remove PythonWin mention.
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-10-12 18:04:41 +02:00
5f8ca1b796
tutorial: remove "with single quotes" ( #98204 )
...
Closes #91856 .
On Windows double quotes are sometimes better, on Unix usually
single quotes. It's not our place to explain that, so just don't.
2022-10-12 09:00:51 -07:00
c39a0c3354
gh-65046: Link to logging cookbook from asyncio docs ( #98207 )
2022-10-11 21:42:57 -07:00
3b33c2010a
Formatting fixes in contextlib docs ( #98111 )
2022-10-11 20:56:32 -07:00
e3bf125c81
gh-95276: Add callable entry to the glossary ( #95738 )
2022-10-11 19:41:08 -07:00
ed6344eed0
gh-96130: Rephrase use of "typecheck" verb for clarity ( #98144 )
...
I'm sympathetic to the issue report, especially in case this helps
clarify to new users that Python itself does not do type checking at runtime
2022-10-11 19:37:58 -07:00
5ecf961640
gh-98172: Fix formatting in `except*` docs ( #98173 )
2022-10-11 09:13:56 -07:00
4067c6d7fe
gh-86404: Doc: Drop now unused make suspicious and rstlint. (GH-98179)
...
They have been replaced by
[sphinx-lint](https://github.com/sphinx-contrib/sphinx-lint ).
2022-10-11 15:31:33 +02:00
f0a680007f
gh-71616: Add note to warn against general translation of saxutils.escape() ( #93450 )
...
* Add note to warn against general translation of saxutils.escape()
* Use more direct wording
2022-10-11 05:27:49 -04:00
6a757da080
gh-88452: Add a warning about non-portability of environments. (GH-98155)
2022-10-10 19:27:52 +01:00
187e853690
gh-83940: os docs: Improve wording for getenv/getenvb ( #98113 )
2022-10-10 06:43:01 -07:00
571e23d991
doc: remove a misleading statement. (GH-98093)
2022-10-10 09:01:16 +02:00
c459fedf7c
Fix types in buffer/memoryview docs ( #98118 )
...
The definition of obj in the `Py_buffer` struct is as a PyObject*
ec091bd47e/Include/pybuffer.h (L22)
2022-10-09 17:55:53 -07:00
281a3f18cc
gh-56133: copyreg docs: Clarify function/constructor parameter ( #95497 )
2022-10-09 17:51:02 -07:00
f1879690aa
Update whatsnew instructions for GitHub ( #98124 )
2022-10-10 00:29:25 +02:00
2d2e01aa4c
Minor edits to the Descriptor HowTo Guide (GH-24901)
...
Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
2022-10-08 20:54:21 -05:00
d8765284f3
GH-94597: deprecate `SafeChildWatcher`, `FastChildWatcher` and `MultiLoopChildWatcher` child watchers ( #98089 )
2022-10-08 13:52:19 -07:00
83eb827247
gh-97922: Run the GC only on eval breaker ( #97920 )
2022-10-08 07:57:09 -07:00
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
840fd19590
[doc] Fix broken links to C extensions accelerating stdlib modules ( #96914 )
...
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-10-07 22:55:35 -07:00
6b485629d2
gh-97822: Fix http.server documentation reference to test() function ( #98027 )
...
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2022-10-07 21:46:23 -07:00
e82d977eb0
gh-91052: Add PyDict_Unwatch for unwatching a dictionary ( #98055 )
2022-10-07 17:37:46 -07:00
0f498f1a95
gh-57179: Add note on symlinks for os.walk ( #94799 )
2022-10-07 15:51:50 -07:00
5eaf4d6101
gh-61105: Add default param, note on using cookiejar subclass ( #95427 )
2022-10-07 15:21:13 -07:00
0f111f53c1
gh-96073: fix backticks in NEWS entry (GH-98056)
...
Automerge-Triggered-By: GH:JelleZijlstra
2022-10-07 14:44:56 -07:00
eed80458e8
gh-91708: Revert params note in urllib.parse.urlparse table ( #96699 )
...
Revert params note in urllib.parse.urlparse table
2022-10-07 12:19:36 -07:00
3a7e955858
gh-96265: Fix some formatting in faq/design.rst ( #96924 )
...
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-10-07 12:15:41 -07:00
fde74be61b
gh-73196: Add namespace/scope clarification for inheritance section ( #92840 )
...
Add namespace/scope clarification for inheritance section
2022-10-07 12:04:14 -07:00
586cfb0131
gh-97956: Mention `generate_global_objects.py` in `AC How-To` ( #97957 )
2022-10-07 11:54:45 -07:00
c81c64ca58
gh-96959: Update HTTP links which are redirected to HTTPS ( #98039 )
2022-10-07 11:52:45 -07:00
fancidev
Stanley
July Tikhonov
Jacob Walls
Jelle Zijlstra
Eclips4
Nikita Sobolev
C.A.M. Gerlach
Kumar Aditya
Johnny11502
Serhiy Storchaka
Omkaar
wim glenn
Clément Robert
Furkan Onder
Ethan Furman
Carl Meyer
Irit Katriel
Vinay Sajip
Noam Cohen
Rafael Fontenelle
Phil Elson
Hugo van Kemenade
Raymond Hettinger
Victor Stinner
Julien Palard
Joannah Nanjekye
Simon Legner
BiscuitCandy
QuakeIV
Shantanu
MonadChains
da-woods
Géry Ogam
Pablo Galindo Salgado
partev
JasonYZ
180909