[pygobject] cache refactoring: Add comments to callable cache structure

[Simon Feltman <sfeltman src gnome org>]

commit 83208bf495b152e93a28a231d445f43ea827d2eb
Author: Simon Feltman <sfeltman src gnome org>
Date:   Fri Aug 2 15:59:25 2013 -0700

    cache refactoring: Add comments to callable cache structure
    
    Add comments to count fields on _PyGICallableCache.
    
    https://bugzilla.gnome.org/show_bug.cgi?id=640812

 gi/pygi-cache.h |   13 ++++++++++++-
 1 files changed, 12 insertions(+), 1 deletions(-)
---
diff --git a/gi/pygi-cache.h b/gi/pygi-cache.h
index 6e5e0ab..25c6db6 100644
--- a/gi/pygi-cache.h
+++ b/gi/pygi-cache.h
@@ -177,12 +177,23 @@ struct _PyGICallableCache
     GSList *arg_name_list; /* for keyword arg matching */
     GHashTable *arg_name_hash;
 
-    /* counts */
+    /* Number of in args passed to g_function_info_invoke.
+     * This is used for the length of PyGIInvokeState.in_args */
     gssize n_from_py_args;
+
+    /* Number of out args passed to g_function_info_invoke.
+     * This is used for the length of PyGIInvokeState.out_values */
     gssize n_to_py_args;
+
+    /* Number of out args for g_function_info_invoke that will be skipped
+     * when marshaling to Python due to them being implicitly available
+     * (list/array length).
+     */
     gssize n_to_py_child_args;
 
     gssize n_args;
+
+    /* Number of Python arguments expected for invoking the gi function. */
     gssize n_py_args;
 };