summaryrefslogtreecommitdiffstats
path: root/Doc
Commit message (Collapse)AuthorAgeFilesLines
...
* Merge remote-tracking branch 'upstream/main'Hugo van Kemenade2024-11-191-1/+1
|\
| * Update docs 'make serve' to suggest 'make htmllive' (#126969)Hugo van Kemenade2024-11-191-1/+1
| |
* | Python 3.14.0a2v3.14.0a2Hugo van Kemenade2024-11-1910-16/+16
|/
* GH-84850: Remove `urllib.request.URLopener` and `FancyURLopener` (#125739)Barney Gale2024-11-193-125/+8
|
* gh-85957: Add missing MIME types for images with RFCs (#126966)Hugo van Kemenade2024-11-181-0/+11
|
* gh-123803: Support arbitrary code page encodings on Windows (GH-123804)Serhiy Storchaka2024-11-182-0/+10
| | | | | | If the cpXXX encoding is not directly implemented in Python, fall back to use the Windows-specific API codecs.code_page_encode() and codecs.code_page_decode().
* Doc: Reorganize math module documentation (#126337)Joseph Martinot-Lagarde2024-11-181-226/+250
| | | | Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com> Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>
* gh-126896: Fix docs about `asyncio.start_server()` (#126897)beavailable2024-11-171-1/+5
|
* GH-126748: amend configure.rst description for the 'build_wasm' make target ↵Hood Chatham2024-11-161-1/+2
| | | | | (#126687) Clarified the documentation around how the build_wasm target is selected.
* gh-126691: Remove --with-emscripten-target (#126787)Hood Chatham2024-11-161-9/+0
| | | | | This unifies the code for nodejs and the code for the browser. After this commit, the browser example doesn't work; this will be fixed in a subsequent update.
* Added a warning to the urljoin docs, indicating that it is not safe to use ↵Alex Gaynor2024-11-151-0/+9
| | | | | with attacker controlled URLs (GH-126659) This was flagged to me at a party today by someone who works in red-teaming as a frequently encountered footgun. Documenting the potentially unexpected behavior seemed like a good place to start.
* Docs: Miscellaneous corrections to simple statements in the language ↵Beomsoo Kim2024-11-151-8/+8
| | | | | | | | reference (GH-126720) * Replace: The :keyword:`global` -> The :keyword:`global` statement Add :keyword: when it's needed * Replace repeated links with duoble backticks
* Add PEP 761 to What's New (#126550)Seth Michael Larson2024-11-151-0/+10
| | | | Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
* gh-122549: Add platform.invalidate_caches() (#122547)Bénédikt Tran2024-11-152-0/+20
| | | Allow to invalidate platform's cached results.
* gh-125063: marshal: Add version 5, improve documentation (GH-126829)Petr Viktorin2024-11-152-22/+51
| | | | | | | | | | * Document that slices can be marshalled * Deduplicate and organize the list of supported types in docs * Organize the type code list in marshal.c, to make it more obvious that this is a versioned format * Back-fill some historical info Co-authored-by: Michael Droettboom <mdboom@gmail.com>
* gh-89083: small docs fixup for UUIDv8 (#126857)Bénédikt Tran2024-11-151-3/+6
|
* gh-126061: add new functions to `refcounts.dat` (#126788)RUANG (James Roy)2024-11-141-0/+13
|
* gh-123832: Adjust `socket.getaddrinfo` docs for better POSIX compliance ↵Petr Viktorin2024-11-141-3/+32
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | (GH-126182) * gh-123832: Adjust `socket.getaddrinfo` docs for better POSIX compliance This changes nothing changes for CPython supported platforms, but hints how to deal with platforms that stick to the letter of the spec. It also marks `socket.getaddrinfo` as a wrapper around `getaddrinfo(3)`; specifically, workarounds to make the function work consistently across platforms are out of scope in its code. Include wording similar to the POSIX's “by providing options and by limiting the returned information”, which IMO suggests that the hints limit the resulting list compared to the defaults, *but* can be interpreted differently. Details are added in a note. Specifically say that this wraps the underlying C function. So, the details are in OS docs. The “full range of results” bit goes away. Use `AF_UNSPEC` rather than zero for the *family* default, although I don't think a system where it's nonzero would be very usable. Suggest setting proto and/or type (with examples, as the appropriate values aren't obvious). Say why you probably want to do that that on all systems; mention the behavior on the “letter of the spec” systems. Suggest that the results should be tried in order, which is, AFAIK best practice -- see RFC 6724 section 2, and its predecessor from 2003 (which are specific to IP, but indicate how people use this): > Well-behaved applications SHOULD iterate through the list of > addresses returned from `getaddrinfo()` until they find a working address. Co-authored-by: Carol Willing <carolcode@willingconsulting.com>
* Document that return-less user-defined functions return None (#126769)John Marshall2024-11-141-1/+2
| | | | Co-authored-by: Andrew Svetlov <andrew.svetlov@gmail.com> Co-authored-by: Carol Willing <carolcode@willingconsulting.com>
* Doc: Recommend shlex.quote alongside pipes removal (#126570)Colin Watson2024-11-141-0/+2
| | | | | | | One of the most common reasons I see the old `pipes` module still in use when porting to Python 3.13 is for the undocumented `pipes.quote` function, which can easily be replaced with `shlex.quote`. I think it's worth specifically calling this out, since being directed to the `subprocess` module would be confusing in this case.
* gh-126731: Update outdated project information in `pprint.pp` doc (#126732)Wulian2024-11-141-1/+1
|
* gh-126390: Support for preserving order of options and nonoption arguments ↵Serhiy Storchaka2024-11-132-0/+27
| | | | in gnu_getopt() (GH-126393)
* gh-123619: Add an unstable C API function for enabling deferred reference ↵Peter Bierma2024-11-132-0/+27
| | | | | | counting (GH-123635) Co-authored-by: Sam Gross <colesbury@gmail.com>
* gh-126175: Add attributes to TOMLDecodeError. Deprecate free-form `__init__` ↵Taneli Hukkinen2024-11-131-2/+29
| | | | args (GH-126428)
* gh-116897: Deprecate generic false values in urllib.parse.parse_qsl() ↵Serhiy Storchaka2024-11-122-0/+15
| | | | | | | | (GH-116903) Accepting objects with false values (like 0 and []) except empty strings and byte-like objects and None in urllib.parse functions parse_qsl() and parse_qs() is now deprecated.
* gh-89083: add support for UUID version 8 (RFC 9562) (#123224)Bénédikt Tran2024-11-122-9/+41
| | | Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
* gh-126133: Only use start year in PSF copyright, remove end years (#126236)Hugo van Kemenade2024-11-123-6/+3
|
* gh-126061: Add PyLong_IsPositive/Zero/Negative() functions (#126065)RUANG (James Roy)2024-11-122-0/+38
| | | | | Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com> Co-authored-by: Peter Bierma <zintensitydev@gmail.com> Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
* gh-125916: Allow functools.reduce() 'initial' to be a keyword argument (#125917)Sayandip Dutta2024-11-122-2/+10
|
* gh-84852: Add MIME types for .eot, ,otf, .ttf, .woff and .woff2 fonts (#20199)Sahil Prajapati2024-11-121-0/+10
| | | | | Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com> Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
* gh-58749: Remove incorrect language spec claims about the global statement ↵Beomsoo Kim2024-11-121-16/+5
| | | | | | | | (GH-126523) * Removes erroneous explanation of the `global` statement restrictions; a name declared as global can be subsequently bound using any kind of name binding operation. * Updates `test_global.py` to also test various name-binding scenarios for global variables to ensure correct behavior
* Docs: re-create pages for removed modules to document their removal. (#126622)Ned Batchelder2024-11-1127-0/+448
| | | | | Will also need to change the redirects that were created here: https://github.com/python/psf-salt/pull/521/files
* gh-89416: Add RFC 9559 MIME types for Matroska formats (#126412)Hugo van Kemenade2024-11-111-0/+14
| | | | | Co-authored-by: Zachary Ware <zachary.ware@gmail.com> Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* gh-84559: gh-103134: Whats new 3.14 entries for multiprocessing. (GH-126697)Gregory P. Smith2024-11-111-8/+25
|
* Update documentation links to Microsoft's documentation pages (GH-126379)谭九鼎2024-11-113-9/+9
|
* gh-126374: Add support of options with optional arguments in the getopt ↵Serhiy Storchaka2024-11-112-3/+28
| | | | module (GH-126375)
* Add missing fullstop `.` to whatsnew/3.8.rst (GH-126553)Rafael Fontenelle2024-11-111-1/+1
|
* gh-126664: Use `else` instead of `finally` in "The with statement" ↵vivodi2024-11-111-5/+2
| | | | documentation. (GH-126665)
* gh-126543: Docs: change "bound type var" to "bounded" when used in the ↵Pedro Fonini2024-11-111-11/+11
| | | | context of the 'bound' kw argument to TypeVar (#126584)
* gh-126647: `Doc/using/configure.rst`: Add an entry for ↵Kirill Podoprigora2024-11-101-0/+13
| | | | | | | | | | | | | | ``--enable-experimental-jit`` option (#126648) Add an entry for the ``--enable-experimental-jit`` option in ``Doc/using/configure.rst``. This was added as an experimental option in CPython 3.13. Possible values for it: * `no` - don't build the JIT. * `yes` - build the JIT. * `yes-off` - build the JIT but disable it by default. * `interpreter` - don't build the JIT but enable tier 2 interpreter instead. Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
* Postpone `module.__loader__` deprecation to Python 3.16 (#126482)Hugo van Kemenade2024-11-103-9/+9
|
* gh-125298: Remove misleading text in os.kill documentation (GH-125749)RUANG (James Roy)2024-11-081-2/+1
| | | Windows has not accepted process handles in many releases.
* Doc: C API: Demote sections to subsections for consistency (#126535)Richard Hansen2024-11-071-7/+7
| | | | The entire file should be a single section; the headings below the first heading should be subsections.
* gh-48020: [docs] Remove the logging howto suggested future FileHandler ↵Gregory P. Smith2024-11-071-5/+2
| | | | | | | | | multiprocessing support (GH-126531) Docs: Remove the logging howto potential promise of multiprocessing support in the future. Stick to the facts and suggestions, don't provide hope where we're not going to implement complexity that we'd rather the user implement themselves when needed.
* gh-122838: Document missing opcodes (#123073)Kamil Turek2024-11-061-0/+21
|
* gh-120754: Add to `io` optimization to what's new (#126466)Cody Maloney2024-11-061-0/+9
|
* GH-124985: Document that `pathlib.Path.copy()` uses copy-on-write. (#125861)Barney Gale2024-11-051-0/+5
|
* Doc: C API: Delete claim that `PyObject_Init` is GC-aware (#126418)Richard Hansen2024-11-051-4/+2
|
* gh-119793: Prefer `map(..., strict=True)` over starmap/zip in examples (#126407)Lukas Geiger2024-11-051-1/+1
|
* gh-120057: Add os.reload_environ() function (#126268)Victor Stinner2024-11-052-12/+28
| | | | | | | Replace the os.environ.refresh() method with a new os.reload_environ() function. Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com> Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>