doc: updated README.xml
doc: included README.md

Added to SCM (not distributed) a markdown README based on the generated
one to make github happy.