17.13.5.18 ins

This element specifies that the inline-level content contained within it shall be treated as inserted content which has been tracked as a revision.

[Example: Consider a paragraph of text in a WordprocessingML document in which one word has been inserted, as follows:

This paragraph has the word text marked inserted as a revision, and is represented as the following WordprocessingML:

<w:p>
  <w:r>
    <w:t>Some</w:t>
  </w:r>
  <w:ins w:id="0" w:author="Joe Smith" w:date="2006-03-31T12:50:00Z">
    <w:r>
      <w:t>text</w:t>
    </w:r>
  </w:ins>
</w:p>

The ins element contains all of the content which must be treated as revision marked as inserted; in this case, the word text was inserted by Joe Smith on March 31, 2006 at 12:50pm. end example]

Attributes

date (Annotation Date)

Specifies the date information for an annotation within a WordprocessingML document. The use of this information is outside of the scope of ISO/IEC 29500.

If this attribute is omitted, then no date information shall be associated with the parent annotation type.

[Example: Consider a comment represented using the following WordprocessingML fragment:

  <… w:id="1" w:date="2006-01-01T10:00:00">
    …
  </…>

The date attribute specifies that the date of the current annotation is January 1st 2006 at 10:00 AM, which can be used as desired. end example]

The possible values for this attribute are defined by the ST_DateTime simple type (17.18.9).

author (Annotation Author)

Specifies the author for an annotation within a WordprocessingML document.

If this attribute is omitted, then no author shall be associated with the parent annotation type.

[Example: Consider a comment represented using the following WordprocessingML fragment:

  <… w:id="1" w:author="Example Author">
    …
  </…>

The author attribute specifies that the author of the current annotation is Example

The possible values for this attribute are defined by the ST_String simple type (22.9.2.13).

id (Annotation Identifier)

Specifies a unique identifier for an annotation within a WordprocessingML document. The restrictions on the id attribute, if any, are defined by the parent XML element.

If this attribute is omitted, then the document is non-conformant.

[Example: Consider an annotation represented using the following WordprocessingML fragment:

  <… w:id="1" … >
    …
  </…>

The id attribute specifies that the ID of the current annotation is 1. This value is used to uniquely identify this annotation within the document content. end example]

The possible values for this attribute are defined by the ST_DecimalNumber simple type (17.18.10).

[Note: The W3C XML Schema definition of this element’s content model (CT_RunTrackChange) is located in A.1. end note]