Document action mailer rescue_from [ci-skip]

[jean-francois-labbe]

Summary

The ActionMailer::Base documentation does not mention the rescue_from nor the fact that using rescue inside a mailer action will not work for exceptions raised inside the mail method.

I faced an issue when working on a mailer that looked like this:

class NotifyMailer < ApplicationMailer
  def notify
    ...
    mail(to: recipient)
  rescue Postmark::InactiveRecipientError => e
     Rails.logger.warn e.message
  end
end

The rescue block was never executed even though the bug tracker was full of Postmark::InactiveRecipientError coming from this mailer action.

So I'd like to document how to use rescue_from inside a mailer.

[jean-francois-labbe]

@jonathanhefner I accepted your suggestions. Thanks for helping me with this.

[jonathanhefner]

@jean-francois-labbe Looks good! Would you mind squashing the commits? Then I'll give this a merge!

[jean-francois-labbe]

@jonathanhefner commits squashed. It's ready.

[jonathanhefner]

Thank you, @jean-francois-labbe! 😄

Backported to 7-0-stable in ae98f49.