jannis at xfce.org
Thu Sep 24 00:32:53 CEST 2009
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.
-------------- next part --------------
A non-text attachment was scrubbed...
Size: 197 bytes
Desc: not available
More information about the Xfce4-dev