PR Summary

See#7502 for the original issue.

We don't actually need to use theany role yet; right now the default isalready theobj role, which resolves to any documented Python object. We can always switch the default toany (as suggested by#7502) at some later point, although I would prefersphinx-doc/sphinx#3616 be fixed before doing that.

Right now, this PR only changes .py files and not .rst files, as in the latter case we probably need to think about what to do with the old whatsnews (if we agree to make the change everywhere it can easily be added).

The PR doesn't re-line wrap the newly formatted docstrings yet as this probably needs to be done manually (and is a lot of work that can be done in subsequent PRs in a piecemeal fashion), but redoing the wrapping would probably further enhance the legibility of the docstrings.

The first commit was simply done by running

sed -i -E 's/:(mod|class|func|data|meth):`/`/g' **/*.py

The second commit fixes a few markups to make the doc build again, as explained in the commit text:

numpydoc does not like entries in See Also sections to be backquoted
without an explicit role, but it is able to handle them without
backquotes at all (in fact, that format is given in the numpydoc
specification). Fix the corresponding docstrings accordingly, and
line-wrap them.

The last commits contains piecemeal minor markup fixes.

PR Checklist

• Has Pytest style unit tests
• Code is PEP 8 compliant
• New features are documented, with examples if plot related
• Documentation is sphinx and numpydoc compliant
• Added an entry to doc/users/next_whats_new/ if major new feature (follow instructions in README.rst there)
• Documented in doc/api/api_changes.rst if API changed in a backward-incompatible way