--- old/src/java.xml.ws/share/classes/javax/xml/soap/SOAPHeaderElement.java 2015-07-08 13:25:16.000000000 +0200 +++ new/src/java.xml.ws/share/classes/javax/xml/soap/SOAPHeaderElement.java 2015-07-08 13:25:15.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 @@ -28,25 +28,25 @@ /** * An object representing the contents in the SOAP header part of the * SOAP envelope. - * The immediate children of a SOAPHeader object can - * be represented only as SOAPHeaderElement objects. + * The immediate children of a {@code SOAPHeader} object can + * be represented only as {@code SOAPHeaderElement} objects. *

- * A SOAPHeaderElement object can have other - * SOAPElement objects as its children. + * A {@code SOAPHeaderElement} object can have other + * {@code SOAPElement} objects as its children. * * @since 1.6 */ public interface SOAPHeaderElement extends SOAPElement { /** - * Sets the actor associated with this SOAPHeaderElement + * Sets the actor associated with this {@code SOAPHeaderElement} * object to the specified actor. The default value of an actor is: - * SOAPConstants.URI_SOAP_ACTOR_NEXT + * {@code SOAPConstants.URI_SOAP_ACTOR_NEXT} *

- * If this SOAPHeaderElement supports SOAP 1.2 then this call is + * If this {@code SOAPHeaderElement} supports SOAP 1.2 then this call is * equivalent to {@link #setRole(String)} * - * @param actorURI a String giving the URI of the actor + * @param actorURI a {@code String} giving the URI of the actor * to set * * @exception IllegalArgumentException if there is a problem in @@ -57,10 +57,10 @@ public void setActor(String actorURI); /** - * Sets the Role associated with this SOAPHeaderElement - * object to the specified Role. + * Sets the {@code Role} associated with this {@code SOAPHeaderElement} + * object to the specified {@code Role}. * - * @param uri - the URI of the Role + * @param uri - the URI of the {@code Role} * * @throws SOAPException if there is an error in setting the role * @@ -73,20 +73,20 @@ /** * Returns the uri of the actor attribute of this - * SOAPHeaderElement. + * {@code SOAPHeaderElement}. *

- * If this SOAPHeaderElement supports SOAP 1.2 then this call is + * If this {@code SOAPHeaderElement} supports SOAP 1.2 then this call is * equivalent to {@link #getRole()} - * @return a String giving the URI of the actor + * @return a {@code String} giving the URI of the actor * @see #setActor */ public String getActor(); /** * Returns the value of the Role attribute of this - * SOAPHeaderElement. + * {@code SOAPHeaderElement}. * - * @return a String giving the URI of the Role + * @return a {@code String} giving the URI of the {@code Role} * * @exception UnsupportedOperationException if this message does not * support the SOAP 1.2 concept of Fault Role. @@ -96,16 +96,16 @@ public String getRole(); /** - * Sets the mustUnderstand attribute for this SOAPHeaderElement + * Sets the mustUnderstand attribute for this {@code SOAPHeaderElement} * object to be either true or false. *

* If the mustUnderstand attribute is on, the actor who receives the - * SOAPHeaderElement must process it correctly. This - * ensures, for example, that if the SOAPHeaderElement + * {@code SOAPHeaderElement} must process it correctly. This + * ensures, for example, that if the {@code SOAPHeaderElement} * object modifies the message, that the message is being modified correctly. * - * @param mustUnderstand true to set the mustUnderstand - * attribute to true; false to set it to false + * @param mustUnderstand {@code true} to set the mustUnderstand + * attribute to true; {@code false} to set it to false * * @exception IllegalArgumentException if there is a problem in * setting the mustUnderstand attribute @@ -116,16 +116,16 @@ /** * Returns the boolean value of the mustUnderstand attribute for this - * SOAPHeaderElement. + * {@code SOAPHeaderElement}. * - * @return true if the mustUnderstand attribute of this - * SOAPHeaderElement object is turned on; false + * @return {@code true} if the mustUnderstand attribute of this + * {@code SOAPHeaderElement} object is turned on; {@code false} * otherwise */ public boolean getMustUnderstand(); /** - * Sets the relay attribute for this SOAPHeaderElement to be + * Sets the relay attribute for this {@code SOAPHeaderElement} to be * either true or false. *

* The SOAP relay attribute is set to true to indicate that the SOAP header @@ -133,7 +133,7 @@ * but not actually process it. This attribute is ignored on header blocks * whose mustUnderstand attribute is set to true or that are targeted at * the ultimate reciever (which is the default). The default value of this - * attribute is false. + * attribute is {@code false}. * * @param relay the new value of the relay attribute * @@ -151,10 +151,10 @@ /** * Returns the boolean value of the relay attribute for this - * SOAPHeaderElement + * {@code SOAPHeaderElement} * - * @return true if the relay attribute is turned on; - * false otherwise + * @return {@code true} if the relay attribute is turned on; + * {@code false} otherwise * * @exception UnsupportedOperationException if this message does not * support the SOAP 1.2 concept of Relay attribute.