From 89b918dfbb11f8ccc3162eb84097c39baccac9cc Mon Sep 17 00:00:00 2001
From: Daiki Ueno <ueno@unixuser.org>
Date: Wed, 31 Oct 2012 12:15:26 +0900
Subject: Add documentation support

Add Valadoc documentation support in the build system.
The template is borrowed from Folks.

https://bugzilla.gnome.org/show_bug.cgi?id=687244
---
 docs/Makefile.am | 99 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 99 insertions(+)
 create mode 100644 docs/Makefile.am

(limited to 'docs')

diff --git a/docs/Makefile.am b/docs/Makefile.am
new file mode 100644
index 0000000..4f4fe6d
--- /dev/null
+++ b/docs/Makefile.am
@@ -0,0 +1,99 @@
+distclean_dirs = \
+	caribou \
+	gtk-doc \
+	$(NULL)
+
+phony_deps = \
+	caribou-doc \
+	caribou-gtk-doc \
+	$(NULL)
+
+upload_docs = \
+	upload-docs-c-caribou \
+	upload-docs-vala-caribou \
+	$(NULL)
+
+cariboudocdir=$(datadir)/devhelp/references/caribou
+caribouimgdir=$(datadir)/devhelp/references/caribou/img
+
+caribougtkdocdir=$(datadir)/gtk-doc/html/caribou
+
+common_doc_files = \
+	*.css \
+	*.png \
+	*.js \
+	index.htm \
+	*.html \
+	$(NULL)
+
+cariboudoc_DATA = \
+	caribou/caribou/caribou.devhelp2 \
+	$(addprefix caribou/caribou/,$(common_doc_files)) \
+	$(NULL)
+
+caribougtkdoc_DATA = gtk-doc/caribou/html/*
+
+caribouimg_DATA = \
+	caribou/caribou/img/*.png \
+	$(NULL)
+
+$(cariboudoc_DATA) $(caribouimg_DATA): caribou-doc
+$(caribougtkdoc_DATA): caribou-gtk-doc
+
+valadoc_flags = \
+	--force \
+	--package-version $(PACKAGE_VERSION) \
+	--no-protected \
+	$(NULL)
+
+# caribou documentation
+caribou_doc_files_blacklist = \
+	$(NULL)
+# this expands the list of files, so we can filter out elements
+caribou_doc_files_all = \
+	$(wildcard $(top_srcdir)/libcaribou/*.vala) \
+	$(NULL)
+# FIXME: sort the files manually to work around the native doclet portion of
+# bgo#662784
+caribou_doc_files = \
+	$(sort \
+	$(filter-out $(caribou_doc_files_blacklist),$(caribou_doc_files_all)))
+caribou_doc_deps = \
+	x11 \
+	xtst \
+	gdk-3.0 \
+	gio-2.0 \
+	gee-1.0 \
+	libxklavier \
+	external-libs \
+	gdk-x11-3.0 \
+	libxml-2.0 \
+	$(NULL)
+valadoc_flags_caribou = \
+	$(valadoc_flags) \
+	-X $(top_srcdir)/libcaribou/caribou.h \
+	$(addprefix --pkg=,$(caribou_doc_deps)) \
+	--vapidir=$(top_srcdir)/libcaribou \
+	$(caribou_doc_files) \
+	$(NULL)
+
+caribou-doc: $(caribou_doc_files)
+	$(AM_V_GEN)$(VALADOC) \
+		-o caribou/ \
+		--doclet=devhelp \
+		$(valadoc_flags_caribou) \
+		$(NULL)
+
+caribou-gtk-doc: $(caribou_doc_files)
+	$(AM_V_GEN)$(VALADOC) \
+		-X -l -X $(top_builddir)/libcaribou/.libs/libcaribou.so \
+		-o gtk-doc/caribou \
+		--doclet=gtkdoc \
+		$(valadoc_flags_caribou) \
+		$(NULL)
+
+.PHONY: $(phony_deps)
+
+distclean-local: distclean-docs
+distclean-docs:
+	rm -rf $(distclean_dirs)
-- 
cgit v1.2.1