Documentation update + misc fixes

Major documentation update, to use the new & improved APIs
in most cases.  Eliminated many unneeded 'with' statements.

s/add_submodule/add_root_subdirectory/