Skip to content

Support soft-deprecated directive - #428

Merged
hugovk merged 1 commit into
python:mainfrom
hugovk:soft-deprecated
Aug 4, 2026
Merged

Support soft-deprecated directive#428
hugovk merged 1 commit into
python:mainfrom
hugovk:soft-deprecated

Conversation

@hugovk

@hugovk hugovk commented Aug 4, 2026

Copy link
Copy Markdown
Member

This was added in python/cpython#148630 and needs support here too.

Showed up during today's 3.15.0rc1 release:

Checking built docs for '(unreleased)'
/var/folders/c8/hl_96fcs0hjgr29njx33x20c0000gn/T/tmpgz1mpshy/python-3.15.0rc1-docs-html/c-api/type.html:1051:<p><span class="versionmodified soft-deprecated"><a class="reference internal" href="../glossary.html#term-soft-deprecated">Soft deprecated</a> since version 3.15.0rc1 (unreleased): </span>Prefer <a class="reference internal" href="#c.PyType_FromSlots" title="PyType_FromSlots"><code class="xref c c-func docutils literal notranslate"><span class="pre">PyType_FromSlots()</span></code></a> in new code.</p>
/var/folders/c8/hl_96fcs0hjgr29njx33x20c0000gn/T/tmpgz1mpshy/python-3.15.0rc1-docs-html/c-api/type.html:1079:<p><span class="versionmodified soft-deprecated"><a class="reference internal" href="../glossary.html#term-soft-deprecated">Soft deprecated</a> since version 3.15.0rc1 (unreleased): </span>Prefer <a class="reference internal" href="#c.PyType_FromSlots" title="PyType_FromSlots"><code class="xref c c-func docutils literal notranslate"><span class="pre">PyType_FromSlots()</span></code></a> in new code.</p>
/var/folders/c8/hl_96fcs0hjgr29njx33x20c0000gn/T/tmpgz1mpshy/python-3.15.0rc1-docs-html/c-api/type.html:1103:<p><span class="versionmodified soft-deprecated"><a class="reference internal" href="../glossary.html#term-soft-deprecated">Soft deprecated</a> since version 3.15.0rc1 (unreleased): </span>Prefer <a class="reference internal" href="#c.PyType_FromSlots" title="PyType_FromSlots"><code class="xref c c-func docutils literal notranslate"><span class="pre">PyType_FromSlots()</span></code></a> in new code.</p>
/var/folders/c8/hl_96fcs0hjgr29njx33x20c0000gn/T/tmpgz1mpshy/python-3.15.0rc1-docs-html/c-api/type.html:1125:<p><span class="versionmodified soft-deprecated"><a class="reference internal" href="../glossary.html#term-soft-deprecated">Soft deprecated</a> since version 3.15.0rc1 (unreleased): </span>Prefer <a class="reference internal" href="#c.PyType_FromSlots" title="PyType_FromSlots"><code class="xref c c-func docutils literal notranslate"><span class="pre">PyType_FromSlots()</span></code></a> in new code.</p>
/var/folders/c8/hl_96fcs0hjgr29njx33x20c0000gn/T/tmpgz1mpshy/python-3.15.0rc1-docs-html/c-api/module.html:1054:<p><span class="versionmodified soft-deprecated"><a class="reference internal" href="../glossary.html#term-soft-deprecated">Soft deprecated</a> since version 3.15.0rc1 (unreleased): </span>Prefer <a class="reference internal" href="#c.PyModule_FromSlotsAndSpec" title="PyModule_FromSlotsAndSpec"><code class="xref c c-func docutils literal notranslate"><span class="pre">PyModule_FromSlotsAndSpec()</span></code></a> in new code.</p>
/var/folders/c8/hl_96fcs0hjgr29njx33x20c0000gn/T/tmpgz1mpshy/python-3.15.0rc1-docs-html/c-api/module.html:1078:<p><span class="versionmodified soft-deprecated"><a class="reference internal" href="../glossary.html#term-soft-deprecated">Soft deprecated</a> since version 3.15.0rc1 (unreleased): </span>Prefer <a class="reference internal" href="#c.PyModule_FromSlotsAndSpec" title="PyModule_FromSlotsAndSpec"><code class="xref c c-func docutils literal notranslate"><span class="pre">PyModule_FromSlotsAndSpec()</span></code></a> in new code.</p>
/var/folders/c8/hl_96fcs0hjgr29njx33x20c0000gn/T/tmpgz1mpshy/python-3.15.0rc1-docs-html/c-api/module.html:1090:<p><span class="versionmodified soft-deprecated"><a class="reference internal" href="../glossary.html#term-soft-deprecated">Soft deprecated</a> since version 3.15.0rc1 (unreleased): </span>To run a module’s own execution slots, prefer <a class="reference internal" href="#c.PyModule_Exec" title="PyModule_Exec"><code class="xref c c-func docutils literal notranslate"><span class="pre">PyModule_Exec()</span></code></a>,
Are these `(unreleased)` strings in built docs OK?
Enter yes or no:

Not too much of a problem for this pre-release, but let's fix for (probably tomorrow's) 3.14 and 3.13.

@hugovk
hugovk merged commit f7f0f33 into python:main Aug 4, 2026
25 of 26 checks passed
@hugovk
hugovk deleted the soft-deprecated branch August 4, 2026 15:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants