Bug 550201 [Passage] provide tutorial "Create Licensed RCP"

bundles/org.eclipse.passage.ldc/META-INF/MANIFEST.MF

@@ -2,9 +2,10 @@ Manifest-Version: 1.0
 Automatic-Module-Name: org.eclipse.passage.ldc
 Bundle-ManifestVersion: 2
 Bundle-SymbolicName: org.eclipse.passage.ldc;singleton:=true
-Bundle-Version: 0.5.0.qualifier
+Bundle-Version: 0.5.100.qualifier
 Bundle-Name: %Bundle-Name
 Bundle-Vendor: %Bundle-Vendor
 Bundle-Copyright: %Bundle-Copyright
 Bundle-RequiredExecutionEnvironment: JavaSE-1.8
-Require-Bundle: org.eclipse.ui.intro;bundle-version="0.0.0"
+Require-Bundle: org.eclipse.ui.intro;bundle-version="0.0.0",
+ org.eclipse.ui.cheatsheets;bundle-version="0.0.0"

bundles/org.eclipse.passage.ldc/OSGI-INF/l10n/bundle.properties

@@ -34,3 +34,4 @@ pluginContent.LicensedE4Product.description=\
 <p>This wizard creates a minimal Eclipse 4.x product with license management support.</p>\
 <p><b>Extensions Used</b></p>\
 <li>org.eclipse.core.runtime.products</li>
+

bundles/org.eclipse.passage.ldc/cheatsheets/rcp3x-composite.xml

@@ -0,0 +1,27 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+	Copyright (c) 2019 ArSysOp and others
+
+	This program and the accompanying materials are made available under the
+	terms of the Eclipse Public License 2.0 which is available at
+	http://www.eclipse.org/legal/epl-2.0.
+
+	SPDX-License-Identifier: EPL-2.0
+
+	Contributors:
+		ArSysOp - initial API and implementation
+-->
+<compositeCheatsheet name="Create an Eclipse 3.x RCP with License Management">
+   <taskGroup kind="set" name="Create an Eclipse 3.x RCP with license management" skip="false">
+      <task kind="cheatsheet" name="Create an RCP" skip="false">
+         <intro>
+            This cheat sheet will demonstrate how to create and run a minimal RCP application with license management support.
+         </intro>
+         <onCompletion>
+            Congratulations!  You just created an RCP application with license management support!
+         </onCompletion>
+         <param name="path" value="tasks/rcp3x-create.xml">
+         </param>
+      </task>
+   </taskGroup>
+</compositeCheatsheet>

bundles/org.eclipse.passage.ldc/cheatsheets/rcp4x-composite.xml

@@ -0,0 +1,27 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+	Copyright (c) 2019 ArSysOp and others
+
+	This program and the accompanying materials are made available under the
+	terms of the Eclipse Public License 2.0 which is available at
+	http://www.eclipse.org/legal/epl-2.0.
+
+	SPDX-License-Identifier: EPL-2.0
+
+	Contributors:
+		ArSysOp - initial API and implementation
+-->
+<compositeCheatsheet name="Create an Eclipse 4.x RCP with License Management">
+   <taskGroup kind="set" name="Create an Eclipse 4.x RCP with license management" skip="false">
+      <task kind="cheatsheet" name="Create an RCP" skip="false">
+         <intro>
+            This cheat sheet will demonstrate how to create and run a minimal RCP application with license management support.
+         </intro>
+         <onCompletion>
+            Congratulations!  You just created an RCP application with license management support!
+         </onCompletion>
+         <param name="path" value="tasks/rcp4x-create.xml">
+         </param>
+      </task>
+   </taskGroup>
+</compositeCheatsheet>

bundles/org.eclipse.passage.ldc/cheatsheets/tasks/rcp3x-create.xml

