<trackRevisions> (Track Revisions to Document)

This element specifies that applications shall track revisions made to the WordprocessingML document. Revisions are changes to a WordprocessingML document which are recorded such that they can be viewed independently, accepted or removed, and reverted if needed. When revisions are tracked, the resulting WordprocessingML markup in the Revisions subclause of this document describes the necessary syntax.

If this element is omitted, then revisions shall not be generated by changes to the contents of this document.

example: 
<w:document>
  <w:body>
    <w:p>
      <w:r>
        <w:t>Example</w:t>
      </w:r>
    </w:p>
  </w:body>
</w:document>

And the corresponding document settings:

<w:settings>
  <w:trackRevisions w:val="false"/>
  …
</w:settings>

If the word text was added to the end of this document and bolded without revisions tracked, the resulting WordprocessingML would be output as follows:

<w:document>
  <w:body>
    <w:p>
      <w:r>
        <w:t>Example</w:t>
      </w:r>
      <w:r>
        <w:rPr>
          <w:b/>
        </w:rPr>
        <w:t>text</w:t>
      </w:r>
    </w:p>
  </w:body>
</w:document>

And the corresponding document settings:

<w:settings>
  <w:trackRevisions w:val="false"/>
  …
</w:settings>

Finally, assume the same insertion and formatting took place when the <trackRevisions> element's @val attribute was set to on, the resulting WordprocessingML would be output as follows:

<w:document>
  <w:body>
    <w:p>
      <w:r>
        <w:t>Example</w:t>
      </w:r>
      <w:ins … >
        <w:r>
          <w:rPr>
            <w:b/>
            <w:rPrChange … >
              <w:rPr/>
            <w:rPrChange>
          </w:rPr>
          <w:t>text</w:t>
        </w:r>
      </w:ins>
    </w:p>
  </w:body>
</w:document>

And the corresponding document settings:

<w:settings>
  <w:trackRevisions w:val="true"/>
  …
</w:settings>

The <trackRevisions> element's @val attribute was set to true, therefore the changes to the content of the document were inserted using the appropriate annotation elements in the document's WordprocessingML. Specifically, inserting the text Text to the right of the existing text was tracked as a revision with the <ins> element. In addition, applying bold formatting to the text was tracked as a revision with the <rPrChange> element. ]

Parent Elements

<settings> (§2.15.1.78)

Attributes

Description

<val> (On/Off Value)

Specifies a binary value for the property defined by the parent XML element.

A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted.

A value of off, 0, or false specifies that the property shall be explicitly turned off.

<w:… w:val="off"/>

The @val attribute explicitly declares that the property is turned off. ]

The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67).

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_OnOff">
	<attribute name="val" type="ST_OnOff"/>
</complexType>