Vincent Geddes wrote:
>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, Joachim,
As I've said in the past to Vincent, I see no reason to add libgnomeui
dependancies to glade if it be for the mere purpose of a single docs
feature - as specially since we already have a devhelp integration
pipeline that allows us to view docs via devhelp at any time.
There must be something I dont understand - after reading the
recent planet.g.o post about spoon - I dont know why on earth anyone
would want to depend on scrollkeeper at all (not to mention it would
be yet another instance of #ifdef HAVE_SCROLLKEEPER dual builds -
which I am religiously against and will avoid if I can).
Maybe one of you can enlighten me to the meaning of this phrase:
"The main issue with glade3 having GNOME documentation is ScrollKeeper."
Why on earth does "GNOME documentation" need to be tied in to
"ScrollKeeper" ?
What kind of fancy features are available in "GNOME" documentation - and
why cant those features be available outside of "GNOME" ?
Cheers,
-Tristan
_______________________________________________
gnome-doc-list mailing list
[email protected]
http://mail.gnome.org/mailman/listinfo/gnome-doc-list
