remove legacy API info from README

Move the API docs into the legacy package.
Merge pull request #153 from rogpeppe/068-remove-legacy-README

remote legacy API info from README

It's misleading and unnecessary.