Re: Docs failing to build

Markus Hoenicka <[email protected]> Thu, 24 Aug 2006 17:16:15 +0200
Newsgroups gmane.text.refdb.devel
Message-ID <[email protected]>
David Nebauer <[email protected]> was heard to say:

> A few other references suggest this error is caused by invalid
> docbook xml.  I've attempted to validate the produced refdb-manual-xml
> file with xmllint but am unable to do so successfully.  I'll send
> you a copy off-list to see if you can validate it.
>

I still believe it is a tool problem. I've more or less finished upgrading my
box to FreeBSD 6.1 with the latest tools and stylesheets available on this
platform. I can still create the PDF manual without any problems. I can also
validate the manual with the following command (all in one line):

xmllint --noout --xinclude --relaxng
/usr/local/share/emacs/21.3/site-lisp/nxml/schema/docbook.rng refdb-manual.xml
2>&1

xmllint only complains about an IDREF with a missing linkend. This is caused by
the refdb-init(8) manpage referencing the RefDB(7) manpage which is not
included in the manual (as it would duplicate some of the general information).
After removing this link (I'll check this in shortly) xmllint reports
"refdb-manual.xml validates". You can remove this link to see whether it helps,
but I guess you won't fare better.

I think the next step is to contact either the docbook-apps list to see whether
other Debian users ran into problems, or find an appropriate Debian list.
Before doing so, did you run any tests with other DocBook documents of a
comparable size?

regards,
Markus

-- 
Markus Hoenicka
[email protected]
(Spam-protected email: replace the quadrupeds with "mhoenicka")
http://www.mhoenicka.de


-------------------------------------------------------------------------
Using Tomcat but need to do more? Need to support web services, security?
Get stuff done quickly with pre-integrated technology to make your job easier
Download IBM WebSphere Application Server v.1.0.1 based on Apache Geronimo
http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642