SAF's DocReader - different wheels
| From: | Brent Cook | Date: | Sun, 15 Sep 2002 22:53:20 +0000 |
| Subject: | SAF's DocReader - different wheels | ||
| References: | 1 | Groups: | php.pear.dev |
| Request: | Send a blank email to pear-dev+get-9074@lists.php.net to get a copy of this message | ||
> Plus I document the hell out of it, but it's not in PHPDoc
> because I wrote my own DocReader (as I call it) before PHPDoc was even
> around. No biggie.
Wow! I just checked out your SAF package, and the DocReader is terrific! I
love how it generates docs on-the-fly, how _fast_ it is and the lack of
ambiguity of the documentation language.
Since you had prepared this system before PHPDoc, were you proposing it as
a solution around the time that PEAR was approaching its genesis? If not,
why not? I would consider using this system a great asset to PEAR. It
seems more expandable, easily parsable and usable than PHPDoc today (not
that the work gone into PHPDoc hasn't been appreciated). It probably could
have gone either way when PEAR was begun regarding documentation standards
and with everything else. Is it possible with PEAR now to say 'hmm, maybe
we should try something different'? I really like this.
- Brent