I suggest to replace:

| The elements [methods] in the array returned are not sorted and are
| not in any particular order.

with:

| If the class is a compiled Java class, the elements in the array are
| sorted according to the order of declaration in the source code.
| Otherwise, the elements are not in any particular order.

There is a growing amount of code which relies on predictable method
order, so backwards compatibility concerns implicitly dictate the
ordering.  The proposed change makes this explicit.

The other reflection methods should be updated in a similar fashion.

-- 
Florian Weimer                <fwei...@bfk.de>
BFK edv-consulting GmbH       http://www.bfk.de/
Kriegsstraße 100              tel: +49-721-96201-1
D-76133 Karlsruhe             fax: +49-721-96201-99

Reply via email to