Docs: added cabal domain for sphinx
It features simple `pkg-section` directive for marking sections for which subsequent `pkg-field` fields are defined. Needed to disambiguate fields such as `type` or `main-is`. Converted most of `developing-packages.rst` to use new directives Future work: * Add directives for describing project.local, make it reference relevant cabal arguments * Add more meta, like since or deprecated which can be rendered in link titles and index. * Add "quick reference" indices for cabal args, package.cabal and project.local fields. Reference these from sidebar. * Using "since" and "deprectated field it is possible to create "what's new" index [ci skip]
Showing
- .gitignore 3 additions, 0 deletions.gitignore
- Cabal/doc/cabaldomain.py 200 additions, 0 deletionsCabal/doc/cabaldomain.py
- Cabal/doc/conf.py 6 additions, 27 deletionsCabal/doc/conf.py
- Cabal/doc/developing-packages.rst 313 additions, 176 deletionsCabal/doc/developing-packages.rst
- Cabal/doc/installing-packages.rst 24 additions, 2 deletionsCabal/doc/installing-packages.rst
Loading
Please register or sign in to comment