added more comments for 'raise' entry points