I would suggest to improve WeBuilder (and of course RapidPHP) integrating support for phpDocumentor Blocks. This is an JavaDoc like API documentation syntax which allows you do specify information about classes, functions/methods and properties like a short and a long description, parameters and their data types, the return type and so on. Also license, author, date and many other more or less important things are possible to define.
Currently classes and functions defined by the programmer are inserted into the autocompletation popup but it's not that informative as the codehints for native PHP functions are because the data types and a short description are missing. So it would be great if you could add DocBlock support to WeBuilder (phpDocumentor and Doxygen).
But there is one big problem: it doesn't make sense if only the current document's API is analysed (by the way, I think API analysis - whether with or without DocBlock support - is useless when only the current file is analysed). WeBuilder had to have a look at included and required files too but that could be very negative for the program's performance. For this I have two possible resolutions:
- The user can specify the depth of recursion
- WeBuilder can use an internal database for the project's API which is much quicker than analysing the files every time
I don't know how other great IDEs solve this problem but they do it so I think it's possible.
Such a feature would make developing much more efficient. Additional a new tool window should be added in which I can view a compiled version of a specific function's API documentation including its long description and all other information, not only the data types and the short description which are shown in the autocompletation popup (e.g. how eclipse and Zend Studio do it).
What do you mean? Would that be a great feature?
Greetings
Manko10