Skip to content

Add a new Sphinx soft-deprecated directive #148630

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
hugovk merged 14 commits into from
Apr 18, 2026
Merged

Add a new Sphinx soft-deprecated directive #148630

Changes from 1 commit
Commits
Show all changes
14 commits
Select commit Hold shift + click to select a range
df3809c
Add soft-deprecated directive
hugovk Apr 5, 2026
3f88cf5
Use 'soft-deprecated' directive instead of 'deprecated'
hugovk Apr 5, 2026
fe5f42e
Split prefixmatch/match into versionadded/soft-deprecated
hugovk Apr 15, 2026
83ebd59
Fix wording
hugovk Apr 15, 2026
9b84663
Remove outdated note
hugovk Apr 15, 2026
d20f5bf
Make directive translatable
hugovk Apr 15, 2026
bee4f6c
Make 'soft deprecated' translatable
hugovk Apr 15, 2026
b43e9c2
Update some C API entries
hugovk Apr 16, 2026
0eee3e3
Update class name
hugovk Apr 16, 2026
768cab3
Ignore c-api/file.html: deprecated-api
hugovk Apr 16, 2026
2d493f0
Ignore c-api/allocation.html: deprecated-aliases
hugovk Apr 16, 2026
a16ca8b
Use `:term:` instead for translators
StanFromIreland Apr 17, 2026
7ebf41b
Use `:term:` instead for translators (#81)
hugovk Apr 17, 2026
70e7f8d
fixup! Use 'soft-deprecated' directive instead of 'deprecated'
hugovk Apr 17, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Remove outdated note
  • Loading branch information
@hugovk
hugovk committed Apr 15, 2026
commit 9b84663059f2a8e3db6067dd18a199afa1675a9f
1 change: 0 additions & 1 deletion Doc/c-api/long.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -197,7 +197,6 @@ distinguished from a number. Use :c:func:`PyErr_Occurred` to disambiguate.

.. c:function:: long PyLong_AS_LONG(PyObject *obj)

A :term:`soft deprecated` alias.
Exactly equivalent to the preferred ``PyLong_AsLong``. In particular,
it can fail with :exc:`OverflowError` or another exception.

Expand Down