Improve the gtk_accelerator_parse() docs

We need to escape the modifiers in angular brackets, or Markdown will consider them as HTML tags.

We also should document the modifiers we're parsing.