xfce4-docs update

[Jannis Pohlmann]

On Thu, 24 Sep 2009 00:16:51 +0200
Mike Massonnet <mmassonnet at gmail.com> wrote:

> I had like to see the projects including sub-modules for the
> documentation not to depend on any extra build configuration. It would
> be really great to have the xfce-docs repo to always generate the
> output in html, etc and just have an additionnal install rule in the
> different projects.

I'm not sure what you mean with extra build configuration. Of course
projects including xfce4-docs as a git submodule will have to add
*something* to their configure scripts and/or makefiles to generate and
install the docs. 

And since we also want documentation people to be able to install
xfce4-docs on its own to test it, the easiest way is to configure and
build it along with the individual projects using AC_CONFIG_SUBDIRS().
This will also pass over the prefix and other build options from the
project to the docs makefiles. I don't think an additional install
rule is that powerful without added hacks.

The project also needs to check for the dependencies required for
building the docs, although I guess that could be handled by xfce4-docs
in its own configure, now that we use AC_CONFIG_SUBDIRS().

BTW, I think we might be able move the crossref python module into
xfce4-docs and sneak it into the python loading path, thus dropping it
as an external dependencies which we have to maintain separately.

  - Jannis
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 197 bytes
Desc: not available
URL: <http://mail.xfce.org/pipermail/xfce4-dev/attachments/20090924/f59b7dd9/attachment.pgp>