79. remark

[ 'edit' [ S PI_content ]? | 
  'delete' | 'deleteAll' | 
  'previous' | 'next' | 'first' | 'last' ]?

Command acting on remarks.

A remark is simply a processing-instruction having "xxe-remark" as its target. This processing-instruction is typically used to comment changes, for example when reviewing a document. This processing-instruction is nicely rendered using XXE's built-in CSS stylesheet and also, the Compare tool displays such processing-instruction in a manner which stands out from the other parts of the changes it has detected.

edit

If a <?xxe-remark> is explicitly selected or if the caret is contained in a <?xxe-remark>, display a special dialog box —the remark editor— allowing to edit this processing-instruction. Otherwise, display the remark editor in order to create a new remark. This new <?xxe-remark> is inserted before the explicit selection if any, or at caret position otherwise.

If PI_content is specified and is successfully parsed as the content of a <?xxe-remark> processing-instruction, the remark editor dialog box is not displayed and the <?xxe-remark> processing-instruction is directly modified or inserted.

delete

Delete explicitly selected <?xxe-remark>, if any. Otherwise if the caret is contained in a <?xxe-remark>, delete this processing-instruction.

deleteAll

Delete all <?xxe-remark>s.

previous

Select preceding <?xxe-remark> if any.

next

Select following <?xxe-remark> if any.

first

Select first <?xxe-remark> if any.

last

Select last <?xxe-remark> if any.

Examples:

remark
remark edit
remark deleteAll
remark first
remark edit john
2024-05-01T13:28:18Z
TO DO!