Skip to content

Setup for sphinx + doxygen documentation#21

Open
Thoemi09 wants to merge 1 commit intoTRIQS:clairfrom
Thoemi09:DEV_DOXYGEN
Open

Setup for sphinx + doxygen documentation#21
Thoemi09 wants to merge 1 commit intoTRIQS:clairfrom
Thoemi09:DEV_DOXYGEN

Conversation

@Thoemi09
Copy link
Collaborator

We are using numpydoc style doc strings. To make them look good, we are processing the doc strings in conf.py to inject parameter and return types of functions. It might be better to do this directly in c2py/clair (if possible).

- update doxygen docstrings in c++ files
- add basic doxygen setup to doc/doxygen
  -> generate doxygen docs with cmake and link them to the sphinx docs

- Add basic doxygen configuration and integration with sphinx
- Update C++ docstrings and generate doxygen docs via cmake
- Refine python docstring processing approach using numpydoc
- Update autosummary templates following scipy/numpy conventions
- Handle undocumented classes and update generated python bindings
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant