RFR: 8176541: XML deprecation "since" values should use 1.x version form for 1.8 and earlier

huizhe wang huizhe.wang at oracle.com
Wed Mar 15 01:08:51 UTC 2017


Hi,

Please review a correction of the "since" values for several deprecated 
classes / methods.

diff --git 
a/src/java.xml/share/classes/javax/xml/stream/XMLEventFactory.java 
b/src/java.xml/share/classes/javax/xml/stream/XMLEventFactory.java
--- a/src/java.xml/share/classes/javax/xml/stream/XMLEventFactory.java
+++ b/src/java.xml/share/classes/javax/xml/stream/XMLEventFactory.java
@@ -155,7 +155,7 @@
     *              #newFactory(java.lang.String, java.lang.ClassLoader)}
     *              method defines no changes in behavior.
     */
*-  @Deprecated(since="7")**
**+  @Deprecated(since="1.7")*
    public static XMLEventFactory newInstance(String factoryId,
            ClassLoader classLoader)
            throws FactoryConfigurationError {
diff --git 
a/src/java.xml/share/classes/javax/xml/stream/XMLInputFactory.java 
b/src/java.xml/share/classes/javax/xml/stream/XMLInputFactory.java
--- a/src/java.xml/share/classes/javax/xml/stream/XMLInputFactory.java
+++ b/src/java.xml/share/classes/javax/xml/stream/XMLInputFactory.java
@@ -222,7 +222,7 @@
     *   java.util.ServiceConfigurationError service configuration 
error} or if
     *   the implementation is not available or cannot be instantiated.
     */
*-  @Deprecated(since="7")**
**+  @Deprecated(since="1.7")*
    public static XMLInputFactory newFactory()
      throws FactoryConfigurationError
    {
@@ -244,7 +244,7 @@
     *              #newFactory(java.lang.String, 
java.lang.ClassLoader)} method
     *              defines no changes in behavior.
     */
*-  @Deprecated(since="7")**
**+  @Deprecated(since="1.7")*
    public static XMLInputFactory newInstance(String factoryId,
            ClassLoader classLoader)
            throws FactoryConfigurationError {
diff --git 
a/src/java.xml/share/classes/javax/xml/stream/XMLOutputFactory.java 
b/src/java.xml/share/classes/javax/xml/stream/XMLOutputFactory.java
--- a/src/java.xml/share/classes/javax/xml/stream/XMLOutputFactory.java
+++ b/src/java.xml/share/classes/javax/xml/stream/XMLOutputFactory.java
@@ -222,7 +222,7 @@
     *              Use the new method {@link #newFactory(java.lang.String,
     *              java.lang.ClassLoader)} instead.
     */
*-  @Deprecated(since="7")**
**+  @Deprecated(since="1.7")*
    public static XMLInputFactory newInstance(String factoryId,
            ClassLoader classLoader)
            throws FactoryConfigurationError {
diff --git a/src/java.xml/share/classes/org/xml/sax/AttributeList.java 
b/src/java.xml/share/classes/org/xml/sax/AttributeList.java
--- a/src/java.xml/share/classes/org/xml/sax/AttributeList.java
+++ b/src/java.xml/share/classes/org/xml/sax/AttributeList.java
@@ -93,7 +93,7 @@
   * @see org.xml.sax.DocumentHandler#startElement startElement
   * @see org.xml.sax.helpers.AttributeListImpl AttributeListImpl
   */
*- at Deprecated(since="5")**
**+ at Deprecated(since="1.5")*
  public interface AttributeList {


diff --git a/src/java.xml/share/classes/org/xml/sax/DocumentHandler.java 
b/src/java.xml/share/classes/org/xml/sax/DocumentHandler.java
--- a/src/java.xml/share/classes/org/xml/sax/DocumentHandler.java
+++ b/src/java.xml/share/classes/org/xml/sax/DocumentHandler.java
@@ -68,7 +68,7 @@
   * @see org.xml.sax.Locator
   * @see org.xml.sax.HandlerBase
   */
*- at Deprecated(since="5")**
**+ at Deprecated(since="1.5")*
  public interface DocumentHandler {


diff --git a/src/java.xml/share/classes/org/xml/sax/Parser.java 
b/src/java.xml/share/classes/org/xml/sax/Parser.java
--- a/src/java.xml/share/classes/org/xml/sax/Parser.java
+++ b/src/java.xml/share/classes/org/xml/sax/Parser.java
@@ -73,7 +73,7 @@
   * @see org.xml.sax.HandlerBase
   * @see org.xml.sax.InputSource
   */
*- at Deprecated(since="5")**
**+ at Deprecated(since="1.5")*
  public interface Parser
  {

diff --git 
a/src/java.xml/share/classes/org/xml/sax/helpers/ParserFactory.java 
b/src/java.xml/share/classes/org/xml/sax/helpers/ParserFactory.java
--- a/src/java.xml/share/classes/org/xml/sax/helpers/ParserFactory.java
+++ b/src/java.xml/share/classes/org/xml/sax/helpers/ParserFactory.java
@@ -64,7 +64,7 @@
   * @version 2.0.1 (sax2r2)
   */
  @SuppressWarnings( "deprecation" )
*- at Deprecated(since="5")**
**+ at Deprecated(since="1.5")*
  public class ParserFactory {
      private static SecuritySupport ss = new SecuritySupport();


Thanks,
Joe



More information about the core-libs-dev mailing list