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

Jim Gish jim.gish at oracle.com
Wed Apr 18 19:15:09 UTC 2012


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



More information about the core-libs-dev mailing list