On Mon, 2 Mar 2026 15:50:07 GMT, Roger Riggs <[email protected]> wrote:
>> A doc only change to clarify that the _smallest_ of many possible mismatch >> indices is returned. > > src/java.base/share/classes/jdk/internal/util/ArraysSupport.java line 481: > >> 479: >> 480: /** >> 481: * Find the smallest index of a mismatch between two arrays. > > The public javadoc uses "first" to describe the one returned. > Its also notable, that only 2 mismatch methods have any javadoc. > It would sufficient to document them by referring to the public javadoc in > Arrays.java. "First" would be OK if the doc stated that the search starts with index 0 (or with the "from" indices in the 5 args variant) but it does not. "Smallest" is unambiguous. I opted for the minimal changes of the current doc that are sharp about the result. ------------- PR Review Comment: https://git.openjdk.org/jdk/pull/29997#discussion_r2873221186
