4b12a6ff4a
gh-119786: add code object doc, inline locations.md into it ( #126832 )
2024-11-22 19:27:41 +00:00
aea0c586d1
GH-127010: Don't lazily track and untrack dicts (GH-127027)
2024-11-20 16:41:20 +00:00
899fdb213d
Revert "GH-126491: GC: Mark objects reachable from roots before doing cycle collection (GH-126502)" ( #126983 )
2024-11-19 11:25:09 +02:00
b0fcc2c47a
GH-126491: GC: Mark objects reachable from roots before doing cycle collection (GH-126502)
...
* Mark almost all reachable objects before doing collection phase
* Add stats for objects marked
* Visit new frames before each increment
* Remove lazy dict tracking
* Update docs
* Clearer calculation of work to do.
2024-11-18 14:31:26 +00:00
3966d8d626
GH-117759: Update GC docs for incremental collection (GH-126695)
2024-11-14 09:50:00 +00:00
19c2481853
gh-126529: Update devguide links to relative filenames in InternalDocs ( #126530 )
...
Update devguide links to relative filenames in InternalDocs/parser.md
and InternalDocs/compiler.md.
2024-11-07 16:35:29 +01:00
b9082958ef
gh-126509: Update link to CPython's grammar docs in InternalDocs/parser.md ( #126510 )
2024-11-06 22:11:48 +00:00
c35b33bfb7
Fix typo in garbage_collector.md ( #125556 )
2024-10-23 19:04:49 -07:00
de0d5c6e2e
gh-119786: move 'changing grammar' checklist from devguide to InternalDocs ( #125874 )
2024-10-23 14:48:39 +01:00
d0bfff47fb
gh-119786: [doc] more consistent syntax in InternalDocs ( #125815 )
2024-10-21 23:37:31 +01:00
695814c6e9
gh-119786: move interpreter doc from devguide to InternalDocs ( #125715 )
2024-10-21 18:54:24 +01:00
0d88b995a6
gh-125644: Update `locations.md` reference ( #125645 )
...
Signed-off-by: Emmanuel Ferdman <emmanuelferdman@gmail.com>
2024-10-17 16:33:37 +02:00
b903fc38d8
gh-119786: fix typo in compiler.md ( #125456 )
2024-10-15 16:38:19 +01:00
187580d95c
gh-119786: [doc] broken link and typo fix in interpreter_definition.md ( #125455 )
2024-10-14 17:24:54 +00:00
89515be596
gh-119786: Move garbage collection doc from devguide to InternalDocs ( #125282 )
...
Co-Authored-By: Carol Willing carolcode@willingconsulting.com
Co-Authored-By: Ezio Melotti ezio.melotti@gmail.com
Co-Authored-By: Hugo van Kemenade hugovk@users.noreply.github.com
Co-Authored-By: Itamar Ostricher itamarost@gmail.com
Co-Authored-By: Jesús Cea jcea@jcea.es
Co-Authored-By: Joannah Nanjekye 33177550+nanjekyejoannah@users.noreply.github.com
Co-Authored-By: Ned Batchelder ned@nedbatchelder.com
Co-Authored-By: Pablo Galindo Salgado Pablogsal@gmail.com
Co-Authored-By: Pamela Fox pamela.fox@gmail.com
Co-Authored-By: Sam Gross colesbury@gmail.com
Co-Authored-By: Stefan Pochmann 609905+pochmann@users.noreply.github.com
Co-Authored-By: T. Wouters thomas@python.org
Co-Authored-By: q-ata 24601033+q-ata@users.noreply.github.com
Co-Authored-By: slateny 46876382+slateny@users.noreply.github.com
Co-Authored-By: Борис Верховский boris.verk@gmail.com
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Jacob Coffee <jacob@z7x.org>
2024-10-11 21:18:37 +01:00
d501153aed
gh-119786: Move parser doc from devguide to InternalDocs ( #125119 )
...
Co-authored-by: Jacob Coffee <jacob@z7x.org>
Co-authored-by: Carol Willing <carolcode@willingconsulting.com>
Co-Authored-By: Adam Turner <9087854+aa-turner@users.noreply.github.com>
Co-Authored-By: Carl Friedrich Bolz-Tereick <cfbolz@gmx.de>
Co-Authored-By: Carol Willing <carolcode@willingconsulting.com>
Co-Authored-By: Erlend E. Aasland <erlend@python.org>
Co-Authored-By: Ezio Melotti <ezio.melotti@gmail.com>
Co-Authored-By: Hugo van Kemenade <hugovk@users.noreply.github.com>
Co-Authored-By: Irit Katriel <iritkatriel@yahoo.com>
Co-Authored-By: Itamar Ostricher <itamarost@gmail.com>
Co-Authored-By: Julien Palard <julien@palard.fr>
Co-Authored-By: Mana <potpath@users.noreply.github.com>
Co-Authored-By: Muhammad Mahad <mahadpy@gmail.com>
Co-Authored-By: Ned Batchelder <ned@nedbatchelder.com>
Co-Authored-By: Pablo Galindo Salgado <Pablogsal@gmail.com>
Co-Authored-By: slateny <46876382+slateny@users.noreply.github.com>
Co-Authored-By: wookie184 <wookie1840@gmail.com>
2024-10-09 18:21:35 +01:00
2d8b6a4e9d
gh-119786: Replace a Sphinx role with a link to `Python/errors.c` ( #124990 )
2024-10-05 01:00:19 +01:00
8bcf118dcb
gh-119786: move a few more details on exception handling from devguide to InternalDocs ( #124989 )
2024-10-05 00:48:12 +01:00
994051e086
gh-124962: Convert leftover rst to markup in `InternalDocs/compiler.md` ( #124971 )
...
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
2024-10-04 19:53:02 +05:30
81a253b929
Fix typo in InternalDocs/string_interning.md (GH-124699)
2024-09-27 19:31:59 +00:00
acf0d9eae6
InternalDocs: Fix typo in link to instruction_sequence.c inside compiler docs ( #122809 )
2024-08-08 09:19:10 +01:00
af0a00f022
gh-122188: Move magic number to its own file ( #122243 )
...
* gh-122188: Move magic number to its own file
* Add versionadded directive
* Do work in C
* Integrate launcher.c
* Make _pyc_magic_number private
* Remove metadata
* Move sys.implementation -> _imp
* Modernize comment
* Move _RAW_MAGIC_NUMBER to the C side as well
* _pyc_magic_number -> pyc_magic_number
* Remove unused import
* Update docs
* Apply suggestions from code review
Co-authored-by: Eric Snow <ericsnowcurrently@gmail.com>
* Fix typo in tests
---------
Co-authored-by: Eric Snow <ericsnowcurrently@gmail.com>
2024-07-30 15:31:05 -04:00
bb09ba6792
gh-122291: Intern latin-1 one-byte strings at startup (GH-122303)
2024-07-27 10:27:06 +02:00
ef10110cd7
gh-119786: fix broken links in docs and comment ( #121601 )
2024-07-10 21:59:14 +00:00
c87876763e
gh-119786: move frames documentation to InternalDocs and add details ( #121009 )
2024-06-26 13:18:20 +01:00
6f1d448bc1
gh-113993: Allow interned strings to be mortal, and fix related issues (GH-120520)
...
* Add an InternalDocs file describing how interning should work and how to use it.
* Add internal functions to *explicitly* request what kind of interning is done:
- `_PyUnicode_InternMortal`
- `_PyUnicode_InternImmortal`
- `_PyUnicode_InternStatic`
* Switch uses of `PyUnicode_InternInPlace` to those.
* Disallow using `_Py_SetImmortal` on strings directly.
You should use `_PyUnicode_InternImmortal` instead:
- Strings should be interned before immortalization, otherwise you're possibly
interning a immortalizing copy.
- `_Py_SetImmortal` doesn't handle the `SSTATE_INTERNED_MORTAL` to
`SSTATE_INTERNED_IMMORTAL` update, and those flags can't be changed in
backports, as they are now part of public API and version-specific ABI.
* Add private `_only_immortal` argument for `sys.getunicodeinternedsize`, used in refleak test machinery.
* Make sure the statically allocated string singletons are unique. This means these sets are now disjoint:
- `_Py_ID`
- `_Py_STR` (including the empty string)
- one-character latin-1 singletons
Now, when you intern a singleton, that exact singleton will be interned.
* Add a `_Py_LATIN1_CHR` macro, use it instead of `_Py_ID`/`_Py_STR` for one-character latin-1 singletons everywhere (including Clinic).
* Intern `_Py_STR` singletons at startup.
* For free-threaded builds, intern `_Py_LATIN1_CHR` singletons at startup.
* Beef up the tests. Cover internal details (marked with `@cpython_only`).
* Add lots of assertions
Co-Authored-By: Eric Snow <ericsnowcurrently@gmail.com>
2024-06-21 17:19:31 +02:00
d484383861
gh-119786: move locations doc to InternalDocs ( #120445 )
2024-06-19 17:58:54 +01:00
ce3879bd45
Fix typos in documentation ( #120338 )
2024-06-12 12:24:43 +00:00
56c3815ba1
gh-119786: copy compiler doc from devguide to InternalDocs and convert to markdown ( #120134 )
...
* gh-119876: move compiler doc from devguide to InternalDocs
Copy of 78fc0d7aa9✌️ ️ <isc.suriyaa@gmail.com>
Co-Authored-By: Zachary Ware <zachary.ware@gmail.com>
Co-Authored-By: psyker156 <242220+psyker156@users.noreply.github.com>
Co-Authored-By: slateny <46876382+slateny@users.noreply.github.com>
Co-Authored-By: svelankar <17737361+svelankar@users.noreply.github.com>
Co-Authored-By: zikcheng <surfingbyte@gmail.com>
* convert to markdown
* add to index
* update more of the out of date stuff
---------
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Brett Cannon <brett@python.org>
Co-authored-by: Carol Willing <carolcode@willingconsulting.com>
Co-authored-by: Daniel Porteous <danielporteous1@gmail.com>
Co-authored-by: Dennis Sweeney <36520290+sweeneyde@users.noreply.github.com>
Co-authored-by: Éric Araujo <merwok@netwok.org>
Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: Georg Brandl <georg@python.org>
Co-authored-by: Guido van Rossum <guido@python.org>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
Co-authored-by: Jeff Allen <ja.py@farowl.co.uk>
Co-authored-by: Jim Fasarakis-Hilliard <d.f.hilliard@gmail.com>
Co-authored-by: Ken Jin <28750310+Fidget-Spinner@users.noreply.github.com>
Co-authored-by: Lincoln <71312724+Lincoln-developer@users.noreply.github.com>
Co-authored-by: Mariatta <Mariatta@users.noreply.github.com>
Co-authored-by: Muhammad Mahad <mahadpy@gmail.com>
Co-authored-by: Ned Deily <nad@acm.org>
Co-authored-by: Pablo Galindo Salgado <Pablogsal@gmail.com>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: Stéphane Wirtel <stephane@wirtel.be>
Co-authored-by: Suriyaa ✌️ ️ <isc.suriyaa@gmail.com>
Co-authored-by: Zachary Ware <zachary.ware@gmail.com>
Co-authored-by: psyker156 <242220+psyker156@users.noreply.github.com>
Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>
Co-authored-by: svelankar <17737361+svelankar@users.noreply.github.com>
Co-authored-by: zikcheng <surfingbyte@gmail.com>
2024-06-10 16:15:12 +01:00
eeb8f67f83
gh-119786: move adaptive interpreter doc from Python to InternalsDoc ( #120137 )
2024-06-06 10:56:58 +00:00
10eac0269b
gh-119786: add links to code in exception handling doc ( #120077 )
2024-06-05 16:28:47 +01:00
367adc91fb
gh-119786: move exception handling doc to InternalDocs ( #119815 )
2024-06-03 09:36:20 +00:00
e91fc11faf
gh-119786: create folder in cpython repo for internals documentation ( #119787 )
2024-05-30 16:38:37 +00:00
Irit Katriel
Mark Shannon
Hugo van Kemenade
Valerii
Marat Sharafutdinov
Emmanuel Ferdman
Mikhail Efimov
Adam Turner
isaacjones99
Petr Viktorin
Francisco Kurucz
Michael Droettboom
Xie Yanbo