senchalabs/jsduck — Issue #78: Replace @alias with @inheritdoc
Author: nene
Created: 2011-10-17 13:14:50+00:00
State: open

It should work like the current @alias, but additionally should allow you to write:

/**
* @inheritdoc
*/
foo: function() {

As if you had written:

/**
* @inheritdoc ParentClass#foo
*/
foo: function() {

The old @alias tag should become the way of explicitly documenting class aliases:

/**
* @alias widget.foo
*/
Ext.define("MyClass", {
alias: "widget.foo",

But for backwards compatibility it should still recognize the old syntax:

/**
* @alias MyClass#bar
*/
foo: function() {

Just throw a warning.