changes as proposed to #51
minor fixes
x-references
typos
code-block intendation