18

What symbol should I use ?

3 Answers 3

29

Below is an extract from the Unified Modeling Language specification. The complete specification is available at http://www.omg.org/spec/UML/2.3.

9.5.1 Comment

A comment is a textual annotation that can be attached to a set of elements.

Description

A comment gives the ability to attach various remarks to elements. A comment carries no semantic force, but may contain information that is useful to a modeler. A comment may be owned by any element.

Notation

A Comment is shown as a rectangle with the upper right corner bent (this is also known as a “note symbol”). The rectangle contains the body of the Comment. The connection to each annotated element is shown by a separate dashed line.

Presentation Options

The dashed line connecting the note to the annotated element(s) may be suppressed if it is clear from the context, or not important in this diagram.

alt text

2
  • thank you. But I think if there is a symbol which stands for comments in UML, there will be more convenient. Just like "//" in java, then I can write a comment after declaring a property or method.
    – Keating
    Oct 24, 2010 at 13:45
  • 3
    @Keating Wang, perhaps what you want is a Object Constraint Language comment? From omg.org/spec/OCL/2.2 section 7.4.10: "Comments in OCL are written following two successive dashes (minus signs). Everything immediately following the two dashes up to and including the end of line is part of the comment. For example: -- this is a comment"
    – WileCau
    Oct 25, 2010 at 9:04
3

Use --.

...if you are looking to comment the UML source, rather than render a comment in a diagram. As mentioned by WileCau above the reference for this is here: http://www.omg.org/spec/OCL/2.2 and is called an Object Constraint Language comment."

-- This section is about [etc.]
[My Thing] -> (Result)

This doesn't work in all UML renderers though - When I tried in PlantUML for example, it considered this a syntax error.

3

If you looking to add a comment in the UML source, depending on the renderer you can use -- or ' for a single line comment.

For PlantUML comments:

@startuml
' This is a comment on a single line
Bob->Alice : hello
/' You quote alors use slash-and-quote
to split your comments on several
lines '/
@enduml
1
  • 1
    Thanks using the symbol ' helped me on plantuml, -- was not working for me
    – iconer
    Apr 16, 2021 at 18:25

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.