A Comment
contains the unformatted docstring, it's position and potentially more
information that is populated when the comment is "cooked".
- Value parameters:
- expanded
If this comment has been expanded, it's expansion, otherwise
None
.- raw
The raw comment, as seen in the source code, without any expansion.
- span
The position span of this
Comment
.- usecases
The usecases for this comment.
- Companion:
- object
Value members
Concrete methods
Expands this comment by giving its content to f
, and then parsing the @usecase
sections.
Typically, f
will take care of expanding the variables.
Expands this comment by giving its content to f
, and then parsing the @usecase
sections.
Typically, f
will take care of expanding the variables.
- Value parameters:
- f
The expansion function.
- Returns:
The expanded comment, with the
usecases
populated.