Re: [90% solved] Re: need more help compiling from CVS

[Gregory Leblanc <gleblanc linuxweasel com>]

On 05 Aug 2001 22:43:26 -0700, Andrew S . Halper wrote:
> On 2001.08.04 00:38 Cyrille Chepelov wrote:
>
> > * You need recent versions of the packages {jade, docbook,
> >   docbook-utils, docbook-dsssl, docbook-stylesheets,
> >   cygnus-stylesheets, etc.} of the whole DocBook rendering system. The
> >   exact names of the packages vary from system to system; this list is
> >   only a starting point! If compiling the documentation fails, please
> >   report on dia-list gnome org once you've found which packages to
> >   install..
> >
> > Tell me whether you have more success with that.
>
> OK, I did upgrade this stuff:
>
> docbook-utils-0.6.9-1 (from Rawhide)
> docbook-style-dsssl-1.64-3 (docbook-utils dependency, also from Rawhide)
> gnome-doc-tools-2-0 (from GNOME Documentation site, to get GNOME PNG variant
> DTD?)

Right, that's what that package provides.  I think it's got Dave's
png2eps util in there as well.

> I'm still getting the error, but I have a better idea why now.  When the 'make
> install' happens in doc/en, this command is executed:
>
> cd . && /usr/bin/db2html dia-manual.sgml && touch stamp-doc
>
> "/usr/bin/db2html" is a shell script that calls "/usr/bin/jw" is a shell script
> that calls "sh /usr/share/sgml/docbook/utils-0.6.9/frontends/docbook
> centralized-catalog", which returns the file name "/etc/sgml/sgml-docbook.cat". 
> It looks to me like "sh /usr/share/sgml/docbook/utils-0.6.9/frontends/docbook
> centralized-catalog" should return the file name "/etc/sgml/catalog" because
> when I run:

Right, that's the old command.  It'll work using the old tools, but not
the new ones.  If you take a look at the sgmldocs.make in gnome-core
HEAD, you'll see how this has been fixed by some of the docs hackers.
Please feel free to copy/steal this file, and adjust it to your needs.

> All of these scripts are part of the docbook-utils-0.6.9-1 package that I got
> from Rawhide, but I'm pretty sure I was having the same problems with the 7.1
> version.

Yeah, we like to call it a "feature".  db2html and related tools only
work on DocBook documents.  Most of the GNOME docs are using a (slight)
variation of the DocBook DTD, which allowed us to use PNG images in our
docs.  Instead, one needs to call jw, or db2html, and point it at the
master catalog, else it gets confused.  This problem will be going away
in the GNOME 2.0 timeframe.  Look for docs hackers to make a mess of,
err, update, things, once the API freeze is complete, and porting work
begins.  Later,
        Greg