KDocCommentDescriptor¶
@SubclassOptInRequired(markerClass = [KtImplementationDetail::class])
interface KDocCommentDescriptor
A view of a KDoc comment.
This is part of a non-public API intended for use only by IDE and Dokka. Current implementation is based on the original findKDoc logic from Kotlin IDE Plugin.
-
If the symbol owns the KDoc,
primaryTagis the KDoc's default section andadditionalSectionscontains all sections of that KDoc (including the default one). -
For a primary constructor, if the enclosing class KDoc has an
@constructorsection, that section is used asprimaryTag, andadditionalSectionscontains the sections that include@paramtags from the class's KDoc. -
In some cases KDoc for a symbol may be extracted from the KDoc of a parent element. Examples:
-
a property-parameter of the primary constructor;
-
a type parameter;
-
a property of a class/object referenced with a @property tag in the class/object KDoc.
Properties¶
additionalSections¶
abstract val additionalSections: List<KDocSection>
Other sections from the same KDoc as primaryTag that may provide additional context
primaryTag¶
abstract val primaryTag: KDocTag
Primary tag/section tag/section if the KDoc that is relevant for the symbol