From: Murray Cumming Date: Thu, 28 Jun 2012 07:54:44 +0000 (+0200) Subject: doc,librenderer: Generate docs X-Git-Tag: RYGEL_0_15_1~49 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=1c893b9cc236992d1d6bc87727e53feef16e0c56;p=profile%2Fivi%2Frygel.git doc,librenderer: Generate docs --- 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 =