RDoc documentation: `Array#&` clarification
|Target version:||next minor|
In the RDoc documentation for
Array#&, it does not mention whether the order of the elements in the returned array preserves the order in the receiver. There is a question raised regarding this point in stackoverflow:
and it mentions that that is included in the test for RubySpec
so it looks like that is taken for granted, but it is not guaranteed. If it is indeed a feature, then that should be written in the document. If not, (meaning the order might not be preserved in a future implementation), then that should also be mentioned in the document as a warning. The documentation for
Array#- makes that point clear:
Array Difference---Returns a new array that is a copy of the original array, removing any items that ...
so, perhaps the docmentation for
Array#& should be written along the same line.