Finish doc for ShowMessage().

I started writing this comment five years ago in
dcdf9a3ea27dd065e3b6a8dc2b520d083d25cf76 and now I get to finally finish
it!  :D