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

[Jack]

I think I've got the answer.

It's OK to have
<author><personname><surname>name</surname></personname><email>e at mail</email></author>
or
<author><surname>name</surname><email>e at mail</email><contrib>did  
stuff</contrib></author>
but not
<author></personname><surname>name</surname></personname><email>e at mail</email><contrib>did  
stuff</contrib></author>

I wasn't reading the error message carefully enough.  You can add  
contrib, but only if you don't have personname.  I have no idea why  
they should conflict, but that's the syntax.

Jack

On 2011.07.02 14:31, Jack wrote:
> On 2011.07.02 13:48, Albert Astals Cid wrote:
> > A Wednesday, June 29, 2011, Jack va escriure:
> >> OK, so there is no problem leaving all the man pages as they are.
> >> However, it should be OK to add a <contrib> or <authorblurb>  
> section
> >> - but it doesn't work.  While I understand this is not really a KDE
> >> bug, it is clearly wrong - so who should I report it to?
> >
> > Why do you say it does not work, i modified
> > kdelibs/doc/kbuildsycoca4/man-kbuildsycoca4.8.docbook adding
> > <contrib>Did stuff</contrib>
> > just before the closing </author> tag and worked fine.
> 
> That does not work for me.  As I said in my second message in this
> thread, if I add  <contrib>programmer</contrib> within the <author>
> section, after the  </personname> either before or after the <email>
> section, 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)
> 
> If I put the contrib within the personname, which I know is wrong, 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)
> 
> This is with docbook-xsl 1.76.1 under archlinux and also 1.75.2 under
> Gentoo.  I'm willing to believe I have some configuration problem, but
> I'm not sure where else to look.  What is more interesting now, is  
> that
> without the <contrib> I no longer seem to get the warnings that  
> started
> this whole thread, although I don't think I changed anything that  
> would
> have that effect.
> 
> Jack
> _______________________________________________
> kde-doc-english mailing list
> kde-doc-english at kde.org
> https://mail.kde.org/mailman/listinfo/kde-doc-english
>