summaryrefslogtreecommitdiffstats
path: root/Doc
Commit message (Collapse)AuthorAgeFilesLines
* Move doctests to the main docs. Eliminate duplication. Improve coverage. ↵Raymond Hettinger2022-01-251-0/+238
| | | | (GH-30869)
* bpo-46431: Add example of subclassing ExceptionGroup. Document the message ↵Irit Katriel2022-01-241-31/+55
| | | | and exceptions attributes (GH-30852)
* bpo-45711: move whatsnew entries which are incorrectly listed under New ↵Irit Katriel2022-01-241-10/+11
| | | | Features (GH-30849)
* bpo-41906: Accept built filters in dictConfig (GH-30756)Mario Corchero2022-01-241-0/+10
| | | | | | | When configuring the logging stack, accept already built filters (or just callables) in the filters array of loggers and handlers. This facilitates passing quick callables as filters. Automerge-Triggered-By: GH:vsajip
* bpo-46422: use `dis.Positions` in `dis.Instruction` (GH-30716)Nikita Sobolev2022-01-241-0/+22
| | | Co-authored-by: Batuhan Taskaya <isidentical@gmail.com>
* bpo-43683: Streamline YIELD_VALUE and SEND (GH-30723)Mark Shannon2022-01-241-0/+16
| | | | | | | | * Split YIELD_VALUE into ASYNC_GEN_WRAP; YIELD_VALUE for async generators. * Split SEND into SEND; YIELD_VALUE. * Document new opcodes.
* fix typo in typing.rst (#30841)Jelle Zijlstra2022-01-231-1/+1
|
* Improve grouper() recipe to demonstrate all forms of zip() (GH-30837)Raymond Hettinger2022-01-231-3/+12
|
* bpo-46468: document that "-m http.server" defaults to port 8000 (GH-30776)Jelle Zijlstra2022-01-221-7/+12
| | | | | | | | Code link: https://github.com/python/cpython/blob/70c16468deee9390e34322d32fda57df6e0f46bb/Lib/http/server.py#L1270 It's been this way since at least 3.4. Also improved some wording in the same section.
* bpo-46460: remove duplicated `versionchanged` from `dis.rst` (GH-30752)Nikita Sobolev2022-01-221-2/+0
|
* bpo-46463: Fixes escape4chm.py script used when building the CHM ↵Steve Dower2022-01-211-4/+5
| | | | documentation file (GH-30768)
* bpo-30512: Add CAN Socket support for NetBSD (GH-30066)Thomas Klausner2022-01-212-1/+11
|
* bpo-46409: Make generators in bytecode (GH-30633)Mark Shannon2022-01-201-0/+15
| | | | | | | | | | | | * Add RETURN_GENERATOR and JUMP_NO_INTERRUPT opcodes. * Trim frame and generator by word each. * Minor refactor of frame.c * Update test.test_sys to account for smaller frames. * Treat generator functions as normal functions when evaluating and specializing.
* no-issue: Fix documentation typos. (GH-30576)Piotr Fusik2022-01-202-2/+2
|
* doc: Clarify os.urandom return type (#30282)Florian Bruhin2022-01-191-1/+1
| | | Other descriptions in the same file also use 'bytestring' to refer to bytes objects
* Update documentation in datetime module strftime-and-strptime-behavior fix ↵Evan2022-01-191-5/+5
| | | | | | | typo in '%W' format code description (GH-30232) A small change to the documentation of datetime module , in the format codes section of stftime and strptime. Changed the description of format code '%W' from 'as a decimal number' to 'a zero padded decimal number' so it's in line with the example having leading zeros. Similar to the format code '%U' above. Automerge-Triggered-By: GH:pganssle
* bpo-45680: Minor formatting fix in stdtypes.rst (GH-30690)Ken Jin2022-01-191-1/+1
| | | Makes quotation consistent with rest of docs in commit 0eae9a2a2db6cc5a72535f61bb988cc417011640.
* bpo-45680: Clarify documentation on ``GenericAlias`` objects (GH-29335)Alex Waygood2022-01-191-33/+84
| | | | | | | | | | | | | | | The documentation on ``GenericAlias`` objects implies at multiple points that only container classes can define ``__class_getitem__``. This is misleading. This PR proposes a rewrite of the documentation to clarify that non-container classes can define ``__class_getitem__``, and to clarify what it means when a non-container class is parameterized. See also: initial discussion of issues with this piece of documentation in GH-29308, and previous BPO issue [42280](https://bugs.python.org/issue42280). Also improved references in glossary and typing docs. Fixed some links. Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no> Co-authored-by: Ken Jin <28750310+Fidget-Spinner@users.noreply.github.com>
* bpo-22039: [doc] clarify that there are no plans to disable deleting an ↵Irit Katriel2022-01-191-2/+3
| | | | attribute via PyObject_SetAttr (GH-30639)
* bpo-43869: Time Epoch is the same on all platforms (GH-30664)Victor Stinner2022-01-191-17/+11
|
* bpo-45554: Document multiprocessing.Process.exitcode values (GH-30142)John Marshall2022-01-181-2/+9
| | | | | This addresses [bpo-45554]() by expanding the `exitcode` documentation to also describe what `exitcode` will be in cases of normal termination, `sys.exit()` called, and on uncaught exceptions. Automerge-Triggered-By: GH:pitrou
* bpo-20823: Clarify copyreg.pickle() documentation (GH-30230)Kumar Aditya2022-01-181-2/+2
|
* bpo-43869: Improve epoch docs (GH-25777)Miguel Brito2022-01-181-1/+1
|
* bpo-46402: Promote SQLite URI tricks in `sqlite3` docs (GH-30660)Erlend Egeberg Aasland2022-01-181-8/+22
| | | | | Provide some examples of URI parameters in sqlite connect(). Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>
* bpo-44934: Add optional feature AppendPath to Windows MSI installer (GH-27889)bneuburg2022-01-182-3/+13
| | | The option must be enabled from the command line
* bpo-40066: [Enum] fix tests (GH-30643)Ethan Furman2022-01-171-1/+1
| | | | | - skip doctest that changes depending on target system - skip doctest that only fails on CI - substitute in values that change depending on target system
* bpo-40066: [Enum] skip failing doc test (GH-30637)Kumar Aditya2022-01-173-240/+301
|
* Revert "bpo-40066: [Enum] update str() and format() output (GH-30582)" ↵Victor Stinner2022-01-173-301/+240
| | | | | (GH-30632) This reverts commit acf7403f9baea3ae1119fc6b4a3298522188bf96.
* bpo-40066: [Enum] update str() and format() output (GH-30582)Ethan Furman2022-01-163-240/+301
| | | | | | | | | | | | | | | Undo rejected PEP-663 changes: - restore `repr()` to its 3.10 status - restore `str()` to its 3.10 status New changes: - `IntEnum` and `IntFlag` now leave `__str__` as the original `int.__str__` so that str() and format() return the same result - zero-valued flags without a name have a slightly changed repr(), e.g. `repr(Color(0)) == '<Color: 0>'` - update `dir()` for mixed-in types to return all the methods and attributes of the mixed-in type - added `_numeric_repr_` to `Flag` to control display of unnamed values - enums without doc strings have a more comprehensive doc string added - `ReprEnum` added -- inheriting from this makes it so only `__repr__` is replaced, not `__str__` nor `__format__`; `IntEnum`, `IntFlag`, and `StrEnum` all inherit from `ReprEnum`
* bpo-20281, bpo-29964: update datetime docs to refer %z and %Z to a ↵Hugo van Kemenade2022-01-141-7/+6
| | | | pre-existing footnote (GH-30354)
* bpo-45569: Change PYLONG_BITS_IN_DIGIT default to 30 (GH-30497)Mark Dickinson2022-01-142-2/+11
|
* bpo-23183: Document the timeit output (GH-30359)Hugo van Kemenade2022-01-141-0/+7
| | | | Co-authored-by: Robert Collins <robertc@robertcollins.net>
* bpo-46355: Document PyFrameObject and PyThreadState changes (GH-30558)Victor Stinner2022-01-131-0/+104
| | | | Document PyFrameObject and PyThreadState changes in What's New in Python 3.11 and explain how to port code.
* bpo-46328: Add sys.exception() (GH-30514)Irit Katriel2022-01-133-16/+34
|
* bpo-40479: Fix hashlib's usedforsecurity for OpenSSL 3.0.0 (GH-30455)Christian Heimes2022-01-131-2/+2
|
* bpo-46342: make @typing.final introspectable (GH-30530)Jelle Zijlstra2022-01-121-0/+9
| | | Co-authored-by: Ken Jin <28750310+Fidget-Spinner@users.noreply.github.com>
* bpo-46307: Add string.Template.get_identifiers() method (GH-30493)Ben Kehoe2022-01-111-0/+19
| | | | | Add `string.Template.get_identifiers()` method that returns the identifiers within the template. By default, raises an error if it encounters an invalid identifier (like `substitute()`). The keyword-only argument `raise_on_invalid` can be set to `False` to ignore invalid identifiers (like `safe_substitute()`). Automerge-Triggered-By: GH:warsaw
* [doc] Add license_url for python-docs-theme 2022.1. (GH-30527)Julien Palard2022-01-112-2/+3
|
* closes bpo-46253: Change Py_UNICODE to Py_UCS4 in the C API docs to match ↵Julian Gilbey2022-01-111-17/+17
| | | | the current source code (GH-30387)
* Remove unused `Any` from `Concatenate` example in typing docs (GH-30516)Michael Oliver2022-01-111-1/+1
|
* bpo-45331: [Enum] add rule to docs that mixin type must be subclassable ↵Nikita Sobolev2022-01-101-4/+7
| | | | (GH-30521)
* bpo-46270: Describe the `in` and `not in` operators as membership tests. ↵Raymond Hettinger2022-01-101-4/+6
| | | | (GH-30504)
* bpo-23882: unittest: Drop PEP 420 support from discovery. (GH-29745)Inada Naoki2022-01-102-2/+27
|
* bpo-46261: Update `sqlite3.Cursor.lastrowid` docs (GH-30407)Erlend Egeberg Aasland2022-01-081-8/+9
|
* bpo-46290: Fix parameter names in dataclasses docs (GH-30450)Zsolt Dollenstein2022-01-081-12/+12
|
* bpo-28546: [doc] Clarify setting pdb breakpoints (GH-30360)Hugo van Kemenade2022-01-071-5/+4
| | | | Co-authored-by: Ian Kelling <ian@iankelling.org>
* bpo-24650: Use full term "generator function" in yield expressions docs ↵Jacob Walls2022-01-071-2/+2
| | | | (GH-24663)
* bpo-46216: remove spurious link to os.system() from os.time() documentation ↵Irit Katriel2022-01-071-8/+8
| | | | | (GH-30326) Automerge-Triggered-By: GH:iritkatriel
* bpo-46251: Add 'Security Considerations' section to logging configura… ↵Vinay Sajip2022-01-061-0/+14
| | | | (GH-30411)
* bpo-45292: [PEP-654] exception groups and except* documentation (GH-30158)Irit Katriel2022-01-063-1/+208
|