Re: [PHP-DOC] Re: OO docs

2004-01-13 Thread Gabor Hojtsy
> > I don't think there was a formal agreement here on this... > > Well then should we come to a formal agreement? > > I dont think this sort of "magic" in the docs makes sense however the > ":" could be used for methods that may be called statically and the "->" > for methods that dont allow stati

[PHP-DOC] Re: OO docs

2004-01-13 Thread Lukas Smith
Gabor Hojtsy wrote: how are methods supposed to be listed in the manual: foo->bar(); http://www.php.net/manual/en/function.domdocument-add-root.php or foo::bar(); http://pear.php.net/manual/en/package.database.db.db-common.affectedrows.p hp (I didn't find an example in the php manual quickly,

[PHP-DOC] Re: OO docs

2004-01-12 Thread Gabor Hojtsy
how are methods supposed to be listed in the manual: foo->bar(); http://www.php.net/manual/en/function.domdocument-add-root.php or foo::bar(); http://pear.php.net/manual/en/package.database.db.db-common.affectedrows.php (I didn't find an example in the php manual quickly, but I think I saw some

Re: [PHP-DOC] RE: OO docs 1

2004-01-05 Thread André L F S Bacci
Hartmut Holzgraefe wrote: > AFAIR (and i have to know because i did it ;) we nowadays use > instead of within phpdoc for the > simple reason that > the older does not really support optional > arguments ... Thats ok ;) And about stylesheets for render when it holds the ID instead of ? Goba?

RE: [PHP-DOC] RE: OO docs 1

2004-01-05 Thread Steph
> AFAIR (and i have to know because i did it ;) we nowadays use > > instead of within phpdoc for the simple reason that > the older does not really support optional > arguments ... We have so many changes here that I'd have to download docbook and start over to check that :) I _know_ I'm going

Re: [PHP-DOC] RE: OO docs 1

2004-01-05 Thread Hartmut Holzgraefe
Steph wrote: Or still to change all manual from methodsynopsys/methodname/methodparam to funcsynopsis/funcparams/parameter... And I'm not crazy ;) What, no grep? ;) There's no reason you should change the way you document non-OO functions. For php-gtk-doc we went the funcsynopsis route; we hav

Re: [PHP-DOC] RE: OO docs 1

2004-01-03 Thread André L F S Bacci
Gabor Hojtsy wrote: >>> There's no reason you should change the way you document non-OO >>> functions. >> >> Only to separate then from OO-functions (METHODS! METHODS!) in tag >> level. > > Well, we can play with context, and there is no need to use the not > that flexible funcsynopsys, which we ha

Re: [PHP-DOC] RE: OO docs 1

2004-01-03 Thread Gabor Hojtsy
Or still to change all manual from methodsynopsys/methodname/methodparam to funcsynopsis/funcparams/parameter... And I'm not crazy ;) What, no grep? ;) No realy, you know ;p There's no reason you should change the way you document non-OO functions. Only to separate then from OO-functions (METHODS

Re: [PHP-DOC] RE: OO docs 1

2004-01-03 Thread André L F S Bacci
Steph wrote: >> Or still to change all manual from >> methodsynopsys/methodname/methodparam to >> funcsynopsis/funcparams/parameter... And I'm not crazy ;) > > What, no grep? ;) No realy, you know ;p > There's no reason you should change the way you document non-OO > functions. Only to separat

[PHP-DOC] RE: OO docs 1

2004-01-03 Thread Steph
> Or still to change all manual from > methodsynopsys/methodname/methodparam to > funcsynopsis/funcparams/parameter... And I'm not crazy ;) What, no grep? ;) There's no reason you should change the way you document non-OO functions. For php-gtk-doc we went the funcsynopsis route; we have funct