jsdoc @inheritdoc doesn't inherit constructor documentation

@inheritdoc doesn't inherit constructor documentation

Open darrylring opened this issue 10 years ago • 9 comments

In the documentation generated by the following code, B's constructor does not inherit A's constructor documentation.

A is documented correctly but B's documentation is empty.

/**
 * Does something with a number.
 *
 * @class
 * @param {number} a - The number.
 */
function A(a) {
    this.a = a;
}

/**
 * @class
 * @augments A
 * @inheritdoc
 */
function B() {
    A.apply(this, arguments);
}

May 21 '15 23:05 darrylring

Confirmed. I agree that this ought to work.

May 27 '15 23:05 hegemonic

This is a similar case that fails, using the ES2015 class syntax:

class Parent {

  /**
   * Some docs go here!
   */
  constructor() {
    // Some stuff
  }
}

/**
 * @extends Parent
 */
class Child extends Parent {

  /**
   * @inheritdoc
   */
  constructor() {
    super();
    // Some more stuff
  }
}