docs: make gtkdoc-mkdb ignore cmph doxygen comment blocks.
authorDieter Verfaillie <dieterv@optionexplicit.be>
Thu, 15 Nov 2012 19:56:21 +0000 (20:56 +0100)
committerDieter Verfaillie <dieterv@optionexplicit.be>
Thu, 15 Nov 2012 22:49:22 +0000 (23:49 +0100)
When building g-i reference documentation, girepository/cmph/*
was being scanned for GTK-Doc comment blocks by gtkdoc-mkdb.
Unfortunately, cmph uses doxygen comment blocks which also
start with /**. This patch prevents gtkdoc-mkdb from complaining.

https://bugzilla.gnome.org/show_bug.cgi?id=688418

docs/reference/Makefile.am

index 19c9aff..c3157be 100644 (file)
@@ -13,7 +13,7 @@ DOC_SOURCE_DIR=$(top_srcdir)/girepository
 SCAN_OPTIONS=
 
 # Extra options to supply to gtkdoc-mkdb
-MKDB_OPTIONS=--sgml-mode --output-format=xml --name-space=g
+MKDB_OPTIONS=--sgml-mode --output-format=xml --name-space=g --ignore-files=cmph
 
 # Used for dependencies
 HFILE_GLOB=$(top_srcdir)/girepository/*.h