Looking for a package-name: PHP::Prototypes
| From: | Jan Kneschke | Date: | Mon, 29 May 2006 11:46:37 +0000 |
| Subject: | Looking for a package-name: PHP::Prototypes | ||
| Groups: | php.pear.dev | ||
| Request: | Send a blank email to pear-dev+get-42665@lists.php.net to get a copy of this message | ||
Hi,
For the PHP::Shell 0.2.7 I wanted to add inline docs for the internal
php-functions like fopen(), ArrayObject::append() and so on.
Based on the xml_proto.php code from phpdoc I wrote a Class which
seperated the code between parsing and generating something from it a
bit more. The idea is to have a single prototype parser and multiple
generators:
- a PHP-class like the PHP_ShellPrototypes.php class
- docbook-XML stubs for phpdoc
- ...
You can see the code I used for the PHP_ShellPrototypes at:
http://jan.kneschke.de/projects/php-shell/PHP_Prototypes.php.html
I used
$ find php-5.1.4/ -name '*.c' | xargs cat | \
php php-shell/PHP_Prototypes.php > php-shell/PHP_ShellPrototypes.php
As others might want to use the output of the parser for there own needs
it might be a good idea to include it into PEAR. The PHP_Shell will use
it, perhaps the phpdoc@ team likes to use it too, IDEs/Editors with
syntax hightlighting and completion need the data too, ....
Now I'm looking for a good name for the package and a way to layout the
files. For now I use
PHP/Prototypes/Parser
PHP/Prototypes/Generator/Class
PHP/Prototypes/Generator/Docbook
as layout.
Is PHP::Prototypes a obvious choice for the namespace ? Or is it
implying that is prototypes a php-application ?
Jan
--
Jan Kneschke http://jan.kneschke.de/
Perhaps you want to say 'thank you, jan': http://jk.123.org/wishlist/