Minor documentation improvements

git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@4579 b2dd03c8-39d4-4d8f-98ff-823fe69b080e

1 files changed, 3 insertions, 2 deletions

diff --git a/lib/set.rb b/lib/set.rb
index c86578c716..a5d4a7730a 100644
--- a/lib/set.rb
+++ b/lib/set.rb
@@ -212,7 +212,8 @@ class Set
     end
   end
 
-  # Deletes the given object from the set and returns self.
+  # Deletes the given object from the set and returns self.  Use +subtract+ to
+  # delete several items at once.
   def delete(o)
     @hash.delete(o)
     self
@@ -282,7 +283,7 @@ class Set
   alias union |		##
 
   # Returns a new set built by duplicating the set, removing every
-  # element that appear in the given enumerable object.
+  # element that appears in the given enumerable object.
   def -(enum)
     enum.is_a?(Enumerable) or raise ArgumentError, "value must be enumerable"
     dup.subtract(enum)