--- old/src/java.xml.ws/share/classes/javax/xml/soap/Name.java 2015-04-21 17:20:15.120098477 +0400 +++ new/src/java.xml.ws/share/classes/javax/xml/soap/Name.java 2015-04-21 17:20:15.032098477 +0400 @@ -32,52 +32,50 @@ * to get the URI of the namespace. *

* The following is an example of a namespace declaration in an element. - *

- *   <wombat:GetLastTradePrice xmlns:wombat="http://www.wombat.org/trader">
- * 
+ * {@code } * ("xmlns" stands for "XML namespace".) * The following - * shows what the methods in the Name interface will return. + * shows what the methods in the {@code Name} interface will return. * *

* XML namespaces are used to disambiguate SOAP identifiers from * application-specific identifiers. *

- * Name objects are created using the method - * SOAPEnvelope.createName, which has two versions. - * One method creates Name objects with + * {@code Name} objects are created using the method + * {@code SOAPEnvelope.createName}, which has two versions. + * One method creates {@code Name} objects with * a local name, a namespace prefix, and a namespace URI. - * and the second creates Name objects with just a local name. + * and the second creates {@code Name} objects with just a local name. * The following line of - * code, in which se is a SOAPEnvelope object, creates a new - * Name object with all three. + * code, in which se is a {@code SOAPEnvelope} object, creates a new + * {@code Name} object with all three. *

  *     Name name = se.createName("GetLastTradePrice", "WOMBAT",
  *                                "http://www.wombat.org/trader");
  * 
- * The following line of code gives an example of how a Name object - * can be used. The variable element is a SOAPElement object. - * This code creates a new SOAPElement object with the given name and + * The following line of code gives an example of how a {@code Name} object + * can be used. The variable element is a {@code SOAPElement} object. + * This code creates a new {@code SOAPElement} object with the given name and * adds it to element. *
  *     element.addChildElement(name);
  * 
*

- * The Name interface may be deprecated in a future release of SAAJ - * in favor of javax.xml.namespace.QName + * The {@code Name} interface may be deprecated in a future release of SAAJ + * in favor of {@code javax.xml.namespace.QName} * @see SOAPEnvelope#createName(String, String, String) SOAPEnvelope.createName * @see SOAPFactory#createName(String, String, String) SOAPFactory.createName * @since 1.6 */ public interface Name { /** - * Gets the local name part of the XML name that this Name + * Gets the local name part of the XML name that this {@code Name} * object represents. * * @return a string giving the local name @@ -86,16 +84,16 @@ /** * Gets the namespace-qualified name of the XML name that this - * Name object represents. + * {@code Name} object represents. * * @return the namespace-qualified name as a string */ String getQualifiedName(); /** - * Returns the prefix that was specified when this Name object + * Returns the prefix that was specified when this {@code Name} object * was initialized. This prefix is associated with the namespace for the XML - * name that this Name object represents. + * name that this {@code Name} object represents. * * @return the prefix as a string */ @@ -103,7 +101,7 @@ /** * Returns the URI of the namespace for the XML - * name that this Name object represents. + * name that this {@code Name} object represents. * * @return the URI as a string */