Tidy up the manual

- Switch to promise terminology.
- Fix a lot of typos and similar minor errors.
- Rewrite some text.
- Point out what is deprecated or remove it.
- ...etc.

This manual is actually superseded by the text in src/core/lwt.mli,
added in #469, but that is taking a while to post, so it is probably
worth updating this now.