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

[Burkhard Lück]

Am Mittwoch, 29. Juni 2011, um 01:48:08 schrieb 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.

I see this errors in my build logs since kde <=4.6, but never noticed that.
Obviously the reason is, that in 4.6 the internal copy of docbook in kdelibs 
was removed and the package docbook-xsl is used now.

Seems all our man pages are broken, no kmymoney specific problem.

But for now I have no clue how to fix that...

-- 
Burkhard Lück