to an extent, this can't be guaranteed in absolute because the complexity of the Iterable isn't specified. but it would be nice to at least document what it is in terms of that.
there are quite a few other functions where the kdoc is less useful than the javadoc of the equivalent function it mirrors