|
From: Dave N. <dc...@us...> - 2008-02-20 00:00:32
|
I tried make html-docs from the docs/ directory but got network access errors. I noticed that the --nonet option was used on the xsltproc invocation, and some comment in the main Makefile that building the docs is slow and intentionally left as the last thing to build. Was the --nonet option to avoid going out to the internet? Maybe your build machines have these things cached locally? I tried removing the --nonet option but then got other network access errors like: > warning: failed to load external entity > "http://docbook.sourceforge.net/release/ > xsl/current/html/docbook.xsl" Is 'make html-docs' just supposed to work, or is there some unwritten stuff I need to do to get it to work? |
|
From: Julian S. <js...@ac...> - 2008-02-20 00:31:17
|
> Is 'make html-docs' just supposed to work, or is there some unwritten > stuff I need to do to get it to work? It certainly just-works for me, but perhaps that's not robust over different distros and which packages are installed. I just tried on openSUSE 10.2 (amd64) and 10.3 (on ppc32) and it works. Have you fed your installation the set of packages listed in "Notes [Mar. 2007]" in docs/README? Building the print docs (make print-docs) is definitely fragile. The last platform on which that worked was SUSE 10.1, so nowadays I keep a virtual machine w/ 10.1 around, purely for that purpose (and hence for building the distro tarballs). J |