Arbortext Command Language > Functions by Alphabetical Listing > change_tracking_find
  
change_tracking_find
oid2 = change_tracking_find(oid1[, offset[, flags]])
 
This function searches for change tracking markup, highlights it and returns the location in oid2. It returns the null oid if no change tracking markup is found.
The first parameter, oid1, is the starting location of the search. If null, the start of the current document is assumed, or the end if searching backward. The second parameter, offset, is the offset from oid1 within the following text. The search does not include the oid1 tag itself, even when the offset is zero.
The third parameter, flags, is a bit mask used to control the search. The possible flag bits are:
0x1 — parent/child
0x2 — reverse
0x4 — no select
0x8 — no message
By default, the search will move forward through the document and highlight any changes found. Wrapping is controlled by the wrapscan set option.
The parent/child bit, if set, causes the search to search the document or to recursively search children for change tracking markup.
The reverse bit reverses the direction of the search.
The no select bit is used to turn off the highlighting.
The no message bit is used so the function will not display a “not found” message. This does not affect the prompt for wrapping which is controlled by the set wrapprompt command.