libxml2.py and gtk-doc

gtk-doc is failing to build with the following error:

if ! test -d de/; then mkdir de/; fi
if [ -f "C/gtk-doc-manual.xml" ]; then d="../"; else d="/usr/local/src/gnome3/gtk-doc/help/manual/"; fi; \
(cd de/ && \
`which xml2po` -e -p \
"${d}de/de.po" \
"${d}C/gtk-doc-manual.xml" > gtk-doc-manual.xml.tmp && \
cp gtk-doc-manual.xml.tmp gtk-doc-manual.xml && rm -f gtk-doc-manual.xml.tmp)
Traceback (most recent call last):
File "/usr/local/gtk3/bin/xml2po", line 35, in
import libxml2
ImportError: No module named libxml2

OSX 10.5 doesn't provide libxml2.py, and building libxml2 is suppressed in .jhbuildrc in favor of the installed library. I know several workarounds, but I'm trying to make this as simple and automatic as possible for other people to build gnucash. Besides, it must be working for everyone else... so what is screwed up with my python installation?

I'm guessing that something

I'm guessing that something changed in gtk-doc that breaks the disabling of doc building. You might want to file a bug report against gtk-doc about that.

Well... As shown in the

Well...
As shown in the error message, the problem lays in xml2po, which is made from /rhult-gnome-doc-utils-fake-ee6993e33d517ff05f55d78694e5edaa4da0bbd9/xml2po.in

So I don't think that the gtk-doc folks would see it as their problem.

But gtk-doc is not supposed

But gtk-doc is not supposed to build docs if docs are disabled. The gnome-doc fake package is not supposed to work at all, just enable packages to go through configure and disable docs hence the "fake" name...

Interesting. There is no

Interesting. There is no "(en|dis)able-docs" or (en|dis)able-gtk-doc parameter to gtk-doc/configure. Is there some Gnome project requirement that the gtk-doc devs are ignoring?

What the gtk-doc folks changed was to add (on March 15 and 16, respectively) spanish and german translation files. This change causes xml2po to actually get invoked, something that wasn't required before.

Since the xml2po program provided by gtk-doc-utils-fake actually works fine if the libxml2.py module is available, ISTM that the solution is to add a module for

ftp://xmlsoft.org/libxml2/python/libxml2-python-2.6.15.tar.gz

to gtk-osx-bootstrap.modules, and a dependency for it to gnome-doc-utils-fake.

The manuals are usually

The manuals are usually disabled using --disable-scrollkeeper.

Oh, really? Here's what

Oh, really? Here's what gtk-doc/configure --help has to say about that:
"--disable-scrollkeeper do not make updates to the scrollkeeper database"

Interestingly, gtk-doc seems to be the one and only project that uses scrollkeeper as an argument.

No, all projects that use

No, all projects that use gnome-doc-utils has the --disable-scrollkeeper command. Some packages use it to disable the docs completely, some only lets g-d-u disable the scrollkeeper updating.

I have made the gtk-doc build ignore errors in the build as a workaround.