@@ -0,0 +1,97 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!--
+	Copyright (c) 2019 ArSysOp and others
+
+	This program and the accompanying materials are made available under the
+	terms of the Eclipse Public License 2.0 which is available at
+	http://www.eclipse.org/legal/epl-2.0.
+
+	SPDX-License-Identifier: EPL-2.0
+
+	Contributors:
+		ArSysOp - initial API and implementation
+-->
+<!-- Simple Cheat Sheet -->
+
+<cheatsheet title="Create a plug-in">
+
+   <!-- Introduction -->
+
+   <intro href="/org.eclipse.platform.doc.user/reference/ref-cheatsheets.htm">
+      <description>
+         This cheat sheet will demonstrate how to create and run an
+         RCP application using PDE. 
+         <br/>
+         <br/>
+         To learn more about using cheat sheets, click the help button
+         in the top right corner (?). 
+      </description>
+   </intro>
+
+   <!-- Item -->
+
+   <item title="Open the plug-in development perspective"
+         href="/org.eclipse.pde.doc.user/guide/tools/views/views.htm"
+         dialog="false"
+         skip="false">
+      <description>
+         To open the plug-in development perspective,
+         select <b>Window-&gt;Open Perspective-&gt;Other...</b> 
+         and choose <b>Plug-in Development</b>.
+         <br/>
+         <br/>
+         Alternatively, click the following button to perform the task.
+      </description>
+      <command serialization="org.eclipse.ui.perspectives.showPerspective(org.eclipse.ui.perspectives.showPerspective.perspectiveId=org.eclipse.pde.ui.PDEPerspective)" required="false" translate="" />
+   </item>
+
+   <!-- Item -->
+
+   <item title="Create the plug-in"
+         href="/org.eclipse.pde.doc.user/guide/tools/project_wizards/new_plugin_project.htm"
+         dialog="true"
+         skip="false">
+      <description>
+         To create the plug-in, perform the following steps:
+      </description>
+      <subitem label="Select &quot;File-&gt;New-&gt;Project...&quot; from the main menu, expand the &quot;Plug-in Development&quot; category within the resulting &quot;New Project&quot; dialog box, and choose &quot;Plug-in Project&quot;" 
+               skip="false">
+         <command serialization="org.eclipse.ui.newWizard(newWizardId=org.eclipse.pde.ui.NewProjectWizard)" required="false" translate="" />
+      </subitem>
+      <subitem label="Input &quot;com.example.rcpapp&quot; into the &quot;Project Name&quot; text box on the &quot;Plug-in Project&quot; page and click &quot;Next &gt;&quot;" 
+               skip="false"/>
+      <subitem label="Select the &quot;Yes&quot; radio button under the &quot;Rich Client Application&quot; heading on the &quot;Plug-in Content&quot; page and click &quot;Next &gt;&quot;" 
+               skip="false"/>
+      <subitem label="Select the &quot;Licensed RCP 3.x (minimal)&quot; template from the list of &quot;Available Templates&quot; and click &quot;Finish&quot;" 
+               skip="false"/>
+   </item>
+
+   <!-- Item -->
+
+   <item title="Run the RCP Application"
+         dialog="false"
+         href="/org.eclipse.pde.doc.user/guide/tools/launchers/eclipse_application_launcher.htm"
+         skip="false">
+      <description>
+         To run the RCP application,
+         perform the following steps:
+      </description>
+      <subitem label="Select the &quot;com.example.rcpapp&quot; plug-in editor from the workbench and select the &quot;Overview&quot; tab within it" 
+               skip="false">
+         <command serialization="org.eclipse.ui.navigate.openResource(filePath=/com.example.rcpapp/META-INF/MANIFEST.MF)" required="false" translate="" />
+      </subitem>               
+      <subitem label="Click the &quot;Launch an Eclipse application&quot; hyperlink under the &quot;Testing&quot; heading" 
+               skip="false"/>
+      <subitem label="Verify that you see a blocking window with an information regarding licensing" 
+               skip="false"/>
+      <subitem label="Exit the RCP application" 
+               skip="false"/>
+   </item>
+
+   <!-- Item -->
+
+
+   <!-- Item -->
+
+
+</cheatsheet>

bundles/org.eclipse.passage.ldc/cheatsheets/tasks/rcp4x-create.xml

