Tag Kind: Inline / Block
TSDoc Reference: @inheritDoc
The @inheritDoc
tag is used to create a reflection's documentation by copying it from another
reflection. The tag has the form {@inheritDoc ref}
where ref
is a
declaration reference.
The @inheritDoc
tag, following the TSDoc specification, will only copy the following parts
of a comment:
@remarks
block@param
blocks@typeParam
Blocks@returns
block/**
* Some documentation
*/
export class SomeClass {}
/** {@inheritDoc SomeClass} */
export interface SomeUnrelatedClass {}
The TSDoc standard states that the @inheritDoc
tag is an inline tag. This conflicts with
JSDoc's usage, which expects it to be present without wrapping braces. TypeDoc will parse
both {@inheritDoc}
and @inheritDoc
. When present without braces, TypeDoc will inherit
comments from the "parent" reflection if possible.
@inheritdoc