[kde-doc-english] Re: New errors/warnings processing man page for KMyMoney

[Jack]

On 2011.06.28 19:01, Jack wrote:
> As KMyMoney is preparing to release a new version, I'm getting ready  
> to update the docs, so I have set up to do a complete compile.  For  
> the man-page, I am getting a list of errors/warnings that I didn't  
> see last time, although I have not done a full compile in over a  
> year.  They seem like the fix should be obvious, but I'm still having  
> trouble figuring out what (if anything) to do.
> 
> [100%] Generating kmymoney.1
> Note: meta source : no *info/productname or alternative
> kmymoney
> Note: meta source : see http://docbook.sf.net/el/productname
> kmymoney
> Note: meta source : no refentry/refmeta/refmiscinfo at class=source
> kmymoney
> Note: meta source : see http://docbook.sf.net/el/refmiscinfo
> kmymoney
> Note: meta version: no *info/productnumber or alternative
> kmymoney
> Note: meta version: see http://docbook.sf.net/el/productnumber
> kmymoney
> Note: meta version: no refentry/refmeta/refmiscinfo at class=version
> kmymoney
> Note: meta version: see http://docbook.sf.net/el/refmiscinfo
> kmymoney
> Warn: meta source : no fallback for source, so inserted a fixme
> kmymoney
> Note: meta manual : no titled ancestor of refentry
> kmymoney
> Note: meta manual : no refentry/refmeta/refmiscinfo at class=manual
> kmymoney
> Note: meta manual : see http://docbook.sf.net/el/refmiscinfo
> kmymoney
> Warn: meta manual : no fallback for manual, so inserted a fixme
> kmymoney
> Warn: AUTHOR sect.: no personblurb|contrib for Michael T\&. Edwar
> kmymoney
> Note: AUTHOR sect.: see see http://docbook.sf.net/el/contrib
> kmymoney
> Note: AUTHOR sect.: see see http://docbook.sf.net/el/personblurb
> kmymoney
> 
> The AUTHOR items repeat for each listed author.
> 
> I'd appreciate a pointer to any summary of these items or an example  
> docbook that does the "right" thing.

Well, I got rid of all the meta errors by adding

<refmiscinfo class="source">&kmymoney;</refmiscinfo>
<refmiscinfo class="manual">Executable programs</refmiscinfo>

to the <refmeta> section.

However, I'm stumped with the author sections.  If I add  
<contrib>programmer</contrib> within the <author> section, after the  
</personname> I get:

man-kmymoney.1.docbook:40: element author: validity error : Element  
author content does not follow the DTD, expecting ((personname |  
(honorific | firstname | surname | lineage | othername | affiliation |  
authorblurb | contrib)+) , (personblurb | email | address)*), got  
(personname contrib email)
<email>ktambascio at users.sourceforge.net</email></author>

but if I put the contrib within the personname, I get

man-kmymoney.1.docbook:39: element personname: validity error : Element  
personname content does not follow the DTD, expecting (honorific |  
firstname | surname | lineage | othername)+, got (firstname surname  
contrib)

which looks to me like there is a problem with the DTD or how it is  
being applied.

Am I missing something obvious?  I seem to have the latest docbook xml  
dtd's available on Gentoo.