@@ -0,0 +1,97 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!--
+	Copyright (c) 2019 ArSysOp and others
+
+	This program and the accompanying materials are made available under the
+	terms of the Eclipse Public License 2.0 which is available at
+	http://www.eclipse.org/legal/epl-2.0.
+
+	SPDX-License-Identifier: EPL-2.0
+
+	Contributors:
+		ArSysOp - initial API and implementation
+-->
+<!-- Simple Cheat Sheet -->
+
+<cheatsheet title="Create a plug-in">
+
+   <!-- Introduction -->
+
+   <intro href="/org.eclipse.platform.doc.user/reference/ref-cheatsheets.htm">
+      <description>
+         This cheat sheet will demonstrate how to create and run an
+         RCP application using PDE. 
+         <br/>
+         <br/>
+         To learn more about using cheat sheets, click the help button
+         in the top right corner (?). 
+      </description>
+   </intro>
+
+   <!-- Item -->
+
+   <item title="Open the plug-in development perspective"
+         href="/org.eclipse.pde.doc.user/guide/tools/views/views.htm"
+         dialog="false"
+         skip="false">
+      <description>
+         To open the plug-in development perspective,
+         select <b>Window-&gt;Open Perspective-&gt;Other...</b> 
+         and choose <b>Plug-in Development</b>.
+         <br/>
+         <br/>
+         Alternatively, click the following button to perform the task.
+      </description>
+      <command serialization="org.eclipse.ui.perspectives.showPerspective(org.eclipse.ui.perspectives.showPerspective.perspectiveId=org.eclipse.pde.ui.PDEPerspective)" required="false" translate="" />
+   </item>
+
+   <!-- Item -->
+
+   <item title="Create the plug-in"
+         href="/org.eclipse.pde.doc.user/guide/tools/project_wizards/new_plugin_project.htm"
+         dialog="true"
+         skip="false">
+      <description>
+         To create the plug-in, perform the following steps:
+      </description>
+      <subitem label="Select &quot;File-&gt;New-&gt;Project...&quot; from the main menu, expand the &quot;Plug-in Development&quot; category within the resulting &quot;New Project&quot; dialog box, and choose &quot;Plug-in Project&quot;" 
+               skip="false">
+         <command serialization="org.eclipse.ui.newWizard(newWizardId=org.eclipse.pde.ui.NewProjectWizard)" required="false" translate="" />
+      </subitem>
+      <subitem label="Input &quot;com.example.rcpapp&quot; into the &quot;Project Name&quot; text box on the &quot;Plug-in Project&quot; page and click &quot;Next &gt;&quot;" 
+               skip="false"/>
+      <subitem label="Select the &quot;Yes&quot; radio button under the &quot;Rich Client Application&quot; heading on the &quot;Plug-in Content&quot; page and click &quot;Next &gt;&quot;" 
+               skip="false"/>
+      <subitem label="Select the &quot;Licensed RCP 4.x (minimal)&quot; template from the list of &quot;Available Templates&quot; and click &quot;Finish&quot;" 
+               skip="false"/>
+   </item>
+
+   <!-- Item -->
+
+   <item title="Run the RCP Application"
+         dialog="false"
+         href="/org.eclipse.pde.doc.user/guide/tools/launchers/eclipse_application_launcher.htm"
+         skip="false">
+      <description>
+         To run the RCP application,
+         perform the following steps:
+      </description>
+      <subitem label="Select the &quot;com.example.rcpapp&quot; plug-in editor from the workbench and select the &quot;Overview&quot; tab within it" 
+               skip="false">
+         <command serialization="org.eclipse.ui.navigate.openResource(filePath=/com.example.rcpapp/META-INF/MANIFEST.MF)" required="false" translate="" />
+      </subitem>               
+      <subitem label="Click the &quot;Launch an Eclipse application&quot; hyperlink under the &quot;Testing&quot; heading" 
+               skip="false"/>
+      <subitem label="Verify that you see a blocking window with an information regarding licensing" 
+               skip="false"/>
+      <subitem label="Exit the RCP application" 
+               skip="false"/>
+   </item>
+
+   <!-- Item -->
+
+
+   <!-- Item -->
+
+
+</cheatsheet>

bundles/org.eclipse.passage.ldc/intro/css/tutorials.css

@@ -0,0 +1,14 @@
+/*******************************************************************************
+ * Copyright (c) 2019 ArSysOp
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Eclipse Public License 2.0 which is available at
+ * http://www.eclipse.org/legal/epl-2.0.
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ *
+ * Contributors:
+ *     ArSysOp - initial API and implementation
+ *******************************************************************************/
+a#rcp3x img { background-image : url(../../images/topiclabel/menu_item.png); }
+a#rcp4x img { background-image : url(../../images/topiclabel/menu_item.png); }

bundles/org.eclipse.passage.ldc/intro/css/tutorials.properties

