tidy up documentation; allow xml to be generated by xbuild