One returns a list of lists, the other an iterator of lists.

split_iter() docs say, "split_iter() yields lists of non-separator values," whereas split() docs say, "Returns a list of lists." Still, I'll look at clarifying it. ;)

You're absolutely correct. I read "yields" colloquially, not in terms of "yield." Written as designed. :)

From my understanding the docs are correct:

> split_iter() yields lists of non-separator values.

-> returns a generator of lists

vs for split()

> Returns a list of lists.

Note that the examples in the docs always wrap split_iter() in list(), hiding the generator step from the visible output.