Admin message
Looking for advice? Join the
Matrix channel for GitLab users in Bielefeld
!
Changes
Page history
Add documentation info
authored
Oct 02, 2021
by
galberding
Hide whitespace changes
Inline
Side-by-side
Development.md
View page @
3d77fb75
...
...
@@ -24,3 +24,27 @@ browser:
```
bash
snakeviz logs/amiroci.perf
```
## Documentation
The program is documented with Doxygen.
*
Switch to the
`doc`
directory
*
Generate documentation with
`doxygen`
or
`doxywizard`
```
bash
cd
doc
doxygen Doxyfile
```
In order to use Doxygen commands inside the docstring it is required to
**place an exclamation mark**
at the beginning of each comment.
Otherwise the commands are ignored.
```
python
def
myfunc
(
name
:
str
)
->
None
:
"""
!Describe stuff here.
@param name some fancy name
@note
Someting worth noting
@return Nothing
"""
```
All special commands are listed
[
here
](
https://www.doxygen.nl/manual/commands.html#cmddef
)
.