fixed issues and added comments to cut down on some reported confusion