update code comments

some were outdated, some more were needed