platform-update-home/doc/working/documentation/user guide.html

Parent Directory Parent Directory | Revision Log Revision Log

Revision 1.5 - (download) (as text) (annotate)
Fri Apr 26 18:41:43 2002 UTC (7 years, 7 months ago) by vlad
Branch: MAIN
Changes since 1.4: +1441 -5520 lines 
*** empty log message ***

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns="http://www.w3.org/TR/REC-html40">
<head>
     
  <meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
     
  <meta name="ProgId" content="Word.Document">
     
  <meta name="Generator" content="Microsoft Word 9">
     
  <meta name="Originator" content="Microsoft Word 9">
     
  <link rel="File-List" href="./user%20guide_files/filelist.xml">
     
  <link rel="Edit-Time-Data" href="./user%20guide_files/editdata.mso">
  <!--[if !mso]>
<style>
v\:* {behavior:url(#default#VML);}
o\:* {behavior:url(#default#VML);}
w\:* {behavior:url(#default#VML);}
.shape {behavior:url(#default#VML);}
</style>
<![endif]--><!--[if gte mso 9]><xml>
 <o:DocumentProperties>
  <o:Author>Labuser</o:Author>
  <o:LastAuthor>Labuser</o:LastAuthor>
  <o:Revision>4</o:Revision>
  <o:TotalTime>40</o:TotalTime>
  <o:Created>2002-04-12T13:24:00Z</o:Created>
  <o:LastSaved>2002-04-26T18:30:00Z</o:LastSaved>
  <o:Pages>37</o:Pages>
  <o:Words>7006</o:Words>
  <o:Characters>39939</o:Characters>
  <o:Company>IBM Canada Ltd.</o:Company>
  <o:Lines>332</o:Lines>
  <o:Paragraphs>79</o:Paragraphs>
  <o:CharactersWithSpaces>49047</o:CharactersWithSpaces>
  <o:Version>9.4402</o:Version>
 </o:DocumentProperties>
</xml><![endif]--><!--[if gte mso 9]><xml>
 <w:WordDocument>
  <w:View>Normal</w:View>
 </w:WordDocument>
</xml><![endif]-->
     
  <style>
<!--
 /* Font Definitions */
@font-face
	{font-family:Wingdings;
	panose-1:5 0 0 0 0 0 0 0 0 0;
	mso-font-charset:2;
	mso-generic-font-family:auto;
	mso-font-pitch:variable;
	mso-font-signature:0 268435456 0 0 -2147483648 0;}
 /* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
	{mso-style-parent:"";
	margin:0in;
	margin-bottom:.0001pt;
	mso-pagination:widow-orphan;
	font-size:12.0pt;
	font-family:"Times New Roman";
	mso-fareast-font-family:"Times New Roman";}
a:link, span.MsoHyperlink
	{color:blue;
	text-decoration:underline;
	text-underline:single;}
a:visited, span.MsoHyperlinkFollowed
	{color:blue;
	text-decoration:underline;
	text-underline:single;}
p
	{font-size:12.0pt;
	font-family:"Times New Roman";
	mso-fareast-font-family:"Times New Roman";}
@page Section1
	{size:8.5in 11.0in;
	margin:1.0in 1.25in 1.0in 1.25in;
	mso-header-margin:.5in;
	mso-footer-margin:.5in;
	mso-paper-source:0;}
div.Section1
	{page:Section1;}
 /* List Definitions */
@list l0
	{mso-list-id:176500654;
	mso-list-type:hybrid;
	mso-list-template-ids:-1610958616 642254348 1802898708 832353870 1508951890 1061685170 -1919385224 2135210068 654506682 1871347928;}
@list l0:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:.5in;
	mso-level-number-position:left;
	text-indent:-.25in;
	mso-ansi-font-size:10.0pt;
	font-family:Symbol;}
@list l1
	{mso-list-id:218640366;
	mso-list-type:hybrid;
	mso-list-template-ids:34625782 1879064160 1004709138 377518572 -120535498 2063753912 -2023747948 -1093910570 1169450864 -892324782;}
@list l1:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:.5in;
	mso-level-number-position:left;
	text-indent:-.25in;
	mso-ansi-font-size:10.0pt;
	font-family:Symbol;}
@list l2
	{mso-list-id:352460617;
	mso-list-type:hybrid;
	mso-list-template-ids:-162135770 1573412640 -1143561686 -1359181440 -1778846596 -675634294 2040702502 -1798133188 1104082008 -1747005554;}
@list l2:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:.5in;
	mso-level-number-position:left;
	text-indent:-.25in;
	mso-ansi-font-size:10.0pt;
	font-family:Symbol;}
@list l3
	{mso-list-id:605431337;
	mso-list-type:hybrid;
	mso-list-template-ids:1882218214 405577580 -2088048828 -620979218 2034551570 -105331346 -1872204942 1960992960 939655452 187189704;}
@list l3:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:.5in;
	mso-level-number-position:left;
	text-indent:-.25in;
	mso-ansi-font-size:10.0pt;
	font-family:Symbol;}
@list l4
	{mso-list-id:616332951;
	mso-list-type:hybrid;
	mso-list-template-ids:-2121503670 -938192272 -326495040 1344303574 -1323801064 876136946 30171346 -155432398 -275235212 964169354;}
@list l4:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:.5in;
	mso-level-number-position:left;
	text-indent:-.25in;
	mso-ansi-font-size:10.0pt;
	font-family:Symbol;}
@list l5
	{mso-list-id:866215456;
	mso-list-type:hybrid;
	mso-list-template-ids:1920229162 1560599570 1041117306 129912886 -1062160960 708860616 27537738 1767956120 355867502 -862035300;}
@list l5:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:.5in;
	mso-level-number-position:left;
	text-indent:-.25in;
	mso-ansi-font-size:10.0pt;
	font-family:Symbol;}
@list l6
	{mso-list-id:1154100461;
	mso-list-type:hybrid;
	mso-list-template-ids:1872510168 -1107939372 1002330802 -109801440 -2066709300 -469189498 -32725494 1094512198 -1131148552 847540354;}
@list l6:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:.5in;
	mso-level-number-position:left;
	text-indent:-.25in;
	mso-ansi-font-size:10.0pt;
	font-family:Symbol;}
@list l7
	{mso-list-id:1187713294;
	mso-list-type:hybrid;
	mso-list-template-ids:-774317378 863262924 94686218 777449778 -1792346184 -177564868 -543274984 570163436 -839747324 154972114;}
@list l7:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:.5in;
	mso-level-number-position:left;
	text-indent:-.25in;
	mso-ansi-font-size:10.0pt;
	font-family:Symbol;}
@list l8
	{mso-list-id:1209759940;
	mso-list-type:hybrid;
	mso-list-template-ids:-1384239484 12115666 -1522996244 1357256764 -57769864 287099324 -498568288 1039707782 -994642542 2043954892;}
@list l8:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:.5in;
	mso-level-number-position:left;
	text-indent:-.25in;
	mso-ansi-font-size:10.0pt;
	font-family:Symbol;}
@list l9
	{mso-list-id:1236814312;
	mso-list-type:hybrid;
	mso-list-template-ids:559448602 -1711787468 1330648572 -883384858 -244786894 -715873546 1211635840 660658588 -744705912 -794755240;}
@list l9:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:.5in;
	mso-level-number-position:left;
	text-indent:-.25in;
	mso-ansi-font-size:10.0pt;
	font-family:Symbol;}
@list l10
	{mso-list-id:1605460185;
	mso-list-type:hybrid;
	mso-list-template-ids:974180206 1133525928 367190754 2067152578 447217748 -831647314 -1073024844 -1079202094 1437874260 1908586386;}
@list l10:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:.5in;
	mso-level-number-position:left;
	text-indent:-.25in;
	mso-ansi-font-size:10.0pt;
	font-family:Symbol;}
