This one has been there for a few years.
http://docs.oracle.com/javase/7/docs/api/java/lang/String.html#subSequence(int,
int)
Problem: The throws comment refers to a parameter that doesn't
exist: startIndex should be endIndex.
Bad:
Throws: IndexOutOfBoundsException - if beginIndex or endIndex are
negative, if endIndex is greater than length(), or if beginIndex is
greater than startIndex
Good:
Throws: IndexOutOfBoundsException - if beginIndex or endIndex are
negative, if endIndex is greater than length(), or if beginIndex is
greater than endIndex
http://docs.oracle.com/javase/7/docs/api/java/lang/String.html#subSequence(int,
int)
Problem: The throws comment refers to a parameter that doesn't
exist: startIndex should be endIndex.
Bad:
Throws: IndexOutOfBoundsException - if beginIndex or endIndex are
negative, if endIndex is greater than length(), or if beginIndex is
greater than startIndex
Good:
Throws: IndexOutOfBoundsException - if beginIndex or endIndex are
negative, if endIndex is greater than length(), or if beginIndex is
greater than endIndex