--- old/src/java.desktop/share/classes/javax/print/attribute/TextSyntax.java 2017-08-11 15:12:17.000000000 -0700 +++ new/src/java.desktop/share/classes/javax/print/attribute/TextSyntax.java 2017-08-11 15:12:17.000000000 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2000, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2000, 2017, 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 @@ -23,48 +23,50 @@ * questions. */ - package javax.print.attribute; import java.io.Serializable; import java.util.Locale; /** - * Class TextSyntax is an abstract base class providing the common + * Class {@code TextSyntax} is an abstract base class providing the common * implementation of all attributes whose value is a string. The text attribute * includes a locale to indicate the natural language. Thus, a text attribute * always represents a localized string. Once constructed, a text attribute's * value is immutable. * - * @author David Mendenhall - * @author Alan Kaminsky + * @author David Mendenhall + * @author Alan Kaminsky */ public abstract class TextSyntax implements Serializable, Cloneable { + /** + * Use serialVersionUID from JDK 1.4 for interoperability. + */ private static final long serialVersionUID = -8130648736378144102L; /** * String value of this text attribute. + * * @serial */ private String value; /** * Locale of this text attribute. + * * @serial */ private Locale locale; /** - * Constructs a TextAttribute with the specified string and locale. - * - * @param value Text string. - * @param locale Natural language of the text string. null - * is interpreted to mean the default locale for as returned - * by {@code Locale.getDefault()} + * Constructs a {@code TextAttribute} with the specified string and locale. * - * @exception NullPointerException - * (unchecked exception) Thrown if {@code value} is null. + * @param value text string + * @param locale natural language of the text string. {@code null} is + * interpreted to mean the default locale for as returned by + * {@code Locale.getDefault()} + * @throws NullPointerException if {@code value} is {@code null} */ protected TextSyntax(String value, Locale locale) { this.value = verify (value); @@ -87,7 +89,8 @@ /** * Returns this text attribute's text string. - * @return the text string. + * + * @return the text string */ public String getValue() { return value; @@ -95,6 +98,7 @@ /** * Returns this text attribute's text string's natural language (locale). + * * @return the locale */ public Locale getLocale() { @@ -104,7 +108,7 @@ /** * Returns a hashcode for this text attribute. * - * @return A hashcode value for this object. + * @return a hashcode value for this object */ public int hashCode() { return value.hashCode() ^ locale.hashCode(); @@ -113,23 +117,17 @@ /** * Returns whether this text attribute is equivalent to the passed in * object. To be equivalent, all of the following conditions must be true: - *