-DOC first pass through UTIL container library

1 files changed, 0 insertions, 73 deletions

diff --git a/src/util/container_multihashmap32.c b/src/util/container_multihashmap32.c
index f349a5f80..ccedd1bbb 100644
--- a/src/util/container_multihashmap32.c
+++ b/src/util/container_multihashmap32.c
@@ -195,12 +195,6 @@ idx_of (const struct GNUNET_CONTAINER_MultiHashMap32 *m, const uint32_t key)
 }
 
 
-/**
- * Get the number of key-value pairs in the map.
- *
- * @param map the map
- * @return the number of key value pairs
- */
 unsigned int
 GNUNET_CONTAINER_multihashmap32_size (
   const struct GNUNET_CONTAINER_MultiHashMap32 *map)
@@ -209,16 +203,6 @@ GNUNET_CONTAINER_multihashmap32_size (
 }
 
 
-/**
- * Given a key find a value in the map matching the key.
- *
- * @param map the map
- * @param key what to look for
- * @return NULL if no value was found; note that
- *   this is indistinguishable from values that just
- *   happen to be NULL; use "contains" to test for
- *   key-value pairs with value NULL
- */
 void *
 GNUNET_CONTAINER_multihashmap32_get (
   const struct GNUNET_CONTAINER_MultiHashMap32 *map,
@@ -237,15 +221,6 @@ GNUNET_CONTAINER_multihashmap32_get (
 }
 
 
-/**
- * Iterate over all entries in the map.
- *
- * @param map the map
- * @param it function to call on each entry
- * @param it_cls extra argument to @a it
- * @return the number of key value pairs processed,
- *         #GNUNET_SYSERR if it aborted iteration
- */
 int
 GNUNET_CONTAINER_multihashmap32_iterate (
   struct GNUNET_CONTAINER_MultiHashMap32 *map,
@@ -300,17 +275,6 @@ update_next_cache (struct GNUNET_CONTAINER_MultiHashMap32 *map,
 }
 
 
-/**
- * Remove the given key-value pair from the map.  Note that if the
- * key-value pair is in the map multiple times, only one of the pairs
- * will be removed.
- *
- * @param map the map
- * @param key key of the key-value pair
- * @param value value of the key-value pair
- * @return #GNUNET_YES on success, #GNUNET_NO if the key-value pair
- *  is not in the map
- */
 int
 GNUNET_CONTAINER_multihashmap32_remove (
   struct GNUNET_CONTAINER_MultiHashMap32 *map,
@@ -346,14 +310,6 @@ GNUNET_CONTAINER_multihashmap32_remove (
 }
 
 
-/**
- * Remove all entries for the given key from the map.
- * Note that the values would not be "freed".
- *
- * @param map the map
- * @param key identifies values to be removed
- * @return number of values removed
- */
 int
 GNUNET_CONTAINER_multihashmap32_remove_all (
   struct GNUNET_CONTAINER_MultiHashMap32 *map,
@@ -397,15 +353,6 @@ GNUNET_CONTAINER_multihashmap32_remove_all (
 }
 
 
-/**
- * Check if the map contains any value under the given
- * key (including values that are NULL).
- *
- * @param map the map
- * @param key the key to test if a value exists for it
- * @return #GNUNET_YES if such a value exists,
- *         #GNUNET_NO if not
- */
 int
 GNUNET_CONTAINER_multihashmap32_contains (
   const struct GNUNET_CONTAINER_MultiHashMap32 *map,
@@ -424,16 +371,6 @@ GNUNET_CONTAINER_multihashmap32_contains (
 }
 
 
-/**
- * Check if the map contains the given value under the given
- * key.
- *
- * @param map the map
- * @param key the key to test if a value exists for it
- * @param value value to test for
- * @return #GNUNET_YES if such a value exists,
- *         #GNUNET_NO if not
- */
 int
 GNUNET_CONTAINER_multihashmap32_contains_value (
   const struct GNUNET_CONTAINER_MultiHashMap32 *map,
@@ -549,16 +486,6 @@ GNUNET_CONTAINER_multihashmap32_put (
 }
 
 
-/**
- * Iterate over all entries in the map that match a particular key.
- *
- * @param map the map
- * @param key key that the entries must correspond to
- * @param it function to call on each entry
- * @param it_cls extra argument to @a it
- * @return the number of key value pairs processed,
- *         GNUNET_SYSERR if it aborted iteration
- */
 int
 GNUNET_CONTAINER_multihashmap32_get_multiple (
   struct GNUNET_CONTAINER_MultiHashMap32 *map,