core: Update osmo_counters_for_each doc

Fix type and add a note about the semantics of the handler's return
code.

Sponsored-by: On-Waves ehf
diff --git a/include/osmocom/core/statistics.h b/include/osmocom/core/statistics.h
index de250be..a9a623d 100644
--- a/include/osmocom/core/statistics.h
+++ b/include/osmocom/core/statistics.h
@@ -37,8 +37,8 @@
  */
 void osmo_counter_free(struct osmo_counter *ctr);
 
-/*! \brief Iteate over all counters
- *  \param[in] handle_counter Call-back function
+/*! \brief Iterate over all counters
+ *  \param[in] handle_counter Call-back function, aborts if rc < 0
  *  \param[in] data Private dtata handed through to \a handle_counter
  */
 int osmo_counters_for_each(int (*handle_counter)(struct osmo_counter *, void *), void *data);