Fixes some misleading comments

SImply fixes and adds some comments.