explanatory text for new functions

Added some notes