documentation for new function