KerML 1.1b1 RTF Avatar
  1. OMG Issue

KERML11 — MULTILINE_NOTE Element Ambiguous Syntax

  • Key: KERML11-105
  • Status: open   Implementation work Blocked
  • Source: Condition-ALPHA ( Alexander Adolf)
  • Summary:

    Clause 8.2.2.2 of the KerML specification defines the syntax for a
    MULTILINE_NOTE element as follows:

    ---------------------------- Begin Quote -----------------------------
    MULTILINE_NOTE =
    '//' COMMENT_TEXT '/'
    ----------------------------- End Quote ------------------------------

    The KerML specification does not contain any examples of multi-line note
    elements, however.

    The SysML specification does provide a single example of a multi-line
    note element in the second code block of its clause 8.4.8.1, near the
    top of page 410:

    ---------------------------- Begin Quote -----------------------------
    //* Effective conjugated features:
    out feature a subsets Base::things;
    in feature b subsets Base::things;
    inout feature c subsets Base::things;
    feature d subsets Items::Item;
    *//
    ----------------------------- End Quote ------------------------------

    In contrast to the Concrete Syntax grammar given in the KerML
    specification, which denotes '*/' (single slash) as the comment closer,
    the example in the SysML specification uses '*//' (double slash) as the
    comment closer.

    It is thus ambiguous which of the two presented variants for closing
    MULTILINE_NOTE elements is the correct one.

  • Reported: KerML 1.0 — Fri, 24 Oct 2025 11:35 GMT
  • Updated: Mon, 27 Oct 2025 18:59 GMT