@list l11
	{mso-list-id:1744404298;
	mso-list-type:hybrid;
	mso-list-template-ids:-88457190 -1540190154 -408363358 -2044964954 -285425460 -240244494 1407350808 -1877299018 -358864090 -1172158700;}
@list l11:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:.5in;
	mso-level-number-position:left;
	text-indent:-.25in;
	mso-ansi-font-size:10.0pt;
	font-family:Symbol;}
@list l12
	{mso-list-id:1885405565;
	mso-list-type:hybrid;
	mso-list-template-ids:1961771624 327431722 1424228792 1048887018 -866747864 -854166330 1516670514 -1122991992 1998767166 804526810;}
@list l12:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:.5in;
	mso-level-number-position:left;
	text-indent:-.25in;
	mso-ansi-font-size:10.0pt;
	font-family:Symbol;}
@list l13
	{mso-list-id:1904632842;
	mso-list-type:hybrid;
	mso-list-template-ids:1140086398 -1191815874 -1132298448 -1085131794 2014741232 -1565625484 -1997398374 1304058260 250103498 912524370;}
@list l13:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:.5in;
	mso-level-number-position:left;
	text-indent:-.25in;
	mso-ansi-font-size:10.0pt;
	font-family:Symbol;}
@list l14
	{mso-list-id:2046173909;
	mso-list-type:hybrid;
	mso-list-template-ids:540473568 1821304618 -460709142 -1138166102 1599221368 788721296 -1790257806 141168422 -1446980396 2088423136;}
@list l14:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:.5in;
	mso-level-number-position:left;
	text-indent:-.25in;
	mso-ansi-font-size:10.0pt;
	font-family:Symbol;}
ol
	{margin-bottom:0in;}
ul
	{margin-bottom:0in;}
-->
</style> <!--[if gte mso 9]><xml>
 <o:shapedefaults v:ext="edit" spidmax="1027"/>
</xml><![endif]--><!--[if gte mso 9]><xml>
 <o:shapelayout v:ext="edit">
  <o:idmap v:ext="edit" data="1"/>
 </o:shapelayout></xml><![endif]-->
</head>
   <body lang="EN-US" link="blue" vlink="blue" style="tab-interval:.5in">
<div class="Section1">
<h1 align="Center" style="text-align: center; ">Install/Update User Guide</h1>
<p class="MsoNormal"><!--[if !supportEmptyParas]--><!--[endif]--><o:p></o:p></p>
<h2>Getting Started: Install/Update in three steps</h2>
<p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">This 
section will teach you how to install a new Feature and how to revert to a
previous state in three easy steps. Before you start, make sure you installed 
the 'mockup' site following the <a href="http://www.eclipse.org">install mockup
site</a>
  instructions.</p>
<h3>Find new Feature</h3>
<p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">This 
section will focus on finding a feature to install. There are different ways 
of finding a feature. The one we are going to focus in this section is <a href="http://www.eclipse.org">
 browsing a site</a>
 . For more information about other ways of finding a feature, look at the 
<a href="http://www.eclipse.org">Find Features</a>
  section.</p>
<p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">Before 
browsing a site, we will have to create a site bookmark to access it.</p>
<h4>Create a new site bookmark</h4>
<ul type="Disc">
  <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l13 level1 lfo1;tab-stops:list .5in">
 Open the Install/Update      perspective Help-&gt;Update Manager</li>
  <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l13 level1 lfo1;tab-stops:list .5in">
 Select the Updates View.</li>
  <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l13 level1 lfo1;tab-stops:list .5in">
 Open the context menu </li>
  <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l13 level1 lfo1;tab-stops:list .5in">
 Select new-&gt;site bookmark...</li>
  <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l13 level1 lfo1;tab-stops:list .5in">
 In the Site Name entry field      type: Test Site</li>
  <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l13 level1 lfo1;tab-stops:list .5in">
 In the Site Address entry      field type the URL where you installed the 
mockup site. (i.e.      file:c:/eclipse/site)</li>
  <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l13 level1 lfo1;tab-stops:list .5in">
 Click Ok </li>
</ul>
<p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">The 
Site should appear on the view. The provider of a feature should give you 
the URL of their site so you can find their feature. We will now browse the 
site to discover the features.</p>
<h4>Choose Feature</h4>
<p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">You 
can expand the site and the categories to see the Features. In this site you
should see one category:  Red Dot Versions, and two features:  Red Dot Feature
1.0.0 and Red Dot Feature 2.0.0. </p>
<p class="MsoNormal" style="margin-right: 0.5in; margin-left: 1in; text-indent: -0.25in; "><!--[if !supportLists]--><span style="font-size: 10pt; font-family: Symbol; ">
 ·<span style="font-family: &quot;Times New Roman&quot;; font-style: normal; font-variant: normal; font-weight: normal; font-size: 7pt; line-height: normal; font-stretch: normal; font-size-adjust: none; "></span></span><!--[endif]-->
Select Red Dot Feature 1.0.0</p>
<p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">The 
Preview page should now look like the following picture:</p>
<p class="MsoNormal" align="Center" style="text-align: center; "><img border="0" width="678" height="518" id="_x0000_i1025" src="images%5Cpic001.gif" alt="PIC001.gif Preview Page of Red Dot 1.0.0">
</p>
<p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">You 
may want to check the license and copyright or decide to have more information 
about the Feature you are about to install. 'Click' on the appropriate link 
at the bottom of the view to automatically open a browser that will show you
the desired page.</p>
<p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">&lt;TIP 
the preference page lets you decide if you want to view the HTML page within 
the workbench or by launching an external browser&gt;</p>
<h3>Install Feature</h3>
<p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">When 
you are ready to install the feature click on the Install button in the Preview 
View. This will launch the Install Wizard.</p>
<h4>Install Wizard</h4>
<ul type="Disc">
  <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l10 level1 lfo3;tab-stops:list .5in">
 The first page of the Wizard      summarizes the action you are going to 
take. Click Next.</li>
  <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l10 level1 lfo3;tab-stops:list .5in">
 The second page shows the      license you have to accept to install the 
feature. Click next of you      accept the presented license otherwise click 
cancel.</li>
  <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l10 level1 lfo3;tab-stops:list .5in">
 The last page of the Wizard      presents the list of Site you can install 
your feature in. You can create      a new site from this page. For more information
about creating new Site      see:<a href="http://www.eclipse.org">  Site
Location Tab</a>
  .You should      see only one site and it should point to the path where 
the workbench is      installed. Click Finish.</li>
</ul>
<p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">The 
feature will then be downloaded, verified and installed in the site. You can
see the progress monitor showing you the evolution of theses tasks. During 
verification, you may be prompted to accept the verification. Click 'Ok' when
prompted.</p>
<p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">When 
the feature has been installed you will need to restart the workbench for 
the changes to take effect. Click 'Ok' on the dialog box.</p>
<h4>Verify the feature has been installed</h4>
<p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">The 
feature you installed will add a red button icon to the tool bar when activated. 
To activate this specific feature customize your perspective and add the Red
Dot Set Action Set:</p>
<ul type="Disc">
  <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l11 level1 lfo4;tab-stops:list .5in">
 Open the menu Window</li>
  <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l11 level1 lfo4;tab-stops:list .5in">
 Select Customize Perspective</li>
  <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l11 level1 lfo4;tab-stops:list .5in">
 Expand Action Sets</li>
  <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l11 level1 lfo4;tab-stops:list .5in">
 Check Red Dot Set</li>
  <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l11 level1 lfo4;tab-stops:list .5in">
 Click Ok</li>
