final polish before next CPAN TRIAL release - v4.130425.  add comments to Changes file, fix all documentation and tests to use new method names in place of legacy method names which were replaced