Macro Language Reference > Macros > Text (Page Level) > ttrevclear
  
ttrevclear
Description
Removes the internal blacklining revision markers associated with a stream. This can apply to a whole stream or selected text.
Syntax
ttrevclear ( source:s ( start:n end:n ( delete:n )? )? )? ( ';' level:n )?
ttrevclear
[no parameter]
Use the current stream in which the cursor is clicked and remove either :
• any internal blacklining revision markers from the stream for the selected text, or
• markers at the current position if no text is selected
If the current stream doesn’t have the cursor focus no markers will be removed.
source
The name of a named stream whose revision marks are to be removed. Use a value of "" to define the stream that has the cursor focus as the source.
start
The character from the source stream at which to start removing internal revision markers. If the value of both start and end is -1, markers will be removed from the entire stream.
end
The character from the source stream at which to stop removing internal revision markers. If the value of both start and end is -1, markers will be removed from the entire stream.
delete
Specify whether to delete any delete marker encountered at the start and/or end of the range of characters:
0
Neither
1
Start
2
End
3
Both
level
The number of the revision level that should be deleted: a positive number specifies the actual level. Four negative numbers can also be used to define a type of level:
>0
Delete the specified level of marker.
-1
Delete marker levels that are visible.
-2
Delete marker levels that would be printed.
-3
During printing delete markers that would be printed, otherwise delete markers that are visible.
-4
Delete all markers (default behaviour).
 
The ; character must be included with the level definition.
A visible marker level is one that has a reference set for at least one of the six slots (delete, para, insert on, insert off, change on, change off) AND is selected in the dialog opened by clicking the Levels button next to the Show Marks on Screen tickbox in the tdrev dialog box.
Additional Information
 
If start and end are the same position ttrevclear will remove a delete marker at that position. If a delete marker does not exist at that position but the position is inside a range, the range will be removed. If the position is the start or end of a range, no markers will be removed.
 
The level parameter is special in that it can be given without having to provide all the parameters before it.
Related Links