Re: OS X Yosemite make all doc fails

Re: OS X Yosemite make all doc fails

[Jeff S]

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>

Re: OS X Yosemite make all doc fails

[brian m. carlson]

[-- Attachment #1: Type: text/plain, Size: 4880 bytes --]

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

[-- Attachment #2: Digital signature --]
[-- Type: application/pgp-signature, Size: 835 bytes --]

Re: OS X Yosemite make all doc fails

[Jeff S]

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:
> 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

Re* OS X Yosemite make all doc fails

[Junio C Hamano]

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,
+   ...
+

Re: Re* OS X Yosemite make all doc fails

[Torsten Bögershausen]

On 2015-08-26 19.42, Junio C Hamano wrote:
> 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