[rygel] doc,librenderer: Generate docs

[Jens Georg <jensgeorg src gnome org>]

commit 1c893b9cc236992d1d6bc87727e53feef16e0c56
Author: Murray Cumming <murrayc murrayc com>
Date:   Thu Jun 28 09:54:44 2012 +0200

    doc,librenderer: Generate docs

 configure.ac                                |    1 +
 doc/reference/Makefile.am                   |    2 +-
 doc/reference/librygel-renderer/Makefile.am |   73 +++++++++++++++++++++++++++
 src/librygel-renderer/Makefile.am           |    6 +-
 src/librygel-renderer/filelist.am           |    8 +++
 5 files changed, 86 insertions(+), 4 deletions(-)
---
diff --git a/configure.ac b/configure.ac
index 8e9ec73..b6c1da3 100644
--- a/configure.ac
+++ b/configure.ac
@@ -243,6 +243,7 @@ data/rygel-preferences.desktop.in
 doc/Makefile
 doc/reference/Makefile
 doc/reference/librygel-core/Makefile
+doc/reference/librygel-renderer/Makefile
 po/Makefile.in
 rygel-core-1.0.pc
 rygel-renderer-1.0.pc
diff --git a/doc/reference/Makefile.am b/doc/reference/Makefile.am
index 158267a..fc2a7f7 100644
--- a/doc/reference/Makefile.am
+++ b/doc/reference/Makefile.am
@@ -1 +1 @@
-SUBDIRS = librygel-core
+SUBDIRS = librygel-core librygel-renderer
diff --git a/doc/reference/librygel-renderer/Makefile.am b/doc/reference/librygel-renderer/Makefile.am
new file mode 100644
index 0000000..48fe1dd
--- /dev/null
+++ b/doc/reference/librygel-renderer/Makefile.am
@@ -0,0 +1,73 @@
+if ENABLE_VALADOC
+
+include $(top_srcdir)/common.am
+include $(top_srcdir)/src/librygel-renderer/filelist.am
+
+# Note that LIBRYGEL_RENDERER_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_VAPI_SOURCE_FILES)
+# There are no LIBRYGEL_RENDERER_NONVAPI_SOURCE_FILES
+
+VALA_SOURCE_FILES_WITH_PATHS = $(addprefix $(top_srcdir)/src/librygel-renderer/, $(VALA_SOURCE_FILES))
+
+#debug:
+#	echo $(VALA_SOURCE_FILES_WITH_PATHS);
+
+# 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 \
+		--vapidir $(top_srcdir)/src/librygel-core \
+		--pkg rygel-core-1.0 \
+		--vapidir $(top_srcdir)/src/librygel-renderer \
+		$(RYGEL_COMMON_VALAFLAGS_PKG) \
+		$(LIBRYGEL_RENDERER_VALAFLAGS_PKG) \
+	        --pkg gstreamer-pbutils-0.10 \
+	        --target-glib=2.32 \
+	        --vapidir=$(rygeldir) \
+	        --pkg rygel-build-config \
+		-b $(top_srcdir)/src/librygel-renderer \
+		--package-name librygel-renderer \
+		--package-version 1.0 \
+		$(VALA_SOURCE_FILES_WITH_PATHS)
+
+valadoc:
+	$(VALADOC) \
+		-o valadoc \
+		$(VALADOC_FLAGS) \
+		$(NULL)
+
+devhelp:
+	$(VALADOC) \
+		-o devhelp \
+		--doclet devhelp \
+		$(VALADOC_FLAGS) \
+		$(NULL)
+
+gtkdoc:
+	$(VALADOC) \
+		-X $(top_builddir)/src/librygel-renderer/rygel-renderer.h \
+		-X -l -X $(top_builddir)/src/librygel-renderer/.libs/librygel-renderer-1.0.so \
+		-o gtkdoc \
+		--doclet gtkdoc \
+		$(VALADOC_FLAGS) \
+		$(NULL)
+
+clean-local:
+	rm -rf valadoc devhelp gtkdoc
+
+uninstall-hook:
+	rm -rf $(DESTDIR)$(datadir)/devhelp/books/librygel-renderer
+	rm -rf $(DESTDIR)$(datadir)/gtk-doc/html/librygel-renderer
+
+install-data-hook: devhelp gtkdoc
+	$(MKDIR_P) $(DESTDIR)$(datadir)/devhelp/books/librygel-renderer/img
+	$(INSTALL_DATA) -t $(DESTDIR)$(datadir)/devhelp/books/librygel-renderer devhelp/librygel-renderer/*.*
+	$(INSTALL_DATA) -t $(DESTDIR)$(datadir)/devhelp/books/librygel-renderer/img devhelp/librygel-renderer/img/*
+	$(MKDIR_P) $(DESTDIR)$(datadir)/gtk-doc/html/librygel-renderer
+	cp -R gtkdoc/html $(DESTDIR)$(datadir)/gtk-doc/html/librygel-renderer
+
+all: valadoc devhelp gtkdoc
+
+EXTRA_DIST = devhelp gtkdoc valadoc
+
+endif
diff --git a/src/librygel-renderer/Makefile.am b/src/librygel-renderer/Makefile.am
index b227d59..0f40593 100644
--- a/src/librygel-renderer/Makefile.am
+++ b/src/librygel-renderer/Makefile.am
@@ -1,13 +1,13 @@
 include ../../common.am
+include $(srcdir)/filelist.am
 
 lib_LTLIBRARIES = librygel-renderer-1.0.la
 
 LIBRYGEL_RENDERER_VERSION=0:0:0
 
 librygel_renderer_1_0_la_SOURCES = \
-	rygel-playbin-player.vala \
-	rygel-playbin-plugin.vala \
-	rygel-playbin-renderer.vala
+	$(LIBRYGEL_RENDERER_VAPI_SOURCE_FILES) \
+	$(LIBRYGEL_RENDERER_NONVAPI_SOURCE_FILES)
 
 librygel_renderer_1_0_la_VALAFLAGS = \
 	-H rygel-renderer.h --library=rygel-renderer-1.0 \
diff --git a/src/librygel-renderer/filelist.am b/src/librygel-renderer/filelist.am
new file mode 100644
index 0000000..470efd9
--- /dev/null
+++ b/src/librygel-renderer/filelist.am
@@ -0,0 +1,8 @@
+LIBRYGEL_RENDERER_VAPI_SOURCE_FILES = \
+	rygel-playbin-player.vala \
+	rygel-playbin-plugin.vala \
+	rygel-playbin-renderer.vala
+
+LIBRYGEL_RENDERER_NONVAPI_SOURCE_FILES =
+
+LIBRYGEL_RENDERER_VALAFLAGS_PKG =