add two more functions; update notes