adding beginnings of a README file
ran the two test files through the latest xslt
moved examples from examples/debug to examples