fix a test
docs on functions