removed old notes, updated function descriptions