index.sgml

[sams marketing-designs com]

Okay, I am getting this problem too.  The "html/index.sgml doesn't
exist" issue that has been mentioned a couple times.  I will paste the
error just for easier searching (if it ever works).

--Installing ./html/index.sgml
/bin/install: cannot stat `./html/index.sgml': No such file or directory
make[5]: *** [install-data-local] Error 1
make[5]: Leaving directory
`/mnt/RedHat/garnome-0.24.2/gnome/glib/work/main.d/glib-2.2.1/docs/reference/glib'
make[4]: *** [install-am] Error 2
make[4]: Leaving directory
`/mnt/RedHat/garnome-0.24.2/gnome/glib/work/main.d/glib-2.2.1/docs/reference/glib'

I have found this on the stderr during make, but it just keeps going
after this error:

warning: failed to load external entity
"file:///usr/share/sgml/docbook/xsl-stylesheets-3.1/VERSION"
compilation error: file
file:///usr/share/sgml/docbook/xsl-stylesheets-3.1/html/docbook.xsl line
23 element include
xsl:include : unable to load
file:///usr/share/sgml/docbook/xsl-stylesheets-3.1/VERSION
runtime error: file
file:///usr/share/sgml/docbook/xsl-stylesheets-3.1/html/docbook.xsl line
127 element meta
unregistered variable VERSION
xmlXPathCompiledEval: evaluation failed

I think this is due to a borked xsl-stylesheets installation, though I
have had the same installation for some 6 months.  It seems it never
complained before, but I can see where the complaint comes from.  Lines
23 and 127 are pasted below from that file:

<xsl:include href="../VERSION"/>
-------
  <meta name="generator" content="DocBook XSL Stylesheets V{$VERSION}"/>

It seems that $VERSION is not defined anywhere, and I don't know enough
about xsl/docbook to know exactly what is wrong.  But, if I comment out
line 23, and change $VERSION to "3.1" then it will compile the
documentation correctly.  So, all in all, it looks like a messed install
of the stylesheets (in my case) and a messed up autoconf/automake in
glib somewhere.  It shouldn't fail if it can't generate the docbook, and
it should give a better warning than just letting make tell us that file
doesn't exist.

Hope this helps someone else,

Sam