summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMurray Cumming <murrayc@murrayc.com>2012-10-12 11:36:38 +0200
committerMurray Cumming <murrayc@murrayc.com>2012-10-12 11:36:38 +0200
commit702e91aa2091f213b37cd07a36c3f6f62990cab3 (patch)
tree84126987fde61d164c895e147907074ff98c817c
parent426d7418fa7395ea3cf0e5b94cb8d834a11bcc9a (diff)
downloadrygel-702e91aa2091f213b37cd07a36c3f6f62990cab3.tar.gz
docs: Generalize the docs build more.
But the librygel-renderer-gst docs are still not correct.
-rw-r--r--doc/reference/doc-build.am24
-rw-r--r--doc/reference/librygel-core/Makefile.am13
-rw-r--r--doc/reference/librygel-renderer-gst/Makefile.am22
-rw-r--r--doc/reference/librygel-renderer/Makefile.am12
-rw-r--r--doc/reference/librygel-server/Makefile.am19
-rw-r--r--src/librygel-renderer-gst/filelist.am2
-rw-r--r--src/librygel-server/filelist.am2
7 files changed, 42 insertions, 52 deletions
diff --git a/doc/reference/doc-build.am b/doc/reference/doc-build.am
index 3d2a5683..c5de6051 100644
--- a/doc/reference/doc-build.am
+++ b/doc/reference/doc-build.am
@@ -1,11 +1,23 @@
# Other Makefile.am files should set:
# VALA_SOURCE_FILES, VALA_SOURCE_FILES_WITH_PATHS,
-# VALADOC_FLAGS, RYGEL_DOCBUILD_MODULE
+# RYGEL_DOCBUILD_VALADOC_FLAGS, RYGEL_DOCBUILD_MODULE
# and RYGEL_DOCBUILD_EXTRA_GTKDOC_OPTIONS
# and the include this .am file.
if ENABLE_VALADOC
+VALADOC_FLAGS = --force \
+ --vapidir $(top_srcdir)/src/lib$(RYGEL_DOCBUILD_MODULE) \
+ $(RYGEL_DOCBUILD_VALADOC_FLAGS) \
+ --target-glib=2.32 \
+ --vapidir=$(rygeldir) \
+ --pkg rygel-build-config \
+ -b $(top_srcdir)/src/lib$(RYGEL_DOCBUILD_MODULE) \
+ --package-name lib$(RYGEL_DOCBUILD_MODULE) \
+ --package-version 2.0 \
+ $(VALA_SOURCE_FILES_WITH_PATHS)
+
+
valadoc-gen: $(VALA_SOURCE_FILES_WITH_PATHS)
$(AM_V_GEN)$(VALADOC) \
-o valadoc \
@@ -20,11 +32,21 @@ gtkdoc-gen: $(VALA_SOURCE_FILES_WITH_PATHS) $(RYGEL_GTKDOC_DOCS_XML)
@rm -rf gtkdoc/html
$(AM_V_GEN)$(VALADOC) \
-X $(top_srcdir)/src/lib$(RYGEL_DOCBUILD_MODULE)/$(RYGEL_DOCBUILD_MODULE).h \
+ $(RYGEL_DOCBUILD_EXTRA_GTKDOC_OPTIONS) \
-X -l -X $(top_builddir)/src/lib$(RYGEL_DOCBUILD_MODULE)/.libs/lib$(RYGEL_DOCBUILD_MODULE)-2.0.so \
-o gtkdoc \
--doclet gtkdoc \
$(VALADOC_FLAGS)
+debugecho:
+ echo $(AM_V_GEN)$(VALADOC) \
+ -X $(top_srcdir)/src/lib$(RYGEL_DOCBUILD_MODULE)/$(RYGEL_DOCBUILD_MODULE).h \
+ $(RYGEL_DOCBUILD_EXTRA_GTKDOC_OPTIONS) \
+ -X -l -X $(top_builddir)/src/lib$(RYGEL_DOCBUILD_MODULE)/.libs/lib$(RYGEL_DOCBUILD_MODULE)-2.0.so \
+ -o gtkdoc \
+ --doclet gtkdoc \
+ $(VALADOC_FLAGS)
+
clean-local:
rm -rf valadoc gtkdoc/html
rm -f gtkdoc/html.stamp
diff --git a/doc/reference/librygel-core/Makefile.am b/doc/reference/librygel-core/Makefile.am
index d61279fa..eeda5d41 100644
--- a/doc/reference/librygel-core/Makefile.am
+++ b/doc/reference/librygel-core/Makefile.am
@@ -10,18 +10,9 @@ VALA_SOURCE_FILES = $(LIBRYGEL_CORE_VAPI_SOURCE_FILES) \
VALA_SOURCE_FILES_WITH_PATHS = $(addprefix $(top_srcdir)/src/librygel-core/, $(VALA_SOURCE_FILES))
-VALADOC_FLAGS = --force \
- --vapidir $(top_srcdir)/src/librygel-core \
+RYGEL_DOCBUILD_VALADOC_FLAGS = \
$(RYGEL_COMMON_VALAFLAGS_PKG) \
- $(LIBRYGEL_CORE_VALAFLAGS_PKG) \
- --pkg gio-2.0 \
- --target-glib=2.32 \
- --vapidir=$(rygeldir) \
- --pkg rygel-build-config \
- -b $(top_srcdir)/src/librygel-core \
- --package-name librygel-core \
- --package-version 2.0 \
- $(VALA_SOURCE_FILES_WITH_PATHS)
+ $(LIBRYGEL_CORE_VALAFLAGS_PKG)
RYGEL_DOCBUILD_MODULE = rygel-core
RYGEL_DOCBUILD_EXTRA_GTKDOC_OPTIONS =
diff --git a/doc/reference/librygel-renderer-gst/Makefile.am b/doc/reference/librygel-renderer-gst/Makefile.am
index ca6db931..772bc1ad 100644
--- a/doc/reference/librygel-renderer-gst/Makefile.am
+++ b/doc/reference/librygel-renderer-gst/Makefile.am
@@ -3,7 +3,7 @@ if ENABLE_VALADOC
include $(top_srcdir)/common.am
include $(top_srcdir)/src/librygel-renderer-gst/filelist.am
-# Note that LIBRYGEL_RENDERER_NONVAPI_SOURCE_FILES all (should) use the internal keyword
+# Note that LIBRYGEL_RENDERER_GST_NONVAPI_SOURCE_FILES all (should) use the internal keyword
# so they are not shown as part of the public API.
VALA_SOURCE_FILES = $(LIBRYGEL_RENDERER_GST_VAPI_SOURCE_FILES) \
$(LIBRYGEL_RENDERER_GST_NONVAPI_SOURCE_FILES)
@@ -15,24 +15,18 @@ VALA_SOURCE_FILES_WITH_PATHS = $(addprefix $(top_srcdir)/src/librygel-renderer-g
# TODO: The need for rygel-build-config here reminds us that we shouldn't need that in librygel-renderer-gst either.
# TODO: Why is gstreamer-pbutils-0.10 needed here, but not needed in librygel-renderer-gst/Makefile.am?
-VALADOC_FLAGS = --force \
+RYGEL_DOCBUILD_VALADOC_FLAGS = \
--vapidir $(top_srcdir)/src/librygel-core \
- --pkg rygel-core-2.0 --pkg rygel-renderer-2.0 \
- --vapidir $(top_srcdir)/src/librygel-renderer-gst \
+ --pkg rygel-core-2.0 \
--vapidir $(top_srcdir)/src/librygel-renderer \
- $(RYGEL_COMMON_VALAFLAGS_PKG) \
- $(LIBRYGEL_RENDERER_VALAFLAGS_PKG) \
+ --pkg rygel-renderer-2.0 \
--pkg gstreamer-pbutils-0.10 \
- --target-glib=2.32 \
- --vapidir=$(rygeldir) \
- --pkg rygel-build-config \
- -b $(top_srcdir)/src/librygel-renderer-gst \
- --package-name librygel-renderer-gst \
- --package-version 2.0 \
- $(VALA_SOURCE_FILES_WITH_PATHS)
+ $(RYGEL_COMMON_VALAFLAGS_PKG) \
+ $(LIBRYGEL_RENDERER_GST_VALAFLAGS_PKG)
RYGEL_DOCBUILD_MODULE = rygel-renderer-gst
-RYGEL_DOCBUILD_EXTRA_GTKDOC_OPTIONS = -X -l -X $(top_builddir)/src/librygel-core/.libs/librygel-core-2.0.so
+RYGEL_DOCBUILD_EXTRA_GTKDOC_OPTIONS = -X -l -X $(top_builddir)/src/librygel-core/.libs/librygel-core-2.0.so \
+ -X -l -X $(top_builddir)/src/librygel-renderer/.libs/librygel-renderer-2.0.so
endif
include $(top_srcdir)/doc/reference/doc-build.am
diff --git a/doc/reference/librygel-renderer/Makefile.am b/doc/reference/librygel-renderer/Makefile.am
index 7d24dd12..dc073c57 100644
--- a/doc/reference/librygel-renderer/Makefile.am
+++ b/doc/reference/librygel-renderer/Makefile.am
@@ -12,19 +12,11 @@ VALA_SOURCE_FILES_WITH_PATHS = $(addprefix $(top_srcdir)/src/librygel-renderer/,
# TODO: The need for rygel-build-config here reminds us that we shouldn't need that in librygel-renderer either.
# TODO: Why is gstreamer-pbutils-0.10 needed here, but not needed in librygel-renderer/Makefile.am?
-VALADOC_FLAGS = --force \
+RYGEL_DOCBUILD_VALADOC_FLAGS = \
--vapidir $(top_srcdir)/src/librygel-core \
--pkg rygel-core-2.0 \
- --vapidir $(top_srcdir)/src/librygel-renderer \
$(RYGEL_COMMON_VALAFLAGS_PKG) \
- $(LIBRYGEL_RENDERER_VALAFLAGS_PKG) \
- --target-glib=2.32 \
- --vapidir=$(rygeldir) \
- --pkg rygel-build-config \
- -b $(top_srcdir)/src/librygel-renderer \
- --package-name librygel-renderer \
- --package-version 2.0 \
- $(VALA_SOURCE_FILES_WITH_PATHS)
+ $(LIBRYGEL_RENDERER_VALAFLAGS_PKG)
RYGEL_DOCBUILD_MODULE = rygel-renderer
RYGEL_DOCBUILD_EXTRA_GTKDOC_OPTIONS = -X -l -X $(top_builddir)/src/librygel-core/.libs/librygel-core-2.0.so
diff --git a/doc/reference/librygel-server/Makefile.am b/doc/reference/librygel-server/Makefile.am
index c278d191..db8b17e3 100644
--- a/doc/reference/librygel-server/Makefile.am
+++ b/doc/reference/librygel-server/Makefile.am
@@ -14,20 +14,11 @@ VALA_SOURCE_FILES_WITH_PATHS = $(addprefix $(top_srcdir)/src/librygel-server/, $
# echo $(VALA_SOURCE_FILES_WITH_PATHS);
# TODO: The need for rygel-build-config here reminds us that we shouldn't need that in librygel-server either.
-# TODO: Why is gstreamer-pbutils-0.10 needed here, but not needed in librygel-server/Makefile.am?
-VALADOC_FLAGS = --force \
- --vapidir $(top_srcdir)/src/librygel-core \
- --pkg rygel-core-2.0 \
- --vapidir $(top_srcdir)/src/librygel-server \
- $(RYGEL_COMMON_VALAFLAGS_PKG) \
- $(LIBRYGEL_SERVER_VALAFLAGS_PKG) \
- --target-glib=2.32 \
- --vapidir=$(rygeldir) \
- --pkg rygel-build-config \
- -b $(top_srcdir)/src/librygel-server \
- --package-name librygel-server \
- --package-version 2.0 \
- $(VALA_SOURCE_FILES_WITH_PATHS)
+RYGEL_DOCBUILD_VALADOC_FLAGS = \
+ --vapidir $(top_srcdir)/src/librygel-core \
+ --pkg rygel-core-2.0 \
+ $(RYGEL_COMMON_VALAFLAGS_PKG) \
+ $(LIBRYGEL_SERVER_VALAFLAGS_PKG)
RYGEL_DOCBUILD_MODULE = rygel-server
diff --git a/src/librygel-renderer-gst/filelist.am b/src/librygel-renderer-gst/filelist.am
index c6fcc9d0..c21215d6 100644
--- a/src/librygel-renderer-gst/filelist.am
+++ b/src/librygel-renderer-gst/filelist.am
@@ -3,6 +3,6 @@ LIBRYGEL_RENDERER_GST_VAPI_SOURCE_FILES = \
rygel-playbin-plugin.vala \
rygel-playbin-renderer.vala
-LIBRYGEL_RENDERER_GST_NONVAPI_SOURCE_FILES =
+LIBRYGEL_RENDERER_GST_NONVAPI_SOURCE_FILES =
LIBRYGEL_RENDERER_GST_VALAFLAGS_PKG = --pkg gstreamer-0.10
diff --git a/src/librygel-server/filelist.am b/src/librygel-server/filelist.am
index a389709f..3db81d6f 100644
--- a/src/librygel-server/filelist.am
+++ b/src/librygel-server/filelist.am
@@ -32,7 +32,7 @@ LIBRYGEL_SERVER_NONVAPI_SOURCE_FILES = \
rygel-client-hacks.vala \
rygel-content-directory.vala \
rygel-dbus-thumbnailer.vala \
- rygel-engine-loader.vala \
+ rygel-engine-loader.vala \
rygel-http-byte-seek.vala \
rygel-http-get-handler.vala \
rygel-http-get.vala \