Renamed Coro's 'wait' to 'finish'.

To avoid confusion with sleep/suspend, wait method of Coro has
been changed to finish.
'write' method improved, added descriptions.

'write' method now takes 'all' optional parameter. If it is True,
coroutine is suspended until all given data has been written (or
some exception occurred).

Added descriptions to some methods.