summaryrefslogtreecommitdiffstats
Commit message (Collapse)AuthorAgeFilesLines
* Add link to documentation translation list (GH-91560) (#91589)Miss Islington (bot)2022-04-161-0/+4
| | | | | | | (cherry picked from commit c4e8a93eb3fa5e5d930cea64f213443242c2588c) Co-authored-by: slateny <46876382+slateny@users.noreply.github.com> Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>
* gh-88513: clarify shutil.copytree's dirs_exist_ok arg (GH-91434) (GH-91464)Miss Islington (bot)2022-04-153-9/+17
| | | | | | | * add a paragraph to document this kwarg in detail * update docstring in the source accordingly (cherry picked from commit f33e2c87a83917b5139d97fd8ef7cba7223ebef5) Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* gh-70979: Fix runpy.run_path parameter name in docs (GH-32265)Miss Islington (bot)2022-04-151-2/+2
| | | | | | Noticed while reviewing GH-30729. (cherry picked from commit f1e989b04507db6f0adbccb5e1624d81cb217ea8) Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* Add redirects to Misc/NEWS bpo links (GH-91454) (GH-91535)Miss Islington (bot)2022-04-141-1/+2
| | | | | (cherry picked from commit 17dbb6bc10ca8a8b602335414c047294f00afcbe) Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
* gh-90879: Fix missing parameter for put_nowait() (GH-91514)Miss Islington (bot)2022-04-142-3/+3
| | | | | (cherry picked from commit 0fc3517cf46ec79b4681c31916d4081055a7ed09) Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>
* gh-91421: Use constant value check during runtime (GH-91422) (GH-91492)Miss Islington (bot)2022-04-142-1/+2
| | | | | | | | | | | | | | | | The left-hand side expression of the if-check can be converted to a constant by the compiler, but the addition on the right-hand side is performed during runtime. Move the addition from the right-hand side to the left-hand side by turning it into a subtraction there. Since the values are known to be large enough to not turn negative, this is a safe operation. Prevents a very unlikely integer overflow on 32 bit systems. Fixes GH-91421. (cherry picked from commit 0859368335d470b9ff33fc53ed9a85ec2654b278) Co-authored-by: Tobias Stoeckmann <stoeckmann@users.noreply.github.com>
* bpo-47260: Fix os.closerange() potentially being a no-op in a seccomp ↵Miss Islington (bot)2022-04-082-4/+7
| | | | | | | | | | | | | | | | | | | | | sandbox (GH-32418) _Py_closerange() currently assumes that close_range() closes all file descriptors even if it returns an error (other than ENOSYS). This assumption can be wrong on Linux if a seccomp sandbox denies the underlying syscall, pretending that it returns EPERM or EACCES. In this case _Py_closerange() won't close any descriptors at all, which in the worst case can be a security issue. Fix this by falling back to other methods in case of any close_range() error. Note that fallbacks will not be triggered on any problems with closing individual file descriptors because close_range() is documented to ignore such errors on both Linux[1] and FreeBSD[2]. [1] https://man7.org/linux/man-pages/man2/close_range.2.html [2] https://www.freebsd.org/cgi/man.cgi?query=close_range&sektion=2 (cherry picked from commit 1c8b3b5d66a629258f1db16939b996264a8b9c37) Co-authored-by: Alexey Izbyshev <izbyshev@ispras.ru>
* Fix bad grammar and import docstring for split/rsplit (GH-32381) (GH-32416)Miss Islington (bot)2022-04-082-22/+37
|
* pickle docs: Fix typos and improve wording (GH-24776) (GH-32395)Miss Islington (bot)2022-04-081-24/+23
| | | | | | Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com> (cherry picked from commit 1d0f08fa46b54f5a9b43a916b66d50b97d56cf36) Co-authored-by: Géry Ogam <gery.ogam@gmail.com>
* bpo-47103: Copy pgort140.dll into output directory when building ↵Steve Dower2022-04-073-18/+18
| | | | PGInstrument on Windows (GH-32083)
* ssl docs: Fix typo (GH-32336)Miss Islington (bot)2022-04-071-1/+1
| | | | | (cherry picked from commit 9ee2d3a93914776d15ac5cc7c44bb3aaca3e0fe5) Co-authored-by: Frederick <fmoor@users.noreply.github.com>
* c-api docs: There are five fields, not four (GH-32379)Miss Islington (bot)2022-04-071-1/+1
| | | | | (cherry picked from commit 4c92427fb85e420404a9bd26347e32acc1bbd3b7) Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* doc: Link to `string.capwords` from `str.title` (GH-20913)Miss Islington (bot)2022-04-071-1/+5
| | | | | | | | Since `title()` mentions its own short-comings, it should also mention the library function which does not possess them. Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com> (cherry picked from commit b786d9ec52a2c2b0b6627be7fd4a3948c61fbdea) Co-authored-by: Eric Wieser <wieser.eric@gmail.com>
* ssl docs: Fix typo (GH-32314)Miss Islington (bot)2022-04-071-1/+1
| | | | | (cherry picked from commit 1da9c38fd352465fd3d1a00e64dc90444b421730) Co-authored-by: Frederick <fmoor@users.noreply.github.com>
* pkgutil docs: Link sys constants, add backticks (GH-32356)Miss Islington (bot)2022-04-071-4/+4
| | | | | | Co-authored-by: Éric <merwok@netwok.org> (cherry picked from commit 63bd72448a5af01206c2a9aec5f1ed1e903f1e12) Co-authored-by: Boris Verkhovskiy <boris.verk@gmail.com>
* stdtypes docs: fix typo (GH-32349) (GH-32370)Miss Islington (bot)2022-04-071-1/+1
| | | | | (cherry picked from commit b33c4564aceeae8323bcb19167fbbd2d5f5002bc) Co-authored-by: Ian <40774387+isteptoe@users.noreply.github.com>
* [3.10] bpo-46769: Fix backticks in typing.rst to appease rstlint (GH-32374)Ken Jin2022-04-062-2/+2
| | | | | * Use double backticks to appease rstlint * Update susp-ignored.csv
* bpo-47235: Note where a typo is intentional in code. (GH-32348)Miss Islington (bot)2022-04-061-4/+4
| | | | | | | | | | | | | | People keep popping up reporting these as typos in the docs despite being described as typos in the surrounding text. Hopefully a comment on the line itself makes it more obvious? Arguably some of the typo examples are not using the "right" typo as the "assret" one in particular is now detected by default due to how common it was in actual code. But I don't want to to typo chasing by changing these examples to be other not yet auto-detected typos as they still illustrate the point well enough. (cherry picked from commit ac1fb07b6ecb6b93446484f52894914e5199de63) Co-authored-by: Gregory P. Smith <greg@krypto.org>
* bpo-47230: Silence compiler warnings on Windows from zlib 1.2.12 (GH-32337)Jeremy Kloth2022-04-051-1/+3
| | | | | (cherry picked from commit 944f09adfcc59f54432ac2947cf95f3465d90e1e) Co-authored-by: Jeremy Kloth <jeremy.kloth@gmail.com>
* [3.10] Backport bpo-47212 (GH-32302) to Python 3.10 (GH-32334)Matthieu Dartiailh2022-04-057-8/+28
| | | | | | | | | (cherry picked from commit aa0f056a00c4bcaef83d729e042359ddae903382) # Conflicts: # Grammar/python.gram # Parser/action_helpers.c Automerge-Triggered-By: GH:pablogsal
* bpo-40982: shutil docs: Remove outdated copytree() example (GH-24778)Miss Islington (bot)2022-04-051-36/+1
| | | | | | | It is not preferable to keep a copy of the implementation in the docs. (cherry picked from commit e06f920c5bc6e9fad29082ba0d84043722806e17) Co-authored-by: Zackery Spytz <zspytz@gmail.com>
* crypt docs: Fix references to `methods` attr (GH-26806)Miss Islington (bot)2022-04-051-4/+3
| | | | | | Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com> (cherry picked from commit cae0f5d3dad6db0d13690e5952ae2015ad8b3a05) Co-authored-by: andrei kulakov <andrei.avk@gmail.com>
* bpo-32658: Regex docs: Fix metacharacter reference (GH-32230)Miss Islington (bot)2022-04-051-1/+1
| | | | | | Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com> (cherry picked from commit 43571a3eea8b5931769376daf4bdad1c9184ae0d) Co-authored-by: Mike cm <mikecmcleod@gmail.com>
* bpo-45790: List macros in same order in which fields are described (GH-29529)Miss Islington (bot)2022-04-052-2/+4
| | | | | | | | Signed-off-by: Rodrigo Tobar <rtobar@icrar.org> Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com> (cherry picked from commit b275267aa7d44ec90fa435c9cb1610c549da745a) Co-authored-by: rtobar <rtobar@icrar.org>
* bpo-47007: [doc] `str` special method lookup (GH-31863)Miss Islington (bot)2022-04-051-1/+2
| | | | | | | | | Clarify the `str()` docs to point out that `object.__str__()` follows special method lookup. Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com> (cherry picked from commit bb86d1d9fbd1888524e04475383f4ea764277f67) Co-authored-by: Vanshaj Singhania <8797467+itsvs@users.noreply.github.com>
* bpo-41233: Add links to errnos referenced in exceptions docs (GH-21380)Miss Islington (bot)2022-04-054-37/+54
| | | | | | | Co-authored-by: Andrew Kuchling <amk@amk.ca> Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com> (cherry picked from commit a74892cb2168d249d9a8c53fad605a5def9b41d4) Co-authored-by: yyyyyyyan <24644216+yyyyyyyan@users.noreply.github.com>
* bpo-46484:Add test for Calendar.iterweekdays (GH-30825)Miss Islington (bot)2022-04-042-0/+9
| | | | | (cherry picked from commit 48269ea9fdbc5804f80962364f95e69097c417ba) Co-authored-by: 180909 <734461790@qq.com>
* Demonstrate `py --list` in the quickstart section of the Windows doc page ↵Miss Islington (bot)2022-04-041-0/+6
| | | | | | | (GH-29383) (cherry picked from commit 1ecfe3d5ae4ddec4e73a6cfc93fed6df43fe0be5) Co-authored-by: Christian Clauss <cclauss@me.com>
* Follow PEP-8 guidelines in tutorial for standard library (GH-26127)Miss Islington (bot)2022-04-031-2/+3
| | | | | (cherry picked from commit 6db2db91b96aaa1270c200ec931a2250fe2799c7) Co-authored-by: Bob Kline <bkline@users.noreply.github.com>
* bpo-47205: Skip error check of sched_get/setaffinity on FreeBSD (GH-32285)Miss Islington (bot)2022-04-032-2/+8
| | | | | (cherry picked from commit b82cdd1dac9a9be52051abd90a1ce69236ac41f4) Co-authored-by: Christian Heimes <christian@python.org>
* Language reference: Remove duplicated text about iterable unpacking (GH-25212)Miss Islington (bot)2022-04-031-3/+1
| | | | | (cherry picked from commit 4f5d56f8f33196f5ed8ffad0ab2f012afda2f9b3) Co-authored-by: Jiashuo Li <4003950+jiasli@users.noreply.github.com>
* bpo-24563: Link encoding names to encoding declarations (GH-32274)Miss Islington (bot)2022-04-031-3/+2
| | | | | (cherry picked from commit 01be5d6446abbdd95d0c18bd19a58a62b05568d8) Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
* [3.10] More minor fixes to C API docs (GH-31525) (GH-32258)Jelle Zijlstra2022-04-0213-28/+29
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * wording fixes in type.rst * grammar and punctuation in sys.rst * set: grammar fixes * structures: capitalization fix * grammar fixes for sequence * objects: point to Py_TYPE instead of direct object access * numbers: add more explicit Python equivalences * method: add missing period * memory: grammar fix * mapping: grammar fixes * long: grammar fix * iter: fix grammar for PyAIter_Check * init: grammar fix. (cherry picked from commit 897bc6f9282238d5fb32d232ab62d30675244736) Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* [3.10] Document func parameter of locale.atof (GH-18183) (GH-32262)Jelle Zijlstra2022-04-021-3/+3
| | | | | | | | | | | | The second parameter (named `func`) has been present since the `locale` module was introduced in eef1d4e8b1, but has never been documented. This commit updates the documentation for `locale.atof` to clarify the behavior of the function and how the `func` parameter is used. Signed-off-by: Kevin Locke <kevin@kevinlocke.name> (cherry picked from commit 208da6d508bb2683732151f4ae288dfc8001267c) Co-authored-by: Kevin Locke <kevin@kevinlocke.name>
* bpo-45584: Clarify `math.trunc` documentation (GH-29183)Miss Islington (bot)2022-04-021-8/+10
| | | | | | | | | | | While floor/ceil 's documentation are very precise, `truncate` was not explained. I actually had to search online to understand the difference between `truncate` and `floor` (admittedly, once I remembered that numbers are signed, and that floating numbers actually uses a bit for negation symbol instead of two complement, it became obvious) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com> Co-authored-by: Éric Araujo <merwok@netwok.org> Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu> Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com> (cherry picked from commit ebbdbbff5d6840807e46ec61b8a323e94ee88de2) Co-authored-by: Arthur Milchior <arthur@milchior.fr>
* os docs: fix typo (GH-28996)Miss Islington (bot)2022-04-021-1/+1
| | | | | | Co-authored-by: Jacob Walls <jacobtylerwalls@gmail.com> (cherry picked from commit 1f80dcd2442f2a354097797fedc077592984903b) Co-authored-by: Vitor Buxbaum Orlandi <vitorbuxbaum@gmail.com>
* codecs docs: fix grammar mistake (GH-29462)Miss Islington (bot)2022-04-021-1/+1
| | | | | (cherry picked from commit ea56845744e815ed468dfbdd835110254c3be997) Co-authored-by: 180909 <wjh180909@gmail.com>
* bpo-45114: Use lstat() instead of stat() in stat docs example (GH-29845)Miss Islington (bot)2022-04-021-1/+1
| | | | | (cherry picked from commit c93a0ac6972221787d8bea1c41a9feb667ed3d2c) Co-authored-by: 180909 <wjh180909@gmail.com>
* bpo-47031: Improve documentation for `math.nan` (GH-32170)Miss Islington (bot)2022-04-021-2/+17
| | | | | | Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com> (cherry picked from commit 182e93c3f57b0c72e765c9896066d32e461c0865) Co-authored-by: Charlie Zhao <zhaoyu_hit@qq.com>
* More minor fixes to C API docs (GH-31714)Miss Islington (bot)2022-04-025-11/+9
| | | | | | | | | | * init_config: wording fixes * bytearray: remove XXX, there is a good link to the buffer docs * bytes, call, exceptions: minor wording fixes (cherry picked from commit 677a87946630c5fbd9998969669b4dd4f4b32545) Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* bpo-47194: Update zlib to v1.2.12 on Windows to resolve CVE-2018-25032 ↵Miss Islington (bot)2022-04-023-2/+3
| | | | | | | (GH-32241) (cherry picked from commit 6066739ff7794e54c98c08b953a699cbc961cd28) Co-authored-by: Zachary Ware <zach@python.org>
* bpo-47089: Avoid test_compileall failures on Windows (GH-32037)Miss Islington (bot)2022-04-011-48/+36
| | | | | (cherry picked from commit 76b8a075b8a79b08468fd0ed06a489a5c815bc11) Co-authored-by: Jeremy Kloth <jeremy.kloth@gmail.com>
* [3.10] bpo-47182: Fix crash by named unicode characters after interpreter ↵Christian Heimes2022-04-012-0/+5
| | | | | reinitialization (GH-32212) (GH-32216) Co-authored-by: Christian Heimes <christian@python.org>
* bpo-47151: Fallback to fork when vfork fails in subprocess. (GH-32186)Miss Islington (bot)2022-03-312-0/+9
| | | | | | bpo-47151: Fallback to fork when vfork fails in subprocess. An OS kernel can specifically decide to disallow vfork() in a process. No need for that to prevent us from launching subprocesses. (cherry picked from commit 4a08c4c469d36f99d3a5e0f17ad82ab35dcf2835) Co-authored-by: Gregory P. Smith <greg@krypto.org>
* bpo-14911: Corrected generator.throw() documentation (GH-32207)Miss Islington (bot)2022-03-314-8/+28
| | | | | | Co-authored-by: Andrew Svetlov <andrew.svetlov@gmail.com> (cherry picked from commit 8be7c2bc5ad5e295f0f855bb31db412eef2c7c92) Co-authored-by: Dave Goncalves <davegoncalves@gmail.com>
* bpo-46775: OSError should call winerror_to_errno unconditionally on Windows ↵Miss Islington (bot)2022-03-312-8/+4
| | | | | | | (GH-32179) (cherry picked from commit d0c67ea0645b7ad37b867c167882a346a24de641) Co-authored-by: Dong-hee Na <donghee.na@python.org>
* bpo-42340: Document issues around KeyboardInterrupt (GH-23255)Miss Islington (bot)2022-03-293-0/+82
| | | | | | | | Update documentation to note that in some circumstances, KeyboardInterrupt may cause code to enter an inconsistent state. Also document sample workaround to avoid KeyboardInterrupt, if needed. (cherry picked from commit d0906c90fcfbc4cfb9bb963eaa6bb152dd543b56) Co-authored-by: benfogle <benfogle@gmail.com>
* Fix typo in the sqlite3 docs (GH-31915) (GH-32157)Miss Islington (bot)2022-03-291-1/+1
| | | | | | | Co-authored-by: Jonathan <89750679+AHypnotoad@users.noreply.github.com> (cherry picked from commit 66584c890d016e40d707400130d1cd98f2aedde9) Co-authored-by: Jonathan <jonathan.joyner94@gmail.com> Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* ctypes docs: Fix array-length reference to "non-negative" from "positive" ↵Miss Islington (bot)2022-03-291-1/+1
| | | | | | | | (GH-32097) (GH-32142) (cherry picked from commit 76f14b0463dc2c53911eaf95e85374e511ba9bcc) Co-authored-by: Yonatan Goldschmidt <yon.goldschmidt@gmail.com> Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* [3.10] bpo-28516: document contextlib.ExitStack.__enter__ behavior ↵Jelle Zijlstra2022-03-291-0/+3
| | | | | | | | | | | (GH-31636) (GH-32171) The enter_context is updated with following information: 'The :meth:`__enter__` method returns the ExitStack instance, and performs no additional operations.' Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com> (cherry picked from commit 86384cf83f96fcaec03e2ad6516e2e24f20d3b92) Co-authored-by: vidhya <96202776+Vidhyavinu@users.noreply.github.com>