- * \param dynar the dynar to sort
- * \param compar_fn comparison function of type (int (compar_fn*) (void*) (void*)).
+ * This function simply apply the classical qsort(3) function to the data stored in the dynar.
+ * You should thus refer to the libc documentation, or to some online tutorial on how to write
+ * a comparison function. Here is a quick example if you have integers in your dynar:
+ *
+ * @verbatim
+ * int cmpfunc (const void * a, const void * b) {
+ * int intA = *(int*)a;
+ * int intB = *(int*)b;
+ * return intA - intB;
+ * }
+ * @endverbatim
+ *
+ * and now to sort a dynar of MSG hosts depending on their speed:
+ * @verbatim
+ * int cmpfunc(const MSG_host_t a, const MSG_host_t b) {
+ * MSG_host_t hostA = *(MSG_host_t*)a;
+ * MSG_host_t hostB = *(MSG_host_t*)b;
+ * return MSG_host_get_speed(hostA) - MSG_host_get_speed(hostB);
+ * }
+ * @endverbatim