Why is inheritedDoc not defined on constructors? [closed]

Question

I was wondering if there is any valid reason why javadoc does not support inheritedDoc on constructors. Suppose I have

class A
{
/**
 * Constructor of A
 */
A(){}   

/**
 * Does something
 */
public void method(){}
}

class B extends A
{
/**
 * {@inheritDoc}
 */
B(){ super();}

/**
 * {@inheritDoc}
 */
public void method(){}
}

For the method method, I could inherit the javadoc, but why the same cannot be applied for constructors? The javadoc does not get inherited unless I use the inheritDoc tag, which means I am well aware that I would want to reuse the documentation. What should prevent me from doing so for the constructors?

Answer 1

What should prevent me from doing so for the constructors?

Presumably the fact that constructors aren't inherited. While they often end up having the same parameters (with the same meaning) as the constructors in the superclass, it's not nearly such a clear relationship as it is with methods.

I can see the practical value, but equally I can see why something that isn't actually inherited shouldn't have @inheritDoc available. It would be nice if you could specifically inherit bits of documentation - for example, if you're going to pass a parameter value directly to the superclass constructor, it would be nice to be able to effectively link to that documentation...