[glib] Teach gtk-doc about G_GNUC_WARN_UNUSED_RESULT

[Matthias Clasen <matthiasc src gnome org>]

commit 40413490374777c0aba8b569f5ad45ffc205cac0
Author: Matthias Clasen <mclasen redhat com>
Date:   Mon Dec 19 07:45:43 2011 -0500

    Teach gtk-doc about G_GNUC_WARN_UNUSED_RESULT

 docs/reference/gio/Makefile.am     |    3 ++-
 docs/reference/glib/Makefile.am    |    2 +-
 docs/reference/gobject/Makefile.am |    2 +-
 3 files changed, 4 insertions(+), 3 deletions(-)
---
diff --git a/docs/reference/gio/Makefile.am b/docs/reference/gio/Makefile.am
index ea65c7f..3c2a4ca 100644
--- a/docs/reference/gio/Makefile.am
+++ b/docs/reference/gio/Makefile.am
@@ -10,7 +10,8 @@ DOC_MODULE=gio
 DOC_MAIN_SGML_FILE=gio-docs.xml
 
 # Extra options to supply to gtkdoc-scan
-SCAN_OPTIONS=--deprecated-guards="G_DISABLE_DEPRECATED"
+SCAN_OPTIONS=--deprecated-guards="G_DISABLE_DEPRECATED" \
+             --ignore-decorators="G_GNUC_WARN_UNUSED_RESULT"
 
 # The directory containing the source code. Relative to $(srcdir)
 DOC_SOURCE_DIR=$(top_srcdir)/gio
diff --git a/docs/reference/glib/Makefile.am b/docs/reference/glib/Makefile.am
index 4dd4ee9..beac383 100644
--- a/docs/reference/glib/Makefile.am
+++ b/docs/reference/glib/Makefile.am
@@ -13,7 +13,7 @@ DOC_MAIN_SGML_FILE=glib-docs.sgml
 DOC_SOURCE_DIR=$(top_srcdir)/glib $(top_srcdir)/gmodule
 
 # Extra options to supply to gtkdoc-scan
-SCAN_OPTIONS=--deprecated-guards="G_DISABLE_DEPRECATED" --ignore-decorators="GLIB_VAR"
+SCAN_OPTIONS=--deprecated-guards="G_DISABLE_DEPRECATED" --ignore-decorators="GLIB_VAR|G_GNUC_WARN_UNUSED_RESULT"
 
 # Extra options to supply to gtkdoc-mkdb
 MKDB_OPTIONS=--sgml-mode --output-format=xml --name-space=g
diff --git a/docs/reference/gobject/Makefile.am b/docs/reference/gobject/Makefile.am
index e108116..3a637b7 100644
--- a/docs/reference/gobject/Makefile.am
+++ b/docs/reference/gobject/Makefile.am
@@ -14,7 +14,7 @@ DOC_SOURCE_DIR=$(top_srcdir)/gobject
 
 # Extra options to supply to gtkdoc-scan
 SCAN_OPTIONS=--deprecated-guards="G_DISABLE_DEPRECATED" \
-	--ignore-decorators=G_GNUC_INTERNAL
+             --ignore-decorators="G_GNUC_INTERNAL|G_GNUC_WARN_UNUSED_RESULT"
 
 # Extra options to supply to gtkdoc-mkdb
 MKDB_OPTIONS=--sgml-mode --output-format=xml --name-space=g