[kde-doc-english]update

[Frederik Fouvry]

Hi,

I've updated the DTD and the template.  The DocBook version that
should be used from now on is 4.2.  The old version (4.1.2) will
remain available for some time, to make sure that old documents
can be validated as well.  The version before that has been
removed.

If you update a document, please also adapt the FPI from 4.1.2 to
4.2.

One extension (which was the only one) has been removed, which
makes that the DTD is again a strict subset of DocBook, i.e. all
KDE documentation that uses the new FPI will be valid DocBook
documents (you will only be able to perform the validation though
when you have all general entity definitions).

Two changes for names:

You can surround the author name(s) with the tags <personname>.
The <affiliation><address> tags can go.  <email> is now allowed
in author :-) An example of the simplified format is in
template.docbook.

You may well ask why on earth you'd add <personname>.  This
concerns the second change.  For documentation contributors,
there's now a file entities/contributors.entities where you can
define an entity for your name and email address.  (Two examples
are given in that file.  More will undoubtedly follow.)  That is
only possible in XML because of the introduction of <personname>.
The author information is now much more friendly-looking (IMHO ;-):

<author>&FirstName.M.LastName; &FirstName.M.LastName.mail;</author>

The same goes for the other contributors.  These entities can
also be used (almost) anywhere else in the text.  This should
greatly help to keep emailaddresses up-to-date, but also to have
a consistent markup of personnames in the documentation.

Translators will have to do the same for in
<lg>/contributor.entities, but that is not set up yet (of course,
user.entities can be used for the time being).

A number of general entities have been removed.  If your document
compilation complains about missing entities, please don't just
add them - they might just have been deleted.

Once we're without problems for this change, I will start
preparing for the introduction of XML catalogues.

Frederik