</ul>
<p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">You 
should now se a red button icon on the toolbar. If you click on it the following 
dialog box should appear, meaning the feature and associated plug-ins have 
been successfully installed and configured.</p>
<p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">We 
will now see how to manage your feature in your configuration.</p>
<h3>Configure Environment</h3>
<p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">A feature
that is installed may be configured or unconfigured for your workspace. A
configured feature means that Install/Update will 'suggests' that the runtime 
configures the feature to be available. An unconfigured feature means that 
Install/Update will make the feature unavailable to the user.</p>
<p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">When 
you installed Red Dot Feature 1.0.0, Install/Update installed and configured 
the feature for you. You can see that in the Configuration History. For more 
information about Configuration History see <a href="http:/ww.eclipse.org">
 Configuration History</a>
 .</p>
<p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">A configuration
is a list of configured and unconfigured features that determine what tool
you can use.<br>
  The current configuration is the configuration currently active.</p>
<p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">For 
more information about configuration, see <a href="http://www.eclipse.org">
 Configuring/Unconfiguring</a>
 .</p>
<p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">In 
this section we will add the current history configuration to the list of 
preserved configuration. We will unconfigure Red Dot 1.0.0, so the feature 
will be unavailable. Then we will restore the preserved configuration, which 
will re-configure the feature.</p>
<h4>Add configuration to preserved</h4>
<p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">To 
add the current configuration, we will first need to find it in the list of
configurations and then add it to the list of preserved configurations. The
current configuration is the configuration in the configuration history folder
with an icon with a running person. It is the last configuration in the list.</p>
<ul type="Disc">
  <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l4 level1 lfo5;tab-stops:list .5in">
 Select the current      configuration.</li>
  <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l4 level1 lfo5;tab-stops:list .5in">
 Open the context menu.</li>
  <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l4 level1 lfo5;tab-stops:list .5in">
 Select Add to preserved.</li>
  <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l4 level1 lfo5;tab-stops:list .5in">
 The configuration now appears      under the Preserved Configurations folder.</li>
</ul>
<h4>Rename configuration</h4>
<p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">We 
will rename the configuration to give it a meaningful name.</p>
<ul type="Disc">
  <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l2 level1 lfo6;tab-stops:list .5in">
 Select the configuration.</li>
  <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l2 level1 lfo6;tab-stops:list .5in">
 Open the context menu and      click Properties.</li>
  <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l2 level1 lfo6;tab-stops:list .5in">
 Change the name of the      configuration to: RedDot 1</li>
  <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l2 level1 lfo6;tab-stops:list .5in">
 Click Ok.</li>
</ul>
<h4>Unconfigure Feature</h4>
<p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">We 
will now unconfigure the feature.</p>
<ul type="Disc">
  <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l0 level1 lfo7;tab-stops:list .5in">
 Expand Current Configuration;</li>
  <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l0 level1 lfo7;tab-stops:list .5in">
 Expand the site</li>
</ul>
<p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "><img border="0" width="202" height="118" id="_x0000_i1026" src="images%5Cpic004.gif" alt="Expand Current Configuration to reveal the configured Feature.">
</p>
<ul type="Disc">
  <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l3 level1 lfo8;tab-stops:list .5in">
 Select Red Dot Feature 1.0.0</li>
  <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l3 level1 lfo8;tab-stops:list .5in">
 In the preview view click      Unconfigure.</li>
  <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l3 level1 lfo8;tab-stops:list .5in">
 When the Dialog opens click      Ok.</li>
</ul>
<p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">The 
workspace will shutdown and restart automatically.</p>
<h3>Restore Configuration</h3>
<p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">We 
shall now restore the configuration we added to preserve, so the feature will
be configured again.</p>
<h4>Verify the Feature is not available</h4>
<p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">You 
should not see the red button icon in the toolbar, meaning the feature was 
not activated</p>
<ul type="Disc">
  <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l14 level1 lfo9;tab-stops:list .5in">
 In the Configuration View,      expand Current Configuration.</li>
  <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l14 level1 lfo9;tab-stops:list .5in">
 Expand the site.</li>
  <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l14 level1 lfo9;tab-stops:list .5in">
 Verify Red Dot Feature 1.0.0      does NOT appear as an icon.</li>
  <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l14 level1 lfo9;tab-stops:list .5in">
 Click on the view toolbar      button 'show unconfigured features'</li>
  <li>Verify Red Dot Feature 1.0.0      does appear</li>
</ul>
<blockquote>
  <div>
  <div><img border="0" width="257" height="117" id="_x0000_i1027" src="file:///c:/oti/source-code/workspace/platform-update-home/doc/working/documentation/images/pic005.gif" alt="Unconfigured feature revealed">
  </div>
  </div>
  </blockquote>
  <blockquote>
    <div align="Left">The icon <img border="0" width="16" height="16" id="_x0000_i1028" src="images%5Cunconf_feature_obj.gif" alt="Unconfigured Feature unconf_feature_obj.gif ">
  means the feature is still installed but not available at this time in
your workspace. To be able to use the feature we will need to configure the
feature.</div>
    </blockquote>
    <h4>Revert to preserved configuration</h4>
    <p class="MsoNormal">            We will now go back to the configuration 
we had previously, in which Red Dot Feature 1.0.0 was configured.</p>
    <ul type="Disc">
      <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l12 level1 lfo10;tab-stops:list .5in">
 Expand Preserved      Configurations</li>
      <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l12 level1 lfo10;tab-stops:list .5in">
 Select RedDot 1</li>
      <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l12 level1 lfo10;tab-stops:list .5in">
 In the preview view click      Restore</li>
      <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l12 level1 lfo10;tab-stops:list .5in">
 When the Dialog opens click      Ok.</li>
    </ul>
    <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
The workspace will shutdown and restart automatically. After the workspace
restart, the feature is configured, based on the revert configuration.</p>
    <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
There are different ways of configuring a feature. To know more about configuring 
and unconfiguring features see: <a href="http://www.eclipse.org">Configuring/Unconfiguring 
features</a>
 .</p>
    <p class="MsoNormal">In this section you learnt how to find a feature
you want to install, how to install a feature, how to unconfigure a feature
and how to restore a preserved configuration. The rest of the book will go
into more details.</p>
    <h2>The User Interface</h2>
    <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
This section describes in details the User Interface of the Install/Update
perspective. The perspective is composed of four different views: The Configuration
View to manage the configurations, the Updates View to manage update sites
and features as well as searches. The Preview View is used to show the details 
of the element selected in the previous two views and the Web View, which 
is used to browse HTML document from either sites or features.</p>
    <h3>The Configuration View</h3>
    <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
The configuration view helps you manage your configurations. A configuration 
is a list of configured and unconfigured features that determine what tool 
are available fro you to use in your workspace. <br>
    </p>
    <blockquote><img border="0" width="251" height="251" id="_x0000_i1029" src="images%5Cpic006.gif" alt="Configuration View">
      </blockquote>
      <h4>Current Configuration</h4>
      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 The current configuration is the configuration currently active. When you 
expand the Current Configuration you can see the sites you are connected to.
Expanding each site reveals the list of Features you have access to. Some
feature may be configured, some may be unconfigured. The configured features 
are the tools the Install/Update suggested the runtime to activate. To know 
more about configured/Unconfigured features see: <a href="http://www.eclipse.org">
 Configured/Unconfigured</a>
 .</p>
      <h4>Configuration History</h4>
      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 The Configuration History folder contains the last <i>n</i> configurations 
you used. <i>n</i> is a number you can set in the Install/Update preference 
page. See: <a href="http://www.eclipse.org">Install/Update Preference Page</a>
 .</p>
      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 You can use the history list to see what are the different activities that 
occurred as well as restoring an old configuration to make it the current 
one.</p>
      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
  Install/Update creates a new configuration history when one or more activities 
are performed (i.e. install, configure, unconfigure etc...). When the Install/Update 
creates a new configuration, it will add it to the list. If you already have 
n configurations, the framework will automatically delete the oldest configuration 
from the list. To know when the Install/Update creates new configuration history
and what are the Activities see:<a href="http://www.eclipse.org">  Configuration
History</a>
 .</p>
      <h4>Preserved Configuration</h4>
      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 The Preserved Configurations folder contains history configurations you
