added some function documentations.