Documentation review for Boost.Coroutine feature/symmetric branch.

Many small grammar tweaks, probably applicable to master branch too.

The one substantive comment specifically about feature/symmetric: can we get
away without yield_type::operator()?