Wording improvements for String.indexOf, String.lastIndexOf
Martin Buchholz
martinrb at google.com
Thu Apr 1 22:38:43 UTC 2010
Renamed to IndexOf-javadoc
http://cr.openjdk.java.net/~martin/webrevs/openjdk7/IndexOf-javadoc/
Martin
On Thu, Apr 1, 2010 at 15:36, Martin Buchholz <martinrb at google.com> wrote:
> On Thu, Apr 1, 2010 at 14:35, Xueming Shen <xueming.shen at oracle.com> wrote:
>>
>> CR 6940381 Created, P4 java/classes_lang Wording improvements for
>> String.indexOf, String.lastIndexOf
>>
>> Since it's a simple rewording, I would not expect a CCC is necessary.
>>
>> Please do it separately.
>>
>> Seems like the "is <code>true</code>." line is missing from the new wording
>> (in
>> all cases), is it purposely? Not a native, but I would assume we still need
>> those 2 words to make the sentence complete.
>
> It is true that "is true"
> would make it a grammatically complete sentence,
> but I think it's best to not be quite that pedantic and lawyerly.
> In general, the JDK makes a pretty good compromise between
> precision and readability.
>
> Martin
>
More information about the core-libs-dev
mailing list