Bunch of README fixes, and addition of the "Multi-line output" section

I think each commit should be self-explanatory! I left the broken example broken, since it's broken. But it should be expecting "6" as output like in the working example.