threads / discuss / 40165

Re: OS X Yosemite make all doc fails

Subject: Re: OS X Yosemite make all doc fails

## tl;dr

5 messages between Aug 24, 2015 and Aug 26, 2015.

replies: 4people: 4as markdown or json

Jeff S· Aug 24, 2015, 09:30 UTC · lore

I tried building git on a fresh install of OS X Yosemite. Unfortunately it errors out. I've attached the error below as well as cat the xml/catalog file. Please let me know if there is anything else needed. Thanks in advance.

Jeff

OS X Yosemite 10.10.5 Xcode 6.4 (6E35b) git

commit ff86faf2fa02bc21933c9e1dcc75c8d81b3e104a
Merge: 8f8d0ec 552a736
Author: Junio C Hamano <gitster@pobox.com>
Date: Wed Aug 19 14:49:37 2015 -0700

Sync with maint

* maint:
Start preparing for 2.5.1

$ brew install autoconf $ brew install asciidoc $ brew install docbook $ brew docbook-xsl $ git clone https://github.com/git/git $ cd git $ make configure $ ./configure --prefix=/usr $ make all doc

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

$ cat /usr/local/etc/xml/catalog <?xml version="1.0"?> <!DOCTYPE catalog PUBLIC "-//OASIS//DTD Entity Resolution XML Catalog V1.0//EN" "http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd"> <catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog"> <nextCatalog catalog="file:///usr/local/Cellar/docbook/5.0/docbook/xml/4.2/catalog.xml"/> <nextCatalog catalog="file:///usr/local/Cellar/docbook/5.0/docbook/xml/4.1.2/catalog.xml"/> <nextCatalog catalog="file:///usr/local/Cellar/docbook/5.0/docbook/xml/4.3/catalog.xml"/> <nextCatalog catalog="file:///usr/local/Cellar/docbook/5.0/docbook/xml/4.4/catalog.xml"/> <nextCatalog catalog="file:///usr/local/Cellar/docbook/5.0/docbook/xml/4.5/catalog.xml"/> <nextCatalog catalog="file:///usr/local/Cellar/docbook/5.0/docbook/xml/5.0/catalog.xml"/> <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>

brian m. carlson· Aug 25, 2015, 01:04 UTC · re: Jeff S · lore

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

Jeff S· Aug 26, 2015, 00:20 UTC · re: brian m. carlson · lore

Brian thanks for responding! I'm finally able to build git completely. Would it be possible to add the OS X dependency to the git/INSTALL file?

Jeff

OSX Yosemite 10.10.5 Xcode 6.4 (6E35b) … $ brew install autoconf $ brew install asciidoc $ brew install xmlto $ brew install docbook $ export XML_CATALOG_FILES=/usr/local/etc/xml/catalog $ brew install docbook-xsl

http://stackoverflow.com/questions/13519203/git-compilingdocumentation-git-add-xml-does-not-validate Jeff

--- sent via the nexus ---

On Mon, Aug 24, 2015 at 6:04 PM, brian m. carlson <sandals@crustytoothpaste.net> wrote:

Show 100 quoted lines

> On Mon, Aug 24, 2015 at 02:30:39AM -0700, Jeff S wrote:
>> 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.
>
>> <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

Junio C Hamano· Aug 26, 2015, 17:42 UTC · re: Jeff S · lore

Re* OS X Yosemite make all doc fails

Jeff S <acornblue@gmail.com> writes:

Show 13 quoted lines

> Brian thanks for responding! I'm finally able to build git completely.
> Would it be possible to add the OS X dependency to the git/INSTALL
> file?
>
> OSX Yosemite 10.10.5
> Xcode 6.4 (6E35b)
> …
> $ brew install autoconf
> $ brew install asciidoc
> $ brew install xmlto
> $ brew install docbook
> $ export XML_CATALOG_FILES=/usr/local/etc/xml/catalog
> $ brew install docbook-xsl

