added for the CSDocs Foundation

For CSRelationship subclasses, the Head reflective property is always the dmaProp_CSRoots property (pointing backward from the CSComponent through the CSRelationship to the CSRoot).  The CSRelationship Tail reflective property is always the dmaProp_CSComponents property (pointing forward from the CSRoot through the CSRelationship to the CSComponent).

There are potentially several CSRelationship instances between the same CSRoot DocVersion and CSComponent DocVersion.  The ability to distinguish them is dependent on the existence of additional properties, including the InstanceId-matching properties and other decorations of the CSRelationship subclass.

[This addition is made to all well-known classes]

If this property is not supported, the CSComponent is simply the DocVersion at the Head.   There is no further CSDocs information on how much of and in what way the CSComponent is employed in the compound/structured document via this CSRelationship.

If this property is supported, and it has no value (or the value is the NULL DmaId), then the employment of the CSComponent in the compound/structured document via this CSRelationship is not specific to a rendition of the CSComponent.   It must be assumed that changes anywhere in the CSComponent may impact the portion of the CSRoot that is involved in the relationship.

If this property is supported and it has a non-NULL DmaId value, then a specific rendition of the CSComponent participates in the compound/structured document via this CSRelationship.   The Rendition object involved is the one in the CSComponent's dmaProp_Renditions list property that has the matching InstanceId property value.  If there is no such Rendition, the CSRelationship has been broken.

• Head Content Element Id {dmaProp_HeadContentElementId}

If this property is not supported, the participating element of the CSComponent is determined in accordance with the definition of the Head Rendition Id property.

If this property is supported, the Head Rendition Id property must also be supported.

If this property is supported, and it has no value (or the value is the NULL DmaId), then the employment of the CSComponent in the compound/structured document via this CSRelationship is not specific to a content element of a rendition of the CSComponent.

If this property is supported and it has a non-NULL DmaId value, then so does the Head Rendition Id property.  A specific content element of the CSComponent participates in the compound/structured document via this CSRelationship.   The Content Element object involved is the one in the identified rendition's dmaProp_ContentElements list property that has the matching InstanceId property.  If there is no such Content Element, the CSRelationship has been broken.

• Tail Rendition Id {dmaProp_TailRenditionId}

If this property is not supported, the CSRoot is simply the DocVersion at the Tail.  There is no further CSDocs information on how much of and in what way the CSRoot is related to the CSComponent via this CSRelationship.

If this property is supported, and it has no value (or the value is the NULL DmaId), then the employment of the CSComponent in the compound/structured document via this CSRelationship is not specific to a rendition of the CSComponent.   It must be assumed that any change to the identified CSComponent can impact any and all of the CSRoot participating in this CSRelationship.

If this property is supported and it has a non-NULL DmaId value, then a specific rendition of the CSRoot participates in the CSRelationship with the identified CSComponent..   The Rendition object involved is the one in the CSRoot's dmaProp_Renditions list property that has the matching InstanceId property value.   If there is no such Rendition, the CSRelationship has been broken.

• Tail Content Element Id {dmaProp_TailContentElementId}

If this property is not supported, the participating element of the CSRoot is determined in accordance with the definition of the Tail Rendition Id property.

If this property is supported, the Tail Rendition Id property must also be supported.

If this property is supported, and it has no value (or the value is the NULL DmaId), then the portion of the CSRoot involved in this CSRelationship to the identified CSComponent  is not a specific content element of a rendition of the CSComponent. 

If this property is supported and it has a non-NULL DmaId value, then so does the Tail Rendition Id property and a specific rendition content element of the CSRoot is involved in the CSRelationship to the identified CSComponent.  The Content Element object involved is the one in the identified CSRoot Rendition's dmaProp_ContentElements list property that has the matching InstanceId property.  If there is no such Content Element, the CSRelationship has been broken.