upgrade doc, add doc for xml replacement, and doc on Acknowledgments