Re: [libvirt] [PATCHv2 2/2] build: fix VPATH build of docs
On Wed, Apr 28, 2010 at 07:37:02PM -0600, Eric Blake wrote:
The rule of thumb for generated files:
If they are distributed, they should be generated in $(srcdir);
otherwise, they should be built by the end user in $(builddir).
Since our .xml docs are built with python, and we want them
available even to end users that don't build with python, we
want them distributed; hence, they must live in $(srcdir).
Actually there is a couple more points, as I wanted those
xml to be part of the docs, if someone installs the package (with
or without python) and online. Now the web space is rebuilt so they
are not in git anymore but it used to be in the SCM for this.
Having the libvirt-api.xml installed as part of the package
documentation is still IMHO a good justification to have it part of
the dist tarball too.
Daniel
--
Daniel Veillard | libxml Gnome XML XSLT toolkit http://xmlsoft.org/
daniel(a)veillard.com | Rpmfind RPM search engine http://rpmfind.net/
http://veillard.com/ | virtualization library http://libvirt.org/