new functions documented.