From 525cbd4c2f1257f131e38caaecf01c7674b1130a Mon Sep 17 00:00:00 2001 From: Tom Kadwill Date: Fri, 22 Aug 2014 08:07:07 +0100 Subject: [ci skip] Added documentation for has_and_belongs_to_many scope parameter --- activerecord/lib/active_record/associations.rb | 12 ++++++++++++ 1 file changed, 12 insertions(+) (limited to 'activerecord') diff --git a/activerecord/lib/active_record/associations.rb b/activerecord/lib/active_record/associations.rb index fb8cf1cecc..4ec1c8d545 100644 --- a/activerecord/lib/active_record/associations.rb +++ b/activerecord/lib/active_record/associations.rb @@ -1578,6 +1578,18 @@ module ActiveRecord # * Developer#projects.create (similar to c = Project.new("developer_id" => id); c.save; c) # The declaration may include an +options+ hash to specialize the behavior of the association. # + # === Scopes + # + # You can pass a second argument +scope+ as a callable (i.e. proc or + # lambda) to retrieve a specific set of records or customize the generated + # query when you access the associated collection. + # + # Scope examples: + # has_and_belongs_to_many :projects, -> { includes :milestones, :manager } + # has_and_belongs_to_many :categories, ->(category) { + # where("default_category = ?", category.name) + # } + # # === Options # # [:class_name] -- cgit v1.2.3