Re: GNOME 1.4 beta 2 is staged

[Owen Taylor <otaylor redhat com>]

Damon Chaplin <damon ximian com> writes:

> jacob berkman wrote:
> 
> > the docs should be built at *dist* time rather than build time.  please
> > mail the maintainers of these, and if they don't reply in a couple of
> > days you can mail me and i'll do the appropriate hackery for it.
> 
> What are the reasons behind this? db2html too slow?
> 
> Is it just for users docs, or should API docs (i.e. gtk-doc stuff) be
> doing the same?

I think the reason is not speed (though that clearly is not
irrelevant, considering jade....) as much as not wanting to
require a documentation build environment.

For GTK+-2.0, we are distributing the HTML docs in the tarballs,
but they will be rebuilt at build time if the users have the
required tools.

Traditionally GTK+ has followed the GNU guidelines and hasn't even
depended on awk or perl to build, much less gtk-doc and a working
SGML setup.

Regards,
                                        Owen