#23789 [NEW]: support for a phpdoc (but doing it right)
| From: | bs_php at infeer dot com | Date: | Sat, 24 May 2003 14:09:25 +0000 |
| Subject: | #23789 [NEW]: support for a phpdoc (but doing it right) | ||
| Groups: | php.bugs | ||
| Request: | Send a blank email to php-bugs+get-40345@lists.php.net to get a copy of this message | ||
From: bs_php at infeer dot com
Operating system: All
PHP version: 4.3.2RC4
PHP Bug Type: Feature/Change Request
Bug description: support for a phpdoc (but doing it right)
I posted this request long ago and will trying it again. After reading
that the last summery of the PEAR meeting (2003-05-10 in Amsterdam) I
noticed that the PHPDocumentor is now the official tool to generate the
API
documentation.
*But* PHPDocumentor, like many other tools that need to parse the PHP
code, all suffer from the same problem: Direct support from the
PHP-language itself.
All of these tools must 'simulate' the real PHP parser and are dammed to
fail (at least on the next major PHP release).
If the PHP lib would offer parsing support (see below) it would open a
world of PHP tools.
My basic idea is to have access to the PHP parsing results (type, line
number, ...).
It would be neet to hace a vituell PHP parser. Passing a file to the
virtuell PHP-parser object should result in structure that can be
requested by PHP itself. E.g. Arrays that deliver name, type and line
number of the containing classes, class-methods, class-vars and other
attributes.
Similar to
array get_class_methods ( mixed class_name)
array get_class_var ( mixed class_name)
Regards Sam
--
Edit bug report at http://bugs.php.net/?id=23789&edit=1
--
Try a CVS snapshot: http://bugs.php.net/fix.php?id=23789&r=trysnapshot
Fixed in CVS: http://bugs.php.net/fix.php?id=23789&r=fixedcvs
Fixed in release: http://bugs.php.net/fix.php?id=23789&r=alreadyfixed
Need backtrace: http://bugs.php.net/fix.php?id=23789&r=needtrace
Try newer version: http://bugs.php.net/fix.php?id=23789&r=oldversion
Not developer issue: http://bugs.php.net/fix.php?id=23789&r=support
Expected behavior: http://bugs.php.net/fix.php?id=23789&r=notwrong
Not enough info: http://bugs.php.net/fix.php?id=23789&r=notenoughinfo
Submitted twice: http://bugs.php.net/fix.php?id=23789&r=submittedtwice
register_globals: http://bugs.php.net/fix.php?id=23789&r=globals
PHP 3 support discontinued: http://bugs.php.net/fix.php?id=23789&r=php3
Daylight Savings: http://bugs.php.net/fix.php?id=23789&r=dst
IIS Stability: http://bugs.php.net/fix.php?id=23789&r=isapi
Install GNU Sed: http://bugs.php.net/fix.php?id=23789&r=gnused