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