381bda9395
[3.15] Docs: Replace hardcoded SOURCE_URI with patchlevel check (GH-150850) ( #150855 )
2026-06-03 16:49:58 +03:00
75be902a13
Docs: Standardize documentation authors ( #148102 )
2026-04-04 19:02:16 +01:00
80ab6d958a
gh-125895: Fix static asset location for sphinx-notfound-page ( #147984 )
2026-04-03 16:19:30 +01:00
f89fafed25
Mention _Float16 (type from Annex H of the C23) in the struct docs ( #146243 )
2026-03-27 19:38:28 +02:00
0dce4c6eab
gh-145254: Add thread safety annotation in docs ( #145255 )
2026-03-12 12:18:43 +05:30
255e79fa95
gh-143055: Fix crash in AST unparser when unparsing dict comprehension unpacking ( #145556 )
2026-03-09 10:37:23 -07:00
fc03cdccc0
gh-139588: Docs: fix PDF build ( #145480 )
2026-03-09 18:19:02 +02:00
15f6479c41
Docs: use a Sphinx extension to eliminate excessive links ( #145130 )
2026-03-03 15:48:43 -05:00
6f7e3d4408
Docs: Remove unnecessary entry from nitpick_ignore (GH-144933)
2026-02-18 08:52:04 +01:00
d18dbd5e1c
gh-138122: Add sampling profiler visualisation to docs ( #142772 )
...
Co-authored-by: Pablo Galindo Salgado <pablogsal@gmail.com >
2026-02-10 23:09:07 +00:00
e4d3c8395c
gh-138122: Add some screenshots to the profiling.sampling docs ( #142676 )
...
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com >
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com >
2025-12-14 17:43:03 +00:00
b4344f7020
Remove GvR from '_stdauthor' in Doc/conf.py ( #141765 )
...
Co-authored-by: Guido van Rossum <gvanrossum@microsoft.com >
2025-11-19 22:30:01 +02:00
0ac890bea7
gh-141004: Document Py_BUILD_ASSERT* macros (GH-141266)
2025-11-08 14:22:05 -05:00
ce4b0ede16
gh-139588: Increase maximum LaTeX list depth ( #140709 )
...
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com >
2025-10-28 19:56:23 +00:00
869bb6948e
Standardize translation of Doc/bugs.rst (GH-137449)
2025-10-17 08:55:12 +02:00
22cb9ba8f9
GH-101100: Remove some entries from `nitpick_ignore` ( #138464 )
2025-09-08 22:10:26 +00:00
8ed1d53e62
GH-138465: Improve documentation for common sequence methods ( #138474 )
...
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com >
2025-09-05 20:55:02 +01:00
39bd7c3156
GH-136155: Use `sphinxext-opengraph` v0.12.0 ( #137393 )
2025-08-05 21:14:31 +01:00
624bf52c83
gh-136155: Docs: check for EPUB fatal errors in CI ( #134074 )
...
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
2025-07-15 15:26:24 +03:00
85bc89f35f
gh-136209: Add .. c:var:: declarations for C exception types (GH-136210)
...
Co-authored-by: Victor Stinner <vstinner@python.org >
2025-07-10 13:07:55 +02:00
c45da6ae16
gh-136155: Docs: only add custom OpenGraph protocol meta tags for HTML builds ( #136187 )
...
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
2025-07-07 16:29:27 +03:00
21bac3aecd
Use replacements to update versions in "Using Python on macOS" ( #130400 )
2025-06-16 18:07:25 -04:00
f00512db20
Docs: Update PyExc_* tables in the c-api documentation (GH-131640)
...
Add `PyExc_BaseExceptionGroup` and `PyExc_EncodingWarning`
2025-06-06 17:51:47 +02:00
f3acbb72ff
gh-101100: Fix Sphinx warnings in library/decimal.rst ( #134303 )
2025-05-20 17:46:13 +03:00
ce724571b3
Docs HTML: Remove self-closing tags ( #132220 )
...
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com >
2025-04-07 18:21:13 +03:00
561965fa5c
Generate social media preview cards for the documentation ( #132101 )
...
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com >
2025-04-05 14:20:06 +00:00
c1a02f9101
GH-121970: Extract pydoc_topics into a new extension ( #131256 )
2025-03-19 18:35:11 +00:00
ca1bedc9a4
gh-121970: Revert "GH-121970: Extract `pydoc_topics` into a new extension ( #129116 )" ( #131245 )
...
Revert "GH-121970: Extract ``pydoc_topics`` into a new extension (#129116 )"
This reverts commit 01bcf13a1c
2025-03-14 16:25:56 +02:00
e53d105872
GH-125722: Increase minimum supported Sphinx to 8.2.0 ( #130444 )
2025-03-05 00:31:01 +00:00
043ab3af9a
GH-121970: Extract `issue_role` into a new extension ( #130615 )
...
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com >
2025-02-27 19:06:13 +00:00
3cc9e867eb
Docs: Test presence of optional extensions with importlib ( #130445 )
2025-02-22 17:52:47 +00:00
4d56c40440
GH-121970: Extract `implementation_detail` into a new extension ( #129663 )
2025-02-06 16:53:27 +00:00
58a4357e29
gh-127833: Docs: Add a grammar-snippet directive & replace productionlist (GH-127835)
...
As a first step toward aligning the grammar documentation with Python's actual
grammar, this overrides the ReST `productionlist` directive to:
- use `:` instead of the `::=` symbol
- add syntax highlighting for strings (using a Pygments highlighting class)
All links and link targets should be preserved. (Unfortunately, this reaches
into some Sphinx internals; I don't see a better way to do exactly what
Sphinx does.)
This also adds a new directive, `grammar-snippet`, which formats the snippet
almost exactly like what's in the source, modulo syntax highlighting and
keeping the backtick character to mark links to other rules.
This will allow formatting the snippets as in the grammar file
(file:///home/encukou/dev/cpython/Doc/build/html/reference/grammar.html).
The new directive is applied to two simple rules in toplevel_components.rst
---------
Co-authored-by: Blaise Pabon <blaise@gmail.com >
Co-authored-by: William Ferreira <wqferr@gmail.com >
Co-authored-by: bswck <bartoszpiotrslawecki@gmail.com >
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com >
2025-02-05 16:12:23 +01:00
ae4788809d
GH-121970: Extract `misc_news` into a new extension ( #129577 )
2025-02-02 16:17:02 +00:00
a156b19424
gh-126022: Remove zope.org from the permitted linkcheck redirects ( #129308 )
2025-01-26 16:46:00 +02:00
01bcf13a1c
GH-121970: Extract `pydoc_topics` into a new extension ( #129116 )
2025-01-21 23:28:32 +00:00
e54ac3b69e
GH-121970: Extract `changes` into a new extension ( #129105 )
2025-01-20 23:53:08 +00:00
d46b577ec0
GH-125722: Increase minimum supported Sphinx to 8.1.3 ( #128922 )
2025-01-20 00:26:24 +00:00
c9d2bc6d7f
Revert "Doc: Show object descriptions in the table of contents ( #125757 )" ( #128406 )
2025-01-02 14:35:00 +00:00
23f2e8f13c
gh-127221: Add colour to unittest output ( #127223 )
...
Co-authored-by: Kirill Podoprigora <kirill.bast9@mail.ru >
2024-12-05 21:10:46 +02:00
91f4908798
gh-126133: Only use start year in PSF copyright, remove end years ( #126236 )
2024-11-12 15:59:19 +02:00
0e45b1fd0f
Doc: Note that pydoc uses and prefers `MANPAGER` ( #125362 )
...
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com >
2024-10-29 23:12:02 +00:00
9effa0ff06
Add lightweight comments to conf.py and update docs readme (GH-126100)
...
* Update contributing contact info in readme
* Add lightweight comments to improve docs workflow understanding
* Apply code review suggestions from @hugovk
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com >
* Add code review suggestion from @AA-Turner
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com >
* Update Doc/conf.py
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com >
* Update Doc/conf.py
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com >
* Update Doc/conf.py
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com >
---------
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com >
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com >
2024-10-29 17:45:03 +00:00
91ddde4af0
Doc: Show object descriptions in the table of contents ( #125757 )
2024-10-22 14:07:09 +01:00
2bb7ab7ad3
GH-125277: Increase minimum supported Sphinx to 7.2.6 ( #125368 )
2024-10-19 04:59:22 +01:00
a2fe9ff11d
Doc: Update CVE URL ( #125489 )
2024-10-15 10:29:08 +03:00
dd0ee201da
Doc: Upgrade Sphinx to 8.1 ( #125276 )
2024-10-10 21:26:01 +01:00
cbfd392479
GH-121970: Extract `availability` into a new extension ( #125082 )
2024-10-09 21:50:03 +01:00
fae5058ec1
Doc: Fix default `latex_elements['papersize']` ( #124525 )
...
https://www.sphinx-doc.org/en/master/latex.html#the-latex-elements-configuration-setting
It should be 'letterpaper' or 'a4paper' not 'letter' or 'a4'
(not to be confused with PAPER env variable).
2024-09-28 11:30:28 +01:00
32119fc377
gh-118915: Add/fix docs entries for some new 3.13 C API (GH-124134)
2024-09-18 14:15:43 +02:00
Hugo van Kemenade