document meta methods

activesupport/lib/active_support/core_ext/string/output_safety.rb

@@ -137,14 +137,14 @@ def to_yaml(*args)
 
     UNSAFE_STRING_METHODS.each do |unsafe_method|
       class_eval <<-EOT, __FILE__, __LINE__
-        def #{unsafe_method}(*args, &block)
-          to_str.#{unsafe_method}(*args, &block)
-        end
-
-        def #{unsafe_method}!(*args)
-          @dirty = true
-          super
-        end
+        def #{unsafe_method}(*args, &block)       # def gsub(*args, &block)
+          to_str.#{unsafe_method}(*args, &block)  #   to_str.gsub(*args, &block)
+        end                                       # end
+
+        def #{unsafe_method}!(*args)              # def gsub!(*args)
+          @dirty = true                           #   @dirty = true
+          super                                   #   super
+        end                                       # end
       EOT
     end