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
-
Call the fpInit() function.
-
Call the
fpXMLConfig()
function with the following arguments (See KVXMLConfig()):Argument
Parameter
nType
nValue
TRUE
(non-zero)pData
NULL
For example:
(*fpXMLConfig)(pKVXML,
KVCFG_INCLREVISIONMARK
,TRUE
, NULL);The
xmlini
sample program demonstrates this function. See xmlini. -
Call the
fpConvertStream()
orKVXMLConvertFile()
function. See fpConvertStream() or KVXMLConvertFile().