README: fixed syntax highlighting of last paragraph.

The cake README generation failed to patch the last
paragraph because of a missing final return at the end
of the file - fixed.

Also some other light editing of the comments.