summaryrefslogtreecommitdiffstats
path: root/Doc/howto
Commit message (Collapse)AuthorAgeFilesLines
* gh-95836: Add custom type converter examples to argparse tutorial (GH-125376)Savannah Ostrowski2024-10-171-0/+47
|
* GH-124478: Cleanup argparse documentation (#124877)Savannah Ostrowski2024-10-081-0/+55
| | | | Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com> Co-authored-by: Tomas R <tomas.roun8@gmail.com>
* gh-75898: make use of thread more explicit in the "Socket Programming HOWTO" ↵Jan Kaliszewski2024-10-081-2/+2
| | | | document (#125023)
* Sorting techniques edits (#124701)Raymond Hettinger2024-09-281-3/+70
|
* gh-124370: Add "howto" for free-threaded Python (#124371)Sam Gross2024-09-252-0/+156
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * gh-124370: Add "howto" for free-threaded Python This is a guide aimed at people writing Python code, as oppposed to the existing guide for C API extension authors. * Add missing new line * Update Doc/howto/free-threading-python.rst Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com> * interned -> immortalized * Apply suggestions from code review Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com> * Update Doc/howto/free-threading-python.rst Co-authored-by: mpage <mpage@cs.stanford.edu> * Update docs * Apply suggestions from code review Co-authored-by: Carol Willing <carolcode@willingconsulting.com> * A few more updates * Additional comment on immortal objects * Mention specializing adaptive interpreter * Remove trailing whitespace * Remove mention of C macro --------- Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com> Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com> Co-authored-by: mpage <mpage@cs.stanford.edu> Co-authored-by: Carol Willing <carolcode@willingconsulting.com>
* gh-101100: Add a table of class attributes to the "Custom classes" section ↵Alex Waygood2024-09-254-9/+10
| | | | of the data model docs (#124480)
* Minor edits to the descriptor guide (GH-123928)Raymond Hettinger2024-09-131-4/+6
|
* gh-119802: Update memory management docs for free-threaded build (gh-124006)Donghee Na2024-09-131-0/+2
| | | | | | | | | | | | | | | | | | | * gh-119802: Update memory management docs for free-threaded build * nit * nit * Address code review * nit * Update Doc/c-api/memory.rst Co-authored-by: Sam Gross <colesbury@gmail.com> --------- Co-authored-by: Sam Gross <colesbury@gmail.com>
* GH-101599: Update docs to remove redundant option in argparse tutorial (#124025)Savannah Ostrowski2024-09-131-1/+1
|
* gh-119180: Documentation for PEP 649 and 749 (#122235)Jelle Zijlstra2024-09-111-2/+19
| | | | | 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> Co-authored-by: Carol Willing <carolcode@willingconsulting.com>
* gh-109975: Add links to py-free-threading.github.io (#123776)Nathan Goldbaum2024-09-061-0/+6
| | | Co-authored-by: Victor Stinner <vstinner@python.org>
* gh-123463: Include logging_flow diagram in non-HTML docs (GH-123464)Alexander Bessman2024-09-041-0/+4
|
* Remove irrelevant detail from example code. (gh-123587)Raymond Hettinger2024-09-021-19/+10
|
* Simplify Property() recipe to focus on the essentials (gh-123585)Raymond Hettinger2024-09-011-20/+6
|
* gh-123517: Remove unnecessary ``:meth:`` parentheses (#123518)Wei-Hsiang (Matt) Wang2024-09-011-1/+1
|
* gh-123492: Remove unnecessary `:func:` parentheses (#123493)Wei-Hsiang (Matt) Wang2024-08-303-4/+4
|
* Fix typos in docs, error messages and comments (#122502)jianghuyiyuan2024-08-011-1/+1
| | | Signed-off-by: jianghuyiyuan <shuangcui@live.com>
* gh-119180: Add `annotationlib` module to support PEP 649 (#119891)Jelle Zijlstra2024-07-231-2/+6
| | | Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* Docs: spelling and grammar fixes (#122084)Ville Skyttä2024-07-222-2/+2
| | | | | | Corrected some grammar and spelling issues in documentation. Co-authored-by: Russell Keith-Magee <russell@keith-magee.com> Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
* gh-121035: Update PNG image for logging flow diagram. (GH-121323)Vinay Sajip2024-07-031-0/+0
|
* gh-121035: Further improve logging flow diagram with respect to dark/light ↵Vinay Sajip2024-07-022-2/+14
| | | | modes. (GH-121265)
* gh-121035: Improve logging flow diagram for dark/light modes. (GH-121254)Vinay Sajip2024-07-022-11/+62
|
* [doc] Update element positions and styles in logging flow diagram. (GH-121182)Vinay Sajip2024-06-301-132/+155
| | | Update element positions and styles.
* gh-121035: Update logging flow chart to include the lastResort handler. ↵Alexander Bessman2024-06-273-2/+283
| | | | (GH-121036)
* gh-120858: PyDict_Next should not lock the dict (#120859)Sam Gross2024-06-241-1/+19
| | | | | | | | | PyDict_Next no longer locks the dictionary in the free-threaded build. Locking around individual PyDict_Next calls is not sufficient because the function returns borrowed references and because it allows concurrent modifications during the iteraiton loop. The internal locking also interferes with correct external synchronization because it may suspend outer critical sections created by the caller.
* gh-118820: Zero-valued flag enum has no name (GH-118848)Nice Zombies2024-06-191-0/+8
| | | Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
* Add a link to free-threading HOWTO to the index (follow-up to GH-119366) ↵Petr Viktorin2024-06-191-0/+1
| | | | (GH-120703)
* gh-119241: Add HOWTO for free-threaded C API extensions (#119877)Sam Gross2024-06-182-0/+255
| | | | | | Some sections adapted from https://github.com/Quansight-Labs/free-threaded-compatibility/ written by Nathan Goldbaum. Co-authored-by: Nathan Goldbaum <nathan.goldbaum@gmail.com>
* Update the documentation howto index page and group docs into 3 logical ↵Carol Willing2024-06-174-5/+38
| | | | | | sections (GH-119366) Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>
* gh-120345: Fix incorrect use of the :class: role with the "()" suffix ↵Serhiy Storchaka2024-06-121-1/+1
| | | | | | | (GH-120347) * Remove "()" when refer to a class as a type. * Use :func: when refer to a callable. * Fix reference to the datetime.astimezone() method.
* gh-119057: Use better error messages for zero division (#119066)Nikita Sobolev2024-06-031-1/+1
|
* gh-119779: Fix pyporting howto docs (#119785)Awbert2024-05-301-2/+2
|
* docs: fix a few typos identified by codespell (#119516)Ned Batchelder2024-05-261-1/+1
|
* gh-118671: Updated dead ActiveState links (#118730)trag1c2024-05-081-1/+1
| | | | | Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com> Co-authored-by: Kirill Podoprigora <kirill.bast9@mail.ru>
* gh-118518: Improve perf docs (#118708)Pablo Galindo Salgado2024-05-071-22/+48
|
* gh-118518: Rename `PYTHONPERFJITSUPPORT` and `-X perfjit` with underscores ↵Hugo van Kemenade2024-05-071-4/+4
| | | | (#118693)
* gh-118518: Allow perf to work without frame pointers (#112254)Pablo Galindo Salgado2024-05-051-0/+33
|
* Fix typo in Doc/howto/timerfd.rst (GH-118376)Xie Yanbo2024-04-291-1/+1
|
* Docs: add link roles with Sphinx extlinks (#117850)Hugo van Kemenade2024-04-152-9/+6
| | | Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* Add 'The Python 2.3 Method Resolution Order' (#116435)Hugo van Kemenade2024-04-152-0/+672
|
* [doc] Update logging documentation to improve grammar and elucidate an ↵Vinay Sajip2024-04-041-4/+64
| | | | example. (GH-117541)
* [docs] Fix typo in docstring and add example to logging cookbook. (GH-117157)Vinay Sajip2024-03-221-14/+126
|
* gh-98731: Improvements to the logging documentation (GH-101618)Nir Friedman2024-03-131-77/+41
| | | Co-authored-by: Vinay Sajip <vinay_sajip@yahoo.co.uk>
* [doc]: Update cookbook recipe for Qt6. (GH-116719)Vinay Sajip2024-03-131-13/+36
|
* gh-89480: Document the gdb helpers (GH-115657)Pablo Galindo Salgado2024-02-232-0/+450
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Content adapted from https://devguide.python.org/development-tools/gdb/# and https://wiki.python.org/moin/DebuggingWithGdb. The original content on the Wiki page came from gdb debug help used by the Launchpad (https://launchpad.net/) team. Thanks to Anatoly Techtonik and user `rmf` for substantial improvements to the Wiki page. The history of the Devguide page follows (with log entries expanded for major content contributions): Hugo van Kemenade, Sat Dec 30 21:22:04 2023 +0200 Hugo van Kemenade, Fri Dec 8 12:04:32 2023 +0200 Erlend E. Aasland & Hugo van Kemenade, Tue Aug 8 22:05:34 2023 +0200 Satish Mishra, Sat Feb 11 13:54:57 2023 +0530 Hugo van Kemenade, Fri Dec 23 17:33:33 2022 +0200 Skip Montanaro, Hugo, Erlend, & Ezio, Fri Nov 4 05:04:23 2022 -0500 Add a GDB tips section to Advanced Tools (#977) Adam Turner, Wed Jun 15 21:19:23 2022 +0100 Adam Turner, Tue Jun 14 11:12:26 2022 +0100 Suriyaa, Fri Jun 8 19:39:23 2018 +0200 Jeff Allen, Tue Oct 24 18:12:53 2017 +0100 Jeff Allen, Fri Oct 13 13:43:43 2017 +0100 Mariatta, Wed Jan 4 09:14:55 2017 -0800 Carol Willing, Mon Sep 26 14:50:54 2016 -0700 Zachary Ware, Thu Jul 21 10:42:23 2016 -0500 Georg Brandl, Mon Nov 3 11:28:19 2014 +0100 Add instruction how to activate python-gdb.py Georg Brandl, Sun Mar 9 10:32:01 2014 +0100 Georg Brandl, Tue Apr 3 09:12:53 2012 +0200 Georg Brandl, Sat Mar 5 17:32:35 2011 +0100 Dave Malcolm, Fri Jan 21 12:34:09 2011 -0500 Add documentation on the gdb extension commands provided in libpython.py I adapted this from documentation I wrote for the Fedora wiki: https://fedoraproject.org/wiki/Features/EasierPythonDebugging#New_gdb_commands reformatting it as rst, and making other minor changes Brett Cannon, Thu Jan 20 15:16:52 2011 -0800 Dave Malcolm, Thu Jan 20 16:17:23 2011 -0500 Add some notes on the gdb pretty-printer hooks Antoine Pitrou, Thu Jan 20 21:17:49 2011 +0100 Give an example backtrace Antoine Pitrou, Thu Jan 20 21:03:06 2011 +0100 Expand explanations about gdb support Brett Cannon, Thu Jan 20 11:33:36 2011 -0800 Tweak the gdb support title to fit in better with the devguide. Brett Cannon, Mon Jan 17 21:12:54 2011 +0000 Short README on gdb support. Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com> Co-authored-by: anatoly techtonik <techtonik@gmail.com> Co-authored-by: Antoine Pitrou <solipsis@pitrou.net> Co-authored-by: Brett Cannon <brett@python.org> Co-authored-by: Carol Willing <carolcode@willingconsulting.com> Co-authored-by: Dave Malcolm <dmalcolm@redhat.com> Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com> Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com> Co-authored-by: Georg Brandl <georg@python.org> Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com> Co-authored-by: Jeff Allen <ja.py@farowl.co.uk> Co-authored-by: Mariatta <Mariatta@users.noreply.github.com> Co-authored-by: Petr Viktorin <encukou@gmail.com> Co-authored-by: Satish Mishra <7506satish@gmail.com> Co-authored-by: Skip Montanaro <skip.montanaro@gmail.com> Co-authored-by: Suriyaa <isc.suriyaa@gmail.com> Co-authored-by: Zachary Ware <zachary.ware@gmail.com>
* gh-101860: Expose __name__ on property (GH-101876)Eugene Toder2024-02-201-4/+15
| | | | | Useful for introspection and consistent with functions and other descriptors.
* gh-113157: Document and test __get__ for MethodType (gh-115492)Raymond Hettinger2024-02-201-2/+18
|
* Make the title match the content (GH-115702)Raymond Hettinger2024-02-202-5/+5
|
* Modernize the Sorting HowTo guide (gh-115479)Raymond Hettinger2024-02-201-6/+54
|
* gh-115233: Fix an example in the Logging Cookbook (GH-115325)Serhiy Storchaka2024-02-121-6/+4
| | | | | Also add more tests for LoggerAdapter. Also support stacklevel in LoggerAdapter._log().