Second series of source code and documenation updates post comments
Thomas