--- old/src/java.xml.ws/share/classes/javax/xml/soap/Node.java 2015-07-09 12:13:54.000000000 +0200 +++ new/src/java.xml.ws/share/classes/javax/xml/soap/Node.java 2015-07-09 12:13:53.000000000 +0200 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2004, 2015, 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 @@ -35,19 +35,19 @@ */ public interface Node extends org.w3c.dom.Node { /** - * Returns the value of this node if this is a Text node or the + * Returns the value of this node if this is a {@code Text} node or the * value of the immediate child of this node otherwise. - * If there is an immediate child of this Node that it is a - * Text node then it's value will be returned. If there is - * more than one Text node then the value of the first - * Text Node will be returned. - * Otherwise null is returned. - * - * @return a String with the text of this node if this is a - * Text node or the text contained by the first - * immediate child of this Node object that is a - * Text object if such a child exists; - * null otherwise. + * If there is an immediate child of this {@code Node} that it is a + * {@code Text} node then it's value will be returned. If there is + * more than one {@code Text} node then the value of the first + * {@code Text} Node will be returned. + * Otherwise {@code null} is returned. + * + * @return a {@code String} with the text of this node if this is a + * {@code Text} node or the text contained by the first + * immediate child of this {@code Node} object that is a + * {@code Text} object if such a child exists; + * {@code null} otherwise. */ public String getValue(); @@ -55,24 +55,24 @@ * If this is a Text node then this method will set its value, * otherwise it sets the value of the immediate (Text) child of this node. * The value of the immediate child of this node can be set only if, there is - * one child node and that node is a Text node, or if - * there are no children in which case a child Text node will be + * one child node and that node is a {@code Text} node, or if + * there are no children in which case a child {@code Text} node will be * created. * - * @exception IllegalStateException if the node is not a Text + * @exception IllegalStateException if the node is not a {@code Text} * node and either has more than one child node or has a child - * node that is not a Text node. + * node that is not a {@code Text} node. * * @since 1.6, SAAJ 1.2 */ public void setValue(String value); /** - * Sets the parent of this Node object to the given - * SOAPElement object. + * Sets the parent of this {@code Node} object to the given + * {@code SOAPElement} object. * - * @param parent the SOAPElement object to be set as - * the parent of this Node object + * @param parent the {@code SOAPElement} object to be set as + * the parent of this {@code Node} object * * @exception SOAPException if there is a problem in setting the * parent to the given element @@ -81,13 +81,13 @@ public void setParentElement(SOAPElement parent) throws SOAPException; /** - * Returns the parent element of this Node object. - * This method can throw an UnsupportedOperationException + * Returns the parent element of this {@code Node} object. + * This method can throw an {@code UnsupportedOperationException} * if the tree is not kept in memory. * - * @return the SOAPElement object that is the parent of - * this Node object or null if this - * Node object is root + * @return the {@code SOAPElement} object that is the parent of + * this {@code Node} object or {@code null} if this + * {@code Node} object is root * * @exception UnsupportedOperationException if the whole tree is not * kept in memory @@ -96,18 +96,18 @@ public SOAPElement getParentElement(); /** - * Removes this Node object from the tree. + * Removes this {@code Node} object from the tree. */ public void detachNode(); /** - * Notifies the implementation that this Node + * Notifies the implementation that this {@code Node} * object is no longer being used by the application and that the * implementation is free to reuse this object for nodes that may * be created later. *

- * Calling the method recycleNode implies that the method - * detachNode has been called previously. + * Calling the method {@code recycleNode} implies that the method + * {@code detachNode} has been called previously. */ public void recycleNode();