* @return a pointer to the inserted element
*
* @note
- * It is not possible to insert on element more than once. If an element
+ * It is not possible to insert one element more than once. If an element
* that should be inserted is already in the set, this functions does
* nothing but returning its pointer.
*/
/**
* Breaks the iteration of a set. Must be called before
- * the next pset_first() call if the iteration was NOT
+ * the next set_first() call if the iteration was NOT
* finished.
*
- * @param pset the pset
+ * @param set the set
*/
void set_break (set *set);
#endif
#ifdef DEBUG
-void set_describe (set *);
+/**
+ * Describe a set.
+ *
+ * Writes a description of a set to stdout. The description includes:
+ * - a header telling how many elements (nkey) and segments (nseg) are in use
+ * - for every collision chain the number of element with its hash values
+ *
+ * @param set the set
+ */
+void set_describe (set *set);
#endif