- * A function is applied to all the elements of a dynar in parallel
- * using threads. The threads are persistent until the destruction
- * of the parmap object.
+ * A function is applied to the n first elements of a dynar in parallel,
+ * where n is the number of threads. The threads are persistent until the
+ * destruction of the parmap object.
+ *
+ * If there are more than n elements in the dynar, the worker threads should
+ * fetch themselves remaining work with xbt_parmap_next() and execute it.
+ *