Core-Spec - Section 4.1:
Change
Create a new instance of a contained DataObject.
to
Create a new instance of a DataObject and attach it to a property.
CoreSpec - Section 4.1.7:
Remove the sentence
Only containment properties may be specified for creation
(towards the end of the first paragraph)
JavaDoc - DataObject.java
Change
/**
* Returns a new {@link DataObject data object} contained by this object using the specified property,
* which must be a {@link Property#isContainment containment property}.
* The type of the created object is the {@link Property#getType declared type} of the specified property.
* @param propertyName the name of the specified containment property.
* @return the created data object.
* @see #createDataObject(String, String, String)
*/
DataObject createDataObject(String propertyName);
To
/**
* Returns a new {@link DataObject data object} as a value of the named property,
* which must be a defined property of the current object’s type.
* The type of the created object is the {@link Property#getType declared type} of the specified property.
* If the property is multi-valued, the new object is added to the end of the list.
* @param propertyName the name of the specified containment property.
* @return the created data object.
* @see #createDataObject(String, String, String)
*/
DataObject createDataObject(String propertyName);
And make the corresponding changes to the other 2 createDataObject methods.
Best Regards,
Ron