<?xml version="1.0" encoding="UTF-8" ?>

<!-- Simple Cheat Sheet -->

<cheatsheet title="Define a plug-in based product">

   <!-- Introduction -->

   <intro href="/org.eclipse.platform.doc.user/reference/ref-cheatsheets.htm">
      <description>
         This cheat sheet will demonstrate how to define a plug-in based
         product configuration for an RCP application and run an RCP application 
         product 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->Open Perspective->Other... 
         and choose <b>Plug-in Development.
         <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 product configuration"
         href="/org.eclipse.pde.doc.user/guide/tools/file_wizards/new_product_config.htm"
         dialog="true"
         skip="false">
      <description>
         To create the product configuration, perform the following steps:
      </description>
      <subitem label="Select "File->New->Product Configuration" from the main menu" 
               skip="false">
         <command serialization="org.eclipse.ui.newWizard(newWizardId=org.eclipse.pde.ui.NewProductConfigurationWizard)" required="false" translate="" />
      </subitem>
      <subitem label="Select "com.example.rcpapp" in the resulting "New Product Configuration" wizard page" 
               skip="false"/>
      <subitem label="Input "rcpapp.product" into the "File name" text box" 
               skip="false"/>
      <subitem label="Select the "Use a launch configuration" radio button inside the "Initialize the file content" group and click "Finish"" 
               skip="false"/>
   </item>

   <!-- Item -->

   <item title="Open the product editor"
         href="/org.eclipse.pde.doc.user/guide/tools/editors/product_editor/editor.htm"
         dialog="false"
         skip="false">
      <description>
         To open the product editor (if it is not already open),
         expand the <b>com.example.rcpapp tree dialog
         in the <b>Package Explorer view and double-click
         on the <b>rcpapp.product file (the Overview page
         should be open initially).
         <br/>
         <br/>
         Alternatively, click the following button to perform the task.         
      </description>
      <command serialization="org.eclipse.ui.navigate.openResource(filePath=/com.example.rcpapp/rcpapp.product)" required="false" translate="" />
   </item>

   <!-- Item -->

   <item title="Define the product"
         href="/org.eclipse.pde.doc.user/guide/tools/editors/product_editor/overview.htm"
         dialog="true"
         skip="false">
      <description>
         To define the product, perform the following steps:
      </description>
      <subitem label="Input "RCP Application" into the "Product Name" text box" 
               skip="false"/>
      <subitem label="Click the "New..." button next to the "Product ID" drop down menu to open the "New Product Definition" dialog box" 
               skip="false"/>
      <subitem label="Verify "com.example.rcpapp" is the inputted value for the "Defining Plug-in" text box" 
               skip="true"/>        
      <subitem label="Verify "product" is the inputted value for the "Product ID" text box" 
               skip="true"/>        
      <subitem label="Accept the defaults and click "Finish"" 
               skip="false"/>        
      <subitem label="Select "File->Save" from the main menu" 
               skip="false"/> 
   </item>

   <!-- Item -->

   <item title="Synchronize the product configuration with the defining plug-in"
         href="/org.eclipse.pde.doc.user/guide/tools/editors/product_editor/overview.htm"
         dialog="true"
         skip="false">
      <description>
         Product configurations and their constituent files may become
         unsynchronized.  This situation is apparent when changes 
         made using the product editor are not reflected in the application.  
         <br/>
         <br/>
         To synchronize the product configuration with the defining plug-in, 
         click the <b>Synchronize hyperlink under the Testing
         heading on the product editor <b>Overview page.
         <br/>
         <br/>
         Note:  PDE automatically synchronizes the product configuration
         when the <b>Launch an Eclipse Application hyperlinks under the 
         <b>Testing heading are used.
      </description>
   </item>

   <!-- Item -->

   <item title="Run the RCP product"
         dialog="false"
         href="/org.eclipse.pde.doc.user/guide/tools/editors/product_editor/overview.htm"
         skip="false">
      <description>
         To run the RCP product,
         perform the following steps:
      </description>
      <subitem label="Click the "Launch an Eclipse application" hyperlink under the "Testing" heading" 
               skip="false"/>
      <subitem label="Note: "RCP Application" now shows up in the window title bar" 
               skip="true"/>
      <subitem label="Exit the RCP application" 
               skip="false"/>
   </item>

</cheatsheet>