summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorPhilip Withnall <philip.withnall@collabora.co.uk>2010-09-13 16:12:00 +0100
committerTravis Reitter <travis.reitter@collabora.co.uk>2010-09-20 16:29:24 -0700
commit531a4e3e6f0064214a854625e790107ad7e57236 (patch)
tree1057a668f7c9e08a822cdb115a425a1a71f39c83 /docs
parent7debb14bfbb22b5865c1d60804c81777151e3640 (diff)
Split the documentation into folks and folks-telepathy packages
This means that each documentation package is only scanning files from one directory, opening us up to the possibility of adding gtk-doc support. Helps: bgo#629526
Diffstat (limited to 'docs')
-rw-r--r--docs/Makefile.am75
1 files changed, 50 insertions, 25 deletions
diff --git a/docs/Makefile.am b/docs/Makefile.am
index 03782cf..83b47e2 100644
--- a/docs/Makefile.am
+++ b/docs/Makefile.am
@@ -1,51 +1,76 @@
-docdir=$(datadir)/devhelp/references/folks-@FOLKS_MAJOR_MINOR_VERSION@
-innerdocdir=$(datadir)/devhelp/references/folks-@FOLKS_MAJOR_MINOR_VERSION@/folks-@FOLKS_MAJOR_MINOR_VERSION@
-imgdir=$(datadir)/devhelp/references/folks-@FOLKS_MAJOR_MINOR_VERSION@/folks-@FOLKS_MAJOR_MINOR_VERSION@/img
+folksdocdir=$(datadir)/devhelp/references/folks-@FOLKS_MAJOR_MINOR_VERSION@
+folksinnerdocdir=$(datadir)/devhelp/references/folks-@FOLKS_MAJOR_MINOR_VERSION@/folks-@FOLKS_MAJOR_MINOR_VERSION@
+folksimgdir=$(datadir)/devhelp/references/folks-@FOLKS_MAJOR_MINOR_VERSION@/folks-@FOLKS_MAJOR_MINOR_VERSION@/img
+folkstpdocdir=$(datadir)/devhelp/references/folks-telepathy-@FOLKS_MAJOR_MINOR_VERSION@
+folkstpinnerdocdir=$(datadir)/devhelp/references/folks-telepathy-@FOLKS_MAJOR_MINOR_VERSION@/folks-telepathy-@FOLKS_MAJOR_MINOR_VERSION@
+folkstpimgdir=$(datadir)/devhelp/references/folks-telepathy-@FOLKS_MAJOR_MINOR_VERSION@/folks-telepathy-@FOLKS_MAJOR_MINOR_VERSION@/img
-doc_data = \
+folksdoc_data = \
folks-@FOLKS_MAJOR_MINOR_VERSION@/*.css \
folks-@FOLKS_MAJOR_MINOR_VERSION@/*.png \
$(NULL)
+folkstpdoc_data = \
+ folks-telepathy-@FOLKS_MAJOR_MINOR_VERSION@/*.css \
+ folks-telepathy-@FOLKS_MAJOR_MINOR_VERSION@/*.png \
+ $(NULL)
-doc_DATA = \
+folksdoc_DATA = \
folks-@FOLKS_MAJOR_MINOR_VERSION@/index.html \
- $(doc_data) \
+ $(folksdoc_data) \
+ $(NULL)
+folkstpdoc_DATA = \
+ folks-telepathy-@FOLKS_MAJOR_MINOR_VERSION@/index.html \
+ $(folkstpdoc_data) \
$(NULL)
-innerdoc_DATA = \
+folksinnerdoc_DATA = \
folks-@FOLKS_MAJOR_MINOR_VERSION@/folks-@FOLKS_MAJOR_MINOR_VERSION@/index.htm \
folks-@FOLKS_MAJOR_MINOR_VERSION@/folks-@FOLKS_MAJOR_MINOR_VERSION@/*.html \
$(NULL)
+folkstpinnerdoc_DATA = \
+ folks-telepathy-@FOLKS_MAJOR_MINOR_VERSION@/folks-telepathy-@FOLKS_MAJOR_MINOR_VERSION@/index.htm \
+ folks-telepathy-@FOLKS_MAJOR_MINOR_VERSION@/folks-telepathy-@FOLKS_MAJOR_MINOR_VERSION@/*.html \
+ $(NULL)
-img_DATA = \
+folksimg_DATA = \
folks-@FOLKS_MAJOR_MINOR_VERSION@/folks-@FOLKS_MAJOR_MINOR_VERSION@/img/*.png \
$(NULL)
+folkstpimg_DATA = \
+ folks-telepathy-@FOLKS_MAJOR_MINOR_VERSION@/folks-telepathy-@FOLKS_MAJOR_MINOR_VERSION@/img/*.png \
+ $(NULL)
-$(doc_data) $(innerdoc_DATA) $(img_DATA): folks-@FOLKS_MAJOR_MINOR_VERSION@/index.html
+$(folksdoc_data) $(folksinnerdoc_DATA) $(folksimg_DATA): folks-@FOLKS_MAJOR_MINOR_VERSION@/index.html
+$(folkstpdoc_data) $(folkstpinnerdoc_DATA) $(folkstpimg_DATA): folks-telepathy-@FOLKS_MAJOR_MINOR_VERSION@/index.html
-VALAFLAGS = \
- --vapidir=$(top_srcdir)/folks \
- --vapidir=$(top_srcdir)/backends/telepathy \
- --vapidir=$(top_srcdir)/backends/telepathy/lib
+# folks documentation
+folks_doc_files = $(top_srcdir)/folks/*.vala
-# The Vala files which will have documentation extracted from them
-_doc_files = \
- $(top_srcdir)/folks/*.vala \
- $(top_srcdir)/backends/telepathy/*.vala \
- $(top_srcdir)/backends/telepathy/lib/*.vala \
- $(top_srcdir)/backends/key-file/*.vala
-doc_files = $(filter-out %-backend-factory.vala,$(wildcard $(_doc_files)))
+folks-@FOLKS_MAJOR_MINOR_VERSION@/index.html: $(folks_doc_files)
+ $(AM_V_GEN)$(VALADOC) -o folks-@FOLKS_MAJOR_MINOR_VERSION@/ --force -b $(top_srcdir)/folks \
+ --pkg=gee-1.0 --pkg=gio-2.0 --pkg=gmodule-2.0 --pkg=build-conf \
+ --vapidir=$(top_srcdir)/folks $(folks_doc_files)
+
+# folks-telepathy documentation
+folks_telepathy_doc_files = $(top_srcdir)/backends/telepathy/lib/*.vala
-folks-@FOLKS_MAJOR_MINOR_VERSION@/index.html: $(doc_files)
- $(AM_V_GEN)$(VALADOC) -o folks-@FOLKS_MAJOR_MINOR_VERSION@/ --force -b $(top_srcdir) \
+folks-telepathy-@FOLKS_MAJOR_MINOR_VERSION@/index.html: $(folks_telepathy_doc_files)
+ $(AM_V_GEN)$(VALADOC) -o folks-telepathy-@FOLKS_MAJOR_MINOR_VERSION@/ \
+ --force -b $(top_srcdir)/backends/telepathy/lib \
--pkg=gee-1.0 --pkg=gio-2.0 --pkg=gmodule-2.0 --pkg=build-conf \
--pkg=dbus-glib-1 --pkg=telepathy-glib --pkg=tp-lowlevel \
- $(VALAFLAGS) $(doc_files)
+ --pkg=folks \
+ --vapidir=$(top_srcdir)/folks \
+ --vapidir=$(top_srcdir)/backends/telepathy/lib \
+ $(folks_telepathy_doc_files)
distclean-local: distclean-docs
distclean-docs:
- rm -rf folks-@FOLKS_MAJOR_MINOR_VERSION@
+ rm -rf folks-@FOLKS_MAJOR_MINOR_VERSION@ && \
+ rm -rf folks-telepathy-@FOLKS_MAJOR_MINOR_VERSION@
-GITIGNOREFILES = folks-@FOLKS_MAJOR_MINOR_VERSION@/
+GITIGNOREFILES = \
+ folks-@FOLKS_MAJOR_MINOR_VERSION@/ \
+ folks-telepathy-@FOLKS_MAJOR_MINOR_VERSION@/ \
+ $(NULL)
-include $(top_srcdir)/git.mk