removed some unnecessary comments; added some documentation; renamed functions to make them uniform and be named as verbes