onury/docma

inheritdoc not respecting "smart linking"

aaronmallen opened this issue · 1 comments

given

// ./lib/a.js
/**
 * A base class
 * @memberof myModule
 */
class A {}
// ./lib/b.js
import A from './a'
/**
 * A child class
 * @memberof myModule
 * @extends myModule~A
 * @inheritdoc
 */
class B extends A {}
// index.js
/** 
 * A module that does stuff
 * @module myModule 
*/
import B from './lib/b'
export default {B}

both the inheritance of properties and the "Extends" link properly generate for B but when you do:

// ./lib/b.js
import A from './a'
/**
 * A child class
 * @memberof myModule
 * @extends A
 * @inheritdoc
 */
class B extends A {}

the inheritance breaks (i.e. none of the class properties are carried over) however the "Extends" link still points to the proper base class.

onury commented

Seems to be a JSDoc issue. (Docma uses JSDoc to parse documentation.)
See @inheritdoc related issues before you decide to open a new one there.

Feel free to re-open if needed.