@@ -0,0 +1,12 @@
+###############################################################################
+# Copyright (c) 2019 ArSysOp and others
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0.
+#
+# SPDX-License-Identifier: EPL-2.0
+#
+# Contributors:
+#     ArSysOp - initial API and implementation
+###############################################################################

bundles/org.eclipse.passage.ldc/intro/overviewExtensionContent.xml

@@ -12,13 +12,13 @@
 		ArSysOp - initial API and implementation
 -->
 <introContent>
-	<extensionContent id="org.eclipse.passage.ldc"
+	<extensionContent id="org.eclipse.passage.ldc.overview"
 		name="License Management" alt-style="css/overview.properties"
 		style="css/overview.css" path="overview/@">
-		<group style-id="content-group" id="content-group">
-			<link style-id="content-link" label="License Management"
-				url="http://org.eclipse.ui.intro/openBrowser?url=https://www.eclipse.org/passage"
-				id="passage">
+		<group id="passage" style-id="content-group">
+			<link id="passage" style-id="content-link"
+				label="License Management"
+				url="http://org.eclipse.ui.intro/openBrowser?url=https://www.eclipse.org/passage">
 				<text>Learn about Eclipse Passage - License Management solution</text>
 			</link>
 		</group>

bundles/org.eclipse.passage.ldc/intro/tutorialsExtensionContent.xml

@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!--
+	Copyright (c) 2019 ArSysOp and others
+
+	This program and the accompanying materials are made available under the
+	terms of the Eclipse Public License 2.0 which is available at
+	http://www.eclipse.org/legal/epl-2.0.
+
+	SPDX-License-Identifier: EPL-2.0
+
+	Contributors:
+		ArSysOp - initial API and implementation
+-->
+<introContent>
+	<extensionContent id="org.eclipse.passage.ldc.tutorials"
+		name="License Management" alt-style="css/tutorials.properties"
+		style="css/tutorials.css" path="tutorials/@">
+		<group id="passage" style-id="content-group" label="License Management">
+			<link id="rcp3x" style-id="content-link"
+				label="Create an Eclipse 3.x RCP with license management"
+				url="http://org.eclipse.ui.intro/showStandby?partId=org.eclipse.platform.cheatsheet&amp;input=org.eclipse.passage.ldc.cheatsheets.rcp3x">
+				<text>
+					Learn how to set up license management for an Eclipse 3.x Rich Client Platform (RCP) application
+				</text>
+			</link>
+			<link id="rcp4x" style-id="content-link"
+				label="Create an Eclipse 4.x RCP with license management"
+				url="http://org.eclipse.ui.intro/showStandby?partId=org.eclipse.platform.cheatsheet&amp;input=org.eclipse.passage.ldc.cheatsheets.rcp4x">
+				<text>
+					Learn how to set up license management for an Eclipse 4.x Rich Client Platform (RCP) application
+				</text>
+			</link>
+		</group>
+	</extensionContent>
+</introContent>

bundles/org.eclipse.passage.ldc/plugin.xml

@@ -19,6 +19,37 @@
             configId="org.eclipse.ui.intro.universalConfig"
             content="$nl$/intro/overviewExtensionContent.xml">
       </configExtension>
+      <configExtension
+            configId="org.eclipse.ui.intro.universalConfig"
+            content="$nl$/intro/tutorialsExtensionContent.xml">
+      </configExtension>
+   </extension>
+   <extension
+         point="org.eclipse.ui.cheatsheets.cheatSheetContent">
+      <category
+            id="org.eclipse.passage.ldc.cheatsheets"
+            name="License Management">
+      </category>
+      <cheatsheet
+            category="org.eclipse.passage.ldc.cheatsheets"
+            composite="true"
+            contentFile="$nl$/cheatsheets/rcp3x-composite.xml"
+            id="org.eclipse.passage.ldc.cheatsheets.rcp3x"
+            name="%cheatsheets.rcp3x.name">
+         <description>
+            %cheatsheets.rcp3x.description
+         </description>
+      </cheatsheet>
+      <cheatsheet
+            category="org.eclipse.passage.ldc.cheatsheets"
+            composite="true"
+            contentFile="$nl$/cheatsheets/rcp4x-composite.xml"
+            id="org.eclipse.passage.ldc.cheatsheets.rcp4x"
+            name="%cheatsheets.rcp4x.name">
+         <description>
+            %cheatsheets.rcp4x.description
+         </description>
+      </cheatsheet>
    </extension>
 
 </plugin>