--- old/src/java.xml.bind/share/classes/javax/xml/bind/JAXBElement.java 2015-09-19 13:15:31.956777002 +0300 +++ new/src/java.xml.bind/share/classes/javax/xml/bind/JAXBElement.java 2015-09-19 13:15:31.820776328 +0300 @@ -35,25 +35,25 @@ * declaration within a schema and the element instance value within an xml document * with the following properties * * - *

The declaredType and scope property are the + *

The {@code declaredType} and {@code scope} property are the * JAXB class binding for the xml type definition. *

* - *

Scope is either {@link GlobalScope} or the Java class representing the + *

{@code Scope} is either {@link GlobalScope} or the Java class representing the * complex type definition containing the schema element declaration. *

* - *

There is a property constraint that if value is null, - * then nil must be true. The converse is not true to enable - * representing a nil element with attribute(s). If nil is true, it is possible - * that value is non-null so it can hold the value of the attributes + *

There is a property constraint that if {@code value} is {@code null}, + * then {@code nil} must be {@code true}. The converse is not true to enable + * representing a nil element with attribute(s). If {@code nil} is true, it is possible + * that {@code value} is non-null so it can hold the value of the attributes * associated with a nil element. *

* @@ -97,7 +97,7 @@ * @param declaredType Java binding of xml element declaration's type * @param scope * Java binding of scope of xml element declaration. - * Passing null is the same as passing GlobalScope.class + * Passing null is the same as passing {@code GlobalScope.class} * @param value * Java instance representing xml element's value. * @see #getScope() @@ -119,7 +119,7 @@ /** * Construct an xml element instance. * - * This is just a convenience method for new JAXBElement(name,declaredType,GlobalScope.class,value) + * This is just a convenience method for {@code new JAXBElement(name,declaredType,GlobalScope.class,value)} */ public JAXBElement(QName name, Class declaredType, T value ) { this(name,declaredType,GlobalScope.class,value); @@ -142,7 +142,7 @@ /** *

Set the content model and attributes of this xml element.

* - *

When this property is set to null, isNil() must by true. + *

When this property is set to {@code null}, {@code isNil()} must by {@code true}. * Details of constraint are described at {@link #isNil()}.

* * @see #isTypeSubstituted() @@ -155,7 +155,7 @@ *

Return the content model and attribute values for this element.

* *

See {@link #isNil()} for a description of a property constraint when - * this value is null

+ * this value is {@code null}

*/ public T getValue() { return value; @@ -165,18 +165,18 @@ * Returns scope of xml element declaration. * * @see #isGlobalScope() - * @return GlobalScope.class if this element is of global scope. + * @return {@code GlobalScope.class} if this element is of global scope. */ public Class getScope() { return scope; } /** - *

Returns true iff this element instance content model + *

Returns {@code true} iff this element instance content model * is nil.

* - *

This property always returns true when {@link #getValue()} is null. - * Note that the converse is not true, when this property is true, + *

This property always returns {@code true} when {@link #getValue()} is null. + * Note that the converse is not true, when this property is {@code true}, * {@link #getValue()} can contain a non-null value for attribute(s). It is * valid for a nil xml element to have attribute(s).

*/