update the documentation for the new core functions