docs: make the settings docs work from tarball builds
authorDan Winship <danw@gnome.org>
Wed, 12 Nov 2014 20:50:39 +0000 (15:50 -0500)
committerDan Winship <danw@gnome.org>
Fri, 14 Nov 2014 22:14:18 +0000 (17:14 -0500)
commit16a9fc49ddd59ded7e03cea2deb3d33bde788000
treee5b2e5c84beedf13c1752a9c5096241f1cc2a3f9
parentd1faee92288831517f6f5f7baa057c790be3b022
docs: make the settings docs work from tarball builds

docs/api/settings-spec.xml was accidentally not getting disted,
because gtk-doc.make explicitly removes all DISTCLEANFILES from
distdir. However, it doesn't actually make sense for the settings docs
files to be in DISTCLEANFILES anyway; they were put there rather than
CLEANFILES (IIRC) so that "make clean" in a tarball build wouldn't
delete them and break things. But the right fix is to just make them
only be in CLEANFILES when BUILD_SETTING_DOCS is true, and not ever
get deleted otherwise.

Also adjust the build rules to ensure that the generated docs don't
get rebuilt in tarball builds, since that can cause problems when
building from a read-only source tree, etc.

Meanwhile, in an unrelated but also fatal bug, configure.ac's check
for if the generated docs were already present never got updated for
the cli/src -> clients/cli move, and so even if we had been disting
settings-spec.xml, configure would still think that the tarball didn't
have all of the generated docs in it, so SETTING_DOCS_AVAILABLE would
be set false and none of the generated docs would get used.

https://bugzilla.gnome.org/show_bug.cgi?id=740035
clients/cli/Makefile.am
configure.ac
docs/api/Makefile.am
libnm-util/Makefile.am
man/Makefile.am