Re: Upgrading to Docbook 4.3
| From: | Stefan Neufeind | Date: | Mon, 17 May 2004 11:29:47 +0000 |
| Subject: | Re: Upgrading to Docbook 4.3 | ||
| References: | 1 2 3 4 5 6 7 | Groups: | php.pear.doc |
| Request: | Send a blank email to pear-doc+get-4007@lists.php.net to get a copy of this message | ||
On Mon, 17 May 2004 at 13:26:49, Alexander Merz wrote:
> Michael Wallner wrote:
>
> >These docbook entity stuff makes anything
> >you want to do with the manual really hard...
> >
> >Are they required?
> >
> >
> Yes and No
>
> Yes: see entities as text macros, they make translation easier and help
> to provide a consistent manual; also entities are used as mark up for
> non-seven bit ASCII characters
> No: they are not required for writing the PEAR manual in general
But I strongly suggest we keep them (well, was there ever a real discussion
about this?). For sure, we need to evaluate how e.g. OOo can handle them when
editing. But there are many cases where they definitely make sense - especially
for translation, URLs (consistency), readability etc.
Stefan