Avoid confusion in Array#- and Array#difference docs (#2070)

My previous attempt to correct #2068 apparently failed and the confusing
wording ("instances") was merged into trunk instead.

This should address any potential confusion.

1 files changed, 6 insertions, 6 deletions

diff --git a/array.c b/array.c
index 5443268c1a..bc5c719267 100644
--- a/array.c
+++ b/array.c
@@ -4500,15 +4500,15 @@ ary_recycle_hash(VALUE hash)
  *  Array Difference
  *
  *  Returns a new array that is a copy of the original array, removing all
- *  instances of any item that also appear in +other_ary+. The order is preserved
- *  from the original array.
+ *  occurences of any item that also appear in +other_ary+. The order is
+ *  preserved from the original array.
  *
  *  It compares elements using their #hash and #eql? methods for efficiency.
  *
  *     [ 1, 1, 2, 2, 3, 3, 4, 5 ] - [ 1, 2, 4 ]  #=>  [ 3, 3, 5 ]
  *
  *  Note that while 1 and 2 were only present once in the array argument, and
- *  were present twice in the receiver array, all instances of each Integer are
+ *  were present twice in the receiver array, all occurences of each Integer are
  *  removed in the returned array.
  *
  *  If you need set-like behavior, see the library class Set.
@@ -4551,7 +4551,7 @@ rb_ary_diff(VALUE ary1, VALUE ary2)
  *  Array Difference
  *
  *  Returns a new array that is a copy of the original array, removing all
- *  instances of any item that also appear in +other_ary+. The order is
+ *  occurences of any item that also appear in +other_ary+. The order is
  *  preserved from the original array.
  *
  *  It compares elements using their #hash and #eql? methods for efficiency.
@@ -4559,10 +4559,10 @@ rb_ary_diff(VALUE ary1, VALUE ary2)
  *     [ 1, 1, 2, 2, 3, 3, 4, 5 ].difference([ 1, 2, 4 ])     #=> [ 3, 3, 5 ]
  *
  *  Note that while 1 and 2 were only present once in the array argument, and
- *  were present twice in the receiver array, all instances of each Integer are
+ *  were present twice in the receiver array, all occurences of each Integer are
  *  removed in the returned array.
  *
- *  Multiple array arguments can be supplied and all instances of any element
+ *  Multiple array arguments can be supplied and all occurences of any element
  *  in those supplied arrays that match the receiver will be removed from the
  *  returned array.
  *