Re: cvs: phpdoc /en/functions array.xml crack.xml
| From: | Lars Torben Wilson | Date: | Tue, 12 Mar 2002 11:12:27 +0000 |
| Subject: | Re: cvs: phpdoc /en/functions array.xml crack.xml | ||
| References: | 1 2 3 4 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969342984@lists.php.net to get a copy of this message | ||
On Tue, 2002-03-12 at 03:10, Gabor Hojtsy wrote:
> > > <section id="array.seealso">
> > > <title>See also</title>
> > > <note role="seealso">
> > > <para>
> > > See also <function>is_array</function>,
> > > <function>explode</function>,
> > > <function>implode</function>,
> > > <function>split</function>,
> > > and <function>join</function>.
> > > </para>
> > > </note>
> > > </section>
> > >
> >
> > What about <section id="array.seealso" role="seealso">? Easy
> > enough to
> > process. But even the example you have above doesn't look bad to me,
> > since the seealso has to be inside a <section> anyway at that point,
> > and it does make sense.
>
> Well, I don't like this above, because you have see also in
> the section id, in the section title, in the note role and
> in the para text. Huh. It would be nice to have a simple
> container tag for this, but I guess this is impossible
> with docbook...
>
> Goba
Well, yeah, but every one of those is optional--especially the para
text. I was speaking more to the fact that there was a note inside a
section, not the specifics of the example.
What I meant by my first sentence was:
<section id="array.seeaslo" role="seealso">
<title>See also</title>
<simpara>
. . .functions. . .
</simparay>
</section>
i.e. just make <section> play this role here.
--
Torben Wilson <torben@php.net>
http://www.thebuttlesschaps.com
http://www.hybrid17.com
http://www.inflatableeye.com
+1.604.709.0506