summaryrefslogtreecommitdiff
path: root/doc/reference
diff options
context:
space:
mode:
authorMurray Cumming <murrayc@murrayc.com>2012-12-11 10:38:04 +0100
committerMurray Cumming <murrayc@murrayc.com>2012-12-11 10:38:04 +0100
commitd8e9174ebadd0393d464244a5e2cea80f3609538 (patch)
tree75dc98d7633943f64150f667b2b59ac81eb14fd7 /doc/reference
parentcd891af0daf9a0eddf22f8b2d9252444ea681b10 (diff)
downloadrygel-d8e9174ebadd0393d464244a5e2cea80f3609538.tar.gz
Add a comment about the docs build for the future.
Diffstat (limited to 'doc/reference')
-rw-r--r--doc/reference/doc-build.am6
1 files changed, 6 insertions, 0 deletions
diff --git a/doc/reference/doc-build.am b/doc/reference/doc-build.am
index 85defa28..1dac20fb 100644
--- a/doc/reference/doc-build.am
+++ b/doc/reference/doc-build.am
@@ -26,6 +26,12 @@ valadoc-gen: $(VALA_SOURCE_FILES_WITH_PATHS)
# Avoid regeneration of the html if none of its dependencies have changed:
gtkdoc/html/index.html: gtkdoc-gen
+# The use of extra .xml DocBook files, just for the gtk-doc output
+# (in RYGEL_GTKDOC_DOCS_XML_EXTRA),
+# will be unnecessary when valadoc has some way to add extra pages of
+# documentation. See https://bugzilla.gnome.org/show_bug.cgi?id=680798
+# The whole gtk-doc build might then get much simpler like it once was:
+# http://git.gnome.org/browse/rygel/commit/doc/reference/Makefile.am?id=80b68029d42fec3fbbb9c0dbdda99c065bddcb0f
RYGEL_GTKDOC_DOCS_XML = \
$(top_srcdir)/doc/reference/lib$(RYGEL_DOCBUILD_MODULE)/gtkdoc/lib$(RYGEL_DOCBUILD_MODULE)-docs.xml \
$(top_srcdir)/doc/reference/lib$(RYGEL_DOCBUILD_MODULE)/gtkdoc/overview.xml $(RYGEL_GTKDOC_DOCS_XML_EXTRA)