doc/api-messages.texi: Improve `message-get-type' documentation.

* doc/api-messages.texi (Message Handling): Improve description of
  `message-get-type' procedure.  Add information about possible
  types and subtypes of a message.