Re: Proposal: CHANGELOG
| From: | Curt Zirzow | Date: | Wed, 18 Aug 2004 04:11:23 +0000 |
| Subject: | Re: Proposal: CHANGELOG | ||
| References: | 1 2 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969363275@lists.php.net to get a copy of this message | ||
* Thus wrote Philip Olson:
>
> > >> <type>integer</type> <parameter role="ref"
> > >> choice="opt">width</parameter>
> > >>
> > >> VS
> > >>
> > >> <parameter role="ref" choice"opt"
> > >> type="integer">width</parameter>
> > >
> > > Parameter has no type attribute, so only the former is possible.
> >
> > Ups, parameter also has no choice attribute, it is of paramdef. Which in
> > turn can only be added inside a funcprototype according to the DocBook
> > DTD. Couldn't we come up with some DocBook friendly alternative? A good
> > idea would be to somehow reference the parameter already defined in the
> > funcprototype, so only one place needs editing when parameters get
> > changed. Then livedocs could resolve the reference and copy the
> > parameter info (type, by reference, name) to the right place in the
> > variablelist.
>
> We may need a livedocs person to tackle this as the structure is already
> in place. Using the same example we have the following in the
> methodsynopsis (split from one line to fit in this email):
>
> <methodparam choice="opt">
> <type>int</type><parameter
> role="reference">width</parameter>
> </methodparam>
I added a patch to do this.
http://www.powertrip.co.za/livedocs/
Curt
--
First, let me assure you that this is not one of those shady pyramid schemes
you've been hearing about. No, sir. Our model is the trapezoid!