summaryrefslogtreecommitdiffstats
path: root/Doc
Commit message (Collapse)AuthorAgeFilesLines
* Remove the execution bit to some socket-related files. (GH-93368)Miss Islington (bot)2022-06-011-0/+0
| | | | | (cherry picked from commit 5247389369ac3da35c44f7c0d8f4facc0300883a) Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
* Remove VOC reference (93333)Miss Islington (bot)2022-05-311-2/+1
| | | | | | | VOC has been archived by the BeeWare project, and they are instead embedding CPython, rather than transpiling to Java bytecode. (cherry picked from commit bb900712a5511ba82ef64105fe28d2a6886a8fed) Co-authored-by: Carl Bordum Hansen <carl@bordum.dk>
* bpo-42272: fix misleading warning filter message/module docs (GH-23172)Miss Islington (bot)2022-05-301-6/+10
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * bpo-42272: improve message/module warning filter docs "The Warnings Filter" section of the warnings module documentation describes the message and module filters as "a string containing a regular expression". While that is true when they are arguments to the filterwarnings function, it is not true when they appear in -W or $PYTHONWARNINGS where they are matched literally (after stripping any starting/ending whitespace). Update the documentation to note when they are matched literally. Also clarify that module matches the "fully-qualified module name", rather than "module name" which is ambiguous. skip news (since this is a doc fix) Signed-off-by: Kevin Locke <kevin@kevinlocke.name> * bpo-42272: remove bad submodule warning filter doc The `error:::mymodule[.*]` example in the "Describing Warning Filters" section of the warnings module documentation does not behave as the comment describes. Since the module portion of the filter string is interpreted literally, it would match a module with a fully-qualified name that is literally `mymodule[.*]`. Unfortunately, there is not a way to match '"module" and any subpackages of "mymodule"' as documented, since the module part of a filter string is matched literally. Instead, update the filter and comment to match only "mymodule". skip news (since this is a doc fix) Signed-off-by: Kevin Locke <kevin@kevinlocke.name> * bpo-42272: add warning filter doc changes to NEWS Signed-off-by: Kevin Locke <kevin@kevinlocke.name> (cherry picked from commit 8136606769661c103c46d142e52ecbbbb88803f6) Co-authored-by: Kevin Locke <kevin@kevinlocke.name>
* gh-92240 : Include release dates for "What's New In Python 3.X" (GH-92937)Miss Islington (bot)2022-05-298-8/+11
| | | | | | | Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com> Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> (cherry picked from commit 877ad7b3b2778a305d3989d58ebd68cb01baf26e) Co-authored-by: georgically <40323509+georgically@users.noreply.github.com>
* gh-77024: test.support: Improve documentation (GH-92513)Miss Islington (bot)2022-05-271-42/+68
| | | | | | | | | | | | | This is a rework of GH-5774 on current main. I was a bit more conservative in making changes than the original PR. See @csabella's comments on issue GH-77024 and the discussion on GH-5774 for explanations of several of the changes. Co-authored-by: Cheryl Sabella <cheryl.sabella@gmail.com> Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com> (cherry picked from commit 8995177030c8b41885ad92b260279b7e622ecaea) Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* [3.10] gh-92859: Doc: add info about logging.debug() calling basicConfig() ↵Miss Islington (bot)2022-05-232-4/+13
| | | | (GH-93063) (GH-93150)
* gh-89158: Add some REPL secondary prompt markers (GH-93073)Miss Islington (bot)2022-05-231-3/+3
| | | | | | | This fixes an issue on tutorial/classes.rst section 9.4 where the example "class Warehouse" was truncated when pressing the >>> button to hide the prompts and output. (cherry picked from commit 88f0d0c1e8fdda036f3f64b0048911ba28ce7f06) Co-authored-by: Nicolas Haller <nicolas@haller.im>
* gh-92994: Clarify importlib "check" example (GH-92995)Miss Islington (bot)2022-05-231-0/+3
| | | | | | Fixes GH-92994 (cherry picked from commit e39cd765610c9099da3b5595186ad16223b670b0) Co-authored-by: Shantanu <12621235+hauntsaninja@users.noreply.github.com>
* gh-73137: Added sub-subsection headers for flags in re (GH-93000)Miss Islington (bot)2022-05-231-30/+42
| | | | | | Fixes GH-73137 (cherry picked from commit b7a6610bc88dfecdd943e8d2817f7cd6b85fb740) Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
* gh-91362: reword pickle docs to account for nested classes (GH-92429)Miss Islington (bot)2022-05-211-6/+6
| | | | | | Fixes GH-91362 (cherry picked from commit f9d6c59917435980fbe1b58c57257c45bfed2244) Co-authored-by: Shantanu <12621235+hauntsaninja@users.noreply.github.com>
* [3.10] gh-72073: Add Windows case in pathlib.rename (GH-93002) (GH-93029)Miss Islington (bot)2022-05-201-2/+3
| | | | | | | | | | | GH-72073 https://docs.python.org/3.12/library/pathlib.htmlGH-pathlib.Path.rename (cherry picked from commit f51ed04c663417f88e10eeb21dad23250358bafa) Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com> Automerge-Triggered-By: GH:brettcannon
* Doc: add missing manpage and title references in tkinter docs (GH-29008)Miss Islington (bot)2022-05-201-2/+3
| | | | | | | - add bind(3tk) manpage markup - add Tcl/Tk book reference markup (cherry picked from commit 0e12781ad9dec6e46ccb85969c0eb7be1ecad81d) Co-authored-by: Rafael Fontenelle <rffontenelle@users.noreply.github.com>
* bpo-46879: Fix incorrect sphinx object names in doc (GH-31615) (GH-92975)Miss Islington (bot)2022-05-193-0/+7
| | | | | | (cherry picked from commit 2cdd57f119e3b85f1bfd28c7ff040e0d9bcaf115) Co-authored-by: Łukasz Langa <lukasz@langa.pl> Co-authored-by: Martin Fischer <martin@push-f.com>
* gh-92417: `subprocess` docs: remove note on compatibility with Python <3.5 ↵Miss Islington (bot)2022-05-191-3/+0
| | | | | | | (GH-92538) (GH-92973) (cherry picked from commit 84b86000e2bc32b0fbb6dfb6445a7ffc882067d2) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* gh-92417: `fractions`, `decimal`: Improve docs for alternative constructor ↵Miss Islington (bot)2022-05-192-8/+9
| | | | | | | | methods (GH-92421) (GH-92971) Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com> (cherry picked from commit 090df844ea16af3a5df79aba2b9c89ac6a31ba06) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* gh-92417: `socket` docs: remove references to Python <3.3 (GH-92544) (GH-92969)Miss Islington (bot)2022-05-191-2/+2
| | | | | (cherry picked from commit 639b62c9c479e38a6f91a80b261097574a1e7ac7) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* bpo-45393: help() on operator precedence has misleading entries (GH-31246) ↵Miss Islington (bot)2022-05-191-2/+2
| | | | | | | (GH-92966) (cherry picked from commit fb082c2fc5a925085b179e63ca10b7f60b356d2f) Co-authored-by: Zackery Spytz <zspytz@gmail.com>
* gh-92417: Update docs and examples of doctest.IGNORE_EXCEPTION_DETAIL for ↵Miss Islington (bot)2022-05-191-27/+21
| | | | | | Py>=3 (GH-92502) (GH-92963) (cherry picked from commit 97b9c1096feff77a564787ef520cc7d4e1d1c45f)
* Doc: amend ssl.PROTOCOL_SSLv2 and ssl.PROTOCOL_SSLv3 wording (GH-92634)Miss Islington (bot)2022-05-191-3/+3
| | | | | (cherry picked from commit 41638967a0e0bf1114c9bba9454d081605b49009) Co-authored-by: Jan Brasna <1784648+janbrasna@users.noreply.github.com>
* gh-92812: Align ArgumentParser.add_subparsers() docs with argument spec ↵Miss Islington (bot)2022-05-181-1/+1
| | | | | | | (GH-92814) (cherry picked from commit f2d994da104eed38f9e110e7d8f37fa6d845b207) Co-authored-by: 180909 <734461790@qq.com>
* bpo-40838: document `getdoc`, `getmodule`, `getsourcefile` in `inspect` ↵Miss Islington (bot)2022-05-181-2/+5
| | | | | | | | | returns `None` (GH-30575) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com> Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com> (cherry picked from commit b86d783a4eff96306f315acf9a6f1aca85d47fc3) Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
* gh-92780: Improve sqlite3.Connection.create_collation docs (GH-92790)Miss Islington (bot)2022-05-181-11/+8
| | | | | | Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com> (cherry picked from commit 7ee19e27150a72eec9e6a076792e3c3ae8bcffbd) Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
* gh-91755: Document Py_IncRef and Py_DecRef as C functions (GH-91805)Miss Islington (bot)2022-05-181-4/+10
| | | | | | | Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com> Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com> (cherry picked from commit 58a3d28039863b014f57a1ac93b51e20920ebe7b) Co-authored-by: Charlie Zhao <zhaoyu_hit@qq.com>
* gh-80143: Add clarification for escape characters (GH-92292) (GH-92629)Miss Islington (bot)2022-05-161-3/+7
| | | | | (cherry picked from commit 549567c6e70da4846c105a18a1a89e7dd09680d7) Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>
* Speedup: build docs in parallel (GH-92733) (GH-92850)Hugo van Kemenade2022-05-161-1/+1
| | | (cherry picked from commit a487623c6b784847a8a1e47b4597b0ae2b8def87)
* gh-87670: Add web.archive redirects from effbot (GH-92816)Miss Islington (bot)2022-05-163-4/+5
| | | | | (cherry picked from commit 3ed1cae9ed9d1f0dd9d68da4b30b731fdf6be768) Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
* Fix typo in argparse docs. (GH-92691) (#92729)thueringa2022-05-131-1/+1
|
* gh-92611: Link to PEP 594 sections & add key detail in doc deprecation ↵Miss Islington (bot)2022-05-1321-22/+46
| | | | | | | notices (GH-92612) (cherry picked from commit 9f68dab3d327335b938046c50b4f09944e993cc8) Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
* Document Py_ssize_t. (GH-92512)Miss Islington (bot)2022-05-1310-24/+31
| | | | | | | | | It fixes 252 errors from a Sphinx nitpicky run (sphinx-build -n). But there's 8182 errors left. Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com> (cherry picked from commit 664aa94b570a4a8f3535efb2e3d638a4ab655943) Co-authored-by: Julien Palard <julien@palard.fr>
* gh-92436: __future__ docs: add note on expectations for "from __future__ ↵Miss Islington (bot)2022-05-121-1/+9
| | | | | | | import annotations" (GH-92568) (cherry picked from commit 6582c96454ddb731eb412c2a473300172225fdb9) Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* Fix minor documentation error in bisect docs (GH-92697)Miss Islington (bot)2022-05-111-1/+1
| | | | | (cherry picked from commit b3f99b69d03cf0ea72a567a81e8bc4bc074ab303) Co-authored-by: Steve Dower <steve.dower@python.org>
* [3.10] Fix typo in unittest.rst: addCleanupModule -> addModuleCleanup ↵Miss Islington (bot)2022-05-111-1/+1
| | | | | | | | | | (GH-92631) (GH-92660) (cherry picked from commit 38486ca212c0827d54e7b0d0b1e2c1ccc2bdad33) Co-authored-by: Mikhail Terekhov <termim@gmail.com> Automerge-Triggered-By: GH:serhiy-storchaka
* gh-91966 Document where key functions are applied in the bisect module ↵Miss Islington (bot)2022-05-111-15/+52
| | | | (GH-92602) (#92666)
* [3.10] gh-76773: Update docs mentioning no-longer-supported Windows versions ↵Miss Islington (bot)2022-05-107-101/+58
| | | | | | | | | | & features (GH-92529) (GH-92609) (cherry picked from commit f1bbcba74f77eff2a4c0881f3d529f3bf0664d40) Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM> Automerge-Triggered-By: GH:serhiy-storchaka
* bpo-13553: Document tkinter.Tk args (GH-4786)Miss Islington (bot)2022-05-101-10/+66
| | | | | (cherry picked from commit c56e2bb9949c95ec8911cd5554b07044a564796f) Co-authored-by: Cheryl Sabella <cheryl.sabella@gmail.com>
* Doc: Update py2app link. (GH-91585)Miss Islington (bot)2022-05-091-1/+1
| | | | | | See: https://mail.python.org/archives/list/docs@python.org/thread/KDVFGNGGUGGPVRZT7WZYHHWXCRS2GEN7/ (cherry picked from commit b77a95f44a024d1afab28e380252aa6d9c4efb1c) Co-authored-by: Julien Palard <julien@palard.fr>
* bpo-38056: overhaul Error Handlers section in codecs documentation (GH-15732)Miss Islington (bot)2022-05-092-74/+126
| | | | | | | | | | | | | * Some handlers were wrongly described as text-encoding only, but actually they can also be used in text-decoding. * Add more description to each handler. * Add two REPL examples. * Add indexes for Error Handler's name. Co-authored-by: Kyle Stanley <aeros167@gmail.com> Co-authored-by: Victor Stinner <vstinner@python.org> Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com> (cherry picked from commit 5bc2390229bbcb4f13359e867fd8a140a1d5496b) Co-authored-by: Ma Lin <animalize@users.noreply.github.com>
* bpo-39229: fix formatting in library/functions.rst (GH-17857)Miss Islington (bot)2022-05-081-2/+2
| | | | | | Missing reference of auditing event presents error when building translated documentation (cherry picked from commit f298ba1f2712ad10530a30bb225548a6889820b5) Co-authored-by: Rafael Fontenelle <rffontenelle@users.noreply.github.com>
* pdb docs: workaround for double semicolon in strings (GH-17011)Miss Islington (bot)2022-05-081-1/+2
| | | | | | | | see https://github.com/gotcha/ipdb/issues/172 Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com> (cherry picked from commit 2888b1107fd0b43cc800987a00155bdbeacdb23a) Co-authored-by: Godefroid Chapelle <gotcha@bubblenet.be>
* gh-77521: Add link to builtin module names in modules tutorial (GH-92438)Miss Islington (bot)2022-05-081-1/+2
| | | | | | Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com> (cherry picked from commit 859250cc55711f4d62b65922d3f7537826c3801e) Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>
* gh-80856: doc: reveal doctest directives (GH-92318)Miss Islington (bot)2022-05-081-17/+37
| | | | | | | | | | | * Doc: Reveal doctest directives. * Fix whitespace. Co-authored-by: Julien Palard <julien@palard.fr> Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com> (cherry picked from commit 7b024e3a3f77027f747da7580ed0a3ed2dec276a) Co-authored-by: Davide Rizzo <sorcio@gmail.com>
* gh-92417: `logging` docs: Remove warning that only applies to Python <3.2 ↵Miss Islington (bot)2022-05-081-10/+0
| | | | | | | (GH-92425) (cherry picked from commit 318c4e91ef166bcd5d513bb42b9156d54d423d4a) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* [3.10] gh-92417: `asyncio` docs: `asyncio.run()` is available on all ↵Miss Islington (bot)2022-05-081-1/+0
| | | | | | | | | | supported Python versions (GH-92419) (GH-92463) (cherry picked from commit f4e317b304c7f86e48885b4b74c7a8826648922c) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com> Automerge-Triggered-By: GH:serhiy-storchaka
* [3.10] gh-92417: `json` docs: `dict` is ordered on all supported Python ↵Miss Islington (bot)2022-05-081-7/+0
| | | | | | | | | | versions (GH-92422) (GH-92465) (cherry picked from commit bc098cfdb756f207d8fa84793e8ad91a2f263efb) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com> Automerge-Triggered-By: GH:serhiy-storchaka
* [3.10] gh-92417: `doctest` docs: remove references to Python <3.6 (GH-92420) ↵Miss Islington (bot)2022-05-081-9/+0
| | | | | | | | | | (GH-92468) (cherry picked from commit 5639ea1ef9ba8452f81b61ad73152bd1bf1fd3a6) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com> Automerge-Triggered-By: GH:serhiy-storchaka
* [3.10] GH-92431: Fix footnotes in Doc/c-api/exceptions.rst (GH-92432) ↵Miss Islington (bot)2022-05-081-11/+11
| | | | | | | | | | | | | (GH-92470) * Remove redundant footnote ref: the footnote has been removed * Fix footnote ref to match footnote * Convert footnotes into reST footnotes: will error if missing (cherry picked from commit 788ef54bc94b0a7aa2a93f626e4067ab8561424c) Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com> Automerge-Triggered-By: GH:serhiy-storchaka
* [3.10] gh-77630: Change Charset to charset (GH-92439) (GH-92476)Miss Islington (bot)2022-05-081-7/+7
| | | | | | | | (cherry picked from commit 8f293180791f2836570bdfc29aadba04a538d435) Co-authored-by: slateny <46876382+slateny@users.noreply.github.com> Automerge-Triggered-By: GH:serhiy-storchaka
* [3.10] gh-92417: `stdtypes` docs: delete discussion of Python 2 differences ↵Miss Islington (bot)2022-05-081-10/+0
| | | | | | | | | | | | | (GH-92423) (GH-92473) Given that 2.7 has now been end-of-life for two and a half years, I don't think we need such a detailed explanation here anymore of the differences between Python 2 and Python 3. (cherry picked from commit 8efda1e7c6343b1671d93837bf2c146e4cf77bbf) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com> Automerge-Triggered-By: GH:serhiy-storchaka
* gh-92417: `typing` docs: `from __future__ import annotations` can be used in ↵Miss Islington (bot)2022-05-081-1/+1
| | | | | | | all supported Python versions (GH-92418) (cherry picked from commit e5b4bd4d60aaf0292c5b9d628512145b8987b3c6) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* [3.10] gh-92448: Update the documentation builder to render the GitHub issue ↵Dong-hee Na2022-05-081-4/+5
| | | | (GH-92449). (GH-92457)