Docstrings
Posted: Mon Jan 23, 2023 9:01 am
Docstrings are JSdoc-like. A docstring is a block comment, which starts with /** instead of just /*.
It is always at least 3 lines long and must directly precede the function it describes. No blank lines inbetween.
It supports generic function description, as well as the following tags:
- @arg (or @param). Arg may include type and default. Types are normal Fallout and WeiDU types, with addition of "list" and "map" types, which mean simple and associative arrays, correspondingly, and "uint" - unsigned int.
- @ret (@return, returns). May include type.
- @deprecated. Should include short description why and what to use instead.
Docstring information will be added to intellisense.
It is always at least 3 lines long and must directly precede the function it describes. No blank lines inbetween.
It supports generic function description, as well as the following tags:
- @arg (or @param). Arg may include type and default. Types are normal Fallout and WeiDU types, with addition of "list" and "map" types, which mean simple and associative arrays, correspondingly, and "uint" - unsigned int.
- @ret (@return, returns). May include type.
- @deprecated. Should include short description why and what to use instead.
Docstring information will be added to intellisense.