summaryrefslogtreecommitdiffstats
path: root/Doc
Commit message (Collapse)AuthorAgeFilesLines
* [doc] Link to section File input (GH-28941) (GH-29375)Miss Islington (bot)2021-11-021-1/+1
| | | | | (cherry picked from commit 48824fa1e26595ac97ffc96ee2c3d32ff130c420) Co-authored-by: Andre Delfino <adelfino@gmail.com>
* bpo-45457: Minor fix to documentation for SSLContext.load_default_certs. ↵Miss Islington (bot)2021-11-021-1/+1
| | | | | | | | | | | (GH-28947) (GH-29373) Specify that SSLContext.set_default_verify_paths is called on ALL systems. The code of SSLContext.load_default_certs was changed in bpo-22449 to do this, this fix corrects the documentation to match that change. (cherry picked from commit 3551bf16ee5c25b6349209dd30e032f0f3b9ace3) Co-authored-by: LincolnPuzey <lincoln@puzey.dev>
* [3.10] Move field width to the right field (GH-29344) (GH-29351)Miss Islington (bot)2021-10-311-2/+2
| | | Co-authored-by: Olaf van der Spek <olafvdspek@gmail.com>
* bpo-45516: add protocol description to the Traversable documentation (GH-29039)Miss Islington (bot)2021-10-311-0/+40
| | | | | | | | | | | | | | | | | | | | * bpo-45516: add protocol description to the Traversable documentation Signed-off-by: Filipe Laíns <lains@riseup.net> * Update Doc/library/importlib.rst Co-authored-by: Jason R. Coombs <jaraco@jaraco.com> * Update Lib/importlib/abc.py * Update Doc/library/importlib.rst Co-authored-by: Jason R. Coombs <jaraco@jaraco.com> Co-authored-by: Jason R. Coombs <jaraco@jaraco.com> (cherry picked from commit 4d03de3329ed8daa9c1107b1aedbb0fa280bddb6) Co-authored-by: Filipe Laíns <filipe.lains@gmail.com>
* Fix docs source link for importlib.metadata (GH-29025)Miss Islington (bot)2021-10-301-1/+1
| | | | | | | | | | The link broke for Python 3.10 since importlib.metadata was made from a module into a package I think this is trivial enough to not need a bpo issue. Automerge-Triggered-By: GH:jaraco (cherry picked from commit aae18a17401dc36917c0f64f971d60ab1a5b477e) Co-authored-by: Philipp A <flying-sheep@web.de>
* bpo-45600: Enhanced / clarified the docs for os.environ and os.environb ↵Miss Islington (bot)2021-10-291-7/+8
| | | | | | | | (GH-29204) (GH-29322) Co-authored-by: Łukasz Langa <lukasz@langa.pl> (cherry picked from commit b17cfd150f4dc2816975d304a71110a2d445eaf0) Co-authored-by: andrei kulakov <andrei.avk@gmail.com>
* bpo-45335: Add note to `sqlite3` docs about "timestamp" converter (GH-29200) ↵Miss Islington (bot)2021-10-291-0/+6
| | | | | | | (GH-29319) (cherry picked from commit 3877fc02f7a8801ba5ce0e94b6075b3fdd9778d0) Co-authored-by: Ian Fisher <ian@iafisher.com>
* bpo-45655: Add ref to union type expressions at top of typing docs (GH-29309)Miss Islington (bot)2021-10-291-1/+2
| | | | | (cherry picked from commit d9575218d7ab3d85b15ce3d4779660b9b724d343) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* [3.10] bo-45655: Add "relevant PEPs" section to typing documentation (GH-29302)Alex Waygood2021-10-292-11/+45
| | | | | | | | | | | The list of PEPs at the top of the documentation for the ``typing`` module has become too long to be readable. This PR proposes presenting this information in a more structured and readable way by adding a new "relevant PEPs" section to the ``typing`` docs. (cherry picked from commit 03db1bbfd2d3f5a343c293b2f0e09a1e962df7ea) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com> Co-authored-by: Łukasz Langa <lukasz@langa.pl>
* bpo-45583: Correct datamodel documentation of int() (GH-29182) (GH-29285)Miss Islington (bot)2021-10-281-2/+2
| | | | | | | It should be noted that this part of the documentation is redundant with function.rst's documentation of int. This one was correctly updated with Python 3.8. (cherry picked from commit d9c1868c25ec6466e8d8ae21fe9315a8a03836ab) Co-authored-by: Arthur Milchior <arthur@milchior.fr>
* bpo-45604: add `level` argument to `multiprocessing.log_to_stderr` func ↵Miss Islington (bot)2021-10-281-1/+2
| | | | | | | | (GH-29226) (GH-29283) Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com> (cherry picked from commit 1fb968c07a76fb2d1ec8c14a0026f1d15828f4a5) Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
* bpo-45608: Document missing `sqlite3` DB-API attributes and methods ↵Miss Islington (bot)2021-10-281-0/+46
| | | | | | | (GH-29219) (GH-29281) (cherry picked from commit 88d8a1a340fb09c54d47f354f5fd7d4fbc5f0c78) Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>
* [3.10] bpo-28737: Document when tp_dealloc should call PyObject_GC_UnTrack() ↵Sam Gross2021-10-283-9/+33
| | | | | | | | | | (GH-29246) (GH-29249) Objects that support garbage collection ("container" objects) should call PyObject_GC_UnTrack() from their destructors before clearing any fields which may point to other "container" objects. (cherry picked from commit 35e1ff38ee67ee543d9fcb268c3552c5397f9b3f) Co-authored-by: Sam Gross <colesbury@gmail.com>
* Fix typo in Counter documentation (GH-29223)Miss Islington (bot)2021-10-281-1/+1
| | | | | | Co-authored-by: Ken Jin <28750310+Fidget-Spinner@users.noreply.github.com> (cherry picked from commit 0a68b3603fbc0aaf9eeb8ce8b42b78d6fa7cfa78) Co-authored-by: Justinas Petuchovas <justinas.petuchovas@gmail.com>
* bpo-45618: Fix documentation build by pinning Docutils version to 0.17.1 ↵Miss Islington (bot)2021-10-271-0/+4
| | | | | | | (GH-29230) (GH-29240) Co-authored-by: Maciej Olko <maciej.olko@yougov.com> Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no> (cherry picked from commit bcee6aa31550cfecdc3acecbd0e4447bb0051887)
* bpo-44344: Document that pow can return a complex number for non-complex ↵Miss Islington (bot)2021-10-211-1/+4
| | | | | | | | inputs. (GH-27853) (GH-29135) Co-authored-by: Łukasz Langa <lukasz@langa.pl> (cherry picked from commit 887a55705bb6c05a507c2886c9978a9e0cff0dd7) Co-authored-by: Mark Dickinson <mdickinson@enthought.com>
* bpo-41983: add availability info to socket docs (GH-27519) (GH-29136)Miss Islington (bot)2021-10-211-0/+4
| | | | | | | | * add availability info to AF_PACKET section * add availability for AF_QIPCRTR as well (cherry picked from commit 51375388bee7287be2d942906b48c8cf3f691e8b) Co-authored-by: andrei kulakov <andrei.avk@gmail.com>
* [3.10] bpo-44174: [Enum] add reference to name mangling (GH-29117)Ethan Furman2021-10-211-3/+3
|
* bpo-34451: Document prompt and output toggle feature in html tutorial ↵Miss Islington (bot)2021-10-211-0/+7
| | | | | | | (GH-27105) (GH-29119) (cherry picked from commit 5a14f71fe869d4a62dcdeb9a8fbbb5884c75060c) Co-authored-by: Thomas <thmsdnnr@gmail.com>
* bpo-44559: [Enum] restore fixes lost in 3.9 reversion (GH-29114)Ethan Furman2021-10-211-2/+12
| | | | - fix exception leaks - re-add deprecation warnings
* bpo-45464: [doc] Explain that subclassing multiple exceptions is fragile ↵Miss Islington (bot)2021-10-201-0/+23
| | | | | | | | (GH-29094) (GH-29104) Co-authored-by: Pablo Galindo Salgado <Pablogsal@gmail.com> (cherry picked from commit dff0b713436e286bb1afdd7c6f3093c8e8db16dd) Co-authored-by: Łukasz Langa <lukasz@langa.pl>
* Add PEPs 593 & 647 to list of PEPs at top of typing docs (GH-29097)Miss Islington (bot)2021-10-201-1/+1
| | | | | (cherry picked from commit d9e1dae35ac20acfeb2509b0dea4c3943693e79d) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* bpo-45449: add note about PEP 585 in collections.abc's documentation ↵Miss Islington (bot)2021-10-191-0/+3
| | | | | | | | | (GH-29047) (GH-29067) Signed-off-by: Filipe Laíns <lains@riseup.net> Co-authored-by: Łukasz Langa <lukasz@langa.pl> (cherry picked from commit 7bafa0cf586227987d3d662264d491e3780024b7)
* bpo-45515: Add zoneinfo to the datetime documentation (GH-29038) (GH-29065)Miss Islington (bot)2021-10-191-4/+6
| | | | | | | | We should have done this way back when 3.9 was released, but it fell off the radar. Co-authored-by: Paul Ganssle <git@m.ganssle.io> (cherry picked from commit 8e40ca127fa92d6113617c80710e0a077977a84d)
* Improve multiserver queue recipe (GH-29012) (GH-29013)Miss Islington (bot)2021-10-171-5/+6
|
* [3.10]bpo-45463: Clarify that global statements allows multiple names ↵Miss Islington (bot)2021-10-161-4/+4
| | | | | | | | | | | | | | (GH-28851) (GH-28989) The global statement allows specifying a list of identifiers (https://docs.python.org/3/reference/simple_stmts.htmlGH-the-global-statement). The "Execution model" chapter described the global statement as if it only allowed one single name. Pluralize "name" in the appropriate places. (cherry picked from commit 4ecd119b007cb766b8bede2dc78b70d29cd932dd) Co-authored-by: Luca Chiodini <luca@chiodini.org> Co-authored-by: Luca Chiodini <luca@chiodini.org>
* [3.10] bpo-45467: Fix IncrementalDecoder and StreamReader in the ↵Serhiy Storchaka2021-10-141-289/+297
| | | | | | | | | | | "raw-unicode-escape" codec (GH-28944) (GH-28952) They support now splitting escape sequences between input chunks. Add the third parameter "final" in codecs.raw_unicode_escape_decode(). It is True by default to match the former behavior. (cherry picked from commit 39aa98346d5dd8ac591a7cafb467af21c53f1e5d) Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
* [3.10] bpo-45461: Fix IncrementalDecoder and StreamReader in the ↵Miss Islington (bot)2021-10-141-5769/+10734
| | | | | | | | | | | | "unicode-escape" codec (GH-28939) (GH-28943) They support now splitting escape sequences between input chunks. Add the third parameter "final" in codecs.unicode_escape_decode(). It is True by default to match the former behavior. (cherry picked from commit c96d1546b11b4c282a7e21737cb1f5d16349656d) Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
* [docs] lexical_analysis: Expand the text on ``_`` (GH-28903) (GH-28933)Miss Islington (bot)2021-10-131-4/+16
| | | | | | | | | | | | | | | | Also: * Expand the discussion into its own entry. (Even before this, text on ``_`` was longet than the text on ``_*``.) * Briefly note the other common convention for `_`: naming unused variables. Co-authored-by: Brandt Bucher <brandtbucher@gmail.com> Co-authored-by: Ken Jin <28750310+Fidget-Spinner@users.noreply.github.com> Co-authored-by: Łukasz Langa <lukasz@langa.pl> (cherry picked from commit 3dee0cb6217db326e844955a7f8b424c67990557) Co-authored-by: Petr Viktorin <encukou@gmail.com>
* bpo-20692: Add Programming FAQ entry for 1.__class__ error. (GH-28918)Miss Islington (bot)2021-10-131-0/+21
| | | | | | To avoid error, add either space or parentheses. (cherry picked from commit 380c44087505d0d560f97e325028f27393551164) Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
* Slight correct grammar (GH-28860) Miss Islington (bot)2021-10-121-1/+1
| | | | | (cherry picked from commit 1b11582f0e00f08833da6adc44030a8b1961989a) Co-authored-by: nobodyatandnothing <91722596+nobodyatandnothing@users.noreply.github.com>
* bpo-45441: Update some moved URLs in documentation (GH-28861)Miss Islington (bot)2021-10-124-6/+6
| | | | | (cherry picked from commit b37dc9b3bc9575adc039c6093c643b7ae5e917e1) Co-authored-by: 180909 <wjh180909@gmail.com>
* bpo-42253: Update xml.dom.minidom.rst (GH-23126) (GH-28874)Miss Islington (bot)2021-10-121-0/+8
| | | | | | | | Document that the "standalone" parameter was added in Python 3.9. Co-authored-by: Serhiy Storchaka <storchaka@gmail.com> (cherry picked from commit c7e81fcf9548ab6a0a4828d6f2db9ece9d204826) Co-authored-by: Jens Diemer <github.com@jensdiemer.de>
* bpo-45351, asyncio: Enhance echo server example, print all addresses (GH-28828)Miss Islington (bot)2021-10-111-2/+2
| | | | | (cherry picked from commit 659812b451aefe1f0e5f83540296519a5fb8f313) Co-authored-by: Olaf van der Spek <olafvdspek@gmail.com>
* Fix the "Finding all Adverbs" example (GH-21420) (#28839)Miss Islington (bot)2021-10-101-2/+2
| | | | | | Co-authored-by: Serhiy Storchaka <storchaka@gmail.com> (cherry picked from commit dbd62e74dadda7868f1c0d497414c8f7e4c0b12b) Co-authored-by: Rim Chatti <chattiriim@gmail.com>
* Fix class pattern docs to refer to class patterns (GH-28849)Miss Islington (bot)2021-10-101-1/+1
| | | | | (cherry picked from commit 0bcc5ade9bff086a0b24d71307fae0a891f4efd2) Co-authored-by: Christophe Nanteuil <35002064+christopheNan@users.noreply.github.com>
* bpo-45353: Remind sys.modules users to copy when iterating. (GH-28842)Miss Islington (bot)2021-10-091-1/+5
| | | | | | | | | | | This is true of all dictionaries in Python, but this one tends to catch people off guard as they don't realize when sys.modules might change out from underneath them as a hidden side effect of their code. Copying it first avoids the RuntimeError. An example when this happens in single threaded code are codecs being loaded which are an implicit time of use import that most need not think about. (cherry picked from commit 3d1ca867ed0e3ae343166806f8ddd9739e568ab4) Co-authored-by: Gregory P. Smith <greg@krypto.org>
* Fix dataclassses spelling (GH-28837) (GH-28841)Miss Islington (bot)2021-10-091-1/+1
| | | | | | | (cherry picked from commit 5b4a7675bcfc6368aff955f4a6231579718f5dad) Co-authored-by: Landon Yarrington <33426811+jly36963@users.noreply.github.com> Co-authored-by: Landon Yarrington <33426811+jly36963@users.noreply.github.com>
* [3.10] Remove draft notice on the 3.10 What's new document (GH-28806) (GH-28807)Miss Islington (bot)2021-10-071-7/+0
| | | | | | | Automerge-Triggered-By: GH:pablogsal (cherry picked from commit 32485cecab0111a858055b7a60df3b9903b162e3) Co-authored-by: Pablo Galindo Salgado <Pablogsal@gmail.com>
* [3.10] Fix typo in whatsnew 3.10.rst (GH-26854) (GH-28782)Miss Islington (bot)2021-10-071-1/+1
| | | | | | | | | Thanks for the fix @wiggin15 . (cherry picked from commit 599c07006a636b0a6904008534118a9ba3daf726) Co-authored-by: Arnon Yaari <wiggin15@yahoo.com> Automerge-Triggered-By: GH:JulienPalard
* [doc] Mention __slots__ behavior in weakref.rst (GH-21061) (GH-28772)Miss Islington (bot)2021-10-061-0/+4
| | | | | | | | | | | | It took me longer than I expected to figure out why a random class I dealt with didn't support weak references. I believe this addition will make the __slots__/weakref interaction more discoverable to people having troubles with this. (Before this patch __slots__ was not mentioned in weakref documentation even once). Co-authored-by: Łukasz Langa <lukasz@langa.pl> (cherry picked from commit b24b47e64355224c1bf4e46ed7c4d9f7df4e6f09) Co-authored-by: Jakub Stasiak <jakub@stasiak.at>
* bpo-34804: [doc] Rephrase section on side effects in functional.rst for ↵Miss Islington (bot)2021-10-061-5/+4
| | | | | | | | clarity (GH-27989) (GH-28762) Co-authored-by: Łukasz Langa <lukasz@langa.pl> (cherry picked from commit 7af95a1e8097b2aab2cbe8de88727809e745b658) Co-authored-by: DonnaDia <37962843+DonnaDia@users.noreply.github.com>
* [3.10] [doc] Fix typos found using codespell (GH-28744) (GH-28758)Christian Clauss2021-10-0612-16/+16
|
* sqlite3: Modernize documentation around unicode and bytes. (GH-28652) (GH-28694)Miss Islington (bot)2021-10-052-4/+4
| | | | | (cherry picked from commit 1dac95c814763eb8a53896ac4326d8d51895d43d) Co-authored-by: Julien Palard <julien@palard.fr>
* [doc] Fix gethostbyname_ex description (GH-28700) (GH-28742)Miss Islington (bot)2021-10-051-2/+2
| | | | | | It seems part of `gethostbyname_ex` doc was copied from `gethostbyaddr`. The latter has an `ip_address` parameter whereas the former doesn't. (cherry picked from commit 4103280b83e1419bef535a42813d6dbe83bfe880) Co-authored-by: Andre Delfino <adelfino@gmail.com>
* bpo-45346: Keep docs consistent regarding true and false values (GH-28697) ↵Miss Islington (bot)2021-10-022-5/+5
| | | | (GH-28698)
* bpo-45341: Replace 'Packaging' with 'Package' in "Python P... Index" (GH-28687)Miss Islington (bot)2021-10-022-7/+7
| | | | | | pypi.org " The Python Package Index (PyPI) ... (cherry picked from commit 0be338199fd663f020d833a4db185d0c5a0e0078) Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
* bpo-45125: Improves pickling docs and tests for `shared_memory` (GH-28294)Miss Islington (bot)2021-10-011-0/+27
| | | | | (cherry picked from commit 746d648d47d12d16c2afedaeff626fc6aaaf6a46) Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
* bpo-45291: Explicitly set --libdir=lib when configure OpenSSL (GH-28566) ↵Miss Islington (bot)2021-09-291-0/+1
| | | | | | | (GH-28616) (cherry picked from commit bc4cde40339dd372960f27401d8fdaa4dab0f469) Co-authored-by: zhanpon <pon.zhan@gmail.com>
* [3.10] [docs] Improve the markup of powers (GH-28598) (GH-28607)Łukasz Langa2021-09-289-19/+19
| | | | | (cherry picked from commit 4f05f15d7b25ef8b690cb94fdc4c8cb5521a4e27) Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>