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

[Jack]

On 2011.06.29 04:16, Albert Astals Cid wrote:
> A Wednesday, June 29, 2011, Burkhard Lück va escriure:
> > 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.
> > >
Albert - note these two conflicting errors:
> > > 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.
> 
> What do you mean by "broken"? Yes, I see there is a note saying that  
> it might
> be a good idea to add a contrib note for authors, but as far as i can  
> see (at
> least with the kbuildsycoca4 man page) the author is added to the  
> generated
> manpage just fine.
> 
> Albert

The note to add a contrib or authorblurb does not make it broken.   
However, if I do add a contrib section, I get a different error  
depending on where I add it, yet one of those two locations should be  
correct.  I believe the first attempt above should be correct "got  
(personname contrib email)" but what it says it expects seems wrong,  
implying that the contrib should be at the same level as the parts of  
the name.

Jack