[#873] [#839] add "includes" automatic scope which is identical to

"include", deprecating "include"

hobo/CHANGES.txt

@@ -36,6 +36,10 @@ report](https://hobo.lighthouseapp.com/projects/8324/tickets/666-user-model-secu
 All code changes may viewed on the [github
 log](https://github.com/tablatom/hobo/compare/v1.0.2...v1.0.3)
 
+The "include" automatic scope has been aliased to "includes" to
+increase future compatibility with Rails 3.  Future versions of Hobo
+will remove support for "include".
+
 === Hobo 1.0.2 ===
 
 This release is almost identical to 1.0.1 except that it updates the

hobo/doctest/scopes.rdoctest

@@ -288,16 +288,16 @@ Gives the N most recent items:
     >> Person.order_by(:code).*.name
     => ["Bryan", "Bethany"]
 
-## include
+## includes
 
-Adding the include function to your query chain has the same effect as
+Adding the includes function to your query chain has the same effect as
 the `:include` option to the `find` method.  
 
     >> Person.search("B", :name).include(:friends).*.name  # test LH#839
     => ["Bryan", "Bethany"]
 .hidden
 
-    >> Person.include(:friends).*.name
+    >> Person.includes(:friends).*.name
     => ["Bryan", "Bethany"]
 
 ## search

hobo/lib/hobo/scopes/automatic_scopes.rb

@@ -270,6 +270,11 @@ def create_scope
               { :include => inclusions }
             end
 
+          when "includes"
+            def_scope do |inclusions|
+              { :include => inclusions }
+            end
+
           when "search"
             def_scope do |query, *fields|
               words = query.split