Re: Re: New skeletons
| From: | Hannes Magnusson | Date: | Thu, 01 Nov 2007 10:47:00 +0000 |
| Subject: | Re: Re: New skeletons | ||
| References: | 1 2 3 4 5 6 7 8 9 10 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969378274@lists.php.net to get a copy of this message | ||
On Nov 1, 2007 11:11 AM, Hannes Magnusson <hannes.magnusson@gmail.com> wrote:
> On Nov 1, 2007 1:21 AM, Edward Z. Yang <edwardzyang@thewritingpot.com> wrote:
> > 2. Split up <methodname> into a <classname> and <methodname>. This
> > approach, not only embedding the information into the XML, also allows
> > us to swap out :: for a more appropriate -> if necessary (especially for
> > non-static functions)
>
> Right, but classname is not allowed anywhere inside methodsynopsis.
> We would need to switch over to classsynopsis, but then we wouldn't be
> able to fetch the classname at all since we can only xinclude the
> methodsynopsis...
We _could_ store the classname in the classsynopsisinfo element as remap
<classsynopsisinfo role="comment" remap="baseclassname">Inherited
methods</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook)
xpointer(id('class.baseclassname')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])"
/>
And then use classsynopsis instead of methodsynopsis for the method docs..
-Hannes