summaryrefslogtreecommitdiffstats
path: root/Doc
Commit message (Collapse)AuthorAgeFilesLines
* gh-96959: Update more HTTP links (GH-97536)Miss Islington (bot)2022-09-2722-101/+101
| | | | | | | Use HTTPS for documents which are available by both HTTP and HTTPS links, but there is no redirection from HTTP to HTTPS or vice versa. (cherry picked from commit dd53b79de0ea98af6a11481217a961daef4e9774) Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
* [3.10] gh-97567: Fixup cached_statements default value in sqlite3.connect ↵Jia Junjie2022-09-271-1/+1
| | | | | docs (#97568) This docs inconsistency was introduced by the 3.10 backport of gh-94629: gh-94646
* GH-65046: Fix docs about logging in `asyncio` (GH-97559)Miss Islington (bot)2022-09-261-0/+4
| | | | | | Explain that logging should not use network I/O. (cherry picked from commit d68c37c0d08542a346a13b150a204208bb0408f5) Co-authored-by: Kumar Aditya <59607654+kumaraditya303@users.noreply.github.com>
* gh-82530: Create blank function instead of invalid import for email example ↵Miss Islington (bot)2022-09-261-5/+9
| | | | | | | | (GH-97529) Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu> (cherry picked from commit 2b428a1faed88f148ede131e3b86ab6227c6c3f0) Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
* gh-96959: Update HTTP links which are redirected to HTTPS (GH-96961)Miss Islington (bot)2022-09-2514-18/+18
| | | | | (cherry picked from commit db39050396a104c73d0da473a2f00a62f9dfdfaa) Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
* gh-77171: Document that wave only supports simple PCM files (GH-97510)Miss Islington (bot)2022-09-231-1/+2
| | | | | (cherry picked from commit dc9065f8c2ddc483d387d977e0818d131fa67420) Co-authored-by: Steve Dower <steve.dower@python.org>
* gh-75608: Add Windows FAQ entry for missing UCRT (GH-92765)Miss Islington (bot)2022-09-231-0/+8
| | | | | (cherry picked from commit 80bc7d7c0a3f777da244ec79429baf382523b8da) Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
* gh-96397: Document that keywords in calls need not be identifiers (GH-96393)Miss Islington (bot)2022-09-221-2/+12
| | | | | | | This represents the official SC stance, see https://github.com/python/steering-council/issues/142GH-issuecomment-1252172695 (cherry picked from commit 9d432b4a181cd42017699de4354e7b36c5b87d88) Co-authored-by: Jeff Allen <ja.py@farowl.co.uk>
* gh-81039: Add small example of f-string's "=}" to tutorial (gh-92291) (gh-96990)Miss Islington (bot)2022-09-212-1/+12
| | | | | | | (cherry picked from commit 4b81139aac3fa11779f6eedb6e621bde29e64b30) Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com> Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
* [3.10] gh-68966: Make mailcap refuse to match unsafe filenames/types/params ↵Miss Islington (bot)2022-09-202-0/+20
| | | | | | | | | | (GH-91993) (GH-93543) * gh-68966: Make mailcap refuse to match unsafe filenames/types/params (GH-91993) (cherry picked from commit b9509ba7a9c668b984dab876c7926fe1dc5aa0ba) * Add a What's New entry for 3.10.8. Co-authored-by: Petr Viktorin <encukou@gmail.com> Co-authored-by: Gregory P. Smith <greg@krypto.org>
* [3.10] gh-96917: link to typing.readthedocs.io from typing.rst (GH-96921) ↵Shantanu2022-09-201-0/+5
| | | | | | | | (GH-96937) See the discussion at https://github.com/python/cpython/issues/91533. (cherry picked from commit 5b3a2569f4b4dfb58a8f90a241f9dac1a7ea4bf6) Co-authored-by: Shantanu <12621235+hauntsaninja@users.noreply.github.com>
* [3.10] gh-96727: Document restrictions on Handler.emit() with respect to ↵Vinay Sajip2022-09-201-0/+16
| | | | | locking. (GH-96948) (GH-96951) (cherry picked from commit 6ad47b41a650a13b4a9214309c10239726331eb8)
* gh-95778: Mention sys.set_int_max_str_digits() in error message (GH-96874)Miss Islington (bot)2022-09-161-2/+2
| | | | | | | When ValueError is raised if an integer is larger than the limit, mention sys.set_int_max_str_digits() in the error message. (cherry picked from commit e841ffc915e82e5ea6e3b473205417d63494808d) Co-authored-by: Victor Stinner <vstinner@python.org>
* gh-96810: Clarify for which statements sqlite3 implicitly opens transactions ↵Miss Islington (bot)2022-09-151-1/+2
| | | | | | | (GH-96832) (cherry picked from commit 16c33a9676e2f3ef330d09f2ab515c56636fa09f) Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
* gh-95778: Fix `sys.set_int_max_str_digits()` parameter name (GH-96798)Miss Islington (bot)2022-09-131-1/+1
| | | | | | Discovered in https://github.com/python/typeshed/pull/8733 (cherry picked from commit bf5fd492524f1b630a60c98eff8fe5fa66603b54) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* [3.10] gh-96702: Order methods before attrs in sqlite3.Connection docs ↵Erlend E. Aasland2022-09-131-97/+95
| | | | | | | (GH-96703). (#96789) (cherry picked from commit 49cceeb5c998a51bb12b7dbde17b53647bb52113) Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
* gh-94972: document that shield users need to keep a reference to their task ↵Miss Islington (bot)2022-09-102-5/+14
| | | | | | | | | (GH-96724) Co-authored-by: Thomas Grainger <tagrain@gmail.com> Co-authored-by: Guido van Rossum <gvanrossum@gmail.com> (cherry picked from commit 6281affee6423296893b509cd78dc563ca58b196) Co-authored-by: Hendrik Makait <hendrik.makait@gmail.com>
* [3.10] gh-88287: Add BufferingFormatter documentation. (GH-96608) (GH-96674)Miss Islington (bot)2022-09-081-0/+29
|
* [doc] Update example in traceback doc (GH-96600) (GH-96605)Irit Katriel2022-09-071-15/+11
| | | | | | This Monty Python reference is of-its-time. It could seem inappropriate in the context of today's sensibilities around mental health. Automerge-Triggered-By: GH:iritkatriel (cherry picked from commit c4999f261fb0cb28ef713b48ef2e81ca5a3eb1e1)
* [3.10] gh-84095: Fill documentation gap regarding user-defined objects. ↵Vinay Sajip2022-09-051-1/+20
| | | | (GH-… (GH-96576)
* Docs: alphabetically order sqlite3.Cursor attrs (GH-96565)Miss Islington (bot)2022-09-041-30/+31
| | | | | (cherry picked from commit 9e5568578234f0ecd003247c8a2deaeb69976b4b) Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
* gh-68163: Correct conversion of Rational instances to float (GH-25619) ↵Miss Islington (bot)2022-09-041-3/+6
| | | | | | | | | | | | (GH-96557) * gh-68163: Correct conversion of Rational instances to float Also document that numerator/denominator properties are instances of Integral. Co-authored-by: Mark Dickinson <dickinsm@gmail.com> (cherry picked from commit 8464b754c4168586b99e2135ccd2567e025625a9) Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>
* gh-95778: remove unneeded doc note on float.as_integer_ratio (GH-96553)Miss Islington (bot)2022-09-041-7/+0
| | | | | | Per mdickinson@'s comment on the main branch PR. (cherry picked from commit 69bb83c2bf254f92491d527ccec1ff41897add56) Co-authored-by: Gregory P. Smith <greg@krypto.org>
* doc typo: spell limitation (GH-96542)Miss Islington (bot)2022-09-041-1/+1
| | | | | (cherry picked from commit af6359dd5c5e20adec12501aaa6074716c316e41) Co-authored-by: Mehrdad Moradizadeh <mhrddmoradii@gmail.com>
* [3.10] gh-89087: Update logging.QueueHandler documentation to clarify ↵Miss Islington (bot)2022-09-031-0/+14
| | | | record… (GH-96527) (GH-96529)
* bpo-30419: DOC: Update missing information in bdb docs (GH-1687)Miss Islington (bot)2022-09-021-58/+123
| | | | | | | | Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com> Co-authored-by: Martin Panter <vadmium@users.noreply.github.com> Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu> (cherry picked from commit ccce9b77e1f599e05425eadc0cc372d142fe05e0) Co-authored-by: Cheryl Sabella <cheryl.sabella@gmail.com>
* [3.10] gh-95778: CVE-2020-10735: Prevent DoS by very large int() (#96501)Gregory P. Smith2022-09-028-15/+272
| | | | | | | | | | | | | | | | | Integer to and from text conversions via CPython's bignum `int` type is not safe against denial of service attacks due to malicious input. Very large input strings with hundred thousands of digits can consume several CPU seconds. This PR comes fresh from a pile of work done in our private PSRT security response team repo. This backports https://github.com/python/cpython/pull/96499 aka 511ca9452033ef95bc7d7fc404b8161068226002 Signed-off-by: Christian Heimes [Red Hat] <christian@python.org> Tons-of-polishing-up-by: Gregory P. Smith [Google] <greg@krypto.org> Reviews via the private PSRT repo via many others (see the NEWS entry in the PR). <!-- gh-issue-number: gh-95778 --> * Issue: gh-95778 <!-- /gh-issue-number --> I wrote up [a one pager for the release managers](https://docs.google.com/document/d/1KjuF_aXlzPUxTK4BMgezGJ2Pn7uevfX7g0_mvgHlL7Y/edit#).
* gh-96168: Improve sqlite3 dict_factory example (GH-96457)Miss Islington (bot)2022-09-011-18/+9
| | | | | | | Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM> Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com> (cherry picked from commit 91f40f3f78d6016a283989e32ec3d1fb61bcebca) Co-authored-by: Erlend E. Aasland <erlend.aasland@innova.no>
* [3.10] gh-96414: Inline code examples in sqlite3 docs (GH-96442). (#96453)Erlend E. Aasland2022-08-3114-283/+308
| | | | | | * [3.10] gh-96414: Inline code examples in sqlite3 docs (GH-96442). (cherry picked from commit f7e7bf161aaec5a5cffdcec7c97e1f09e445421b) Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
* Docs: normalise sqlite3 placeholder how-to heading (GH-96413)Miss Islington (bot)2022-08-301-2/+2
| | | | | (cherry picked from commit 7b01ce7953c0e24aa7aeaf207216fc9e7aefd18a) Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
* Docs: Improve clarity for bytes.hex() (GH-95257)Miss Islington (bot)2022-08-301-3/+4
| | | | | (cherry picked from commit 860fa351452de1502da12ec6f027d3f72dfc309f) Co-authored-by: Tim Burke <tim.burke@gmail.com>
* [3.10] gh-91305: Add a note about DatagramHandler and DNS latency. ↵Miss Islington (bot)2022-08-301-0/+7
| | | | (GH-96380) (GH-96400)
* Doc: Update Py_TPFLAGS_HAVE_FINALIZE in docs (GH-96273)Miss Islington (bot)2022-08-301-3/+6
| | | | | | It is now deprecated and the docs should reflect that. (cherry picked from commit 9625de6fab4597bcd04ec390b680b053b0533816) Co-authored-by: da-woods <dw-git@d-woods.co.uk>
* [3.10] Docs: normalize SQL style in sqlite3 docs (GH-96403). (#96409)Erlend E. Aasland2022-08-301-6/+6
| | | | | (cherry picked from commit 6d403e264a7dcd1544a91708f139c6dd8612204d) Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
* [3.10] gh-95432: Add doctests for the sqlite3 docs (GH-96225) (#96379)Erlend E. Aasland2022-08-292-48/+91
| | | | | | | | | | As a consequence of the added test, this commit also includes fixes for broken examples. - Add separate namespace for trace tests bco. module level callback - Move more backup and cursor examples under separate namespaces. (cherry picked from commit bf9259776dff5348bc854983409ea68618c1f174) Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
* GH-96359: Fix docs that claim int(0|1) doesn't match False (GH-96361)Miss Islington (bot)2022-08-291-1/+1
| | | | | (cherry picked from commit 3d3a86ed40626471b2c9e7f1336b228eb0dd0879) Co-authored-by: Jonathan Oberländer <github@l3vi.de>
* [3.10] gh-95994: Clarify escaped newlines. (GH-96066) (#96360)Ezio Melotti2022-08-281-11/+21
| | | | | | | | | | | | | | | | * gh-95994: clarify escaped newlines. * Rephrase ambiguous sentence. Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM> * Use `<newline>` in escape sequences table. Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM> Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>. (cherry picked from commit c3d591fd0699605c8253beda2372114052a7bdba) Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
* [3.10] gh-77116: Add SMTP buffering example to logging cookbook. (GH-96324) ↵Miss Islington (bot)2022-08-271-0/+82
| | | | (GH-96325)
* gh-96197: Define the behavior of repr if sys.displayhook is lost (gh-96242)Miss Islington (bot)2022-08-261-0/+2
| | | | | (cherry picked from commit 0319cd6825f3c247a875c91493a38992fb33a5b3) Co-authored-by: Dong-hee Na <donghee.na@python.org>
* gh-96197: Fix expression when :func:`sys.breakpointhook is missing (gh-96293)Miss Islington (bot)2022-08-261-1/+1
| | | | | (cherry picked from commit 47d406ffc4946b023e38322c5235bec25f068481) Co-authored-by: Dong-hee Na <donghee.na@python.org>
* Clarify API stability of PyTypeObject in relation to static types. (GH-96217)Miss Islington (bot)2022-08-251-3/+3
| | | | | | | | | | Fixes: https://github.com/python/cpython/issues/95300 Related: https://github.com/python/cpython/issues/91271 (cherry picked from commit caa2a9799a47294441e4206037620322eea9ed06) Co-authored-by: ov2k <ov2k.github@gmail.com>
* [3.10] gh-91070: Add note about SysLogHandler on macOS 12.x (Monterey). ↵Miss Islington (bot)2022-08-251-0/+6
| | | | (GH-94803) (GH-96261)
* GH-96179: Fix misleading example on the bisect documentation (GH-96228)Miss Islington (bot)2022-08-241-1/+1
| | | | | | The `movies[bisect(movies, 1960, key=by_year)]` will actually return only movies **after** 1960. (cherry picked from commit 4317b25a2323ae4be04574e45de0e335c571c463) Co-authored-by: prego <pedropregueiro@gmail.com>
* gh-96197: Define the behavior of breakpoint if sys.breakpointhook is lost ↵Miss Islington (bot)2022-08-241-0/+2
| | | | | | | (gh-96231) (cherry picked from commit 09563a764ebc54f98087c128419f46cf0822b4b7) Co-authored-by: Dong-hee Na <donghee.na@python.org>
* [3.10] gh-94635: Frame sqlite3 how-to headings as such & move default ↵Erlend E. Aasland2022-08-241-43/+45
| | | | | | | | | adapters to reference (GH-96136) (#96227) Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com> Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>. (cherry picked from commit 6bda5b85b53443f3467865fbf85cbe72932e7cd6) Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
* gh-96096: Add undocumented SQLITE_OK/DENY/IGNORE sqlite3 constants (GH-96134)Miss Islington (bot)2022-08-231-4/+14
| | | | | | | Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com> Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com> (cherry picked from commit d6259c58cbb48b8f3fbd70047f004ea19fe91e86) Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
* gh-95432: Add doctest for sqlite3 tutorial (GH-96193)Miss Islington (bot)2022-08-231-16/+47
| | | | | (cherry picked from commit 04c73e5efbfea8ae9da5bd518cee96086017ef4f) Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
* gh-96121: Merge sqlite3.Row examples into sqlite3.Row class doc (GH-96122)Miss Islington (bot)2022-08-222-70/+18
| | | | | | | Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com> Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM> (cherry picked from commit 18b1782192f85bd26db89f5bc850f8bee4247c1a) Co-authored-by: Erlend E. Aasland <erlend.aasland@innova.no>
* gh-96098: Clearly link concurrent.futures from threading & multiprocessing ↵Miss Islington (bot)2022-08-212-1/+23
| | | | | | | | | | docs (GH-96112) Clearly link concurrent.futures from threading & multiprocessing docs Also link directly to asyncio from the beginning of the threading docs. (cherry picked from commit bcc4cb0c7d5e0590928e74cae86b0a7938c0f74b) Co-authored-by: Nick Coghlan <ncoghlan@gmail.com>
* Docs: Fix markup of module name in sqlite3 docs (GH-96115)Miss Islington (bot)2022-08-191-3/+3
| | | | | (cherry picked from commit ee9f22d3464308566c63e972133ebf71b7664baa) Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>