Original wikiparser from NSC
Original wikiparser from NSC
The raw doc comment of symbol sym
, minus usecase and define sections, augmented by
missing sections of an inherited doc comment.
The raw doc comment of symbol sym
, minus usecase and define sections, augmented by
missing sections of an inherited doc comment.
If a symbol does not have a doc comment but some overridden version of it does,
the doc comment of the overridden version is copied instead.
The position of the raw doc comment of symbol sym
, or NoPosition if missing
If a symbol does not have a doc comment but some overridden version of it does,
the position of the doc comment of the overridden version is returned instead.
The position of the raw doc comment of symbol sym
, or NoPosition if missing
If a symbol does not have a doc comment but some overridden version of it does,
the position of the doc comment of the overridden version is returned instead.
Expand inheritdoc tags
Expand inheritdoc tags
This is done separately, for two reasons: 1. It takes longer to run compared to merge 2. The inheritdoc annotation should not be used very often, as building the comment from pieces severely impacts performance
The source (or parent) comment
The child (overriding member or usecase) comment
The child symbol
The child comment with the inheritdoc sections expanded
The cooked doc comment of symbol sym
after variable expansion, or "" if missing.
The cooked doc comment of symbol sym
after variable expansion, or "" if missing.
The symbol for which doc comment is returned
The class for which doc comments are generated
ExpansionLimitExceeded
when more than 10 successive expansions
of the same string are done, which is
interpreted as a recursive variable definition.
Performs a lookup based on the provided (pruned) query string
Performs a lookup based on the provided (pruned) query string
Will return a Tooltip
if unsucessfull, otherwise a LinkToEntity or LinkToExternal
Lookup definition of variable.
Lookup definition of variable.
The variable for which a definition is searched
The class for which doc comments are generated
Parses a raw comment string into a Comment
object.
Parses a raw comment string into a Comment
object.
all packages parsed by Scaladoc tool, used for lookup
the raw comment source string.
the position of the comment in source.
Parses comment and returns the path to the entity with an optional comment
Parses comment and returns the path to the entity with an optional comment
The idea here is to use this fact to create Future[Seq[(String, Option[Comment]]]
which can then be awaited near the end of the run - before the pickling.
Parses a string containing wiki syntax into a Comment
object.
Parses a string containing wiki syntax into a Comment
object.
Note that the string is assumed to be clean:
endOfLine
is used to mark line endings.The cooked doc comment of an overridden symbol
The cooked doc comment of an overridden symbol