Re: [PHP-DEV] Re: [PEAR-DEV] PHPDoc Development Status
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]
[PHP-DEV] Re: [PEAR-DEV] Re: [PHP-DEV] Re: [PEAR-DEV] PHPDoc Development Status
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. What needs doing on this front?? - James -- 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]
Re: [PHP-DEV] Re: [PEAR-DEV] PHPDoc Development Status
On Sun, Nov 25, 2001 at 02:16:38AM +0100, Stig S. Bakken wrote: Just this extension. Hurry up and apply for a CVS account at http://php.net/cvs-php.php :-) done. - Stig Jan -- mailto: [EMAIL PROTECTED] weigon @ #php.de (IRCnet) http://jan.kneschke.de weigon @ #modlogan (openprojects) -- 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]
Re: [PHP-DEV] Re: [PEAR-DEV] PHPDoc Development Status
[EMAIL PROTECTED] wrote: On Thu, Nov 22, 2001 at 04:06:35PM +0100, Andre Gildemeister wrote: hi, I have pursued the development of PHPDoc very interestedly. After the incorporation into the CVS Repository: php4/pear/PHPDoc I have heard nothing more new... - in the meantime was something to heard about a rewrite in C, is that true? I've written a PHP-2-XML converter which is sitting directly on the Zend-parser. This gives us more speed and more accuracy. It has been written because Ulf Wendel convinced me to do it by delivering a few pizzas. If someone wants to test it, download it from http://weigon.dyndns.org/ It is a php-extension which requires some patches to the Zend engine. If someone tests it, don't give up to early. The ext has been written for 4.0.4pl1 or the like and won't compile with the latest php as the Zend core has changed. Currently missing is the PHPDoc part (the php code) which can handle XML. - shouldn't PHPDoc become an official extension either? (ext/phpdoc) phpdoc itself or just this extension ? Just this extension. Hurry up and apply for a CVS account at http://php.net/cvs-php.php :-) - Stig -- 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]
[PHP-DEV] Re: [PEAR-DEV] PHPDoc Development Status
On Fri, Nov 23, 2001 at 09:19:15AM +0100, Ol wrote: On Thu, 22 Nov 2001 22:17:18 +0100 [EMAIL PROTECTED] wrote: I've written a PHP-2-XML converter which is sitting directly on the Zend-parser. This gives us more speed and more accuracy. Difficult to do better in fact ... ;) Right. If someone wants to test it, download it from http://weigon.dyndns.org/ Yeap it works fine :) Some minor bugfixes i've find tonight (diff -u at bottom) Fine. It is a php-extension which requires some patches to the Zend engine. If someone tests it, don't give up to early. The ext has been written for 4.0.4pl1 or the like and won't compile with the latest php as the Zend core has changed. At least it still work with 4.0.6 Very good. Currently missing is the PHPDoc part (the php code) which can handle XML. What to you thing about a double output for this code : - on a side can generate standart HTML output like 'classical' phpdoc - on the other a docbook output. Why not. Perfect. PHP - HTML (highlight_string) PHP - XML (ext/phpdoc) PHP - SGML (ext/phpdoc + sgml) It could be a good way to obtain more easily pear's enduser doc. Even if the docbook output surely need corrections it could be anyway a nice starting point... Sure. Doing the SGML in PHP based on the XML could simplify the development a lot. Perhaps XSLT can be usefull in these cases. PHP - XML - [XSLT] - HTML PHP - XML - [XSLT] - DocBook PHP - XML - PHPDoc This would be nice. Olivier Courtin Jan -- mailto: [EMAIL PROTECTED] weigon @ #php.de (IRCnet) http://jan.kneschke.de weigon @ #modlogan (openprojects) -- 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]
[PHP-DEV] Re: [PEAR-DEV] PHPDoc Development Status
On Thu, 22 Nov 2001 22:17:18 +0100
[EMAIL PROTECTED] wrote:
I've written a PHP-2-XML converter which is sitting directly on the
Zend-parser. This gives us more speed and more accuracy.
Difficult to do better in fact ... ;)
It has been written because Ulf Wendel convinced me to do it by
delivering a few pizzas.
:))
If someone wants to test it, download it from http://weigon.dyndns.org/
Yeap it works fine :)
Some minor bugfixes i've find tonight (diff -u at bottom)
It is a php-extension which requires some patches to the Zend engine. If
someone tests it, don't give up to early. The ext has been written for
4.0.4pl1 or the like and won't compile with the latest php as the Zend
core has changed.
At least it still work with 4.0.6
Currently missing is the PHPDoc part (the php code) which can handle
XML.
What to you thing about a double output for this code :
- on a side can generate standart HTML output like 'classical' phpdoc
- on the other a docbook output.
It could be a good way to obtain more easily pear's enduser doc. Even if
the docbook output surely need corrections it could be anyway a nice
starting point...
--- old_phpdoc.cFri Nov 23 08:58:31 2001
+++ phpdoc.cFri Nov 23 08:47:44 2001
@@ -17,6 +17,7 @@
+--+
*/
+
#include php.h
#include php_ini.h
#include php_phpdoc.h
@@ -488,6 +489,14 @@
PHPDOC_STRCAT(new_string, /);
st.pos--;
break;
+ case T_INCLUDE:
+ case T_INCLUDE_ONCE:
+ case T_REQUIRE:
+ case T_REQUIRE_ONCE:
+ zend_sprintf(buffer, \/\n);
+ PHPDOC_STRCAT(new_string, buffer);
+ st.pos--;
+ break;
}
break;
case '=':
@@ -530,6 +539,14 @@
}
break;
case ',':
+ switch (find_something(st.stack, st.pos)) {
+ case T_FUNCTION_PARAM:
+ zend_sprintf(buffer, /);
+ PHPDOC_STRCAT(new_string, buffer);
+ st.pos--;
+ break;
+ }
+ case T_ARRAY:
switch (find_something(st.stack, st.pos)) {
case T_FUNCTION_PARAM:
zend_sprintf(buffer, /);
--
Olivier Courtin
--
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]
[PHP-DEV] Re: [PEAR-DEV] PHPDoc Development Status
On Thu, 22 Nov 2001 16:06:35 +0100, Andre Gildemeister wrote: - shouldn't PHPDoc become an official extension either? (ext/phpdoc) I don't see a good reason for that. - Martin -- Martin Jansen, [EMAIL PROTECTED] http://www.martin-jansen.de/ -- 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]
[PHP-DEV] Re: [PEAR-DEV] PHPDoc Development Status
Martin Jansen [EMAIL PROTECTED] wrote: I don't see a good reason for that. What speaks in principle against this? -Andre Gildemeister -- 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]
Re: [PHP-DEV] Re: [PEAR-DEV] PHPDoc Development Status
Andre Gildemeister wrote: Martin Jansen [EMAIL PROTECTED] wrote: I don't see a good reason for that. What speaks in principle against this? wrong direction we want to get things from ext to pear, not the other way -- Hartmut Holzgraefe [EMAIL PROTECTED] http://www.six.de +49-711-99091-77 -- 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]
[PHP-DEV] Re: [PEAR-DEV] PHPDoc Development Status
On Thu, Nov 22, 2001 at 04:06:35PM +0100, Andre Gildemeister wrote: hi, I have pursued the development of PHPDoc very interestedly. After the incorporation into the CVS Repository: php4/pear/PHPDoc I have heard nothing more new... - in the meantime was something to heard about a rewrite in C, is that true? I've written a PHP-2-XML converter which is sitting directly on the Zend-parser. This gives us more speed and more accuracy. It has been written because Ulf Wendel convinced me to do it by delivering a few pizzas. If someone wants to test it, download it from http://weigon.dyndns.org/ It is a php-extension which requires some patches to the Zend engine. If someone tests it, don't give up to early. The ext has been written for 4.0.4pl1 or the like and won't compile with the latest php as the Zend core has changed. Currently missing is the PHPDoc part (the php code) which can handle XML. - shouldn't PHPDoc become an official extension either? (ext/phpdoc) phpdoc itself or just this extension ? comments etc. welcome. -Andre Gildemeister Jan -- mailto: [EMAIL PROTECTED] weigon @ #php.de (IRCnet) http://jan.kneschke.de weigon @ #modlogan (openprojects) -- 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]
