Re: RE: OO docs 1
| From: | Andr� L F S Bacci | Date: | Sat, 03 Jan 2004 19:32:26 +0000 |
| Subject: | Re: RE: OO docs 1 | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969357893@lists.php.net to get a copy of this message | ||
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 separate then from OO-functions (METHODS! METHODS!) in tag level.
>> http://www.docbook.org/tdg/en/html/classsynopsis.html
>> A ClassSynopsis contains the syntax summary of a class (generally
>> speaking,
>> a class in the object-oriented programming language sense).
>>
>> This and the <method> tag may simplifies our lives.
>
> Where did you see the <method> tag?
I don't see it :|
<funcsynopsis> has <function>
Why not a
<class> for <classsynopsis>, a <method> for <methodsynopsys> and a
<constructor> for <constructorsynopsis>...
We speak in making our proper solution, but perhaps let us can convince the
DocBook's staff in adding these tags, if to decide for this way.
André Æ