RFR: 7160714 - Strange or obsolete @see tags in some exception java.util javadoc

[David Holmes]

On 19/04/2012 5:49 AM, Mike Duigou wrote:
> Looks good with the copyright change.

Agreed. Will need CCC request as well though.

David
-----

> Mike
>
> On Apr 18 2012, at 12:15 , Jim Gish wrote:
>
>> Description:  just a trivial change to add in Iterator#next() as a @see reference
>>
>> (Alan and I discussed the possibilities here of completeness vs brevity, and we opted for brevity.  There are actually other uses, particularly in Deque , and Queue but thought it best to keep it simple)
>>
>> Patch:
>>
>> diff -r 00f5665ee0ea src/share/classes/java/util/NoSuchElementException.java
>> --- a/src/share/classes/java/util/NoSuchElementException.java    Tue Apr 17 09:30:29 2012 -0400
>> +++ b/src/share/classes/java/util/NoSuchElementException.java    Wed Apr 18 15:07:49 2012 -0400
>> @@ -1,5 +1,5 @@
>> /*
>> - * Copyright (c) 1994, 2008, Oracle and/or its affiliates. All rights reserved.
>> + * Copyright (c) 1994, 2008, 2012 Oracle and/or its affiliates. All rights reserved.
>>   * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
>>   *
>>   * This code is free software; you can redistribute it and/or modify it
>> @@ -26,13 +26,12 @@
>> package java.util;
>>
>> /**
>> - * Thrown by the<code>nextElement</code>  method of an
>> - *<code>Enumeration</code>  to indicate that there are no more
>> - * elements in the enumeration.
>> + * Thrown by various accessor methods to indicate that the element being requested
>> + * does not exist.
>>   *
>>   * @author  unascribed
>> - * @see     java.util.Enumeration
>>   * @see     java.util.Enumeration#nextElement()
>> + * @see     java.util.Iterator#next()
>>   * @since   JDK1.0
>>   */
>> public
>> Strange or obsolete @see tags in some exception java.util javadoc
>>
>> Thanks,
>>    Jim
>