want to keep. The framework does not automatically delete the configurations
in the Preserved Configurations folder; you have to explicitly delete them.</p>
      <h4>Configured/Unconfigured</h4>
      <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 You can decide to see only the configured features or both configured/unconfigured 
features by clicking the 'Show Unconfigured Features' toggle button in the 
view tool bar. To know more about configured/unconfigured features see: <a href="http://www.eclipse.org">
 Configured/Unconfigured</a>
 .</p>
      <h4>Local View Toolbar Actions</h4>
      <h5>Show Unconfigured Feature</h5>
      <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 This button allows you to see only the configured features or both configured 
and unconfigured features. Unconfigured features appear with a red circle 
around the icon. For more information about configuring/unconfiguring features 
see: <a href="http://www.eclipse.org">Configuring/Unconfiguring</a>
 .</p>
      <h4>Context Actions</h4>
      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 This section describes the different context actions available in the Configuration 
View.</p>
      <h5>Go Home</h5>
      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 This action &lt;TODO be consistent with navigator&gt;</p>
      <h5>Go Back</h5>
      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 This action &lt;TODO be consistent with navigator&gt;</p>
      <h5>Go Into</h5>
      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 This action &lt;TODO be consistent with navigator&gt;</p>
      <h5>Show Details</h5>
      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 This action opens or refreshes the Preview View with the details of the
selected element.</p>
      <h5>Properties</h5>
      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 This opens a Dialog box that presents the label of the selected configuration. 
You are able to change the label of a configuration. Click Ok when you have 
finished and you want to preserve your changes or click Cancel if you do not
want to change the properties.</p>
      <h5>Add to Preserved</h5>
      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
  This action adds the selected configuration in the Configuration History 
folder to the list of preserved configuration.</p>
      <h5>Remove from Preserved</h5>
      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 This action removes the selected configuration from the list of preserved 
configurations. This action will not delete any Site, Site Bookmark or Feature. 
This action will not delete the configuration it was created from or any other
configuration.</p>
      <h5>Restore</h5>
      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
  This action creates a new configuration based on the selected configuration 
and marks it as current. Install/Update will automatically configure all the
features that were configured in the selected configuration you want to restore.
To know more about restoring or reverting to a configuration see: <a href="http://www.eclipse.org">
Restore a Configuration/Revert to previous configuration</a>
 .</p>
      <h3>The Updates View</h3>
      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 The Updates view allows you to manage the remote sites you can install from 
to search for features as well as features you can install. <br>
      </p>
      <blockquote><img border="0" width="251" height="249" id="_x0000_i1030" src="images%5Cpic007.gif" alt="Updates View">
        </blockquote>
        <h4>My Computer</h4>
        <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 My Computer lets you browse your computer and any mounted local file to
discover any site on your file system. You can also search My Computer to
discover sites: see <a href="http://www.eclipse.org">Search the file system</a>
 .</p>
        <h4>Places to Visit</h4>
        <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 Places to visit are sites suggested by the features you installed for you 
to visit. </p>
        <h4>Available Updates</h4>
        <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 Available Updates will let you search for updates of already installed features. 
The search occurs in the background so you can still use the workbench while 
searching for updates. To know more about searching: see <a href="http://www.eclipse.org">
 Search</a>
 .</p>
        <h4>Sites Bookmark</h4>
        <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 A site is a location that contains features. In the Updates View, the sites 
contain features you can install. You can browse or search features in Site 
bookmarks. There are two ways of adding a site bookmark. You can use the context
menu and the context action add site bookmarks, or you may browse My Computer
and add a site as a site bookmark. See <a href="http://www.eclipse.org"> Context
Action</a>
  for more details. </p>
        <h4>Search</h4>
        <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 Search is a bookmark for a specific query that will retrieve features from 
update sites. You can create a new specific query based on a template or execute
the query to fetch the features from the desired update sites. You can also
query your local file system. The resulting features appear on the same search
preview than the query. To know more about how to create your own query:
see <a href="http://www.eclipse.org">Context Action [new-&gt;Search]</a>
 . To know how to search the file system: see <a href="http://www.eclipse.org">
 Search the file system</a>
 . To search for available updates: see <a href="http://www.eclipse.org">
Update Already Existing Features</a>
 . To search for new features: see <a href="http://www.eclipse.org">Finding 
New Features</a>
 . To know more about the search Preview View: see <a href="http://www.eclipse.org">
 Search Preview View</a>
 .</p>
        <h4>Folder</h4>
        <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 Folders are placeholders in the Updates View. They are used to help you
categorize and organize the view. Folders can contain folders, update sites
and/or searches. You can change the label of a folder. To know more about
how to create a folder see: <a href="http://www.eclipse.org">Context Action
[new-&gt;folder]</a>
 .</p>
        <h4>Local View Toolbar Actions</h4>
        <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 This section describes the local view toolbar actions of the Updates View.</p>
        <h5>Show Feature Categories </h5>
        <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 When this action is selected, you will see the features organized in categories.<br>
        </p>
        <blockquote><img border="0" width="253" height="193" id="_x0000_i1054" src="images%5Cpic008.gif" alt="Categories">
          <br>
          </blockquote>
          <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
When this action is not selected, you will see all the features as a list.<br>
          </p>
          <blockquote><img border="0" width="253" height="97" id="_x0000_i1032" src="images%5Cpic008b.gif" alt="No Categories">
            </blockquote>
            <h5>Show My Computer Files </h5>
            <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 When this action is selected, you will be able to browse the files when
you expand MyComputer.<br>
            </p>
            <blockquote><img border="0" width="251" height="249" id="_x0000_i1033" src="images%5Cpic009.gif" alt="Browse Files">
              </blockquote>
              <h4>Context Actions</h4>
              <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 This section describes the different context actions available in the Updates 
View. </p>
              <h5>New-&gt;Site Bookmark...</h5>
              <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 Creates a new Site bookmark. This opens a Dialog box that presents the properties 
of the Bookmark Site you want to create. The properties of a Bookmark Site 
are the label you want to see in the View as well as the Address of the physical 
site. You have to enter the Site URL. Optionally you can enter the Site Name. 
If you o not enter a Site Name, it will default to the Site URL. Click Ok 
when you have finished and you want to preserve your changes or click Cancel 
if you do not want to create a new Site Bookmark.</p>
              <h5>New-&gt;Folder</h5>
              <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 This action lets you create a new Folder. When you select this action, a 
dialog will open.<br>
              </p>
              <blockquote>
                <div align="Left"><img border="0" width="438" height="481" id="_x0000_i1034" src="images%5Cpic011.gif" alt="New Folder Dialog">
                <br>
                </div>
                </blockquote>
                <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
Type the label of the folder in the 'Name;' entry field.<br>
  Type the name of the parent folder in the 'Create in:' entry field, or
select  it in the 'Existing folders:' tree view. If no parent is selected,
the newly  created folder will appear in the updates view as a root folder.<br>
                </p>
                <blockquote><img border="0" width="251" height="249" id="_x0000_i1035" src="images%5Cpic010.gif" alt="folders">
                  <img border="0" width="32" height="32" id="_x0000_i1036" src="pic010.gif" alt="folders">
                  </blockquote>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "></p>
                  <h5>New-&gt;Search</h5>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 This action will create a new Search. It will open a dialog window.  Enter 
the name of the search you desire in Name. Select the folder you want the 
Search to appear in by selecting the appropriate folder under the existing 
folders tree or by typing its name in the Create in entry field. Open the 
Category combo box and select the search you want. You can change the category 
of a search after it has been created: see <a href="http://www.eclipse.org">
 Search Preview View</a>
 . Click finish to close the dialog and create the search or click Cancel 
