std::str: Correct docstrings for lack of null terminator in ~str and &str
std::str: Rename .word_iter() to .whitespace_split_iter()

We don't want to keep this as "word_iter" since it's not correct for
unicode, which defines a different method for breaking text up into
words.