Merge pull request #6 from mwichmann/master

more readme fiddling
add a revised outline structure on the document, and a couple FIXME's
add a needed linebreak
just some code formatting
paste in a better comment stripper