somewhat better errors, and a new x:documentation element

The errors should now be better formatted in the HTML report. fixes #11 - I'm not sure if they are good enough - anyone can feel free to open the issue again and specify what needs more improvement.

A new `x:documentation` element is added. fixes #10 - it should make it easy to document and generate documentation for xprocspec documents.