user manual: mention needed explicit import of D.Coordinates
more updates to user manual

All the drop-dead showstopper things have been fixed, so it's pretty
much ready for a release, though there are still things we can
continue improving/adding after the release.