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

[Roger Riggs]

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
>