Re: SPL docs

Hi Nuno, Christian Weiske and myself have both done quite a lot with docbook - mostly extending the PHP-GTK dtd and forcing the (fairly elderly but much-altered) stylesheets to do all sorts of horrible things they weren't designed to do :). The same goes for James Moore if he's around at all, and of course Goba (if he's around, ditto). I don't know how much any of us (other than Goba) could sensibly be called 'specialist', but we've a fair idea of how it all works between us. Talking with Sebastian and Marcus about their plans a couple of weeks ago, though, I came away with the distinct impression that a docbook-centred solution wasn't what they're hoping for. I think it would be a smart move to agree on the kind(s) of documentation that will be acceptable for PHP OO before we start trying to actually work with other groups to create it. (And probably not on the internals list, those poor inboxes have had their fill of mail from me today.) - Steph ----- Original Message ----- From: "Nuno Lopes" <nlopess@php.net> To: "Andrei Zmievski" <andrei@gravitonic.com>; "Andi Gutmans" <andi@zend.com> Cc: <helly@php.net>; "Derick Rethans" <derick@php.net>; <internals@lists.php.net> Sent: Friday, June 09, 2006 9:51 PM Subject: Re: [PHP-DEV] SPL docs

The problem is always maintenance.. I've have some knowledge about DSSSL but none about XSL. In phpdoc we use both, that need to be kept in sync, so that's always complicated to make changes. The best option would be to create a "work-group" to study with docbook creators the best approaches to OOP. Again, the problem is that we don't have any specialist in docbook. We work with recipes/templates, that are in a wiki, which are changed twice in a decade :) Nuno ----- Original Message -----

PHP-GTK has been using modified docbook for its stuff... http://gtk.php.net/manual/en/classtree.php -Andrei On Jun 9, 2006, at 6:55 AM, Andi Gutmans wrote:

Maybe we can get a volunteer to improve the docbook? At 11:25 PM 6/8/2006, Derick Rethans wrote:

On Thu, 8 Jun 2006, Andi Gutmans wrote:

Any chance we can get the SPL docs integrated into the PHP manual? I get questions about it here and there and think that as it's in the default PHP distro it makes sense to have that as part of the

official

PHP manual.

There is no way we can do that as the docbook stuff's OO support is well, quite minimal. regards, Derick

-- PHP Internals - PHP Runtime Development Mailing List To unsubscribe, visit: http://www.php.net/unsub.php __________ NOD32 1.1380 (20060125) Information __________ This message was checked by NOD32 antivirus system. http://www.eset.com