updated comments to all the interfaces