Re: Tagging methodsynopsis with role="oop" / role="proc".
| From: | Hannes Magnusson | Date: | Fri, 14 May 2010 12:40:56 +0000 |
| Subject: | Re: Tagging methodsynopsis with role="oop" / role="proc". | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969381824@lists.php.net to get a copy of this message | ||
On Thu, May 13, 2010 at 15:00, Richard Quadling
<rquadling@googlemail.com> wrote:
> So, I would like to use a role on the methodsynopsis to indicate OOP
> or PROC use. This will allow me to include only the OOP methodsynopsis
> via the xinclude in the event of method overloading.
>
> Changing
>
> <xi:include
> xpointer="xmlns(db=http://docbook.org/ns/docbook)
>
> xpointer(id('class.xyz')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])"
> />
>
> to
>
> <xi:include
> xpointer="xmlns(db=http://docbook.org/ns/docbook)
>
> xpointer(id('class.xyz')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis)"
> />
> <xi:include
> xpointer="xmlns(db=http://docbook.org/ns/docbook)
>
> xpointer(id('class.xyz')/db:refentry/db:refsect1[@role='description']/descendant::db:destructorsynopsis)"
> />
> <xi:include
> xpointer="xmlns(db=http://docbook.org/ns/docbook)
>
> xpointer(id('class.xyz')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='oop'])"
> />
>
I like it.
It has always bothered me that functions use <methodsynopsis>. In the
beginning it was <funcsynopsis>, but I can't find any discussion on
why it was changed. The <funcdef> model does fit well for us.. But
like you said, that would be a major change.
-Hannes