improve documentation and fix issues identified in pull request #182