thekid/rfc — Issue #25: RFC 0025: Replace text.apidoc with new API
Author: thekid
Created: 2011-10-09 14:15:44+00:00
State: open

Scope of Change
====
The old API in text.apidoc will be deprecated and replaced by the API
from experiments/arena/apidoc.

Rationale
====
The old API doc is slow, hard to extend and does not offer sufficient
access to all program elements.

Functionality
====
Functionality is achieved by extending the abstract class "Doclet".

de.thekid.doclets.NameListDoclet class
----

```php
classes->hasNext()) {
$classdoc= &$root->classes->next();
echo '- ', $classdoc->qualifiedName();
if ($classdoc->superclass) {
echo ' extends ', $classdoc->superclass->qualifiedName();
}
echo "\n";
}
}
}
?>
```

doclet.php
----

```php
value('doclet'));

RootDoc::start($class->newInstance(), $p);
// }}}
?>
```

Usage
----

```
$ php doclet.php --doclet=de.thekid.doclets.NameListDoclet lang.Object lang.XPClass

```

Output
----

```
- lang.Object
- lang.XPClass extends lang.Object

```

Security considerations
====
n/a

Speed impact
====
The new API, though way more powerful, is actually quite a bit faster due to the
underlying parser.

Dependencies
====
n/a

Related documents
====
- Javadoc 5.0 Tool
http://java.sun.com/j2se/1.5.0/docs/guide/javadoc/

Comments
====
- friebe, Tue May 17 17:25:54 CEST 2005
Copied classes from experiments to text.doclet. Deprecated the old API
but did not remove it.