edited function documentations to epydoc requirements