updated docs + new test case to make sure they aren't lying!