update SmartMDSD Toolchain sources for version 3.11 (#10)

* this Toolchain update v3.11 relates to the SmartSoft API update v1.1

Author: alex-lotz

CHANGELOG

@@ -1,3 +1,12 @@
+SmartMDSD Toolchain v3.11
+	* Updated Welcome Pages (see Help->Welcome)
+	* Updated C++ code geenrators to support updated background infrastructure (SmartSoft API v1.1 and ACE/SmartSoft Kernel v3.2)
+	* Improved build performance for Toolchain Project builds (each recursive dependency is only built once now)
+	* Added support for building ROS Mixedport components as part of the regular Toolchain build process (see also the RleaseNotes)
+	* New experimental Modeling language for specifying non-technical Datasheet properties has been added (this language is yet likely to change and evolve in future releases)
+	* Several internal bugfixes (not directly visible in the UI)
+-- Fr, 30 Nov. 2019
+
 SmartMDSD Toolchain v3.10
 	* Add a Universal Intro specification for the Eclipse Welcome Page (see Help->Welcome)
 	* Add new step-by-step cheatsheets for creating DomainModels, Component, and System projects

ReleaseNotes.md

@@ -2,6 +2,20 @@
 
 This file contains the release notes for the SmartMDSD Toolchain version 3.x. For each release, it provides important information to users to support them in switching from one specific version the previous version. This includes information and instructions how to migrate content from one version to another.
 
+## v3.11
+
+This is a maintainance release mostly motivated by the updated background infrastructure. Most notably, the **SmartSoft Component Developer API** has been updated from version 1.0 to **version 1.1**, and the **ACE/SmartSoft Kernel** has been updated from version 3.1 to **version 3.2**. Therefore the Toolchain's internal C++ code generators have been updated and now generate consistently towards the updated background infrastructure. This also means that if you have not yet updated your current background infrastructure, then you should do so **before** using this new Toolchain update.
+
+As pre-announced in the previous release, the **old UI now has been deactivated** in this release. This means, that **from now on you have to use the new UI** by opening the new Eclipse perspectives introduced in the release v3.9 (see release notes below).
+
+The SmartMDSD Preferences page has been revised (see the menu: **Window -> Preferences -> SmartMDSD**). Here you can now also specify the default **build type Debug/Release** which will be used to either include debug symbols into the binaries (default), or exclude it to reduce the overall footprint. Moreover, here you can select the used **ROS distribution for building ROS mixed port components**. The toolchain initially searches the default location **/opt/ros** and selects the first found distribution. In case you have more than one, here you can change the required distro. The Toolchain build process automatically sets related ROS environment variables as described here (see "4. Building projects inside Eclipse"):
+
+http://wiki.ros.org/IDEs
+
+Please note, the ROS build feature is rather new/experimental and might not yet work in all situations. In case it does not work, as a backup strategy, you can compile the project from within a bash terminal with the ROS setup initiated from .bashrc.
+
+This release also includes a few minor usability improvements. Most notably, recursive build now works from within the Toolchain with a considerable improvement of the overall build performance: each dependency now is only built once (and not multiple times as before). While you still can build projects from a bash terminal if needed, the Toolchain build now is the recommended way.
+
 ## v3.10
 
 This is a minor release, mostly focusing on bugfixing and smaller usability improvements. The biggest change concerns the Plain OPC UA usage which now requires the new **[Open62541CppWrapper library](https://github.com/Servicerobotics-Ulm/Open62541CppWrapper)** to be installed. Moreover, the Welcome page has been extended with new tutorials, links and cheat-sheets (use the menu Help->Welcome, or Help->Cheat sheets...). Finally, a new context menu has been added: when right-clicking on any folder within the SmartMDSD Project Explorer, you now can open this folder directly within a Linux terminal. Other than tha, all the previous major features from the last release v3.9 remain unchanged. Please note, that the old UI (mentioned in v3.9 below) is curretly still active, however, it will be likely removed in one of the next releases, so we encourage using the new UI from now on and to update your projects as described below in the v3.9 section.

org.ecore.metamodels/org.ecore.base/org.ecore.base.basicAttributes.edit/META-INF/MANIFEST.MF

@@ -11,6 +11,8 @@ Bundle-RequiredExecutionEnvironment: JavaSE-1.8
 Export-Package: org.ecore.base.basicAttributes.provider
 Require-Bundle: org.eclipse.core.runtime,
  org.ecore.base.basicAttributes;visibility:=reexport,
- org.eclipse.emf.edit;visibility:=reexport
+ org.eclipse.emf.edit;visibility:=reexport,
+ org.ecore.base.documentation;visibility:=reexport,
+ org.ecore.base.documentation.edit;visibility:=reexport
 Bundle-ActivationPolicy: lazy
 Automatic-Module-Name: org.ecore.base.basicAttributes.edit

org.ecore.metamodels/org.ecore.base/org.ecore.base.basicAttributes.edit/src-gen/org/ecore/base/basicAttributes/provider/AttributeDefinitionItemProvider.java

@@ -14,28 +14,22 @@
 
 import org.eclipse.emf.edit.provider.ComposeableAdapterFactory;
 import org.eclipse.emf.edit.provider.IChildCreationExtender;
-import org.eclipse.emf.edit.provider.IEditingDomainItemProvider;
-import org.eclipse.emf.edit.provider.IItemLabelProvider;
 import org.eclipse.emf.edit.provider.IItemPropertyDescriptor;
-import org.eclipse.emf.edit.provider.IItemPropertySource;
-import org.eclipse.emf.edit.provider.IStructuredItemContentProvider;
-import org.eclipse.emf.edit.provider.ITreeItemContentProvider;
 import org.eclipse.emf.edit.provider.ItemPropertyDescriptor;
-import org.eclipse.emf.edit.provider.ItemProviderAdapter;
 import org.eclipse.emf.edit.provider.ViewerNotification;
 
 import org.ecore.base.basicAttributes.AttributeDefinition;
 import org.ecore.base.basicAttributes.BasicAttributesFactory;
 import org.ecore.base.basicAttributes.BasicAttributesPackage;
+import org.ecore.base.documentation.provider.AbstractDocumentedElementItemProvider;
 
 /**
  * This is the item provider adapter for a {@link org.ecore.base.basicAttributes.AttributeDefinition} object.
  * <!-- begin-user-doc -->
  * <!-- end-user-doc -->
  * @generated
  */
-public class AttributeDefinitionItemProvider extends ItemProviderAdapter implements IEditingDomainItemProvider,
-		IStructuredItemContentProvider, ITreeItemContentProvider, IItemLabelProvider, IItemPropertySource {
+public class AttributeDefinitionItemProvider extends AbstractDocumentedElementItemProvider {
 	/**
 	 * This constructs an instance from a factory and a notifier.
 	 * <!-- begin-user-doc -->

org.ecore.metamodels/org.ecore.base/org.ecore.base.basicAttributes.edit/src-gen/org/ecore/base/basicAttributes/provider/AttributeRefinementItemProvider.java

@@ -14,27 +14,21 @@
 
 import org.eclipse.emf.edit.provider.ComposeableAdapterFactory;
 import org.eclipse.emf.edit.provider.IChildCreationExtender;
-import org.eclipse.emf.edit.provider.IEditingDomainItemProvider;
-import org.eclipse.emf.edit.provider.IItemLabelProvider;
 import org.eclipse.emf.edit.provider.IItemPropertyDescriptor;
-import org.eclipse.emf.edit.provider.IItemPropertySource;
-import org.eclipse.emf.edit.provider.IStructuredItemContentProvider;
-import org.eclipse.emf.edit.provider.ITreeItemContentProvider;
-import org.eclipse.emf.edit.provider.ItemProviderAdapter;
 import org.eclipse.emf.edit.provider.ViewerNotification;
 
 import org.ecore.base.basicAttributes.AttributeRefinement;
 import org.ecore.base.basicAttributes.BasicAttributesFactory;
 import org.ecore.base.basicAttributes.BasicAttributesPackage;
+import org.ecore.base.documentation.provider.AbstractDocumentedElementItemProvider;
 
 /**
  * This is the item provider adapter for a {@link org.ecore.base.basicAttributes.AttributeRefinement} object.
  * <!-- begin-user-doc -->
  * <!-- end-user-doc -->
  * @generated
  */
-public class AttributeRefinementItemProvider extends ItemProviderAdapter implements IEditingDomainItemProvider,
-		IStructuredItemContentProvider, ITreeItemContentProvider, IItemLabelProvider, IItemPropertySource {
+public class AttributeRefinementItemProvider extends AbstractDocumentedElementItemProvider {
 	/**
 	 * This constructs an instance from a factory and a notifier.
 	 * <!-- begin-user-doc -->
@@ -135,7 +129,9 @@ protected boolean shouldComposeCreationImage() {
 	 */
 	@Override
 	public String getText(Object object) {
-		return getString("_UI_AttributeRefinement_type");
+		String label = crop(((AttributeRefinement) object).getDocumentation());
+		return label == null || label.length() == 0 ? getString("_UI_AttributeRefinement_type")
+				: getString("_UI_AttributeRefinement_type") + " " + label;
 	}
 
 	/**

org.ecore.metamodels/org.ecore.base/org.ecore.base.basicAttributes.edit/src-gen/org/ecore/base/basicAttributes/provider/BasicAttributesEditPlugin.java

@@ -5,6 +5,7 @@
 import org.eclipse.emf.common.EMFPlugin;
 
 import org.eclipse.emf.common.util.ResourceLocator;
+import org.ecore.base.documentation.provider.DocumentationEditPlugin;
 
 /**
  * This is the central singleton for the BasicAttributes edit plugin.
@@ -36,7 +37,7 @@ public final class BasicAttributesEditPlugin extends EMFPlugin {
 	 * @generated
 	 */
 	public BasicAttributesEditPlugin() {
-		super(new ResourceLocator[] {});
+		super(new ResourceLocator[] { DocumentationEditPlugin.INSTANCE, });
 	}
 
 	/**

org.ecore.metamodels/org.ecore.base/org.ecore.base.basicAttributes.edit/src-gen/org/ecore/base/basicAttributes/provider/BasicAttributesItemProviderAdapterFactory.java

@@ -395,6 +395,7 @@ public Adapter createEnumerationValueAdapter() {
 	 * <!-- end-user-doc -->
 	 * @generated
 	 */
+	@Override
 	public ComposeableAdapterFactory getRootAdapterFactory() {
 		return parentAdapterFactory == null ? this : parentAdapterFactory.getRootAdapterFactory();
 	}
@@ -405,6 +406,7 @@ public ComposeableAdapterFactory getRootAdapterFactory() {
 	 * <!-- end-user-doc -->
 	 * @generated
 	 */
+	@Override
 	public void setParentAdapterFactory(ComposedAdapterFactory parentAdapterFactory) {
 		this.parentAdapterFactory = parentAdapterFactory;
 	}
@@ -480,6 +482,7 @@ public ResourceLocator getResourceLocator() {
 	 * <!-- end-user-doc -->
 	 * @generated
 	 */
+	@Override
 	public void addListener(INotifyChangedListener notifyChangedListener) {
 		changeNotifier.addListener(notifyChangedListener);
 	}
@@ -490,6 +493,7 @@ public void addListener(INotifyChangedListener notifyChangedListener) {
 	 * <!-- end-user-doc -->
 	 * @generated
 	 */
+	@Override
 	public void removeListener(INotifyChangedListener notifyChangedListener) {
 		changeNotifier.removeListener(notifyChangedListener);
 	}
@@ -500,6 +504,7 @@ public void removeListener(INotifyChangedListener notifyChangedListener) {
 	 * <!-- end-user-doc -->
 	 * @generated
 	 */
+	@Override
 	public void fireNotifyChanged(Notification notification) {
 		changeNotifier.fireNotifyChanged(notification);
 
@@ -514,6 +519,7 @@ public void fireNotifyChanged(Notification notification) {
 	 * <!-- end-user-doc -->
 	 * @generated
 	 */
+	@Override
 	public void dispose() {
 		if (attributeDefinitionItemProvider != null)
 			attributeDefinitionItemProvider.dispose();

org.ecore.metamodels/org.ecore.base/org.ecore.base.basicAttributes/META-INF/MANIFEST.MF

@@ -13,6 +13,7 @@ Export-Package: org.ecore.base.basicAttributes,
 Require-Bundle: org.eclipse.emf.ecore;visibility:=reexport,
  org.eclipse.core.runtime,
  org.eclipse.xtext.xbase.lib,
- org.eclipse.jface
+ org.eclipse.jface,
+ org.ecore.base.documentation;visibility:=reexport
 Bundle-ActivationPolicy: lazy
 Automatic-Module-Name: org.ecore.base.basicAttributes