added test for issue #4

commit 9f88e28c2be446d3f0f2118e9838cefb298a50ca seems to fix #4 - this commit provides a regression test for it
refreshed the documentation
Merge branch 'issue-4'