Re: Re: PHPDoc Development Status

"Stig S. Bakken" wrote: > > jan@kneschke.de wrote: > > phpdoc itself or just this extension ? > > Just this extension. Hurry up and apply for a CVS account at > http://php.net/cvs-php.php :-) Ok, now that everybody commented on it, let me add my 2 Cents. I never stopped beliving in the importance of PHPDoc and I never ever wanted to give up my engagement entirely. I and Jan passed the half-the-way extension to quite some companies that asked for bugfixes and/or and update. Some one them offered help with the development but actually never supplied any. Up to now there's just one serious contact to a company willing to help. This was indeed a frustrating situation which gained almost 8 months. And that's why I put my focus on other projects: no Open-Source without contributions. Anyway, finally I got some cool feedback from you these days. Now that we're about to get a stable extension - thanks to Ol <pnine@free.fr> and again to Jan <jan@kneschke.de> - I'll try to find some time to write a 1.0 version. More credits go to Kristian <kris@koehntopp.de> who came up with the highlight_source() idea. I can't promise anything on the timeframe, but belive me, I'm still intrested in it. Please do not blow up the extension, keep it simple and smart/stupid. Let it output it's very own, simple XML files: no HTML, no Docbook or anything else. Any transformation of the basic output belongs to the userspace as comment parsing and documentation information inheritance does. Once we have a stable extension people will start to write lot's of documentation tools. Some chaos will come up and we'll need a discussion on the development lists on what features some kind of "standard" documentation generation should implement; quite similar to PEAR coding rules. Let me end with some Q/A's. Q: Will you write docs on your documentation tool? A: I'm currently updating my websites, some of them contain tutorials which I plan to expand. Yes, PHPDoc will be discussed as well. Q: When will there be 1.0 of PHPDoc - any roadmap? A: Can't tell you - but I'm very much interested in working on it. Those intrested getting involved in the development can ask question on the existing code on PEAR-DEV. Please, no PM. Q: Any chance to get a GUI? A: Yes, definetly. I never went into this business as I was looking for a tool to handle the expected mass of user interfaces, mostlysimple forms. Now, that I have a tool to handle lot's of forms... Q: What about DocBook? A: I don't have the neccessary knowledge for this, but I know some guys that actually have it. Means, I've send some pizza's and beer crates to send to them and make them feel guilty to help us ;). Help is very much appreciated. Ulf