Can't build doc anymore (v1.7.3.2)

3 messages, 3 authors, 2016-06-15 · open the first message on its own page

Can't build doc anymore (v1.7.3.2)

From: Francis Moreau <hidden>
Date: 2016-06-15 22:50:05

Hello,

I'm trying to build the git's documentation, but after pulling v1.7.3.2,
it fails:

  $ make prefix=/usr/local doc
  make -C Documentation all
  make[1]: Entering directory `/home/fmoreau/git/Documentation'
  make[2]: Entering directory `/home/fmoreau/git'
  make[2]: `GIT-VERSION-FILE' is up to date.
  make[2]: Leaving directory `/home/fmoreau/git'
      XMLTO git-fetch.1
  xmlto: /home/fmoreau/git/Documentation/git-fetch.xml does not validate (status 3)
  xmlto: Fix document syntax or use --skip-validation option
  I/O error : Attempt to load network entity http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd
  /home/fmoreau/git/Documentation/git-fetch.xml:2: warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
  D DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
                                                                                 ^
  I/O error : Attempt to load network entity http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd
  warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
  validity error : Could not load the external subset "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
  Document /home/fmoreau/git/Documentation/git-fetch.xml does not validate
  make[1]: *** [git-fetch.1] Error 13
  make[1]: Leaving directory `/home/fmoreau/git/Documentation'

Could anybody tell me what's now wrong ?

Thanks
-- 
Francis

Re: Can't build doc anymore (v1.7.3.2)

From: Drew Northup <hidden>
Date: 2016-06-15 22:50:05

On Mon, 2010-11-22 at 20:45 +0100, Francis Moreau wrote:
Hello,

I'm trying to build the git's documentation, but after pulling v1.7.3.2,
it fails:

  $ make prefix=/usr/local doc
  make -C Documentation all
  make[1]: Entering directory `/home/fmoreau/git/Documentation'
  make[2]: Entering directory `/home/fmoreau/git'
  make[2]: `GIT-VERSION-FILE' is up to date.
  make[2]: Leaving directory `/home/fmoreau/git'
      XMLTO git-fetch.1
  xmlto: /home/fmoreau/git/Documentation/git-fetch.xml does not validate (status 3)
  xmlto: Fix document syntax or use --skip-validation option
  I/O error : Attempt to load network entity http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd
  /home/fmoreau/git/Documentation/git-fetch.xml:2: warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
  D DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
                                                                                 ^
  I/O error : Attempt to load network entity http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd
  warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
  validity error : Could not load the external subset "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
  Document /home/fmoreau/git/Documentation/git-fetch.xml does not validate
  make[1]: *** [git-fetch.1] Error 13
  make[1]: Leaving directory `/home/fmoreau/git/Documentation'

Could anybody tell me what's now wrong ?
Without more information, not specifically. However, the fix may be
fairly simple. 

Some distributions are apparently so ancient that they don't include the
version 4.5 and newer Docbook XML XSL & DTD files. RHEL 5 and older make
this list. Putting those files in the local cache and fixing the
appropriate configuration file quiets the errors.

-- 
-Drew Northup N1XIM
   AKA RvnPhnx on OPN
________________________________________________
"As opposed to vegetable or mineral error?"
-John Pescatore, SANS NewsBites Vol. 12 Num. 59

Re: Can't build doc anymore (v1.7.3.2)

From: Pascal Obry <hidden>
Date: 2016-06-15 22:50:05

Francis,
      XMLTO git-fetch.1
  xmlto: /home/fmoreau/git/Documentation/git-fetch.xml does not validate (status 3)
  xmlto: Fix document syntax or use --skip-validation option
  I/O error : Attempt to load network entity http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd
  /home/fmoreau/git/Documentation/git-fetch.xml:2: warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
  D DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
                                                                                 ^
  I/O error : Attempt to load network entity http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd
  warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
  validity error : Could not load the external subset "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
  Document /home/fmoreau/git/Documentation/git-fetch.xml does not validate
  make[1]: *** [git-fetch.1] Error 13
  make[1]: Leaving directory `/home/fmoreau/git/Documentation'

Could anybody tell me what's now wrong ?
I had a similar problem on Cygwin at some point. The fix was to add some
rewrite rule in the docbook catalog (/etc/xml/catalog):

I had added this:

  <rewriteSystem
     systemIdStartString="http://www.oasis-open.org/docbook/xml/4.5/"
     rewritePrefix="/usr/share/sgml/docbook/xml-dtd-4.4/"/>

You may have to adjust...

-- 

--|------------------------------------------------------
--| Pascal Obry                           Team-Ada Member
--| 45, rue Gabriel Peri - 78114 Magny Les Hameaux FRANCE
--|------------------------------------------------------
--|    http://www.obry.net  -  http://v2p.fr.eu.org
--| "The best way to travel is by means of imagination"
--|
--| gpg --keyserver keys.gnupg.net --recv-key F949BD3B
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help