code changes to allow a two-argument form of open_handle() and more and more documentation improvements and additions