Re: OS X Yosemite make all doc fails

From: brian m. carlson <sandals@crustytoothpaste.net>
Date: Aug 25, 2015, 01:04 UTC
Message-ID: <20150825010428.GA428718@vauxhall.crustytoothpaste.net>
In-Reply-To: <CAJD5XBy+RnM7ZYt9_SGXgoE2gOKaiM=rmUv=Tkn3Ndi4S4-atQ@mail.gmail.com>

On Mon, Aug 24, 2015 at 02:30:39AM -0700, Jeff S wrote:

Show 73 quoted lines

> XSLTPROC user-manual.html
> warning: failed to load external entity
> "http://docbook.sourceforge.net/release/xsl/current/common/l10n.xsl"
> compilation error: file
> http://docbook.sourceforge.net/release/xsl/current/html/docbook.xsl line 29
> element include
> xsl:include : unable to load
> http://docbook.sourceforge.net/release/xsl/current/common/l10n.xsl
> warning: failed to load external entity
> "http://docbook.sourceforge.net/release/xsl/current/common/utility.xsl"
> compilation error: file
> http://docbook.sourceforge.net/release/xsl/current/html/docbook.xsl line 31
> element include
> xsl:include : unable to load
> http://docbook.sourceforge.net/release/xsl/current/common/utility.xsl
> warning: failed to load external entity
> "http://docbook.sourceforge.net/release/xsl/current/common/labels.xsl"
> compilation error: file
> http://docbook.sourceforge.net/release/xsl/current/html/docbook.xsl line 32
> element include
> xsl:include : unable to load
> http://docbook.sourceforge.net/release/xsl/current/common/labels.xsl
> warning: failed to load external entity
> "http://docbook.sourceforge.net/release/xsl/current/html/autotoc.xsl"
> compilation error: file
> http://docbook.sourceforge.net/release/xsl/current/html/docbook.xsl line 39
> element include
> xsl:include : unable to load
> http://docbook.sourceforge.net/release/xsl/current/html/autotoc.xsl
> warning: failed to load external entity
> "http://docbook.sourceforge.net/release/xsl/current/html/verbatim.xsl"
> compilation error: file
> http://docbook.sourceforge.net/release/xsl/current/html/docbook.xsl line 43
> element include
> xsl:include : unable to load
> http://docbook.sourceforge.net/release/xsl/current/html/verbatim.xsl
> warning: failed to load external entity
> "http://docbook.sourceforge.net/release/xsl/current/html/formal.xsl"
> compilation error: file
> http://docbook.sourceforge.net/release/xsl/current/html/docbook.xsl line 46
> element include
> xsl:include : unable to load
> http://docbook.sourceforge.net/release/xsl/current/html/formal.xsl
> warning: failed to load external entity
> "http://docbook.sourceforge.net/release/xsl/current/common/table.xsl"
> compilation error: file
> http://docbook.sourceforge.net/release/xsl/current/html/table.xsl line 11
> element include
> xsl:include : unable to load
> http://docbook.sourceforge.net/release/xsl/current/common/table.xsl
> warning: failed to load external entity
> "http://docbook.sourceforge.net/release/xsl/current/html/footnote.xsl"
> compilation error: file
> http://docbook.sourceforge.net/release/xsl/current/html/docbook.xsl line 51
> element include
> xsl:include : unable to load
> http://docbook.sourceforge.net/release/xsl/current/html/footnote.xsl
> warning: failed to load external entity
> "http://docbook.sourceforge.net/release/xsl/current/html/block.xsl"
> compilation error: file
> http://docbook.sourceforge.net/release/xsl/current/html/docbook.xsl line 65
> element include
> xsl:include : unable to load
> http://docbook.sourceforge.net/release/xsl/current/html/block.xsl
> warning: failed to load external entity
> "http://docbook.sourceforge.net/release/xsl/current/common/stripns.xsl"
> compilation error: file
> http://docbook.sourceforge.net/release/xsl/current/html/docbook.xsl line 76
> element include
> xsl:include : unable to load
> http://docbook.sourceforge.net/release/xsl/current/common/stripns.xsl
> make[1]: *** [user-manual.html] Error 5
> make: *** [doc] Error 2

It's clear from the message that your catalogs are not properly set up. Once you get that working, the documentation should build correctly.

Show 5 quoted lines

> <nextCatalog
> catalog="file:///usr/local/Cellar/docbook-xsl/1.78.1/docbook-xsl/catalog.xml"/>
> <nextCatalog
> catalog="file:///usr/local/Cellar/docbook-xsl/1.78.1/docbook-xsl-ns/catalog.xml"/>
> </catalog>

Unfortunately, this doesn't tell us much, since these are all references to other catalogs. You need to look in the other catalogs, specifically the two mentioned above, and ensure that there are appropriate rewriteURI and rewriteSystem entries pointing to the right place. On my system, that looks like the following:

  <rewriteURI uriStartString="http://docbook.sourceforge.net/release/xsl/current/" rewritePrefix="./"/>
  <rewriteSystem systemIdStartString="http://docbook.sourceforge.net/release/xsl/current/" rewritePrefix="./"/>

I don't know how your system is configured, so I can't tell you what entries would be correct. You might ask in an appropriate user forum for Homebrew.

-- 
brian m. carlson / brian with sandals: Houston, Texas, US
+1 832 623 2791 | http://www.crustytoothpaste.net/~bmc | My opinion only
OpenPGP: RSA v4 4096b: 88AC E9B2 9196 305B A994 7552 F1BA 225C 0223 B187