It seems strange that the only PHP documentor requires that you define everything yourself in damn comments and it results in huge lists of comments. Now with PHP5 you have a reflection class that can work on functions and classes. There are also functions that can extract all the currently loaded classes and then using reflection you can interate through each one and basically... in short... produce some UML sort of documentation (even if it's not diagrams yet) which would be quite useful to simply append to a page, and the script produces a report on all the classes loaded, their relationships, etc etc etc.
It would also be a good start for an intellisense system - though thats another project altogether.
It would be great if someone wanted to take on this project. If i wasn't as busy as i am with my own project (coder profile) and didn't have 50 million books to read i would definatly take the task of doing this project. Automatic Documentation sounds pretty good to me
Oh, i forgot to mention... reflection also returns details like line numbers and the file location of the class allowing you to easily extract code (and comments) with it... meaning you wouldn't just be limited to what the reflection class abstracts for you, but in fact, you could extract the comments etc as well as a "bonus" along with code snippets etc.
You do not have permission to post replies to topics in this board. If you want to join in with discussions and create new topics please register. If you want to register your own free account with us, please click here.
