Re: Glade 3.0 stable branched

[Vincent Geddes <vgeddes metroweb co za>]

On Sat, 2006-09-30 at 11:14 -0400, Tristan Van Berkom wrote:
> Glade needs a user manual that is for sure, Vincent Geddes has
> expressed an interest in writing one (CC'ing you here vgeddes,
> maybe you can tell us what your availability for that is for this
> comming season).
> 

Hehe, actually I have already updated the old Glade 2 manual and
integrated it the glade3 build system (on my local cvs checkout). I just
haven't found a good time to discuss all of it with tristan yet.

The main issue with glade3 having GNOME documentation is ScrollKeeper.
Apparently scrollkeeper is unmaintained (I can't wait for Spoon ;)). 
It also adds additional complexity and a possible build dependency that
I need to have tristan check out first.

I have added a `--disable-scrollkeeper' to configure.in, for systems
that do not have scrollkeeper installed. When scrollkeeper is disabled,
html documentation will be installed instead. The html docs will be
generated from the docbook sources using `xmlto'. These html docs will
need to be stored alongside the docbook sources in the repository, so
that there is no build dependency on xmlto.

I am pretty new to the documentation side of things, so I a hope I am
making sense here :)

Vincent