Sphinx bug: reminder (:show-inheritance:)

[MuellerSeb]

Due to a bug in sphinx, the :show-inheritance: option is not working in some cases, since the generated base class reference could have a wrong path, so you can't be redirected to the base class documentation.

See here:

• New hook to customize base list sphinx-doc/sphinx#3014
• python bases in packages sphinx-doc/sphinx#4944

[MuellerSeb]

Sphinx 4.1 will add an option for this:
https://www.sphinx-doc.org/en/master/usage/extensions/autodoc.html#event-autodoc-process-bases

Added via: sphinx-doc/sphinx#9233

Then we can use the new hook def autodoc_process_bases(app, name, obj, options, bases) in conf.py to check for the CovModel base class and redirect to the correct gstools.covmodel.CovModel to get the correct site in documentation.

[MuellerSeb]

This is magically solved now.
Clicking on gstools.covmodel.base.CovModel now correctly resolves.
https://geostat-framework.readthedocs.io/projects/gstools/en/stable/generated/gstools.covmodel.Gaussian.html#gstools.covmodel.Gaussian