to close the dialog and abort the creation. To know more about the different 
type of search: see <a href="http://www.eclipse.org">Searching New Features</a>
 .</p>
                  <h5>Show Details</h5>
                  <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 This action opens or refreshes the Preview View with the details of the
selected element.</p>
                  <h5>Refresh</h5>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 This action re-initializes the content of an element &lt;TODO see dejan&gt;</p>
                  <h5>Bookmark Location</h5>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 This action lets you create bookmark site for a site found on your local 
file system. This opens a Dialog box that presents the properties of the selected
site. The properties of a Site are the label you want to see in the View
as well as the Address of the site. You are able to change the Site Name.
Click Ok when you have finished and you want to preserve your changes or
click Cancel if you do not want to change the properties.</p>
                  <h5>Properties</h5>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 This action opens a Dialog box that presents the properties of the selected 
site. The properties of a Site are the label you want to see in the View as
well as the Address of the site. If the element you selected was a bookmark, 
you are able to change both the Site Name and the Site Address of the site. 
If you change the Site Address of a Bookmark Site you will need to 'refresh' 
the Bookmark Site to access its new content. Click Ok when you have finished 
and you want to preserve your changes or click Cancel if you do not want to
change the properties.</p>
                  <h5>Delete</h5>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 This action removes the Bookmark Site from the workbench. This does not
erase the content of the Site nor the physical remote or local Site itself.</p>
                  <h3>The WebView</h3>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 The Web View is &lt;TODO &gt;</p>
                  <h3>The flat concept (see Dejan)</h3>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 &lt;TODO&gt;</p>
                  <h3>The Preview View</h3>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 The preview shows information about the selected element. The preview view 
is different for each selected element.</p>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 You can open the preview view by either selecting an element in the updates 
or Configuration view, by opening a context menu on any element in the Updates 
or Configuration View and selecting Show Details or by open the Preview View 
from the Workbench menu. Select Window-&gt;Show View-&gt;Other to open the 
list of available Views. Expand Update Manager Folder, select Preview and 
Click Ok.</p>
                  <h4>The 'Home' Preview view.</h4>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 You can open the 'Home' Preview by clicking on the home in the local tool 
bar menu if the View. This view summarizes the different tasks you can achieve 
through the Install/Update. By using the flat concept you are able to &lt;TODO 
dejan&gt;</p>
                  <p class="MsoNormal" align="Center" style="margin-right: 0.5in; margin-left: 0.5in; text-align: center; "><img border="0" width="507" height="503" id="_x0000_i1037" src="images%5Cpic012.gif" alt="Home Preview">
                  </p>
                  <h4>The current configuration Preview view</h4>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 This Preview shows information about the product you are using. The content 
of the view depends on the product you launched. </p>
                  <p class="MsoNormal" align="Center" style="margin-right: 0.5in; margin-left: 0.5in; text-align: center; "><img border="0" width="507" height="503" id="_x0000_i1038" src="images%5Cpic012b.gif" alt="product preview">
                  </p>
                  <h4>The Site and Site Bookmark Preview View</h4>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 This Preview shows the Site Address of the selected Site or Bookmark Site.</p>
                  <p class="MsoNormal" align="Center" style="margin-right: 0.5in; margin-left: 0.5in; text-align: center; "><img border="0" width="507" height="503" id="_x0000_i1039" src="images%5Cpic012c.gif" alt="Site Preview">
                  </p>
                  <h4>The Feature Preview View</h4>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 This Preview View shows information about a feature.</p>
                  <p class="MsoNormal" align="Center" style="margin-right: 0.5in; margin-left: 0.5in; text-align: center; "><img border="0" width="507" height="669" id="_x0000_i1040" src="images%5Cpic012d.gif" alt="Feature Preview">
                  </p>
                  <h5>Provider</h5>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 The name of the provider of the feature.</p>
                  <h5>Version</h5>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 The version of the feature.</p>
                  <h5>Installed Version</h5>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 The list of already installed version of this feature or 'Not Installed' 
if no version of this feature has been configured in the current configuration.</p>
                  <h5>Download Size</h5>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 The maximum download size for the feature. If the site you will install
the feature in already contains some of the files the feature require, the
files will not be installed twice, and thus the downloaded and installed
size will be smaller than the maximum one.</p>
                  <h5>Supported Platforms</h5>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 This expandable category shows the different supported platforms for this 
feature. The categories are Operating Systems, Windowing Systems, Architectures 
and Languages.</p>
                  <ul type="Disc">
                    <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l9 level1 lfo11;tab-stops:list .5in">
 Operating Systems: the list      of supported Operating Systems.</li>
                    <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l9 level1 lfo11;tab-stops:list .5in">
 Windowing Systems: the list      of supported Windowing Systems.</li>
                    <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l9 level1 lfo11;tab-stops:list .5in">
 Supported Architectures: the      list of supported processor architecture.</li>
                    <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l9 level1 lfo11;tab-stops:list .5in">
 Supported Languages: the      list of supported languages.</li>
                  </ul>
                  <h5>Description </h5>
                  <p class="MsoNormal" style="margin-bottom: 12pt; ">The
description of the Feature</p>
                  <h5>More Info </h5>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 Opens a page with more information about the feature. The page may be found 
locally or remotely.</p>
                  <h5>License</h5>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 Opens a page with the license of the Feature.</p>
                  <h5>Copyright</h5>
                  <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 Opens a page with the copyright of the Feature.</p>
                  <h5>Actions</h5>
                  <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 In the lower left side of the Preview View for a feature you may see one 
or multiple buttons. They provide you with actions you can take on the Feature 
depending of its configuration. If a change is pending for this feature, no
actions will be available until the workbench is restarted.</p>
                  <ul type="Disc">
                    <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l5 level1 lfo12;tab-stops:list .5in">
 Install: this launches the      Install Wizard for this feature. See <a href="http://www.eclipse.org">
 Installing      a Feature</a>
 .</li>
                    <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l5 level1 lfo12;tab-stops:list .5in">
 Unconfigure: this launches      the Unconfigure Wizard for this configured 
feature. See <a href="http://www.eclipse.org">Configuring/Unconfiguring a 
Feature</a>
 .<br>
       Configure: this launches the Configure Wizard for this unconfigured
      feature. See <a href="http://www.eclipse.org">Configuring/Unconfiguring 
a      Feature</a>
 .<br>
       Uninstall: this removes the unconfigure feature from the file system. 
See <a href="http://www.eclipse.org">Removing a Feature</a>
 .</li>
                  </ul>
                  <h4>The Configuration Preview View</h4>
                  <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 This preview shows information about the select configuration.</p>
                  <p class="MsoNormal" align="Center" style="margin-right: 0.5in; margin-left: 0.5in; text-align: center; "><img border="0" width="621" height="488" id="_x0000_i1041" src="images%5Cpic013.gif" alt="Configuration Preview">
                  </p>
                  <p class="MsoNormal"><!--[if !supportEmptyParas]--><!--[endif]--><o:p></o:p></p>
                  <h5>Created On</h5>
                  <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 The date in the current locale, the configuration was created on.</p>
                  <h5>Current Configuration</h5>
                  <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 If the selected configuration is the active configuration.</p>
                  <h5>Activities</h5>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 List of activities that led to the creation of the configuration. For more 
information about the different activities, see <a href="http://www.eclipse.org">
 Activities</a>
 .</p>
                  <h5>Configuration Reversal</h5>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 In the lower left side of the Preview View for a configuration you may see 
one button. It provides you with actions you can take on the Configuration 
depending if it is the current configuration or another one. If a change is
pending for a feature, no actions will be available until the workbench is
restarted.</p>
                  <ul type="Disc">
                    <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l6 level1 lfo13;tab-stops:list .5in">
 Restore: this restores the      selected configuration. See <a href="http://www.eclipse.org">
 Restore a      Configuration/Revert to previous configuration</a>
 .</li>
                    <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l6 level1 lfo13;tab-stops:list .5in">
 Revert: this revert the      current configuration to the previous configuration. 
