[gobject-introspection] gitypeinfo: Expand documentation for g_type_info_is_pointer()

[Colin Walters <walters src gnome org>]

commit dd4914d7122ef50b7cd1e0e907d85ce3abbf3a80
Author: Philip Withnall <philip withnall collabora co uk>
Date:   Tue Dec 10 15:59:24 2013 +0000

    gitypeinfo: Expand documentation for g_type_info_is_pointer()
    
    Note that (direction [in]out) parameters are only pointers if the
    underlying type being transferred is a pointer, i.e. if the formal
    parameter is a pointer to a pointer or deeper.
    
    https://bugzilla.gnome.org/show_bug.cgi?id=720201

 girepository/gitypeinfo.c |    5 +++++
 1 files changed, 5 insertions(+), 0 deletions(-)
---
diff --git a/girepository/gitypeinfo.c b/girepository/gitypeinfo.c
index 1bc189c..8b2e3ec 100644
--- a/girepository/gitypeinfo.c
+++ b/girepository/gitypeinfo.c
@@ -58,6 +58,11 @@
  *
  * Obtain if the type is passed as a reference.
  *
+ * Note that the types of %GI_DIRECTION_OUT and %GI_DIRECTION_INOUT parameters
+ * will only be pointers if the underlying type being transferred is a pointer
+ * (i.e. only if the type of the C function’s formal parameter is a pointer to a
+ * pointer).
+ *
  * Returns: %TRUE if it is a pointer
  */
 gboolean