more tests and docs (bug 959780)