doNotTrackFormatting (Do Not Track Formatting Revisions When Tracking Revisions)

This element specifies that applications shall not track revisions made to the formatting of this WordprocessingML document when the trackRevisions element (§2.15.1.90) is turned on.

If this element is omitted, then revisions to formatting shall be generated by changes to the contents of this document when the trackRevisions element is turned on.

[Example: Consider a WordprocessingML document containing the text run Example that shall have revisions tracked. Example WordprocessingML from Document 1 is given below:

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

If the word text was added to the end of this document and bolded, 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>

If changes to formatting were turned off using the following WordprocessingML syntax in the document settings:

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

The same revision (the word text was added to the end of this document and bolded) would result in the following markup:

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

The doNotTrackFormatting element's val attribute was set to true, therefore the changes to the formatting of the document were not tracked as revisions in the document's WordprocessingML. Specifically, applying bold formatting to the text was not tracked as a revision with the rPrChange (§2.13.5.32) element. end example]

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.

[Example: For example, consider the following on/off property:

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

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

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>