diff options
author | Daiki Ueno <ueno@unixuser.org> | 2012-10-31 12:15:26 +0900 |
---|---|---|
committer | Daiki Ueno <ueno@unixuser.org> | 2012-12-30 14:16:07 +0900 |
commit | 89b918dfbb11f8ccc3162eb84097c39baccac9cc (patch) | |
tree | 2e4ff4d48291bab92568b1d3876ab5daf956da0f /docs | |
parent | 73e45d3d4e848168b2c78dc8953167f222dfc768 (diff) | |
download | caribou-89b918dfbb11f8ccc3162eb84097c39baccac9cc.tar.gz |
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
Diffstat (limited to 'docs')
-rw-r--r-- | docs/Makefile.am | 99 |
1 files changed, 99 insertions, 0 deletions
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) |