generating html docs with gnome-doc-utils

[Stefan Kost <ensonic hora-obscura de>]

hi,

I try to re-build html docs for gnome-devel-docs. The project uses
gnome-doc-utils and I also managed to fix the build a bit. I have the latest
gnome-doc-utils (0.9.2) installed.

First question - it adds --with-help-formats=FORMATS option to configure. What
is valid here? --with-help-formats=html,pdf or --with-help-formats="html pdf".

Second question - how to get it to build html. There are xsltproc calls in
gnome-doc-utils.make. But I faild to see how to invoke them.

The makefile has some problems (and there are commet inside the seem to support
my doubts):
> make
Making all in platform-overview
make[1]: Entering directory
`/home/ensonic/projects/gnome-devel-docs/platform-overview'
Makefile:573: warning: overriding commands for target `es/platform-overview.xhtml'
Makefile:559: warning: ignoring old commands for target `es/platform-overview.xhtml'
make[1]: Circular es/platform-overview.xhtml <- es/platform-overview.xhtml
dependency dropped.
if ! test -d es/; then mkdir es/; fi
case "." in /*) sd=".";; *) sd="../.";; esac; \
        if [ -f "C/apx-modules.xhtml" ]; then d="../"; else d="$sd/"; fi; \
        (cd es/ && \
          `which xml2po` -e -p \
            "${d}es/es.po" \
            "${d}C/apx-modules.xhtml" > apx-modules.xhtml.tmp && \
            cp apx-modules.xhtml.tmp apx-modules.xhtml && rm -f
apx-modules.xhtml.tmp)
Error: cannot open file '.././C/apx-modules.xhtml'.
make[1]: *** [es/apx-modules.xhtml] Error 1
make[1]: Leaving directory
`/home/ensonic/projects/gnome-devel-docs/platform-overview'
make: *** [all-recursive] Error 1

Any ideas? If someone shares the wisdom, I promisse to get it into the docs.

Stefan