docs updated for future changes in functions
minor doc fixes