A comment is a textual annotation that can be attached to a set of items.
You can create a Comments in the following ways:
• Through the context menu of most items types. When you create a Comment from the context menu of an item, Modeler applies the Comment to the owning item (except when the owning item is the Model or a Package)
• Through the Items tab of an item's Property Pages.
• Through most diagram types. When you create a Comment on a diagram, the Comment is owned by the item that owns the diagram. On a diagram, you can apply a Comment to an item by creating a Note Link between the Comment and the item.
Specify the text of a Comment through its Full Text property, which appears on the Full Text tab of its Property Pages.
Note that Modeler sets the name of a new Comment to 'Comment'. When you specify the text of a Comment through the Full Text property, Modeler sets the name of the Comment to the text of the Full Text property.
You can view which items a Comment applies to in the following ways:
• On a Comment's Property Pages, you can see which items the Comment is applied to through the Items tab – in the Show Associated list, select Annotated Items, and then the items to which the Comment applies are listed.
• A Usage report for a Comment reports which diagrams the Comment appears on and which items the Comment is applied to.
• In the Relationships pane, you can expand a Comment, and then expand the Annotated Items folder.
When shown on a diagram, a Comment's notation is as follows:
In the Modeler panes, a short-cut symbol on the Comment's icon indicates that the item is a
stub.
The following sections provide information about how a Comment is used in the model. For more information about a property, item, model part or diagram, click it.