manpage improvements

while looking at the manpage for #177, I noticed some small glitches in the formating.

this PR adds the notice for #177 and cleans up the markdown a bit, so that the resulting manpage is more readable.