We don't have any documentation on the mail method and their uses.
Maybe that should go into the mail plugin documentation with pointer to the different mail methods
Cheers