From ee760d3c02ab4fbb3be022521dfe742471469fa7 Mon Sep 17 00:00:00 2001 From: HOS Date: Tue, 14 Oct 2025 11:37:01 +0200 Subject: [PATCH 1/9] CorrectUnitName --- Modelica/UsersGuide/ReleaseNotes.mo | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Modelica/UsersGuide/ReleaseNotes.mo b/Modelica/UsersGuide/ReleaseNotes.mo index ac20ac0692..c0a828fc54 100644 --- a/Modelica/UsersGuide/ReleaseNotes.mo +++ b/Modelica/UsersGuide/ReleaseNotes.mo @@ -112,7 +112,7 @@ more of the following changes. ")); end VersionManagement; From 44999222628cffc487873b42beafcec67843d93a Mon Sep 17 00:00:00 2001 From: HOS Date: Tue, 14 Oct 2025 11:49:40 +0200 Subject: [PATCH 3/9] MinorAndMajorAndUser --- Modelica/UsersGuide/ReleaseNotes.mo | 33 +++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/Modelica/UsersGuide/ReleaseNotes.mo b/Modelica/UsersGuide/ReleaseNotes.mo index d8e6f7971a..b6a7f03e80 100644 --- a/Modelica/UsersGuide/ReleaseNotes.mo +++ b/Modelica/UsersGuide/ReleaseNotes.mo @@ -124,6 +124,39 @@ more of the following changes. because a user might already extend from this class and already using the same name.
  • The changes should not significantly degrade performance.
    • +

    +As a recommendation, a minor version may in addition contain one or more of the following changes. +

    + + +

    +Note that many of these changes may break backwards compatibility in very rare cases. +

    +The user perspective is that user can rely on this library to be backwards compatible for bug fixes versions and practically backwards compatible for minor versions. +And that new major versions will provide conversion scripts. +Provided you don't rely on any of the following: +

    + ")); end VersionManagement; From bcbf77e241922f13c0e082a14c0271784c5420df Mon Sep 17 00:00:00 2001 From: HOS Date: Tue, 14 Oct 2025 11:54:11 +0200 Subject: [PATCH 4/9] MissingP --- Modelica/UsersGuide/ReleaseNotes.mo | 1 + 1 file changed, 1 insertion(+) diff --git a/Modelica/UsersGuide/ReleaseNotes.mo b/Modelica/UsersGuide/ReleaseNotes.mo index b6a7f03e80..c4d5a8bd5f 100644 --- a/Modelica/UsersGuide/ReleaseNotes.mo +++ b/Modelica/UsersGuide/ReleaseNotes.mo @@ -147,6 +147,7 @@ As a recommendation, a minor version may in addition contain one or more of the

    Note that many of these changes may break backwards compatibility in very rare cases.

    +

    The user perspective is that user can rely on this library to be backwards compatible for bug fixes versions and practically backwards compatible for minor versions. And that new major versions will provide conversion scripts. Provided you don't rely on any of the following: From 3bde8b2f12d460ed4e0364172c2ac1a344eacd4f Mon Sep 17 00:00:00 2001 From: HOS Date: Tue, 14 Oct 2025 12:05:49 +0200 Subject: [PATCH 5/9] StrongInsteadOfB --- Modelica/UsersGuide/ReleaseNotes.mo | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Modelica/UsersGuide/ReleaseNotes.mo b/Modelica/UsersGuide/ReleaseNotes.mo index c4d5a8bd5f..99f7744646 100644 --- a/Modelica/UsersGuide/ReleaseNotes.mo +++ b/Modelica/UsersGuide/ReleaseNotes.mo @@ -150,7 +150,7 @@ Note that many of these changes may break backwards compatibility in very rare c

    The user perspective is that user can rely on this library to be backwards compatible for bug fixes versions and practically backwards compatible for minor versions. And that new major versions will provide conversion scripts. -Provided you don't rely on any of the following: +Provided you don't rely on any of the following:

    • Models that are marked as Example or documentation models. From efe57f8ac30843cc2d7ba7f2afdcc6a88482cbcc Mon Sep 17 00:00:00 2001 From: HOS Date: Tue, 14 Oct 2025 12:12:19 +0200 Subject: [PATCH 6/9] AddImportRestriction --- Modelica/UsersGuide/ReleaseNotes.mo | 1 + 1 file changed, 1 insertion(+) diff --git a/Modelica/UsersGuide/ReleaseNotes.mo b/Modelica/UsersGuide/ReleaseNotes.mo index 99f7744646..39b218b324 100644 --- a/Modelica/UsersGuide/ReleaseNotes.mo +++ b/Modelica/UsersGuide/ReleaseNotes.mo @@ -156,6 +156,7 @@ And that new major versions will provide conversion scripts.
    • Models that are marked as Example or documentation models. You can use them for inspiration and copy the Example, but directly using Example models in user models should be avoided.
    • Combining extending a non-partial class with named elements (either directly or indirectly by using multiple inheritance).
      • +
    • Unqualified import from the library.
    • Clear bugs in the library.
    ")); From 220258a804f1ebee5d4512b3f6859dee92c98231 Mon Sep 17 00:00:00 2001 From: Hans Olsson Date: Tue, 14 Oct 2025 14:34:01 +0200 Subject: [PATCH 7/9] Apply suggestions from code review Co-authored-by: Malte Lenz --- Modelica/UsersGuide/ReleaseNotes.mo | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Modelica/UsersGuide/ReleaseNotes.mo b/Modelica/UsersGuide/ReleaseNotes.mo index 39b218b324..df4f844092 100644 --- a/Modelica/UsersGuide/ReleaseNotes.mo +++ b/Modelica/UsersGuide/ReleaseNotes.mo @@ -148,14 +148,14 @@ As a recommendation, a minor version may in addition contain one or more of the Note that many of these changes may break backwards compatibility in very rare cases.

    -The user perspective is that user can rely on this library to be backwards compatible for bug fixes versions and practically backwards compatible for minor versions. -And that new major versions will provide conversion scripts. +The user perspective is that user can rely on this library to be backwards compatible for bug fix versions and practically backwards compatible for minor versions. +Additionally, they can rely on new major versions providing conversion scripts. Provided you don't rely on any of the following:

    • Models that are marked as Example or documentation models. You can use them for inspiration and copy the Example, but directly using Example models in user models should be avoided.
      • -
    • Combining extending a non-partial class with named elements (either directly or indirectly by using multiple inheritance).
      • +
    • Extending a non-partial class with named elements (either directly or indirectly by using multiple inheritance).
    • Unqualified import from the library.
    • Clear bugs in the library.
    From f6083d8d4b61e83e2f02d03ed6a13c96485e4c7a Mon Sep 17 00:00:00 2001 From: Hans Olsson Date: Fri, 17 Oct 2025 17:23:04 +0200 Subject: [PATCH 8/9] Update Modelica/UsersGuide/ReleaseNotes.mo Co-authored-by: Thomas Beutlich --- Modelica/UsersGuide/ReleaseNotes.mo | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Modelica/UsersGuide/ReleaseNotes.mo b/Modelica/UsersGuide/ReleaseNotes.mo index df4f844092..1b3872d498 100644 --- a/Modelica/UsersGuide/ReleaseNotes.mo +++ b/Modelica/UsersGuide/ReleaseNotes.mo @@ -131,7 +131,7 @@ As a recommendation, a minor version may in addition contain one or more of the
    • Add new classes (in partial packages this may break backwards compatibility, so in those cases only when necessary).
    • Modify Examples (including renaming).
      • -
    • Improving/fixing the documentation.
      • +
    • Improve/fix the documentation.
    • Add new names in the public section of a class (or in any section of a partial class), even if it may break backwards compatibility, but should satisfy:
      • Any new input connector, or connector with annotation mustBeConnected must be conditional and as default not enabled.
        • From 2c98ed1edf12ae0cf9bd35dd1a01d1911bcbcca0 Mon Sep 17 00:00:00 2001 From: HOS Date: Fri, 17 Oct 2025 17:33:17 +0200 Subject: [PATCH 9/9] AddEnumerationAndRecord --- Modelica/UsersGuide/ReleaseNotes.mo | 3 +++ 1 file changed, 3 insertions(+) diff --git a/Modelica/UsersGuide/ReleaseNotes.mo b/Modelica/UsersGuide/ReleaseNotes.mo index 1b3872d498..0e02e322ff 100644 --- a/Modelica/UsersGuide/ReleaseNotes.mo +++ b/Modelica/UsersGuide/ReleaseNotes.mo @@ -138,6 +138,8 @@ As a recommendation, a minor version may in addition contain one or more of the
      • Any new parameter must have a default value.
      • Any new function input must be after existing inputs and have a default value.
      • Any new function output must be after existing outputs.
        • +
      • Any new enumeration member must be after existing ones.
        • +
      • Any new record members should be after existing ones, and have a default value (needed if there are any record constructor calls).
    • Delete/rename names in the protected section of a non-partial class if unlikely to be used.
      • @@ -158,6 +160,7 @@ You can use them for inspiration and copy the Example, but directly using Exampl
    • Extending a non-partial class with named elements (either directly or indirectly by using multiple inheritance).
    • Unqualified import from the library.
    • Clear bugs in the library.
      • +
    • Equivalence between a copy of record or enumeration class and the one in the standard library.
    ")); end VersionManagement;