added comments for new function