See <a href="http://www.eclipse.org">Restore a Configuration/Revert to previous
      configuration</a>
 .</li>
                  </ul>
                  <h4>The search Preview View</h4>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 This view allows you to change the search query, enter the appropriate settings 
for the query, set the scope of the search, run the query and see the result 
of the query. The settings are different for each query.</p>
                  <h5>Change the query</h5>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 To change the category of the query, expand Query Settings. Expand the Search 
Category Settings and select the desired search category.</p>
                  <h5>Enter the settings</h5>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 Each category has its own settings. For more information about the different 
settings for a category: see <a href="http://www.eclipse.org">Searching New 
Features</a>
 .</p>
                  <h5>Set the scope</h5>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 To change the scope of the search, expand Scope Settings. You can select 
to search the local file system, the discovery sites in 'places to visit' 
and/or the bookmarked sites you created. When searching the local file system, 
click Settings to select which root folder will be searched.</p>
                  <h5>Run the query</h5>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 Click Search Now to run the query.</p>
                  <h5>See the results</h5>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 The result will appear at the bottom of the View. Select Show Results in 
Extended Form to have more information about the features.</p>
                  <h3>The Install/Update Preference Page</h3>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 You can open the preference page from the Workbench main menu. Click Window-&gt;preferences 
to open the Preference Dialog. Select Install/Update to reveal the Install/Update 
preference Page. In this page, you can modify the number of history configuration 
you want the workbench to manage as well as decide which browser to open.</p>
                  <h4>Maximum number of 'History' configurations entry field.</h4>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 Enter the number of history configurations you want the Install/Update to 
keep. See <a href="http://www.eclipse.org">Configuration History</a>
  for more information.</p>
                  <h4>Web Links radio buttons.</h4>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 When opening Web links. It allows you to choose between opening the internal 
WebView and opening an external browser.</p>
                  <h2>Finding features</h2>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 This section will explain how to find the features to install. There are 
different way of looking for features; you may know exactly which feature 
you need and where it is located, or you may want to search for an update 
of an already installed feature is available, finally you may just decide 
to browse or search to discover new sites and new features. </p>
                  <h3>Find a specific feature </h3>
                  <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 This section will focus on finding a feature when you know exactly where 
to find it. To find a feature you may either add the Update Site that contains 
this feature and browse the site to find the feature, or open the WebView 
and browse to the Feature WebPage.</p>
                  <h4>Add a new Update Site </h4>
                  <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 To add a new Update site, open the context Menu in the Updates View and
select New-&gt;Site Bookmark....  This opens a Dialog box that presents the
properties of the Bookmark Site you want to create. The properties of a Bookmark
Site are the label you want to see in the View as well as the URL of the
physical site. You have to enter the Site URL. Optionally you can enter the
Site Name. If you do not enter a Site Name, it will default to the Site URL.
Click Ok when you have finished and you want to preserve your changes or
click Cancel if you do not want to create a new Site Bookmark.  </p>
                  <h4>Find the feature   </h4>
                  <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 Expand the site to find the feature you want. You can find the feature by 
looking at the label or selecting a feature and reading the preview view. 
To know more about preview view:  See <a href="http://www.eclipse.org">Preview 
View</a>
 .</p>
                  <h4>Browse WebPages </h4>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 Open the <a href="http://www.eclipse.org">WebView</a>
  and enter the URL for the feature web page. Follow the indication of the 
web page. &lt;TODO web install&gt;</p>
                  <h3>Update already existing features</h3>
                  <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 This section will focus on updating features that are configured in your 
current configuration. To know how to configure/unconfigure a feature: see: 
            <a href="http://www.eclipse.org">Configuring/Unconfiguring</a>
 .</p>
                  <h4>Search for updates</h4>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 To search for available updates, select Available Updates in the Updates 
View. In the preview view, press Search now.  This will search the site the 
configured feature come from for new version the installed and configured 
feature. During the search you will see the progress monitor move, indicating 
the search is in progress. When new version of configured features are found, 
they will appear under the progress monitor.  You can decide to see the result 
in a short form or an extended form by checking the 'Show results in extended 
form' box, under the Scope Settings section in the preview view.</p>
                  <h4>Search the file system</h4>
                  <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 You can decide to search the file system for updates by checking the 'Include 
my computer in the search' box, under the Scope Settings section in the preview 
view. Click on the Settings... button to customize which part of the file 
system you want to search.</p>
                  <h4>Customize Search</h4>
                  <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 You can customize the search for updates by creating a new search. To know 
how to create a new search: see <a href="http://www.eclipse.org">Updates View:
Context Action [new-&gt;search]</a>
 .</p>
                  <h3>Browse to discover</h3>
                  <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 This section will focus on browsing update sites to find the features you 
want to install. The entire update site appears in the Updates View. There 
are different places in the view where you can find sites to browse. You may
have sites in the folder 'Places to visit' or you may have sites on your file
system. You can also add some update site if you know their URL.</p>
                  <h4>Browse already existing sites</h4>
                  <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 If you expand the folder 'Places to visit' you may see some sites. They
were automatically added to the folder by the feature you installed. You
can expand the site and browse the features.</p>
                  <h4>Browse the file system</h4>
                  <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 To browse the file system, expand 'My Computer'.  &lt;TODO what more to
say?&gt;</p>
                  <h4>Add a new Update Site </h4>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 You can add a new update site from the context menu. Select new-&gt;Site 
Bookmark... This opens a Dialog box that presents the properties of the Bookmark 
Site you want to create. The properties of a Bookmark Site are the label you
want to see in the View as well as the Address of the physical site. You
have to enter the Site URL. Optionally you can enter the Site Name. If you
do not enter a Site Name, it will default to the Site URL. Click Ok when you
have finished and you want to preserve your changes or click Cancel if you
do not want to create a new Site Bookmark. Once the site has been created, 
expand the icon to see the categories and or the available features.</p>
                  <h4>Add a bookmark of a file system site.</h4>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 When you browse the file system, you can add a file system site as a bookmark. 
Select the site. Open the context menu. Select  'Bookmark Location'. This 
action lets you create bookmark site for a site found on your local file system.
This opens a Dialog box that presents the properties of the selected site.
The properties of a Site are the label you want to see in the View as well
as the Address of the site. You are able to change the Site Name. Click Ok
when you have finished and you want to preserve your changes or click Cancel
if you do not want to change the properties. Once the site has been created,
expand the icon to see the categories and or the available features.</p>
                  <h3>Searching Features</h3>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 This section will explain how to find features by using the search mechanism. 
It will first focus on finding update of configured features, then it will 
explain how to search the file system, finally it will expose how to customize 
a search by presenting the three default search categories.</p>
                  <h4>Search for updates</h4>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 To search for available updates, select Available Updates in the Updates 
View. In the preview view, press Search now.  This will search the site the 
configured features come from for new versions. During the search you will 
see the progress monitor move, indicating the search is in progress. When 
new version of configured features are found, they will appear under the progress
monitor.  You can decide to see the result in a short form or an extended
form by checking the 'Show results in extended form' box, under the Scope
Settings section in the preview view.</p>
                  <h4>Search the file system</h4>
                  <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 You can decide to search the file system for updates by checking the 'Include 
my computer in the search' box, under the Scope Settings section in the preview 
view. Click on the Settings... button to customize which part of the file 
system you want to search.</p>
                  <h4>Customize Search</h4>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 Three default categories of search are provided: Search for available updates, 
search features based on regular expression and search features that contain 
a specific plugin. You may see other categories. Check the user documentation 
of the features that provide the extra categories to learn more about them.</p>
                  <h5>Available Updates</h5>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 This search attempts to find update of configured features. There are no 
