added documentation to new functions