Subject: Re: Gnome libraries and documentation
To: None <tech-pkg@netbsd.org>
From: James K. Lowden <jklowden@schemamania.org>
List: tech-pkg
Date: 10/22/2002 20:00:49
On Tue, 22 Oct 2002 00:56:25 +0200, Julio Merino <jmmv@menta.net> wrote:
> 
> Generating this documentation requires gtk-doc, which in turn depends
> on jade, dsssl, docbook dtd's, iso entities, etc etc (this is true for
> most of gnome2 packages/libraries)... Is it worth the load to generate
> and install this api documentation? It can always be found on gnome's
> website (and will usually be more up to date than the one included in
> packages).

It's worth it IMO.  As the website's docs are be updated, they fall out of
synch with the installed package's features.  Also, not everyone has
broadband.  

I am confused in a small way about what meta-pkgs/netbsd-doc installs. 
Perhaps you know or will stumble on the answer?  

When I generate html from sgml/docbook, My notes, warnings, tips, and
things have the form:

	Note: blah blah

All text.  When my cool Linux dude friends do the same thing, they get the
little finger, yield sign, whatnot.  Which I'm embarrassed to say I like
better and would like to generate, too.  I can't figure out what knob to
turn, though.  

Regards, 

--jkl