updated README and XML file comments