lots of testing, source comments and doc updates