Collapse AllExpand All

6.2. Remark menu

You may need to enable this submenu by checking "Enable the 'Tools|Remark' Submenu" in OptionsPreferences, General|Features section.

What is a remark?

A remark is simply a <?xxe-remark> processing-instruction nicely rendered as a balloon in the styled view.

Figure 3.2. A remark made by use bart and its tooltip.
A remark made by use bart and its tooltip.

This balloon contains the first two letters of the username (login) of the author of the remark.

This balloon is given a random background color, which is specific to the author of the remark. For example, the color of all the remarks created by user bart will always be green, but there is no way for user bart to choose the color of his own remarks.

Hovering the mouse over this balloon displays the contents of the remark in a tooltip.

Double-clicking on this balloon displays the remark editor, a simple dialog box.

The Remark menu

Insert or Edit Remark

If a remark is explicitly selected or if the caret is contained in a remark, display the remark editor in order to edit this remark.

Otherwise display the remark editor in order to create a new remark. The new remark is inserted before the explicit selection if any, or at caret position otherwise.

Delete Remark

Delete explicitly selected remark, if any. Otherwise if the caret is contained in a remark, delete this remark.

Delete All Remarks

Delete all remarks.

Select Preceding Remark

Select preceding remark, if any.

Select Following Remark

Select following remark, if any.