rest of new functions documented