I'm re-implementing some libraries of mine inside ActionScript 3.0. For example, I've this:
package org.hydroper.sxc.semantics
{
public class NamespaceSymbol implements ISymbol
{
/**
* @see NamespaceType
*/
public function get type():String { return null }
/**
* Indicates the reserved namespace type for a reserved namespace.
*
* @see ReservedNamespaceType
*/
public function get reservedNamespaceType():String
{
throw new ReferenceError
return null
}
/**
* Indicates the declarator package for a reserved namespace.
*/
public function get declarator():Package
{
throw new ReferenceError
return null
}
/**
* Indicates the definition name for an explicit namespace.
*/
public function get prefix():String
{
throw new ReferenceError
return null
}
/**
* Indicates the URI for an explicit namespace.
*/
public function get uri():String
{
throw new ReferenceError
return null
}
public final function toString():String
{
return this is ReservedNamespaceType ? reservedNamespaceType.toString() : prefix || uri
}
}
}
When I run asdoc (even with the include-all-for-asdoc
option on) the generated reference at package org.hydroper.sxc.semantics
omits less specific instance properties or methods.
For my Type class, I see no summaries for some properties, which is confusing. I'm using asdoc from Adobe AIR SDK (distributed by HARMAN). I use the tag @inheritDoc
in subclasses.
Here are the related sources: https://github.com/shockscript/sxc/tree/master/src/semantics/src/symbols