documented all new functions