Yet more detail in the README

Together with a detailed commit message which tests what users
see when this happens
Add support for multiline messages