Additional doc string edits for the while_state functions.
Added description of “timeout conditions” to each while_state function.  Note, the doc strings as I have written them are intended as notes for the programmers, not as documentation for the end users at this point.