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 >
