gtk-doc toolchain (was: Re: [ITP] gtk-doc (was: Re: [ITP-2] glib-2.4.2-1 (NOT YET)))

["Gerrit P. Haase" <gerrit at familiehaase dot de>]

Hi Marcel,

> Hi Yaakov,

>> The build script needs a couple of changes; the patch is attached.  The
>> rest of us don't have a working gtk-doc installation, so
>> - --disable-gtk-doc is needed.  Note that the resulting glib2-doc tarball
>> is half the size of yours, although the file list is the same AFAICT;
>> not sure why.

> Since I have gtk-doc installed and I'm the maintainer tobe I don't see
> why it is needed to remove the flag.  However, it is not much more work
> as I already have loaded on my plate to provide also a gtk-doc package
> since it is a prerequisite to build gnome packages (at least for the CVS
> versions). 

Since openjade and docbook-dsssl are not available as official cygwin
packages, I post gtk-doc as unofficial package for those who want a
working gtk-doc installation: http://anfaenger.de/cygwin/gtk+/gtk-doc/
An update to gtk-doc-1.2 is following soon.  No setup support for
gtk-doc yet, sorry.  Anyway, there are only some templates and scripts,
dependencies are: a working docbook toolchain (see below) and perl.


You'll need a working openjade installation and docbook-dsssl besides
the cygwin packages libxml2, docbook-xml2 and docbook-xsl.

>From here: http://anfaenger.de/cygwin/docbook, all but tei-xml & tei-xsl
are required (see attached screenshot).

Best bet is to point setup.exe to http://anfaenger.de/cygwin and let
setup do the work.


Later get an update for DSSSL from
http://docbook.sourceforge.net/projects/dsssl/ 

See also the hints at the README: http://anfaenger.de/cygwin/gtk+/gtk-doc/

I use this script to install an initial docbook catalog with which works
ok for me: http://anfaenger.de/cygwin/docbook/buildDocBookCatalog
which is a modified version from this script found here:
http://xmlsoft.org/buildDocBookCatalog 

With this modification, the docbook-xsl path from the cygwin docbook-xsl
package is found which seems to be not 'default' if there is anything
like a default for docbook related things.

It should output s.th. like this:

$ /usr/bin/buildDocBookCatalog
Found DocBook XML 4.1.2 DTD in /usr/share/xml/docbook-4.1.2
Found ISO DocBook entities in /usr/share/xml/docbook-4.1.2/ent
Found DocBook XSLT stylesheets in /usr/share/docbook-xsl



However, I'm not sure if this is all what is needed to get gtk-doc up
and running...


Gerrit
-- 
=^..^=