update XML comment to note impending change