special settings to fill when running this query. The query will find all 
new version of configured features based on the search scope. To know more 
about the scope of the search: see <a href="http://www.eclipse.org">Search 
Preview View</a>
 .</p>
                  <h5>Regular Expression</h5>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 This search attempts to find features based on a simple regular expression 
query. You must change the settings of the query before running it. Select 
the query in the Updates View. In the preview view, expand Query Settings.</p>
                  <ul type="Disc">
                    <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l7 level1 lfo14;tab-stops:list .5in">
 Type the string you want to      search for in the Expression Entry Field.</li>
                    <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l7 level1 lfo14;tab-stops:list .5in">
 Check the check box if you      want the search to be case sensitive. A
case sensitive search will consider      Uppercase and Lowercase character
as different.</li>
                    <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l7 level1 lfo14;tab-stops:list .5in">
 Selection where you want the      search to occur by checking Feature Name, 
Feature Provider and/or Feature      Description.</li>
                  </ul>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 The query will find the features that match the query based on the scope. 
To know more about the scope of the search: see <a href="http://www.eclipse.org">
 Search Preview View</a>
 .</p>
                  <h5>Plug-ins</h5>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 This search attempts to find feature that contain a specific plug-in. You 
must change the settings of the query before running it. Select the query 
in the Updates View. In the preview view, expand Query Settings.</p>
                  <ul type="Disc">
                    <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     mso-list:l8 level1 lfo15;tab-stops:list .5in">
 Click New to add a specific plug-in.      &lt;TODO doesn't work in 0423&gt;</li>
                  </ul>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 The query will find the features that match the query based on the scope. 
To know more about the scope of the search: see <a href="http://www.eclipse.org">
 Search Preview View</a>
 .</p>
                  <h2>Installing a Feature</h2>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 This section will describe the Wizard used to install, configure, unconfigure 
and remove a feature as well as the verification task that may occur when 
installing a new feature. The first part will focus on the three tab that 
are part of the Wizard, while the second part will deal with verification 
and security issues when installing a feature.</p>
                  <h3>Install Wizard</h3>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 The Wizard will help you install, configure, unconfigure and remove a feature. 
It will allow you to review any license agreement and to choose the Site in
which you wish to install the feature.</p>
                  <h4>The Preview Tab</h4>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 This tab summarizes the action you are going to take. </p>
                  <div align="Center">
                  <p class="MsoNormal"><img border="0" width="500" height="500" id="_x0000_i1042" src="images%5Cpic002.gif" alt="Install Wizard Preview Tab PIC002.gif">
                  </p>
                  </div>
                  <h4> The License Tab</h4>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 This tab will present you the license you have to agree with to install
the product. Click on agree if you agree with the whole license and whish
to continue or click cancel to abort the installation</p>
                  <h4>Site location Tab</h4>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 This tab has three main goals. The first one is to show you the available 
sites on your local file system, the second is the ability to create a new 
site if the one proposed are not satisfactory, finally you will be able to 
see the space left on the selected site and the size in kilobyte of the feature 
you are about to install.</p>
                  <h4>Verification </h4>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 Verification is an important part of the install process. It will allow
you to verify if the feature you are about to install has been digitally
signed, not digitally signed or tempered with. When a feature or a file has
been digitally signed, you will be able to see the certificate used to sign
the feature. A certificate will contain information about the entity that
signed the feature, and information about the entity that authenticated the
first entity. If the entity authenticated itself, you will only see one entity.</p>
                  <h5>Signed</h5>
                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 A dialog with the following will appear if the feature or one of its files 
has been signed. A signed feature means the signer has digitally signed the 
file, and the authenticator has authenticated the signer.</p>
                  <blockquote>
                    <p class="MsoNormal"><img border="0" width="251" height="85" id="_x0000_i1043" src="images%5Cpic018.gif" alt="Signed Feature">
                    </p>
                    </blockquote>
                    <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
  The authenticator can be the same entity as the signer, in which case you 
will see such a dialog. You have to be very careful with self-signed certificate, 
as the authentication of the signer cannot be verified.</p>
                    <blockquote>
                      <p class="MsoNormal"><img border="0" width="600" height="189" id="_x0000_i1044" src="images%5Cpic019.gif" alt="Self Sigend Certificate">
                      </p>
                      </blockquote>
                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 In some cases, the authenticator is a different entity than the signer.<br>
  If you do not authorize the authenticator, you will see such a dialog.
You have to be very careful with signed certificate you didn't authorize,
as the authenticator of the certificate is not one of the worldwide known
authenticator.</p>
                      <blockquote>
                        <p class="MsoNormal"><img border="0" width="600" height="234" id="_x0000_i1045" src="images%5Cpic020.gif" alt="Root not trusted">
                        </p>
                        </blockquote>
                        <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 If the signature of the authenticator has been authorized before, you will 
see such a dialog &lt;PICTURE&gt;. You have to be careful with signed certificate 
you authorized, as the authenticator of the certificate only validates that 
the signer has been authenticated. It does not provide any guarantee as to 
the feature you are going to install. Only install if you trust the signer.</p>
                        <blockquote>
                          <p class="MsoNormal"><img border="0" width="600" height="265" id="_x0000_i1046" src="images%5Cpic021.gif" alt="Root Trusted">
                          </p>
                          </blockquote>
                          <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 Click continue or install only if you trust the signer of the feature file 
and you want to install the feature, or click cancel if you want to abort 
the installation.<br>
                          <br>
  To learn more about how to authorize an authenticator: see <a href="http://www.eclipse.org">
 Security and Keystore Management</a>
 .</p>
                          <h5>Non Signed</h5>
                          <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 A dialog like the following will appear if the feature or one of its files 
has not been signed.</p>
                          <blockquote>
                            <p class="MsoNormal"><img border="0" width="289" height="84" id="_x0000_i1047" src="images%5Cpic016.gif" alt="Non Signed Feature">
                            </p>
                            </blockquote>
                            <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 When a feature has not been signed, we cannot authenticate the sender of 
the package, nor can we certify the validity of any of the file. Click continue 
or install only if you want to install the feature, or click cancel if you 
want to abort the installation.</p>
                            <h5>Corrupted </h5>
                            <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 If the content of a feature has changed since it has been signed, you will 
see such a dialog.</p>
                            <blockquote>
                              <p class="MsoNormal"><img border="0" width="599" height="187" id="_x0000_i1048" src="images%5Cpic017.gif" alt="Corrupted Feature">
                              </p>
                              </blockquote>
                              <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 This means the content has been tempered with since the feature has been 
signed. The content of the feature has been changed since it has been packaged. 
You should notify the signer of the package. Install/Update will prevent you
from installing such a feature. Click cancel if you want to abort the installation
and contact the provider of the feature and/or the site. </p>
                              <h5>Persistence of the answer</h5>
                              <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 If click continue or install on a verification dialog, the Install/Update 
component will remember your action and will not prompt you again if one of
the file of the feature is about to show the exact same verification dialog. 
            </p>
                              <h2>Configuring/Unconfiguring a Feature</h2>
                              <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 This section will focus on configuring and unconfiguring the feature you 
can manage in your current configuration. A configuration is a list of configured 
and unconfigured features that determine what tool are available for you to
use in your workspace.  To know more about configuration see: <a href="http://www.eclipse.org">
 Configuration</a>
 .</p>
                              <h3>Checking if a feature is configured or
unconfigured.</h3>
                              <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 Feature you installed appear in the Configuration View. Expand the Current 
