-
Notifications
You must be signed in to change notification settings - Fork 12
4. Inline Documentation for DaisySP Module Headers
andrewikenberry edited this page May 22, 2020
·
1 revision
Reference Documentation for DaisySP is parsed from inline markdown in each module's header file.
All comments that have text after a space will be parsed as Markdown into the generated reference documentation.
Only Header files are parsed.
Here's an example of the format that should be used when documenting a module:
Something about the module blahblah
Author/Source: Person Person
Date Added: December 2019
enums, templates, types, etc. etc each in their own subsection:
blah
Description of Function
arg1: rate in Hz -- default: 1.0
void Init(float arg1);
Description of Function
float Process();
Description
Range
Units
void SetParameter(float foo);
float GetParameter();
etc.
- List Item
- Another List Item
- etc.