Doco update

Updated some doc strings, generated HTML documentation, added link to
doc in README.md