Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[doc] Add a stub for doxygen documentation #85

Merged
merged 2 commits into from
Nov 26, 2024

Conversation

cgraeser
Copy link
Contributor

@cgraeser cgraeser commented Nov 25, 2024

This adds a doxygen configuration file and some
rudimentary structure. The documentation can
be build by calling

make doxygen

in the build directory after the project has been configured with CMake and if doxygen was found.
This will create a subdirectory ADOL-C/doc/doxygen/html/ containing the class documentation with index.html as entry page. Currently there is no class documentation at all. If doxygen tags are added to classes and functions, they will show up here after regeneration of the documentation.

Once a CMake build system has been established, one can also build the doxygen documentation using CMake. (done)

This adds a doxygen configuration file and some
rudimentary structure. The documentation can
be build by calling

```
doxygen Doxyfile
```

in the `ADOL-C/doc/doxygen/` subdirectory.
This will create a sudirectory `ADOL-C/doc/doxygen/html/`
containing the class documentation with `index.html`
as entry page. Currently there is no class documentation
at all. If doxygen tags are added to classes and functions,
they will show up here after regeneration of the documentation.

Once a CMake build system has been established, one can also
build the doxygen documentation using CMake.
Copy link

codecov bot commented Nov 26, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 65.95%. Comparing base (6c58e40) to head (a02023b).
Report is 4 commits behind head on master.

Additional details and impacted files
@@           Coverage Diff           @@
##           master      #85   +/-   ##
=======================================
  Coverage   65.95%   65.95%           
=======================================
  Files          51       51           
  Lines       26473    26473           
  Branches     1843     1843           
=======================================
  Hits        17461    17461           
  Misses       9012     9012           
Flag Coverage Δ
unittests 65.95% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

@cgraeser
Copy link
Contributor Author

For now the doxygen documentation has to be build manually. If desired, one can add the ALL flag to the target, such that it is always build (if doxygen was found).

@cgraeser
Copy link
Contributor Author

While both touch the CMake build-system this is essentially independent of #87, since the latter does not touch doc/.

@TimSiebert1 TimSiebert1 merged commit e3027cf into coin-or:master Nov 26, 2024
30 of 39 checks passed
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.

2 participants