make dist and gtk-doc

[Rodolphe Ortalo]

Le jeudi 22 novembre 2007 à 21:04 +0100, Michael 'Mickey' Lauer a
écrit :
> Rodolphe Ortalo wrote:
> > when doing a "make dist" (e.g. in libmokojournal2, or libmokoui2), it
> > complains about gtk-doc not enabled. I am on Ubuntu with gtk-doc-tools
> > installed of course, so I don't really understand the issue.
> 
> The documentation is disabled by default. You should configure the
> tree with:
> 
> ./configure --enable-gtk-doc

Thanks.

> (recursive make) Got some current patches? ;)

Ah, btw, maybe you noticed I posted this to another mailing list
yesterday:

I just published a patch that provides a recursive auto{make,conf}
system for the OM2007.2 subtree of OpenMoko source tree.
 I do *not* think that the patch is ready for iinclusion yet (primarily
because it does not build everything yet), but I'd like it to receive
wider testing now if possible. Hence this message.

The patch is available at an URL shown below. It should apply to SVN
version now. It builds the main libraries, a few applications (dialer2
calculator2) and several panel-plugins; for running on the host as a
conventional GNOME program.
 You need to have the needed dependencies available, like
matchbox-panel2, etc. (and to setup PKG_CONFIG_PATH before configuring).
There is a funny script that runs autogen.sh scripts in the whole tree.
 I am going to extend coverage to other programs.

Enjoy, and of course I welcome your feedback.

Rodolphe

Usage example on a fresh source tree:

wget http://rodolphe.ortalo.free.fr/patch-recconf-2007-11-25.patch
svn co http://svn.openmoko.org/trunk/src/target/OM-2007.2
cd OM-2007.2
patch -p0 < ./patch-recconf-2007-11-25.patch 
. ./autogen-recursive.sh 
mkdir build && cd build
export PKG_CONFIG_PATH=/where/dependencies/are/lib/pkgconfig
../configure --enable-gtk-doc --enable-maintainer-mode
--prefix=/some/place/for/test/install --config-cache
nice make
nice make (sgml thingy error simply resolves by re-running)
nice make distcheck (re-running autoreconf may be needed sometimes)

Note in the example above that I usually build in a separate build
directory. make and make distcheck should run, but maybe not at first
shot. If you have make or make distcheck errors (especially if they are
related to generated scripts like depcomp or makedirs), try simply to
re-run make or to re-run "autoreconf" either in the failed program
source tree or at the OM2007.2 root. Usually it solves these issues
permanently (this remains mysterious to me... ;-)