From 564506bb0d026018861645a0236da6a23bbb439b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?M=C3=A4rt=20P=C3=B5der?= <tramm@p6drad-teel.net>
Date: Sat, 2 Aug 2014 13:20:20 +0300
Subject: [PATCH] Add annotations to get_proclist* to make Python bindings
 work.

https://bugzilla.gnome.org/show_bug.cgi?id=734170
---
 include/glibtop/proclist.h | 39 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/include/glibtop/proclist.h b/include/glibtop/proclist.h
index 2fdbfb44..9bb192b9 100644
--- a/include/glibtop/proclist.h
+++ b/include/glibtop/proclist.h
@@ -127,6 +127,15 @@ struct _glibtop_proclist
 	guint64 size;			/* GLIBTOP_PROCLIST_SIZE	*/
 };
 
+/**
+ * glibtop_get_proclist:
+ * @buf: a #glibtop_proclist
+ * @which: a #GLIBTOP_* constant specifying process type
+ * @arg: an argument specific for the process type
+ *
+ * Returns: (array zero-terminated=1) (transfer none): an array of process
+ *     ids
+ */
 pid_t*
 glibtop_get_proclist(glibtop_proclist *buf, gint64 which, gint64 arg);
 
@@ -136,6 +145,16 @@ glibtop_get_proclist(glibtop_proclist *buf, gint64 which, gint64 arg);
 #define glibtop_get_proclist_r		glibtop_get_proclist_s
 #endif
 
+/**
+ * glibtop_get_proclist_l:
+ * @server: a #glibtop server
+ * @buf: a #glibtop_proclist
+ * @which: a #GLIBTOP_* constant specifying process type
+ * @arg: an argument specific for the process type
+ *
+ * Returns: (array zero-terminated=1) (transfer none): an array of process
+ *     ids
+ */
 pid_t*
 glibtop_get_proclist_l (glibtop *server, glibtop_proclist *buf,
 			gint64 which, gint64 arg);
@@ -143,12 +162,32 @@ glibtop_get_proclist_l (glibtop *server, glibtop_proclist *buf,
 #if GLIBTOP_SUID_PROCLIST
 void _glibtop_init_proclist_p (glibtop *server);
 
+/**
+ * glibtop_get_proclist_p:
+ * @server: a #glibtop server
+ * @buf: a #glibtop_proclist
+ * @which: a #GLIBTOP_* constant specifying process type
+ * @arg: an argument specific for the process type
+ *
+ * Returns: (array zero-terminated=1) (transfer none): an array of process
+ *     ids
+ */
 pid_t*
 glibtop_get_proclist_p (glibtop *server, glibtop_proclist *buf,
 			gint64 which, gint64 arg);
 #else
 void _glibtop_init_proclist_s (glibtop *server);
 
+/**
+ * glibtop_get_proclist_s:
+ * @server: a #glibtop server
+ * @buf: a #glibtop_proclist
+ * @which: a #GLIBTOP_* constant specifying process type
+ * @arg: an argument specific for the process type
+ *
+ * Returns: (array zero-terminated=1) (transfer none): an array of process
+ *     ids
+ */
 pid_t*
 glibtop_get_proclist_s (glibtop *server, glibtop_proclist *buf,
 			gint64 which, gint64 arg);