remove spurious spaces in the example files
clarify README, add 'future work' section