[kde-doc-english]New FPI's, New Entities, Other HEAD only changes

[Frederik Fouvry]

Yes, your description is what I was thinking of.  I apologise for my
bad explanation - I usually want to keep it short, and then have to
keep going because it was unclear.

The new DTD makes the person markup much more flexible than it used to
be, so that there are less differences in the fragile parts for the
markup for credits and contributors, with the added benefit of easy
maintenance.

(See also my reply to Eric).

| We have entities like this:
| 
| Konqui.Dragon 
| '<personname><firstname>Konqui</firstname><surname>Dragon</surname></personname>'
| 
| and 
| 
| Konqui.Dragon.email
| '<email>konqui at kde.org</email>'
| 
| <personname> (and therefore the entity) is valid anywhere we might want to use 
| a name, including in the <author> element, and in a <para>
| 
| The french team, meanwhile, uses these:
| 
| traducteurEricBischoff       '<othercredit 
| role="translator"><firstname><C3><89>ric</firstname><surname>Bischoff</surname><affilia
| tion><address><email>e.bischoff at noos.fr</email></address></affiliation><contrib>Traduction 
| fran<C3><A7>aise</contrib></othercredit>'
| <!ENTITY relecteurEricBischoff        '<othercredit 
| role="reviewer"><firstname><C3><89>ric</firstname><surname>Bischoff</surname><affiliati
| on><address><email>e.bischoff at noos.fr</email></address></affiliation><contrib>Relecture 
| de la documentation fran<C3><A7>aise</contrib></oth
| ercredit>'>
| 
| And Éric is a good example to use, because, he is in various places a 
| developer, an author, an editor, and a translator.
| 
| So, could not the French team now do this (in HEAD):
| 
| traducteurEricBischoff '<othercredit 
| role="translator">&eric.bischoff;&eric.bischoff.mail;</othercredit>
| relecteurEricBischoff  '<othercredit 
| role="reviewer">&eric.bischoff;&eric.bischoff.mail;
| <contrib>Relecture de la documentation fran<C3><A7>aise</contrib></oth
| ercredit>'>
| 
| and the credits for translators in the credits-and-licenses chapter, wouldn't 
| hardly need any changing at all:
| 
| From: <para>Traduction fran<C3><A7>aise par &BenoitCosandier;.</para> 
| <para>Relecture par &LudovicGrossard;.</para>
| 
| To: <para>Traduction francaise par &Benoit.Cosandier; 
| &Benoit.Cosandier.email;</para>
| <para>Relecture par &Ludovic.Grossard; &Ludovic.Grossard.email;</para>
| 
| Meanwhile, we in English (and also the translations) get the benefit of being 
| able to drop names in pretty much anywhere in the text, since the original 
| <personname> element is permitted as a child of just about everything.  Best 
| of all nobody will ever have their name spelt wrong again, and email 
| addresses will be a heck of a lot easier to keep up with.