more tests and docs (bug 959780)
Merge pull request #15 from andymckay/959780

more tests and docs