src/java.base/share/classes/java/lang/Deprecated.java

*** 1,7 ****
  /*
!  * Copyright (c) 2003, 2013, 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
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this
--- 1,7 ----
  /*
!  * Copyright (c) 2003, 2015, 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
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this
*** 32,44 ****
   * A program element annotated @Deprecated is one that programmers
   * are discouraged from using, typically because it is dangerous,
   * or because a better alternative exists.  Compilers warn when a
   * deprecated program element is used or overridden in non-deprecated code.
   *
   * @author  Neal Gafter
   * @since 1.5
!  * @jls 9.6.3.6 @Deprecated
   */
  @Documented
  @Retention(RetentionPolicy.RUNTIME)
  @Target(value={CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, PARAMETER, TYPE})
  public @interface Deprecated {
--- 32,48 ----
   * A program element annotated @Deprecated is one that programmers
   * are discouraged from using, typically because it is dangerous,
   * or because a better alternative exists.  Compilers warn when a
   * deprecated program element is used or overridden in non-deprecated code.
   *
+  * <p>Use of the @Deprecated annotation on a local variable
+  * declaration or on a parameter declaration or a package declaration
+  * has no effect.
+  *
   * @author  Neal Gafter
   * @since 1.5
!  * @jls 9.6.4.6 @Deprecated
   */
  @Documented
  @Retention(RetentionPolicy.RUNTIME)
  @Target(value={CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, PARAMETER, TYPE})
  public @interface Deprecated {