DOC: more detail on acceptable functions