renamed list_add_list to list_append_list

[ppastats.git] / src / list.h

diff --git a/src/list.h b/src/list.h
index 69b7b25..1b66014 100644 (file)
--- a/src/list.h
+++ b/src/list.h
@@ -20,8 +20,26 @@
 #ifndef _PPASTATS_LIST_H_
 #define _PPASTATS_LIST_H_
 
+/*
+ * Convenience functions for manipulating null-terminated list of
+ * pointers.
+ */
+
+/* Returns the number of items in the list. */
 int list_length(void **list);
+
+/*
+ * Adds item into a list.
+ *
+ * Returns a new allocated list contains all items.
+ */
 void **list_add(void **list, void *new_item);
-void **list_add_list(void **list1, void **list2);
+
+/*
+ * Appends all items of two lists.
+ *
+ * Returns a new allocated list containing all items.
+ */
+void **list_append_list(void **list1, void **list2);
 
 #endif