aboutsummaryrefslogtreecommitdiffstats
path: root/activerecord/lib
diff options
context:
space:
mode:
authorRafael Mendonça França <rafael.franca@plataformatec.com.br>2015-02-19 09:08:10 -0200
committerRafael Mendonça França <rafael.franca@plataformatec.com.br>2015-02-19 09:08:51 -0200
commite28721baf275891ab8cb4e91e33877d52f5f26e8 (patch)
tree5419e4858b8b5b25edd16b6af561162c96485b10 /activerecord/lib
parent41b9730c6d033ea7f38fae4d18347c5370ff7b6c (diff)
downloadrails-e28721baf275891ab8cb4e91e33877d52f5f26e8.tar.gz
rails-e28721baf275891ab8cb4e91e33877d52f5f26e8.tar.bz2
rails-e28721baf275891ab8cb4e91e33877d52f5f26e8.zip
Copy edit the suppressor documentation
[ci skip]
Diffstat (limited to 'activerecord/lib')
-rw-r--r--activerecord/lib/active_record/suppressor.rb30
1 files changed, 15 insertions, 15 deletions
diff --git a/activerecord/lib/active_record/suppressor.rb b/activerecord/lib/active_record/suppressor.rb
index b47f02143c..5c46d7cc9c 100644
--- a/activerecord/lib/active_record/suppressor.rb
+++ b/activerecord/lib/active_record/suppressor.rb
@@ -5,26 +5,26 @@ module ActiveRecord
# For example, here's a pattern of creating notifications when new comments
# are posted. (The notification may in turn trigger an email, a push
# notification, or just appear in the UI somewhere):
- #
- # class Comment < ActiveRecord::Base
- # belongs_to :commentable, polymorphic: true
- # after_create -> { Notification.create! comment: self,
- # recipients: commentable.recipients }
- # end
- #
+ #
+ # class Comment < ActiveRecord::Base
+ # belongs_to :commentable, polymorphic: true
+ # after_create -> { Notification.create! comment: self,
+ # recipients: commentable.recipients }
+ # end
+ #
# That's what you want the bulk of the time. New comment creates a new
# Notification. But there may well be off cases, like copying a commentable
# and its comments, where you don't want that. So you'd have a concern
# something like this:
- #
- # module Copyable
- # def copy_to(destination)
- # Notification.suppress do
- # # Copy logic that creates new comments that we do not want
- # # triggering notifications.
+ #
+ # module Copyable
+ # def copy_to(destination)
+ # Notification.suppress do
+ # # Copy logic that creates new comments that we do not want
+ # # triggering notifications.
+ # end
# end
# end
- # end
module Suppressor
extend ActiveSupport::Concern
@@ -38,7 +38,7 @@ module ActiveRecord
end
# Ignore saving events if we're in suppression mode.
- def save!(*args)
+ def save!(*args) # :nodoc:
SuppressorRegistry.suppressed[self.class.name] ? self : super
end
end