I was scanning through active_record/validations.rb the other day and
noticed that there's a method RDoc comment about
ClassMethods::validate (which also addresses the validate_on_create
and validate_on_update class methods) floating in space just north of
validates_each. Since it's not stuck to a method def, RDoc ignores it.
(I did a bisect and found that the comment got orphaned back in
January when ActiveSupport::Callbacks was extracted
Does anyone have a better suggestion than converting that into a
section in the module-level Rdoc for
ActiveRecord::Validations::ClassMethods? As far as I know, RDoc's
support for metaprogrammed methods (excluding the special case of
attribute readers and writers) is non-existent.