added comments to last few public functions