v2.0.2 (2026-10-04)

Improved performance.

v2.0.1 (2026-08-26)

Fix the sdist for real, closing issue 22.

v2.0.0 (2026-08-25)

Renamed to sphinx-linklint to clarify that this is a Sphinx extension and tool. Fixes issue 19.

Fix the sdist to include all files needed for the project, closing issue 21.

v1.0.3 (2026-08-25)

Publish an updated README under the old linklint name.

v1.0.1 (2026-06-09)

Fix: references that are fully qualified when they don’t need to be are now recognized and will be unlinked.

Fix: references to functions that incorrectly use the :meth: role are recognized by Sphinx anyway, so now linklint also recognizes and unlinks them. Fixes issue 13.

These fixes change the CPython docs build from 1579 self-references unlinked to 1649.

v1.0.0 (2026-05-02)

Fix: the :noindex: directive was ignored, so sections marked as such were considered targets when they shouldn’t have been. This is now fixed.

v0.4.1 (2026-03-27)

Linklint v0.4.0 required Sphinx 9.x, which prevented it from being used by the CPython docs. Now linklint will work with Sphinx 8.x as well.

v0.4.0 (2026-03-10)

A number of roles (:ref:, :doc: and others) were being unlinked when they seemed excessive, but shouldn’t have been. They are explicit references to other parts of the documentation, so should never be removed. This is now fixed.

v0.3.1 (2026-03-01)

Published to PyPI.

v0.3.0 (2026-02-28)

Methods are associated with classes properly in a number of ways.

The Sphinx extension now displays the number of references that were unlinked. The CPython docs report 3612 references unlinked.

v0.2.0 (2026-02-22)

Now available as a Sphinx extension. Instead of changing .rst source files, the excessive links are automatically unlinked in the generated documentation.

v0.1.0 (2026-02-21)

First version: works as a linter with --check and --fix to change .rst source files.

Testing on CPython

To try local changes in the CPython docs:

cd python/cpython/Doc
make clean venv html
mv build build0
sed -i '' "/sphinx-linklint/s@.*@-e $HOME/linklint@" requirements.txt
make clean venv
uv pip install -r requirements.txt
make html
meld build0/html build/html
# or
diff -I 'Last updated on' -r build0/html build/html

Publishing

To release a new version:

1. Update the Changes section in README.rst

2. Change the __version__ value in src/sphinx_linklint/__init__.py.

3. Commit the changes.

4. Add a tag named for the version, like 1.2.3.

5. Push the tag, a GitHub action will use trusted publishing to publish to PyPI.