Convert Revision Tracking Information

The revision tracking feature in applications—such as Microsoft Word's Track Changes—marks changes to a document (typically, strikethrough for deleted text and underline for inserted text) and tracks each change by reviewer name and date.

If revision tracking was enabled when changes were made to a document, you can configure Export to convert the deleted text and graphics and include revision tracking information in the XML output. (The deleted content and revision tracking information is excluded from the XML output by default.)

Content that was added to the document is identified by <ins> tags. Content that was deleted from the document is identified by <del> tags.

The <ins> and <del> tags include cite and datetime attributes which define the name of the reviewer who made the change and the date the change was made respectively. (The date is in ISO-8601 format: YYYY-MM-DDThh:mm:ss.) The tags also include a title attribute which allows you to display the author and date information in a browser. These elements are included in the verity.dtd.

The following markup is generated for inserted text:

<ins title="Inserted: JohnD, 2006-04-24Tl4:47:00" cite="mailto:JohnD" datetime="2006-04-24T14:47:00">This text was added</ins> in a previous version.

The following markup is generated for deleted text:

<del title="Deleted: JohnD, 2006-04-24Tl4:56:00" cite="mailto:JohnD" datetime="2006-04-24T14:56:00">This text was deleted</del> in a previous version.

To convert deleted text and graphics and include revision tracking information

  1. Call the fpInit() or fpInitWithLicenseData() function. See fpInit() or fpInitWithLicenseData().

  2. Call the fpXMLConfig() function with the following arguments (See KVXMLConfig()):

    Argument

    Parameter

    nType

    KVCFG_INCLREVISIONMARK

    nValue

    TRUE (non-zero)

    pData

    NULL

    For example:

    (*fpXMLConfig)(pKVXML, KVCFG_INCLREVISIONMARK, TRUE, NULL);

    The xmlini sample program demonstrates this function. See xmlini.

  3. Call the fpConvertStream() or KVXMLConvertFile() function. See fpConvertStream() or KVXMLConvertFile().