*
* complete_iterate() copy in dstbuf (the size is specified in the
* parameter) the next possible completion for this token. Return 0 on
- * success or a negative value on error (or when there is no more
+ * success (final completion), 1 if it's an intermediate completion,
+ * or a negative value on error (or when there is no more
* completion). Refer to cmdline_complete_string_iterate() for an
* example.
*