update README and comments in XML file