Building Bonobo API docs ...

[Michael Meeks <michael ximian com>]

	Some people have moaned at me that their docs are not building
properly, etc. etc. after some applied Damon advice the following
solution has arisen to make it work at least on my system:

	with some docbook-3.1-3 RPM I got from an unknown source applying
the following patch to

/usr/lib/sgml/CATALOG

--- CATALOG	Tue Feb 20 19:31:52 2001
+++ CATALOG.works	Tue Feb 20 19:31:32 2001
@@ -35,16 +35,16 @@
 -- Stylesheets --
 
 PUBLIC "-//Norman Walsh//DOCUMENT DocBook Print Stylesheet//EN"
-  print/docbook.dsl
+  stylesheets/nwalsh-modular/print/docbook.dsl
 
 PUBLIC "-//Norman Walsh//DOCUMENT DocBook HTML Stylesheet//EN"
-  html/docbook.dsl
+  stylesheets/nwalsh-modular/html/docbook.dsl
 
 PUBLIC "-//Norman Walsh//DOCUMENT DSSSL Library//EN"
-  lib/dblib.dsl
+  stylesheets/nwalsh-modular/lib/dblib.dsl
 
 PUBLIC "-//Norman Walsh//DOCUMENT DSSSL Library V2//EN"
-  lib/dblib.dsl
+  stylesheets/nwalsh-modular/lib/dblib.dsl
 
 -- DTDs --
 
	Allows some rather crucial files to be found, in tandem with this
I discovered that I had a lurking SGML_CATALOG_FILES environment variable
that needed:

-SGML_CATALOG_FILES=/opt/gnome/src/gtk-doc-extra/sgml.catalog
+SGML_CATALOG_FILES=/opt/gnome/src/gtk-doc-extra/sgml.catalog:/usr/lib/sgml/CATALOG

	I hope this helps someone, its quite possible that someone has
new / fixed RPMs available somewhere, it would be interesting to know,

	Also, it would be _really_ nice if an autoconf check could be done
to ensure that we have a fully sane docs system before enabling doc
building.

	HTH,

		Michael.

-- 
 mmeeks gnu org  <><, Pseudo Engineer, itinerant idiot