Add clarifying comments to smart escape