src/daemon/utils_cache.h: Improve documentation for uc_iterator_get_next().
authorFlorian Forster <octo@collectd.org>
Wed, 28 Sep 2016 11:54:00 +0000 (13:54 +0200)
committerFlorian Forster <octo@collectd.org>
Wed, 28 Sep 2016 20:09:50 +0000 (22:09 +0200)
src/daemon/utils_cache.h

index 93c2519..e020429 100644 (file)
@@ -85,9 +85,9 @@ uc_iter_t *uc_get_iterator (void);
  *
  * PARAMETERS
  *   `iter'     The iterator object to advance.
- *   `ret_name' Pointer to a string where to store the name. The returned
- *              value is a copy of the value and has to be freed by the
- *              caller.
+ *   `ret_name' Optional pointer to a string where to store the name. If not
+ *              NULL, the returned value is a copy of the value and has to be
+ *              freed by the caller.
  *
  * RETURN VALUE
  *   Zero upon success or non-zero if the iterator ie NULL or no further