RFR: 7160714 - Strange or obsolete @see tags in some exception java.util javadoc
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
I've updated the copyrights to just have first and current year. Jim On 04/18/2012 03:15 PM, 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
Looks good with the copyright change. 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
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
On 18/04/2012 20:49, Mike Duigou wrote:
Looks good with the copyright change.
Mike
Looks fine to me too.
participants (4)
-
Alan Bateman
-
David Holmes
-
Jim Gish
-
Mike Duigou