It may not be a bad idea to add a whole section at the end of the document to list the prerequisite packages for various common platforms, whose beginning perhaps would look like this?

diff --git a/INSTALL b/INSTALL
index ffb071e..84fa5cf 100644
--- a/INSTALL
+++ b/INSTALL
@@ -221,3 +221,23 @@ Issues of note:
          http://www.oasis-open.org/docbook/xml/4.5/xsl/current \
          /usr/share/sgml/docbook/xml-dtd-4.5 \
      /etc/xml/catalog
+
+
+Platform specific hints:
+
+You would need to install prerequiste tools and libraries to compile
+and use Git from the source.
+
+ - OSX needs the following packages installed with 'brew install'
+   (in addition to the usual make and C compiler suite):
+
+   autoconf, asciidoc, xmlto, docbook, docbook-xsl
+
+ - Linux distributions derived from Debian need the following packages
+   instaslled via 'apt-get install' or similar (in addition to the
+   usual 'make' and C compiler suite that come as part of
+   build-essential):
+
+   autoconf, asciidoc, xmlto, docbook, libz-dev, livcurl4-openssl-dev,
+   ...
+

Torsten Bögershausen· Aug 26, 2015, 19:40 UTC · re: Junio C Hamano · lore

Re: Re* OS X Yosemite make all doc fails

On 2015-08-26 19.42, Junio C Hamano wrote:

Show 48 quoted lines

> Jeff S <acornblue@gmail.com> writes:
> 
>> Brian thanks for responding! I'm finally able to build git completely.
>> Would it be possible to add the OS X dependency to the git/INSTALL
>> file?
>>
>> OSX Yosemite 10.10.5
>> Xcode 6.4 (6E35b)
>> …
>> $ brew install autoconf
>> $ brew install asciidoc
>> $ brew install xmlto
>> $ brew install docbook
>> $ export XML_CATALOG_FILES=/usr/local/etc/xml/catalog
>> $ brew install docbook-xsl
> 
> It may not be a bad idea to add a whole section at the end of the
> document to list the prerequisite packages for various common
> platforms, whose beginning perhaps would look like this?
> 
> diff --git a/INSTALL b/INSTALL
> index ffb071e..84fa5cf 100644
> --- a/INSTALL
> +++ b/INSTALL
> @@ -221,3 +221,23 @@ Issues of note:
>           http://www.oasis-open.org/docbook/xml/4.5/xsl/current \
>           /usr/share/sgml/docbook/xml-dtd-4.5 \
>       /etc/xml/catalog
> +
> +
> +Platform specific hints:
> +
> +You would need to install prerequiste tools and libraries to compile
> +and use Git from the source.
> +
> + - OSX needs the following packages installed with 'brew install'
> +   (in addition to the usual make and C compiler suite):
> +
> +   autoconf, asciidoc, xmlto, docbook, docbook-xsl
> +
> + - Linux distributions derived from Debian need the following packages
> +   instaslled via 'apt-get install' or similar (in addition to the
> +   usual 'make' and C compiler suite that come as part of
> +   build-essential):
> +
> +   autoconf, asciidoc, xmlto, docbook, libz-dev, livcurl4-openssl-dev,
> +   ...
> +

I like this.

This is what I have been using for Debian (and RHEL 6.5 or so) (But it doesn't include "make doc")

#!/bin/sh
if type apt-get; then
  APTGET="sudo apt-get install"
fi
if type yum; then
  APTGET="sudo /usr/bin/yum install"
fi
export APTGET

type gcc || $APTGET gcc type curl-config || $APTGET libcurl4-openssl-dev || $APTGET libcurl-devel test -r /usr/include/expat.h || $APTGET libexpat1-dev || $APTGET expat-devel test -r /usr/include/ssl.h || test -r /usr/include/openssl/ssl.h || $APTGET openssl-devel type msgfmt || $APTGET gettext type make || $APTGET make