documentation clean-up

Mostly fixes to rst formatting.

`select_nb` appears to have been removed in favour of `select(block=False)`. I've updated the documentation to reflect this.