"Stig S. Bakken" wrote:
>
> [EMAIL PROTECTED] 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
<[EMAIL PROTECTED]> and again to Jan <[EMAIL PROTECTED]> - I'll try to find
some time to write a 1.0 version. More credits go to Kristian
<[EMAIL PROTECTED]> 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
--
PHP Development Mailing List <http://www.php.net/>
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
To contact the list administrators, e-mail: [EMAIL PROTECTED]
