remove obsolete code
added parameter/return type documentation