requested coding style improvements

includes improvements from pull request #53
and adds description for multiple instances to documentation.