RFR: 7160725 - Strange or obsolete @see tags in some exception java.lang javadoc

[David Holmes]

Hi Jim,

I guess I don't see the point here. There must be literally dozens of 
APIs that throw IllegalArgumentException, and a significant number that 
can throw NumberFormatError. What is so special about these selections?

I'd argue for removing the old @see tags.

David

On 19/04/2012 5:47 AM, Jim Gish wrote:
> I've updated the copyrights to just have first and current year.
>
> Jim
>
> On 04/18/2012 03:33 PM, Jim Gish wrote:
>> Description:
>>
>> Another trivial javadoc update - fixed existing @see ref and added a
>> few more representative of the exception usage
>>
>> Patch:
>>
>> diff -r 00f5665ee0ea
>> src/share/classes/java/lang/IllegalArgumentException.java
>> --- a/src/share/classes/java/lang/IllegalArgumentException.java Tue
>> Apr 17 09:30:29 2012 -0400
>> +++ b/src/share/classes/java/lang/IllegalArgumentException.java Wed
>> Apr 18 15:28:26 2012 -0400
>> @@ -1,5 +1,5 @@
>> /*
>> - * Copyright (c) 1994, 2003, Oracle and/or its affiliates. All rights
>> reserved.
>> + * Copyright (c) 1994, 2003, 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
>> @@ -30,7 +30,10 @@
>> * inappropriate argument.
>> *
>> * @author unascribed
>> + * @see java.lang.Enum#valueOf(Class, String)
>> * @see java.lang.Thread#setPriority(int)
>> + * @see java.lang.Runtime#exec(String)
>> + * @see java.lang.System#getProperty(String)
>> * @since JDK1.0
>> */
>> public
>>
>> diff -r 00f5665ee0ea
>> src/share/classes/java/lang/NumberFormatException.java
>> --- a/src/share/classes/java/lang/NumberFormatException.java Tue Apr
>> 17 09:30:29 2012 -0400
>> +++ b/src/share/classes/java/lang/NumberFormatException.java Wed Apr
>> 18 15:28:26 2012 -0400
>> @@ -1,5 +1,5 @@
>> /*
>> - * Copyright (c) 1994, 2001, Oracle and/or its affiliates. All rights
>> reserved.
>> + * Copyright (c) 1994, 2001, 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
>> @@ -31,7 +31,8 @@
>> * have the appropriate format.
>> *
>> * @author unascribed
>> - * @see java.lang.Integer#toString()
>> + * @see java.lang.Float#Float(String)
>> + * @see java.lang.Integer#parseInt(String)
>> * @since JDK1.0
>> */
>> public
>>
>> Thanks,
>> Jim Gish
>