Improve documentation to classify to make it clear that it expects names to be plural. Reference #10615 [kris_chambers]

git-svn-id: http://svn-commit.rubyonrails.org/rails/trunk@8596 5ecf4fe2-1ee6-0310-87b1-e25e094e27de

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

@@ -104,13 +104,16 @@ module ActiveSupport #:nodoc:
           Inflector.tableize(self)
         end
 
-        # Create a class name from a table name like Rails does for table names to models.
+        # Create a class name from a plural table name like Rails does for table names to models.
         # Note that this returns a string and not a Class. (To convert to an actual class
         # follow classify with constantize.)
         #
         # Examples
         #   "egg_and_hams".classify #=> "EggAndHam"
-        #   "post".classify #=> "Post"
+        #   "posts".classify #=> "Post"
+        #
+        # Singular names are not handled correctly
+        #   "business".classify #=> "Busines"
         def classify
           Inflector.classify(self)
         end

activesupport/lib/active_support/inflector.rb

@@ -218,13 +218,16 @@ module Inflector
     pluralize(underscore(class_name))
   end
 
-  # Create a class name from a table name like Rails does for table names to models.
+  # Create a class name from a plural table name like Rails does for table names to models.
   # Note that this returns a string and not a Class. (To convert to an actual class
   # follow classify with constantize.)
   #
   # Examples
   #   "egg_and_hams".classify #=> "EggAndHam"
-  #   "post".classify #=> "Post"
+  #   "posts".classify #=> "Post"
+  #
+  # Singular names are not handled correctly
+  #   "business".classify #=> "Busines"
   def classify(table_name)
     # strip out any leading schema name
     camelize(singularize(table_name.to_s.sub(/.*\./, '')))