sphinx: autodoc support
Currently the roles and directives in the sphinx module do not follow the standard form of like the python
domain or the matlab
. This creates problems for downstream users of moderncmakedomain, particularly when they mix it with myst-parser. E.g. having nested documentation of module and function breaks down because they are mixed.
Some restructuring that can help:
- convert the python module into a python package, separating
domain
,directive
,auto-api
/documenter
, etc. - follow the domain/auto-api syntax, i.e.
cmake:module
is the domain role,cmake:auto-module
the crawler that populates it - include an
indexer
and resolve-any-xref - remove duplicate
command:
, etc. tags from intersphinx linkage - overall replicate the python/matlab domain as much as possible