doc/api-messages.texi (Message Handling): Improve doc.

* doc/api-messages.texi (Message Handling): Add general
  description of a message.  Improve description of
  `message-reply-success' procedure.