#47651 [Opn]: New format/theme to create funcindex.xml and friends

ID: 47651 Updated by: philip@php.net Reported By: philip@php.net Status: Open Bug Type: Doc Build problem Operating System: All PHP Version: Irrelevant New Comment: Here's a proof of concept structure from a documented function: http://wiki.php.net/doc/skeletons/ide-function Included are various thoughts, concerns, and points of discussion. Previous Comments: ------------------------------------------------------------------------ [2009-03-29 23:19:24] philip@php.net This feature should expand what we do currently, in order to be more friendly to the IDE community. TODO: - Discuss this topic with the IDE community and determine what they want - Have as much information as possible - Design the XML Syntax for these files - Expand the idea for variables, types, constants, expressions, ... - Work for functions that are both Procedural and OO --- Like MySQLi - Include example scripts for parsing these generated files - Have one script available that converts it to SQLite - Update these weekly and list them on the doc server - Inform the IDE community of what we've done and will do I've started discussing this with the IDE community. ------------------------------------------------------------------------ [2009-03-13 17:10:48] philip@php.net Description: ------------ In phpdoc/ we have [had] the following: - funcindex.xml - funclist.txt - funcsummary.txt - quickref.txt This is a request for PhD to build these. Currently much of this information still comes directly from php-src, and it'd be nice to simply build them from the documentation sources instead. Building them from php-src is problematic, and besides our scripts to do so are unmaintained and essentially broken. And while this is done let's leave them out of CVS and host on either the mirrors or doc.php.net. Note: A related and additional option is to create an ini setting for PhD to create funcindex.xml and use it in the build. Note: Several scripts exist in scripts/ but likely they won't offer much help as they simply scour php-src. ------------------------------------------------------------------------ -- Edit this bug report at http://bugs.php.net/?id=47651&edit=1