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
