[kde-doc-english] formatting question for <author> sections

[Jack]

Hello,

While preparing a new version of the KMyMoney handbook, I've noticed  
that the <author> sections are not consistent, in that some use entities
   <author> &author.name; &author.name.mail; </author>
and some are fully written out
   <author>
     <firstname>author</firstname>
     <surname>author</surname>
     <affiliation>
       <address><email>author at wherever.net</email></address>
     </affiliation>
   </author>

What I find interesting, is that in the first case, the displayed  
handbook page only has the author's name, not his email address, but in  
the latter case, it shows both name and email.  I've tried several  
variations, and the email address only shows up with the full  
<affiliation><address><email> format.  (The .mail entities are all  
defined with just <email>user at host</email>.)

I suppose it is not really important whether an author's email address  
shows up at chapter and section headings, but I like consistency, and  
I'm curious if this is a known issue and whether there is any point in  
adding <affiliation><address> around the <email> either in the  
contributor.entities file, or just within the <author> sections in the  
docbook files.

Thanks.

Jack