Re: en/install/pecl.xml
| From: | Philip Olson | Date: | Wed, 03 Nov 2004 18:52:54 +0000 |
| Subject: | Re: en/install/pecl.xml | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969364884@lists.php.net to get a copy of this message | ||
> > There is simplesect used which messes the ToC.
> > According to Norman Walsh comment on simplesect it aren't supposed
> > to be in ToC. Was it the main idea when writing en/install/pecl.xml?
> > Should I alter XML or processing templates?
>
> It is probably better to be conformant to DocBook guidelines, so fix the
> XML please. If it breaks translations (ie. you need to modify the
> container, but not only the XML file itself), then it is more work (it
> would be nice to fix it across translations). If it does not break the
> build, then there is no immediate need to fix the translated files.
How does it mess with the ToC? It looks fine to me. I like
simplesect in how it puts all sections on one page with a
ToC on said page. I hate how the PHP manual always breaks
the sections on separate pages, sometimes one paragraph per
page. Maybe you have a solution to remedy this as I simply
chose simplesect because it was already parsed exactly how I
wanted. security.magicquotes uses simplesect for this same
reason.
Regards,
Philip