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
1 file changed