documentation update for escape annotation