added docstrings & convenience properties

- better documentation for Text properies
- TextFrame.text returns the substring that’s laid out within the
frame’s bounds
made the text-flow generators a bit more explicit

- no longer a chain of next() calling next()