+2013-03-20 Jérémy Zurcher (jeyzu)
+
+ * Eina: Add eina_list_shuffle
+
2013-03-19 Mike Blumenkrantz
* Fix magic failure in eina_value_array_count when array has not been allocated
--------------------
Additions:
+ * Add eina_list_shuffle
* Add multiple font draws support to engines
* eina :
- Add DOCTYPE children parsing in eina_simple_xml
* nodes.
* @return the new head of list.
*
- * This function sorts @p list. @p size if the number of the first
- * element to sort. If @p limit is 0 or greater than the number of
+ * This function sorts @p list. If @p limit is 0 or greater than the number of
* elements in @p list, all the elements are sorted. @p func is used to
* compare two elements of @p list. If @p func is @c NULL, this function returns
* @p list.
/**
+ * @brief Shuffle list.
+ *
+ * @param list The list handle to shuffle.
+ * @param func A function pointer that can return an int between 2 inclusives values
+ * @return the new head of list.
+ *
+ * This function shuffles @p list.
+ * @p func is used to generate random list indexes within the range of
+ * unshuffled list items. If @p func is @c NULL, rand is used.
+ *
+ * @note @b in-place: this will change the given list, so you should
+ * now point to the new list head that is returned by this function.
+ *
+ * @since 1.8
+ *
+ * @warning @p list must be a pointer to the first element of the list.
+ */
+EAPI Eina_List *eina_list_shuffle(Eina_List *list, Eina_Random_Cb func) EINA_WARN_UNUSED_RESULT;
+
+
+/**
* @brief Merge two list.
*
* @param left Head list to merge.