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

Mike Duigou mike.duigou at oracle.com
Wed Apr 18 19:49:55 UTC 2012


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




More information about the core-libs-dev mailing list