Re: RFC
| From: | Hojtsy Gabor | Date: | Fri, 19 Oct 2001 17:05:16 +0000 |
| Subject: | Re: RFC | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969338102@lists.php.net to get a copy of this message | ||
> i have just uploaded the draft for the 'beyond' part of my conference
> talk "The manual and beyond" to
>
> http://zugeschaut-und-mitgebaut.de/php/conference-talk.pdf
>
> comments & suggestions are highly appreciated :)
You should speak about
- the problem of entities (global.ent) as used in some old
translations and the main tree (deletes can make unbuildable manuals)
- Jouni suggested to split up installation.xml also, as it is
a hube beast now, and it is impossible to start the translation
and finish it in a reasonable time (the same as with function
files, mixed language). That is the most huge part, and there
are some semi-sections (eg. Servers- prefix of titles), which
are ugly IMHO, but with the current system, we can't do anything.
- Extending docbook with namespaces. Also with drawbacks (design
validity testing and other problems mentioned by Jirka).
After reading the pdf through these things seemed to be
important. Maybe more will come into my mind in the future.
Goba