Configuration to see the configured sites. Expand the site to see the Features. 
Use the local view toolbar button to switch between configured features and 
all the features. Unconfigured features appear with such icon <img border="0" width="16" height="16" id="_x0000_i1049" src="images%5Cunconf_feature_obj.gif" alt="unconf_feature_obj.gif Unconfigured Feature">
                              </p>
                              <h3>Configure/Unconfigure Wizard</h3>
                              <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 The Wizard will help you configure or unconfigure a feature. </p>
                              <h4>Preview Tab</h4>
                              <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 This tab summarizes the action you are going to take. </p>
                              <div align="Center">
                              <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "><img border="0" width="500" height="500" id="_x0000_i1050" src="images%5Cpic003.gif" alt="PIC003.gif Configure Wizard Preview Tab">
                              </p>
                              </div>
                              <h2>Configuration</h2>
                              <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 A configuration is a list of configured and unconfigured features that determine 
what tool are available for you to use in your workspace. A configuration 
determines what task you can execute. There are three types of configurations: 
the current configuration, the history configuration and the preserved configuration.</p>
                              <h3>Current Configuration</h3>
                              <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 The current configuration is the configuration currently active.</p>
                              <h3>Configuration History or Preserved Configuration</h3>
                              <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 Configuration History are automatically created by the Install/Update as 
a snapshot of your current configuration at a certain time, before an activity 
occurs. Preserved Configuration are configuration in the History Configuration 
you want to persist.</p>
                              <h3>Configuration History</h3>
                              <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 When you install a feature, the install/update component will copy your
current configuration in the history configuration, and then install and
configure the feature in you current configuration. You will end up with
two configurations, one without the feature installed and configured and
one with the feature installed and configured. The install/update will also
copy your current configuration when you install or remove a site, when you
configure or unconfigure a feature or when reconciliation is needed. Each
activity will be recorded in the configuration. For each configuration selected
in the history configuration folder, you can see in the preview view the
list of activities that were executed. See <a href="http://www.eclipse.org">
Activities </a>
 for more information about the different activities.</p>
                              <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 The install/update will keep a certain number of configurations in the configuration 
history folder. After this number has been reached, if a new configuration 
is created, the oldest configuration inside Configuration History folder will
be deleted. </p>
                              <h4>Renaming an history configuration</h4>
                              <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 You can rename any configuration in the Configuration History folder. To 
change the label of a Configuration, select the configuration, open the context 
menu and click Properties. This will open a dialog where you can change the 
label of the selected configuration. Click Ok if you want to save the label 
or click cancel if you do not want to change the label of the configuration.</p>
                              <h4>Revert the current configuration to the
previous configuration</h4>
                              <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 You can revert the current configuration to the previous configuration.
This action behaves like an 'Undo' where you want to go back to the previous
configuration.</p>
                              <h3> Preserved Configuration</h3>
                              <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 Preserved Configurations are configurations of the Configuration History 
folder you want to Preserved because it represents a set of configured features 
for a certain task. (I.e. you may want to enable some features for Enterprise 
Java Bean Development, and have a configuration with some feature for front-end 
development). If you do not preserved a configuration, it will be deleted 
from the file system when the history maximum number is reached: see <a href="http://www.eclipse.org">
 Preference Page</a>
 . You should add to preserved configuration the configuration you want to 
quickly restore.</p>
                              <h4>Add a Configuration in the preserved folder</h4>
                              <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 To add a configuration to the list of preserved configurations, select the 
configuration in the history configuration folder. Open the context menu; 
click 'add to preserved configuration'. </p>
                              <h4>Remove a Configuration in the preserved
folder   </h4>
                              <p style="margin-right: 0.5in; margin-left: 0.5in; ">
To remove a preserved configuration from the list, select the preserved configuration. 
Open the context menu. Click Remove from preserved.</p>
                              <h4>Rename a Preserved Configuration</h4>
                              <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 You can rename any configuration in the Preserved Configurations folder. 
To change the label of a Configuration, select the configuration, open the 
context menu and click Properties. This will open a dialog where you can change
the label of the selected configuration. Click Ok if you want to save the
label or click cancel if you do not want to change the label of the configuration.</p>
                              <p class="MsoNormal"><!--[if !supportEmptyParas]--><!--[endif]--><o:p></o:p></p>
                              <h3>Restore a Configuration/Revert to previous
configuration</h3>
                              <p class="MsoNormal">    &lt;TODO&gt;</p>
                              <p class="MsoNormal"><!--[if !supportEmptyParas]--><!--[endif]--><o:p></o:p></p>
                              <h3>The Activities </h3>
                              <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 Activities are tasks that are part of a configuration. Activities are the 
actions that were taken to create the Configuration. You can see activities 
in the preview view when you select a configuration.<br>
                              </p>
                              <blockquote><img src="images%5Cpic014.gif" alt="activities" width="594" height="151">
                                <br>
                                </blockquote>
                                <h5>Date</h5>
                                <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 The date using the locale format ate which the action took place.</p>
                                <h5>Target</h5>
                                <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 The identifier of the target of the action (see the different type of activities)</p>
                                <h5>Action</h5>
                                <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 The label of the action (see the different types of activities)</p>
                                <h5>Status</h5>
                                <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 The status of the action. Success if the action was successful.</p>
                                <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 There are nine different actions that create an activity in a configuration.</p>
                                <h4>Feature Installed   </h4>
                                <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 When a new feature is installed in a configured site.<br>
  The target in the preview view is the identifier of the installed feature.</p>
                                <h4>Feature Removed</h4>
                                <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 When a new feature is physically removed from a configured site.<br>
  The target in the preview view is the identifier of the removed feature.</p>
                                <h4>Site Installed</h4>
                                <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 When a Site is added to the current configuration.</p>
                                <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 The target in the preview view is the Address of the site</p>
                                <h4>Site Removed</h4>
                                <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 When a Site is removed from the current configuration.</p>
                                <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 The target in the preview view is the Address of the site</p>
                                <h4>Feature Configured</h4>
                                <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 When a new feature is configured in a configured site.<br>
  The target in the preview view is the identifier of the configured feature.</p>
                                <h4>Feature Unconfigured</h4>
                                <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 When a new feature is unconfigured in a configured site.<br>
  The target in the preview view is the identifier of the unconfigured feature.</p>
                                <h4>Revert to Configuration</h4>
                                <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 When the user reverted to a configuration from either the configuration
history or the preserved configuration</p>
                                <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 The target in the preview view is the identifier of the configuration we 
reverted to.</p>
                                <h4>Reconciliation</h4>
                                <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 When the Install/Update detected a changed occurred between the last shutdown 
and this startup.</p>
                                <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 The URL of the file maintaining the overall configuration.</p>
                                <h4>Added to Preserved Configuration</h4>
                                <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 When a configuration was added to the list of preserved configurations.</p>
                                <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 The target in the preview view is the identifier of the configuration added 
to the preserved configurations.</p>
                                <h2>Removing a Feature</h2>
                                <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
 This section explains how to physically remove an unconfigured feature from 
the file system. You can only remove unconfigured features. You know how to
unconfigure a feature see: <a href="http://www.eclipse.org">Configure/Unconfigure 
Features</a>
 .</p>
                                <h3>Remove Wizard</h3>
                                <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 This Wizard will help you uninstall an unconfigured feature.<br>
  To launch the wizard, select an unconfigured feature in your current configuration. 
See <a href="http://www.eclipse.org">Configure/Unconfigure</a>
  a feature to know how to unconfigure a configured feature, and if a feature 
is configured or not.</p>
                                <h4>Preview Tab</h4>
                                <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
 This tab summarizes the action you are going to take.<br>
                                </p>
                                <div align="Center"><img border="0" width="600" height="500" id="_x0000_i1052" src="images%5Cpic015.gif" alt="uninstall wizard">
                                </div>
                                <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "></p>
                                <h2>Troubleshooting</h2>
                                <p class="MsoNormal">    If the workbench
does not start after you installed a new feature.<br>
      The Install/Update views do not show anything.<br>
      I created a Site but nothing shows (verify URL)</p>
                                <h2>Advanced User</h2>
                                <p class="MsoNormal">    Security and keystore
management.</p>
                                </div>
                                </body>
                                </html>