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

[huizhe wang]

Thanks Roger, Joe!

-Joe

On 3/14/2017 6:16 PM, Roger Riggs wrote:
> Looks fine Joe.
>
> On 3/14/17 9:08 PM, huizhe wang wrote:
>> 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
>>
>