summaryrefslogtreecommitdiffstats
path: root/Doc
Commit message (Collapse)AuthorAgeFilesLines
* gh-101100: Fix Sphinx warnings in `argparse` module (#103289)Hugo van Kemenade2023-04-245-16/+78
| | | | | Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM> Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
* gh-99032: datetime docs: Encoding is no longer relevant (#93365)William Andrea2023-04-241-4/+1
| | | | | | | This removes a section of the `strftime` and `strptime` documentation that refers to a bygone era when `strftime` would return an encoded byte string. --------- Co-authored-by: Paul Ganssle <1377457+pganssle@users.noreply.github.com>
* gh-94300: Update datetime.strptime documentation (#95318)Howie Zhao2023-04-241-1/+1
| | | | | | | The new wording better reflects the cases where `datetime.strptime` differs from` time.strptime`. --------- Co-authored-by: Paul Ganssle <git@m.ganssle.io>
* GH-65022: Fix description of copyreg.pickle function (#102656)Furkan Onder2023-04-241-2/+2
| | | Fix description of copyreg.pickle function
* gh-91687: modernize dataclass example typing (#103773)Allan Lago2023-04-241-1/+1
| | | modernize dataclass example typing `list` rather than `List` and comment as to that line being the alluded too error.
* gh-103765: Fix 'Warning: py:class reference target not found: ModuleSpec' ↵Jaime Alonso Lorenzo2023-04-241-1/+1
| | | | (GH-103769)
* gh-87452: Improve the Popen.returncode docsJoshua Herman2023-04-241-3/+6
| | | Clarifies that it remains None until a method checking the child process status has been called and noticed it has terminated.
* Removed unnecessary escaping of asterisks (#103714)Richard Hajek2023-04-241-1/+1
| | | | | Removed unnecessary escaping of asterisks, as visible both on GitHub and in https://docs.python.org/3/library/decimal.html#decimal.localcontext Co-authored-by: Łukasz Langa <lukasz@langa.pl>
* gh-103091: Add PyUnstable_Type_AssignVersionTag (#103095)Brett Simmers2023-04-241-0/+9
|
* gh-103712: Increase the length of the type name in AttributeError messages ↵Alex Gaynor2023-04-241-1/+1
| | | | (#103713)
* gh-44123: Add note on relative path for os.exec* (GH-93826)Stanley2023-04-241-1/+2
| | | Co-authored-by: Steve Dower <steve.dower@python.org>
* Change 'dependant' to 'dependent' (#103745)Christopher Chavez2023-04-241-1/+1
| | | | The word 'dependent' is both an adjective and a noun. A 'dependant' is a British alternative spelling for the noun form. In idlelib.sidebar, 'OS-dependant' is an adjective and clearly wrong. In 'Using', 'dependant' as a noun would be acceptable in Britain, but we use American spellings in Python docs. https://www.merriam-webster.com/words-at-play/spelling-variants-dependent-vs-dependant
* gh-102950: Implement PEP 706 – Filter for tarfile.extractall (#102953)Petr Viktorin2023-04-243-20/+478
|
* gh-101688: Implement types.get_original_bases (#101827)James Hilton-Balfe2023-04-233-0/+51
| | | Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* gh-68654: Clarify subdirectories used by pkgutil.extend_path (#103701)Randy2023-04-221-3/+3
| | | Clarify sub directories used by pkgutil.extend_path in the docs and the docstring
* Revert "Avoid error lexing multiprocessing docs code block on Pygments ↵Hugo van Kemenade2023-04-221-3/+1
| | | | | 2.15.0" (#103616) This reverts commit ace51dcdb781b0608b1273d246ebaee849561435.
* gh-84436: Implement Immortal Objects (gh-19474)Eddie Elizondo2023-04-222-2/+26
| | | | | | | | | This is the implementation of PEP683 Motivation: The PR introduces the ability to immortalize instances in CPython which bypasses reference counting. Tagging objects as immortal allows up to skip certain operations when we know that the object will be around for the entire execution of the runtime. Note that this by itself will bring a performance regression to the runtime due to the extra reference count checks. However, this brings the ability of having truly immutable objects that are useful in other contexts such as immutable data sharing between sub-interpreters.
* gh-83791: Raise TypeError for len(memoryview_0d) (#18463)Eric Wieser2023-04-221-6/+9
| | | Changes the behaviour of `len` on a zero-dimensional `memoryview` to raise `TypeError`. Previously, `len` would return `1`.
* GH-103484: Fix broken links reported by linkcheck (#103608)Rafael Fontenelle2023-04-2210-25/+40
| | | | | | | | | | | | | | | | | | | | | | | | | | | | * Doc: Fix broken links reported by linkcheck * Apply suggestions from code review - Remove extra diff line in faq/library.rst (merwok) - Use HTTPS to link Unicode 15.0.0 to solve a redirect (hugovk) - Use wayback machine link for openssl 1.1.0 instead of linking 1.1.1, "as this text mentions a feature from 1.1.0" (hugovk) Co-authored-by: Éric <merwok@netwok.org> Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com> * Doc: Make mark-up code as literal * Doc: Alphabetize items in linkcheck_ignore Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com> * Doc: Improve comment in sphinx conf Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> --------- Co-authored-by: Éric <merwok@netwok.org> Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com> Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* GH-103475: cache() and lru_cache() do not have a "call once" guarantee ↵Raymond Hettinger2023-04-221-4/+14
| | | | (GH-103669)
* Descriptor HowTo: Update to include attributes added in Python 3.10 ↵Raymond Hettinger2023-04-221-8/+90
| | | | (GH-103666)
* Minor improvements to the functools docs (#103672)Raymond Hettinger2023-04-221-3/+2
| | | | | * Use an f-string for improved readability * Put version notes in chronological order
* GH-103415: Document itertools.batched() in whatsnew.3.12 (#103670)Raymond Hettinger2023-04-221-0/+7
|
* Sync with importlib_metadata 6.5 (GH-103584)Jason R. Coombs2023-04-211-0/+4
|
* gh-98641: Document difference between task group and gather (#103644)Adrien2023-04-201-5/+10
| | | The purpose of the comments is to rule out the implication that asyncio.TaskGroup is a drop-in replacement / better alternative to asyncio.gather().
* gh-102856: Initial implementation of PEP 701 (#102855)Pablo Galindo Salgado2023-04-191-0/+10
| | | | | | Co-authored-by: Lysandros Nikolaou <lisandrosnik@gmail.com> Co-authored-by: Batuhan Taskaya <isidentical@gmail.com> Co-authored-by: Marta Gómez Macías <mgmacias@google.com> Co-authored-by: sunmy2019 <59365878+sunmy2019@users.noreply.github.com>
* GH-88342: clarify that `asyncio.as_completed` accepts generators yielding ↵Kumar Aditya2023-04-192-1/+5
| | | | tasks (#103626)
* gh-103582: Remove last references to `argparse.REMAINDER` from docs (#103586)Nikita Sobolev2023-04-191-2/+2
|
* gh-103596: [Enum] do not shadow mixed-in methods/attributes (GH-103600)Ethan Furman2023-04-182-6/+15
| | | | | | | | | | | | | | | | | | For example: class Book(StrEnum): title = auto() author = auto() desc = auto() Book.author.desc is Book.desc but Book.author.title() == 'Author' is commonly expected. Using upper-case member names avoids this confusion and possible performance impacts. Co-authored-by: samypr100 <3933065+samypr100@users.noreply.github.com>
* [Doc] Fix a typo in optparse.rst (#103504)zyckk42023-04-181-1/+1
|
* gh-101100: Fix broken reference `__format__` in `string.rst` (#103531)yuki2023-04-181-2/+2
|
* gh-95299: Stop installing setuptools as a part of ensurepip and venv (#101039)Pradyun Gedam2023-04-183-4/+28
| | | | | | | Remove the bundled setuptools wheel from ensurepip, and stop installing setuptools in environments created by venv. Co-Authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com> Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM> Co-authored-by: Oleg Iarygin <oleg@arhadthedev.net>
* GH-103484: Docs: add linkcheck allowed redirects entries for most cases ↵Rafael Fontenelle2023-04-181-3/+8
| | | | | | (#103569) Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
* gh-67230: update whatsnew note for csv changes (#103598)Skip Montanaro2023-04-181-1/+1
|
* gh-48330: address review comments to PR-12271 (#103209)Giampaolo Rodola2023-04-161-4/+0
| | | | | address review comments to PR-12271 Signed-off-by: Giampaolo Rodola <g.rodola@gmail.com>
* Fix syntax typo in isolating extensions doc (#103516)AN Long2023-04-141-3/+3
|
* Proofread howto/perf_profiling.rst (#103530)Boris Verkhovskiy2023-04-141-10/+10
|
* gh-103479: [Enum] require __new__ to be considered a data type (GH-103495)Ethan Furman2023-04-131-3/+5
| | | a mixin must either have a __new__ method, or be a dataclass, to be interpreted as a data-type
* gh-103365: [Enum] STRICT boundary corrections (GH-103494)Ethan Furman2023-04-131-2/+3
| | | | | | STRICT boundary: - fix bitwise operations - make default for Flag
* gh-67230: document new csv quoting modes in whatsnew (gh-103491)Skip Montanaro2023-04-131-0/+7
|
* gh-67230: add quoting rules to csv module (GH-29469)Skip Montanaro2023-04-121-2/+20
| | | | | | Add two quoting styles for csv dialects. They will help to work with certain databases in particular. Automerge-Triggered-By: GH:merwok
* gh-103417: use time.monotonic in the example for sched.scheduler (#103418)Nick Burns2023-04-121-1/+1
|
* GH-83893: Cross reference env. vars and -X command line options (GH-103414)Furkan Onder2023-04-121-6/+12
| | | Co-authored-by: Erlend E. Aasland
* gh-103357: Add logging.Formatter defaults support to logging.config ↵Bar Harel2023-04-121-1/+8
| | | | fileConfig and dictConfig (GH-103359)
* gh-103237: Polish pdb docs (#103238)Tian Gao2023-04-121-38/+100
|
* gh-103143: Polish pdb help messages and doc strings (GH-103144)Tian Gao2023-04-111-2/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * Made all the command part of the docstring match the official documentation * Always have a space between the command and the description in docstring * Added a helper function to format the help message Before: ``` (Pdb) h a a(rgs) Print the argument list of the current function. (Pdb) h commands commands [bpnumber] (com) ... (com) end (Pdb) ... (Pdb) h interact interact Start an interactive interpreter whose global namespace contains all the (global and local) names found in the current scope. ``` After ``` (Pdb) h a Usage: a(rgs) Print the argument list of the current function. (Pdb) h commands Usage: (Pdb) commands [bpnumber] (com) ... (com) end (Pdb) ... (Pdb) h interact Usage: interact Start an interactive interpreter whose global namespace contains all the (global and local) names found in the current scope. ``` Automerge-Triggered-By: GH:brandtbucher
* gh-87864: Use correct function definition syntax in the docs (#103312)Nikita Sobolev2023-04-112-2/+2
|
* gh-77757: replace exception wrapping by PEP-678 notes in typeobject's ↵Irit Katriel2023-04-111-0/+4
| | | | __set_name__ (#103402)
* gh-103373: `__mro_entries__` docs: improve cross references (#103398)Alex Waygood2023-04-112-7/+12
| | | Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
* gh-103176: sys._current_exceptions() returns mapping to exception instances ↵Irit Katriel2023-04-112-0/+12
| | | | instead of exc_info tuples (#103177)