Re: Looking for a package-name: PHP::Prototypes
| From: | Hannes Magnusson | Date: | Mon, 29 May 2006 22:53:12 +0000 |
| Subject: | Re: Looking for a package-name: PHP::Prototypes | ||
| References: | 1 | Groups: | php.pear.dev |
| Request: | Send a blank email to pear-dev+get-42673@lists.php.net to get a copy of this message | ||
On 5/29/06, Jan Kneschke <jan@kneschke.de> wrote:
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 ?How about PHP_Internal_Proto (PHP_Internal_Proto_Parser/_Generator)...? -Hannes