Re: "index.sgml" problem when using vicious-build-scripts [Was: [gnome-love] GNOME 2 needs YOU! - gnome-utils : easy fix ;)]

[Xing Wang <quixon gnuchina org>]

Empty_one, I hope this can help.

"/usr/bin/install: cannot stat `./html/index.sgml': No such file" 

When I tried to build GNOME2 from CVS, vicious-build-scripts failed at
glib for the reason above. 

I'm sure many people have experienced this problem and it should have
been solved, so I went to http://mail.gnome.org/mailman/search but it
totally sucks. It missed lots of obvious hits when I tested it:-( 

Question 5.6 of
http://www.gnome.org/~chema/gnome-love/compiling_faq.html talked about
this, but Chema's solution didn't work for me. It took me almost 2 hours
to figure out what's wrong in my case -- CATALOG. 

Short answer for debian users:
        apt-get jade openjade docbook docbook-dsssl 
                or even: apt-get install gtk-doc ;-)
        export SGML_CATALOG_FILES=/etc/sgml/catalog

Whole story:
gtk-doc needs a usable docbook toolkit. You have to get every component
right -- DTD, jade/openjade, dsssl, catalog ... There are plenty of docs
on docbook installation. Just go to google.

I was building GNOME2 on a fresh woody and had openjade installed
already. However, it turned out that both openjade and jade are needed,
as some catalog files are only available in jade package.

If it still refuses to work, go into
/gnome/head/cvs/glib/docs/reference/glib and try "make", you will get
detailed error messages, such as "cannot generate system identifier for
public text XXX..... ". Check your SGML_CATALOG_FILES and make sure XXX
is in it.

Thanks to jfleck, who helped me on irc.gnome.org.

Good luck!

On Tue, 2002-04-30 at 12:57, Empty_One wrote:
> Well, I'm taking a little break from this, cause it's driving me nuts.  
> I tried the fix from Chema at 
> http://www.gnome.org/~chema/gnome-love/compiling_faq.html but it didn't 
> work.  I also installed the sgml-tools package from slack current, 
> which sounds like it was something i had missing.  Here is the text 
> from the package description.
>
>    SGML stands for Standard Generalized Markup Language.  This is a
>    system which allows you to produce LaTeX, HTML, GNU info, LyX, RTF,
>    and plain text (via groff) from a single source file in SGML.  It is
>    often used for technical software documentation, such as the Linux
>    HOWTO documents.  This package includes everything you need to use
>    SGML -- all the standard SGML tools, OpenJade, and tools for working
>    with DocBook documents (various DTDs).
>
> I even trien deleting the gtk-doc line from ~/bin/head/modules.sh, and 
> that didn't work either.  So i give up, before i throw my pc through 
> the window.  :)
>
> Emptyone
>
> On Monday 29 April 2002 05:48 pm, John Fleck wrote:
> > EL -
> >
> > This means the DocBook toolkit is not properly installed on your
> > system, so gtk-doc can't generate the html from the sgml used in the
> > library documentation.
> >
> > You need:
> > openjade
> > the docbook dtd and stylesheets
> > the proper SGML_CATALOG_FILES environmental variable, pointing to the
> > sgml catalog files installed by the dtd and stylesheets
> >
> > Details are in the gtk-doc README.
> >
> > Cheers,
> >
> > John
>
> _______________________________________________
> gnome-love mailing list
> gnome-love gnome org
> http://mail.gnome.org/mailman/listinfo/gnome-love