some more function docs