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.
