[wenzeslaus]

The Sphinx build of the Python library originally documented every subpackage under a stripped namespace (pygrass, script, temporal, ...). Then we added the top-level namespace grass to match the documentation with the code (full, preferred one, such as grass.pygrass and grass.script). Now is the time to keep only the grass.* documentation pages (after release, new documentation, other Sphinx cleanups).

This is a follow-up to #7526 and removes the warnings about the subpackages packages being documented twice.

Details

Drop the seven per-subpackage sphinx-apidoc runs and the sys.path entries in conf.py that made the modules importable under their stripped names, and point the handwritten pages, the theme navigation and the links in doc/ at the grass.* pages and modules.

This removes 22 of the 42 Sphinx warnings. All ten "more than one target
found for cross-reference" warnings (Table, GrassTestFilesMultiReporter)
are gone, since they were caused purely by the duplicate generation, as
are the docstring warnings which were reported once per spelling.

The three remaining "duplicate object description" warnings (Module,
MultiModule, ParallelModuleQueue) are not caused by the stripped
namespace: grass.pygrass.modules re-exports these classes, so autodoc
documents them both on the package page and on the page of the module
defining them. They are left for a separate change.

This change was prepared with the assistance of Claude Code.

[echoix]

After this, it might be possible to retry using a static configuration of sphinx.ext.apidoc (instead of caling a command line tool apidoc from a makefile), some work that I tried to do in June 2025, but was impossible to configure correctly because of the complex mapping that was needed, and the fact that that new Sphinix isolated extension didn't support of the required configs that was available in the old way. My PR finally never got merged sphinx-doc/sphinx#13668