update reference manual
update function documentation