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

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.4, Thu Apr 25 12:12:53 2002 UTC revision 1.5, Fri Apr 26 18:41:43 2002 UTC
# Line 10  Line 10 
10    
11    <meta name="Originator" content="Microsoft Word 9">    <meta name="Originator" content="Microsoft Word 9">
12    
13    <link rel="File-List" href="./user%20guide%20structure_files/filelist.xml">    <link rel="File-List" href="./user%20guide_files/filelist.xml">
14         <!--[if gte mso 9]><xml>  
15      <link rel="Edit-Time-Data" href="./user%20guide_files/editdata.mso">
16      <!--[if !mso]>
17    <style>
18    v\:* {behavior:url(#default#VML);}
19    o\:* {behavior:url(#default#VML);}
20    w\:* {behavior:url(#default#VML);}
21    .shape {behavior:url(#default#VML);}
22    </style>
23    <![endif]--><!--[if gte mso 9]><xml>
24   <o:DocumentProperties>   <o:DocumentProperties>
25    <o:Author>Labuser</o:Author>    <o:Author>Labuser</o:Author>
26    <o:LastAuthor>Labuser</o:LastAuthor>    <o:LastAuthor>Labuser</o:LastAuthor>
27    <o:Revision>3</o:Revision>    <o:Revision>4</o:Revision>
28    <o:TotalTime>23</o:TotalTime>    <o:TotalTime>40</o:TotalTime>
29    <o:Created>2002-04-12T13:24:00Z</o:Created>    <o:Created>2002-04-12T13:24:00Z</o:Created>
30    <o:LastSaved>2002-04-13T17:21:00Z</o:LastSaved>    <o:LastSaved>2002-04-26T18:30:00Z</o:LastSaved>
31    <o:Pages>12</o:Pages>    <o:Pages>37</o:Pages>
32    <o:Words>3593</o:Words>    <o:Words>7006</o:Words>
33    <o:Characters>20485</o:Characters>    <o:Characters>39939</o:Characters>
34    <o:Company>IBM Canada Ltd.</o:Company>    <o:Company>IBM Canada Ltd.</o:Company>
35    <o:Lines>170</o:Lines>    <o:Lines>332</o:Lines>
36    <o:Paragraphs>40</o:Paragraphs>    <o:Paragraphs>79</o:Paragraphs>
37    <o:CharactersWithSpaces>25157</o:CharactersWithSpaces>    <o:CharactersWithSpaces>49047</o:CharactersWithSpaces>
38    <o:Version>9.2720</o:Version>    <o:Version>9.4402</o:Version>
39   </o:DocumentProperties>   </o:DocumentProperties>
40  </xml><![endif]--><!--[if gte mso 9]><xml>  </xml><![endif]--><!--[if gte mso 9]><xml>
41   <w:WordDocument>   <w:WordDocument>
# Line 36  Line 45 
45    
46    <style>    <style>
47  <!--  <!--
48     /* Font Definitions */
49    @font-face
50            {font-family:Wingdings;
51            panose-1:5 0 0 0 0 0 0 0 0 0;
52            mso-font-charset:2;
53            mso-generic-font-family:auto;
54            mso-font-pitch:variable;
55            mso-font-signature:0 268435456 0 0 -2147483648 0;}
56   /* Style Definitions */   /* Style Definitions */
57  p.MsoNormal, li.MsoNormal, div.MsoNormal  p.MsoNormal, li.MsoNormal, div.MsoNormal
58          {mso-style-parent:"";          {mso-style-parent:"";
# Line 44  Line 61 
61          mso-pagination:widow-orphan;          mso-pagination:widow-orphan;
62          font-size:12.0pt;          font-size:12.0pt;
63          font-family:"Times New Roman";          font-family:"Times New Roman";
64          mso-fareast-font-family:"Times New Roman";          mso-fareast-font-family:"Times New Roman";}
         mso-bidi-font-family:"Times New Roman";}  
65  a:link, span.MsoHyperlink  a:link, span.MsoHyperlink
66          {color:blue;          {color:blue;
67          text-decoration:underline;          text-decoration:underline;
# Line 54  Line 70 
70          {color:blue;          {color:blue;
71          text-decoration:underline;          text-decoration:underline;
72          text-underline:single;}          text-underline:single;}
73    p
74            {font-size:12.0pt;
75            font-family:"Times New Roman";
76            mso-fareast-font-family:"Times New Roman";}
77  @page Section1  @page Section1
78          {size:8.5in 11.0in;          {size:8.5in 11.0in;
79          margin:1.0in 1.25in 1.0in 1.25in;          margin:1.0in 1.25in 1.0in 1.25in;
# Line 62  Line 82 
82          mso-paper-source:0;}          mso-paper-source:0;}
83  div.Section1  div.Section1
84          {page:Section1;}          {page:Section1;}
85     /* List Definitions */
86    @list l0
87            {mso-list-id:176500654;
88            mso-list-type:hybrid;
89            mso-list-template-ids:-1610958616 642254348 1802898708 832353870 1508951890 1061685170 -1919385224 2135210068 654506682 1871347928;}
90    @list l0:level1
91            {mso-level-number-format:bullet;
92            mso-level-text:\F0B7;
93            mso-level-tab-stop:.5in;
94            mso-level-number-position:left;
95            text-indent:-.25in;
96            mso-ansi-font-size:10.0pt;
97            font-family:Symbol;}
98    @list l1
99            {mso-list-id:218640366;
100            mso-list-type:hybrid;
101            mso-list-template-ids:34625782 1879064160 1004709138 377518572 -120535498 2063753912 -2023747948 -1093910570 1169450864 -892324782;}
102    @list l1:level1
103            {mso-level-number-format:bullet;
104            mso-level-text:\F0B7;
105            mso-level-tab-stop:.5in;
106            mso-level-number-position:left;
107            text-indent:-.25in;
108            mso-ansi-font-size:10.0pt;
109            font-family:Symbol;}
110    @list l2
111            {mso-list-id:352460617;
112            mso-list-type:hybrid;
113            mso-list-template-ids:-162135770 1573412640 -1143561686 -1359181440 -1778846596 -675634294 2040702502 -1798133188 1104082008 -1747005554;}
114    @list l2:level1
115            {mso-level-number-format:bullet;
116            mso-level-text:\F0B7;
117            mso-level-tab-stop:.5in;
118            mso-level-number-position:left;
119            text-indent:-.25in;
120            mso-ansi-font-size:10.0pt;
121            font-family:Symbol;}
122    @list l3
123            {mso-list-id:605431337;
124            mso-list-type:hybrid;
125            mso-list-template-ids:1882218214 405577580 -2088048828 -620979218 2034551570 -105331346 -1872204942 1960992960 939655452 187189704;}
126    @list l3:level1
127            {mso-level-number-format:bullet;
128            mso-level-text:\F0B7;
129            mso-level-tab-stop:.5in;
130            mso-level-number-position:left;
131            text-indent:-.25in;
132            mso-ansi-font-size:10.0pt;
133            font-family:Symbol;}
134    @list l4
135            {mso-list-id:616332951;
136            mso-list-type:hybrid;
137            mso-list-template-ids:-2121503670 -938192272 -326495040 1344303574 -1323801064 876136946 30171346 -155432398 -275235212 964169354;}
138    @list l4:level1
139            {mso-level-number-format:bullet;
140            mso-level-text:\F0B7;
141            mso-level-tab-stop:.5in;
142            mso-level-number-position:left;
143            text-indent:-.25in;
144            mso-ansi-font-size:10.0pt;
145            font-family:Symbol;}
146    @list l5
147            {mso-list-id:866215456;
148            mso-list-type:hybrid;
149            mso-list-template-ids:1920229162 1560599570 1041117306 129912886 -1062160960 708860616 27537738 1767956120 355867502 -862035300;}
150    @list l5:level1
151            {mso-level-number-format:bullet;
152            mso-level-text:\F0B7;
153            mso-level-tab-stop:.5in;
154            mso-level-number-position:left;
155            text-indent:-.25in;
156            mso-ansi-font-size:10.0pt;
157            font-family:Symbol;}
158    @list l6
159            {mso-list-id:1154100461;
160            mso-list-type:hybrid;
161            mso-list-template-ids:1872510168 -1107939372 1002330802 -109801440 -2066709300 -469189498 -32725494 1094512198 -1131148552 847540354;}
162    @list l6:level1
163            {mso-level-number-format:bullet;
164            mso-level-text:\F0B7;
165            mso-level-tab-stop:.5in;
166            mso-level-number-position:left;
167            text-indent:-.25in;
168            mso-ansi-font-size:10.0pt;
169            font-family:Symbol;}
170    @list l7
171            {mso-list-id:1187713294;
172            mso-list-type:hybrid;
173            mso-list-template-ids:-774317378 863262924 94686218 777449778 -1792346184 -177564868 -543274984 570163436 -839747324 154972114;}
174    @list l7:level1
175            {mso-level-number-format:bullet;
176            mso-level-text:\F0B7;
177            mso-level-tab-stop:.5in;
178            mso-level-number-position:left;
179            text-indent:-.25in;
180            mso-ansi-font-size:10.0pt;
181            font-family:Symbol;}
182    @list l8
183            {mso-list-id:1209759940;
184            mso-list-type:hybrid;
185            mso-list-template-ids:-1384239484 12115666 -1522996244 1357256764 -57769864 287099324 -498568288 1039707782 -994642542 2043954892;}
186    @list l8:level1
187            {mso-level-number-format:bullet;
188            mso-level-text:\F0B7;
189            mso-level-tab-stop:.5in;
190            mso-level-number-position:left;
191            text-indent:-.25in;
192            mso-ansi-font-size:10.0pt;
193            font-family:Symbol;}
194    @list l9
195            {mso-list-id:1236814312;
196            mso-list-type:hybrid;
197            mso-list-template-ids:559448602 -1711787468 1330648572 -883384858 -244786894 -715873546 1211635840 660658588 -744705912 -794755240;}
198    @list l9:level1
199            {mso-level-number-format:bullet;
200            mso-level-text:\F0B7;
201            mso-level-tab-stop:.5in;
202            mso-level-number-position:left;
203            text-indent:-.25in;
204            mso-ansi-font-size:10.0pt;
205            font-family:Symbol;}
206    @list l10
207            {mso-list-id:1605460185;
208            mso-list-type:hybrid;
209            mso-list-template-ids:974180206 1133525928 367190754 2067152578 447217748 -831647314 -1073024844 -1079202094 1437874260 1908586386;}
210    @list l10:level1
211            {mso-level-number-format:bullet;
212            mso-level-text:\F0B7;
213            mso-level-tab-stop:.5in;
214            mso-level-number-position:left;
215            text-indent:-.25in;
216            mso-ansi-font-size:10.0pt;
217            font-family:Symbol;}
218    @list l11
219            {mso-list-id:1744404298;
220            mso-list-type:hybrid;
221            mso-list-template-ids:-88457190 -1540190154 -408363358 -2044964954 -285425460 -240244494 1407350808 -1877299018 -358864090 -1172158700;}
222    @list l11:level1
223            {mso-level-number-format:bullet;
224            mso-level-text:\F0B7;
225            mso-level-tab-stop:.5in;
226            mso-level-number-position:left;
227            text-indent:-.25in;
228            mso-ansi-font-size:10.0pt;
229            font-family:Symbol;}
230    @list l12
231            {mso-list-id:1885405565;
232            mso-list-type:hybrid;
233            mso-list-template-ids:1961771624 327431722 1424228792 1048887018 -866747864 -854166330 1516670514 -1122991992 1998767166 804526810;}
234    @list l12:level1
235            {mso-level-number-format:bullet;
236            mso-level-text:\F0B7;
237            mso-level-tab-stop:.5in;
238            mso-level-number-position:left;
239            text-indent:-.25in;
240            mso-ansi-font-size:10.0pt;
241            font-family:Symbol;}
242    @list l13
243            {mso-list-id:1904632842;
244            mso-list-type:hybrid;
245            mso-list-template-ids:1140086398 -1191815874 -1132298448 -1085131794 2014741232 -1565625484 -1997398374 1304058260 250103498 912524370;}
246    @list l13:level1
247            {mso-level-number-format:bullet;
248            mso-level-text:\F0B7;
249            mso-level-tab-stop:.5in;
250            mso-level-number-position:left;
251            text-indent:-.25in;
252            mso-ansi-font-size:10.0pt;
253            font-family:Symbol;}
254    @list l14
255            {mso-list-id:2046173909;
256            mso-list-type:hybrid;
257            mso-list-template-ids:540473568 1821304618 -460709142 -1138166102 1599221368 788721296 -1790257806 141168422 -1446980396 2088423136;}
258    @list l14:level1
259            {mso-level-number-format:bullet;
260            mso-level-text:\F0B7;
261            mso-level-tab-stop:.5in;
262            mso-level-number-position:left;
263            text-indent:-.25in;
264            mso-ansi-font-size:10.0pt;
265            font-family:Symbol;}
266    ol
267            {margin-bottom:0in;}
268    ul
269            {margin-bottom:0in;}
270  -->  -->
271  </style> <!--[if gte mso 9]><xml>  </style> <!--[if gte mso 9]><xml>
272   <o:shapedefaults v:ext="edit" spidmax="1026"/>   <o:shapedefaults v:ext="edit" spidmax="1027"/>
273  </xml><![endif]--><!--[if gte mso 9]><xml>  </xml><![endif]--><!--[if gte mso 9]><xml>
274   <o:shapelayout v:ext="edit">   <o:shapelayout v:ext="edit">
275    <o:idmap v:ext="edit" data="1"/>    <o:idmap v:ext="edit" data="1"/>
276   </o:shapelayout></xml><![endif]-->   </o:shapelayout></xml><![endif]-->
277  </head>  </head>
278    <body lang="EN-US" link="blue" vlink="blue" style="tab-interval:.5in">    <body lang="EN-US" link="blue" vlink="blue" style="tab-interval:.5in">
   
279  <div class="Section1">  <div class="Section1">
280  <h1>    </h1>  <h1 align="Center" style="text-align: center; ">Install/Update User Guide</h1>
281    <p class="MsoNormal"><!--[if !supportEmptyParas]--><!--[endif]--><o:p></o:p></p>
 <div align="Center">  
 <h1>Install/Update User Guide</h1>  
     </div>  
   
 <p class="MsoNormal"><!--[if !supportEmptyParas]--> <!--[endif]--><o:p></o:p></p>  
   
282  <h2>Getting Started: Install/Update in three steps</h2>  <h2>Getting Started: Install/Update in three steps</h2>
283    <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">This
284  <blockquote>   This section will teach you how to install a new Feature and  section will teach you how to install a new Feature and how to revert to a
285    how to  revert to a previous state in three easy steps. Before you start,  previous state in three easy steps. Before you start, make sure you installed
286    make sure you installed the 'mockup' site following  the <a href="http://www.eclipse.org">  the 'mockup' site following the <a href="http://www.eclipse.org">install mockup
287      install mockup site</a>  site</a>
288         instructions.</blockquote>    instructions.</p>
   
289    <h3>Find new Feature</h3>    <h3>Find new Feature</h3>
290    <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">This
291    <blockquote>This section will focus on finding a feature to install. There  section will focus on finding a feature to install. There are different ways
292    are different ways of finding a feature. The one we are going to focus in  of finding a feature. The one we are going to focus in this section is <a href="http://www.eclipse.org">
293    this section is <a href="http://www.eclipse.org">browsing a site</a>   browsing a site</a>
294         . For more information about other ways of finding a feature, look   . For more information about other ways of finding a feature, look at the
295  at  the  <a href="http://www.eclipse.org">Find Features</a>  <a href="http://www.eclipse.org">Find Features</a>
296         section.<br>    section.</p>
297          </blockquote>  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">Before
298    browsing a site, we will have to create a site bookmark to access it.</p>
     <blockquote>Before browsing a site, we will have to create a site bookmark  
   to access it.<br>  
           </blockquote>  
   
       <p class="MsoNormal"></p>  
   
299        <h4>Create a new site bookmark</h4>        <h4>Create a new site bookmark</h4>
300    <ul type="Disc">
301        <p class="MsoNormal"></p>    <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
302         mso-list:l13 level1 lfo1;tab-stops:list .5in">
303        <ul>   Open the Install/Update      perspective Help-&gt;Update Manager</li>
304              <li>Open the Install/Update perspective (TODO: menu path + key)</li>    <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
305              <li>Select the Updates View.</li>       mso-list:l13 level1 lfo1;tab-stops:list .5in">
306              <li>Open the context menu </li>   Select the Updates View.</li>
307              <li>Select new-&gt;site bookmark...</li>    <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
308              <li>In the Site Name entry field type: Test Site</li>       mso-list:l13 level1 lfo1;tab-stops:list .5in">
309              <li>In the Site Address entry field type the URL where you installed   Open the context menu </li>
310    the  mockup site. (i.e. file:c:/eclipse/site)</li>    <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
311              <li>Click Ok </li>       mso-list:l13 level1 lfo1;tab-stops:list .5in">
312     Select new-&gt;site bookmark...</li>
313      <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
314         mso-list:l13 level1 lfo1;tab-stops:list .5in">
315     In the Site Name entry field      type: Test Site</li>
316      <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
317         mso-list:l13 level1 lfo1;tab-stops:list .5in">
318     In the Site Address entry      field type the URL where you installed the
319    mockup site. (i.e.      file:c:/eclipse/site)</li>
320      <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
321         mso-list:l13 level1 lfo1;tab-stops:list .5in">
322     Click Ok </li>
323        </ul>        </ul>
324    <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">The
325        <blockquote> The Site should appear on the view. The provider of a  Site should appear on the view. The provider of a feature should give you
326  feature should  give you the URL of their site so you can  find their feature.  the URL of their site so you can find their feature. We will now browse the
327  We will now browse the site to discover the features.<br>  site to discover the features.</p>
             </blockquote>  
   
328          <h4>   Choose Feature</h4>          <h4>   Choose Feature</h4>
329    <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">You
330          <blockquote>You can expand the site and the categories to see the  can expand the site and the categories to see the Features. In this site you
331    Features.  In this site you should see one category:  Red Dot Versions,  should see one category:  Red Dot Versions, and two features:  Red Dot Feature
332   and  two features:   Red Dot Feature 1.0.0 and Red Dot Feature 2.0.0. <br>  1.0.0 and Red Dot Feature 2.0.0. </p>
333    <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; ">
334            <ul>   ·<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]-->
335                 <li>Select Red Dot Feature 1.0.0</li>  Select Red Dot Feature 1.0.0</p>
336    <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">The
337            </ul>  Preview page should now look like the following picture:</p>
338                </blockquote>  <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">
339    </p>
340            <blockquote>The Preview page should now look like the following  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">You
341    picture:<br>  may want to check the license and copyright or decide to have more information
342                  </blockquote>  about the Feature you are about to install. 'Click' on the appropriate link
343    at the bottom of the view to automatically open a browser that will show you
344              <div align="Center">           <img src="images/pic001.gif" alt="PIC001.gif Preview Page of Red Dot 1.0.0" width="678" height="518">  the desired page.</p>
345                 <br>  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">&lt;TIP
346                  </div>  the preference page lets you decide if you want to view the HTML page within
347    the workbench or by launching an external browser&gt;</p>
             <blockquote>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.<br>  
                   </blockquote>  
   
               <blockquote>&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;<br>  
                     </blockquote>  
   
348                  <h3>   Install Feature</h3>                  <h3>   Install Feature</h3>
349    <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">When
350                  <blockquote>When you are ready to install the feature click  you are ready to install the feature click on the Install button in the Preview
351    on the Install button in the Preview View. This will launch the Install  View. This will launch the Install Wizard.</p>
 Wizard.<br>  
                       </blockquote>  
   
   
352                    <h4>Install Wizard</h4>                    <h4>Install Wizard</h4>
353    <ul type="Disc">
354      <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
355                    <p class="MsoNormal"></p>       mso-list:l10 level1 lfo3;tab-stops:list .5in">
356     The first page of the Wizard      summarizes the action you are going to
357    take. Click Next.</li>
358                    <ul>    <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
359                          <li>The first page of the Wizard summarizes the action       mso-list:l10 level1 lfo3;tab-stops:list .5in">
360    you are going to take. Click Next.</li>   The second page shows the      license you have to accept to install the
361                          <li>The second page shows the license you have to  feature. Click next of you      accept the presented license otherwise click
362  accept  to install  the feature. Click next of you accept the presented license  cancel.</li>
363   otherwise  click  cancel.</li>    <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
364                          <li>The last page of the Wizard presents the list       mso-list:l10 level1 lfo3;tab-stops:list .5in">
365  of  Site you can  install your feature in. You can create a new site from   The last page of the Wizard      presents the list of Site you can install
366  this  page. For more  information about creating new Site see:  <a href="http://www.eclipse.org">  your feature in. You can create      a new site from this page. For more information
367         Site Location Tab</a>  about creating new Site      see:<a href="http://www.eclipse.org">  Site
368    Location Tab</a>
369         . You should see only one site and it should point to the path where         . You should see only one site and it should point to the path where
370   the  workbench is installed. Click Finish.</li>   the  workbench is installed. Click Finish.</li>
   
   
371                    </ul>                    </ul>
372    <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">The
373    feature will then be downloaded, verified and installed in the site. You can
374                    <blockquote>   The feature will then be downloaded, verified  see the progress monitor showing you the evolution of theses tasks. During
375    and installed  in the site. You can see the progress monitor showing you  verification, you may be prompted to accept the verification. Click 'Ok' when
376   the evolution of  theses tasks. During verification, you may be prompted  prompted.</p>
377  to accept the verification. Click 'Ok' when prompted.<br>  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">When
378                          </blockquote>  the feature has been installed you will need to restart the workbench for
379    the changes to take effect. Click 'Ok' on the dialog box.</p>
   
                     <blockquote>   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.<br>  
                           </blockquote>  
   
   
                       <p class="MsoNormal"></p>  
   
   
380                        <h4>Verify the feature has been installed</h4>                        <h4>Verify the feature has been installed</h4>
381    <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">The
382    feature you installed will add a red button icon to the tool bar when activated.
383                        <blockquote>The feature you installed will add a red  To activate this specific feature customize your perspective and add the Red
384    button icon to the tool  bar when activated. To activate this specific  Dot Set Action Set:</p>
385  feature   customize your perspective  and add the Red Dot Set Action Set:<br>  <ul type="Disc">
386                              </blockquote>    <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
387         mso-list:l11 level1 lfo4;tab-stops:list .5in">
388     Open the menu Window</li>
389                          <p class="MsoNormal"></p>    <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
390         mso-list:l11 level1 lfo4;tab-stops:list .5in">
391     Select Customize Perspective</li>
392                          <ul>    <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
393                                <li>Open the menu Window</li>       mso-list:l11 level1 lfo4;tab-stops:list .5in">
394                                <li>Select Customize Perspective</li>   Expand Action Sets</li>
395                                <li>Expand Action Sets</li>    <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
396                                <li>Check Red Dot Set</li>       mso-list:l11 level1 lfo4;tab-stops:list .5in">
397                                <li>Click Ok</li>   Check Red Dot Set</li>
398      <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
399         mso-list:l11 level1 lfo4;tab-stops:list .5in">
400     Click Ok</li>
401                          </ul>                          </ul>
402    <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">You
403    should now se a red button icon on the toolbar. If you click on it the following
404                          <blockquote>You should now se a red button icon on  dialog box should appear, meaning the feature and associated plug-ins have
405    the toolbar. If you click  on it the following dialog box should appear,  been successfully installed and configured.</p>
406   meaning the feature and associated  plug-ins have been successfully installed  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">We
407   and configured.<br>  will now see how to manage your feature in your configuration.</p>
                               </blockquote>  
   
   
                           <blockquote>   We will now see how to manage your  
   feature in your configuration.<br>  
                                 </blockquote>  
   
   
408                              <h3>   Configure Environment</h3>                              <h3>   Configure Environment</h3>
409    <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">A feature
410    that is installed may be configured or unconfigured for your workspace. A
411                              <blockquote>   A feature that is installed may  configured feature means that Install/Update will 'suggests' that the runtime
412    be configured or unconfigured for  your workspace. A configured feature  configures the feature to be available. An unconfigured feature means that
413  means  that Install/Update will 'suggests'  that the runtime configures the  Install/Update will make the feature unavailable to the user.</p>
414  feature  to be available. An unconfigured feature means that Install/Update  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">When
415  will make  the feature unavailable to the user.<br>  you installed Red Dot Feature 1.0.0, Install/Update installed and configured
416                                    </blockquote>  the feature for you. You can see that in the Configuration History. For more
417    information about Configuration History see <a href="http:/ww.eclipse.org">
418     Configuration History</a>
419                                <blockquote>When you installed Red Dot Feature   .</p>
420    1.0.0, Install/Update installed  and configured the feature for you. You  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">A configuration
421   can see that in the Configuration  History. For more information about Configuration  is a list of configured and unconfigured features that determine what tool
422    History see <a href="http:/ww.eclipse.org">  Configuration History</a>  you can use.<br>
423         .<br>    The current configuration is the configuration currently active.</p>
424                                      </blockquote>  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">For
425    more information about configuration, see <a href="http://www.eclipse.org">
426     Configuring/Unconfiguring</a>
427                                  <blockquote>A configuration is a list of   .</p>
428  configured and unconfigured features  that determine what tool you can use.<br>  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">In
429      The current configuration is the configuration currently active.<br>  this section we will add the current history configuration to the list of
430                                        </blockquote>  preserved configuration. We will unconfigure Red Dot 1.0.0, so the feature
431    will be unavailable. Then we will restore the preserved configuration, which
432    will re-configure the feature.</p>
                                   <blockquote>For more information about  
 configuration, see <a href="http://www.eclipse.org">Configuring/Unconfiguring</a>  
   .<br>  
                                         </blockquote>  
   
   
   
                                     <blockquote>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.<br>  
                                           </blockquote>  
   
   
   
433                                        <h4>Add configuration to preserved</h4>                                        <h4>Add configuration to preserved</h4>
434    <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">To
435    add the current configuration, we will first need to find it in the list of
436    configurations and then add it to the list of preserved configurations. The
437                                        <blockquote>To add the current configuration,  current configuration is the configuration in the configuration history folder
438    we will first need to find  it in the list of configurations and then add  with an icon with a running person. It is the last configuration in the list.</p>
439    it to the list of preserved  configurations. The current configuration  <ul type="Disc">
440  is   the configuration in the configuration  history folder with an icon    <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
441  with  a running person. It is the last configuration  in the list.<br>       mso-list:l4 level1 lfo5;tab-stops:list .5in">
442                                              </blockquote>   Select the current      configuration.</li>
443      <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
444         mso-list:l4 level1 lfo5;tab-stops:list .5in">
445     Open the context menu.</li>
446                                          <p class="MsoNormal"></p>    <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
447         mso-list:l4 level1 lfo5;tab-stops:list .5in">
448     Select Add to preserved.</li>
449      <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
450                                          <ul>       mso-list:l4 level1 lfo5;tab-stops:list .5in">
451                                                <li>Select the current configuration.</li>   The configuration now appears      under the Preserved Configurations folder.</li>
                                               <li>Open the context menu.</li>  
                                               <li>Select Add to preserved.</li>  
                                               <li>The configuration now appears  
   under the Preserved Configurations  folder.</li>  
   
   
   
452                                          </ul>                                          </ul>
   
   
   
453                                          <h4>Rename configuration</h4>                                          <h4>Rename configuration</h4>
454    <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">We
455    will rename the configuration to give it a meaningful name.</p>
456    <ul type="Disc">
457                                          <blockquote>We will rename the configuration    <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
458    to give it a meaningfull name.<br>       mso-list:l2 level1 lfo6;tab-stops:list .5in">
459                                                </blockquote>   Select the configuration.</li>
460      <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
461         mso-list:l2 level1 lfo6;tab-stops:list .5in">
462     Open the context menu and      click Properties.</li>
463                                            <p class="MsoNormal"></p>    <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
464         mso-list:l2 level1 lfo6;tab-stops:list .5in">
465     Change the name of the      configuration to: RedDot 1</li>
466      <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
467                                            <ul>       mso-list:l2 level1 lfo6;tab-stops:list .5in">
468                                                  <li>Select the configuration.</li>   Click Ok.</li>
                                                 <li>Open the context menu  
 and  click Properties.</li>  
                                                 <li>Change the name of the  
  configuration  to: RedDot 1</li>  
                                                 <li>Click Ok.</li>  
   
   
   
469                                            </ul>                                            </ul>
   
   
   
470                                            <h4>Unconfigure Feature</h4>                                            <h4>Unconfigure Feature</h4>
471    <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">We
472    will now unconfigure the feature.</p>
473    <ul type="Disc">
474                                            <blockquote>We will now unconfigure    <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
475    the feature.<br>       mso-list:l0 level1 lfo7;tab-stops:list .5in">
476                                                  </blockquote>   Expand Current Configuration;</li>
477      <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
478         mso-list:l0 level1 lfo7;tab-stops:list .5in">
479     Expand the site</li>
                                             <p class="MsoNormal"></p>  
   
   
   
                                             <ul>  
                                                   <li>Expand Current Configuration;</li>  
                                                 <li>Expand the site</li>  
   
   
480                                              </ul>                                              </ul>
481    <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.">
482    </p>
483                                              <blockquote>  <ul type="Disc">
484      <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
485         mso-list:l3 level1 lfo8;tab-stops:list .5in">
486                                                <div align="Left"><img src="images/pic004.gif" alt="Expand Current Configuration to reveal the configured Feature." width="202" height="118">   Select Red Dot Feature 1.0.0</li>
487                                                  <br>    <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
488                                                  </div>       mso-list:l3 level1 lfo8;tab-stops:list .5in">
489                                                  </blockquote>   In the preview view click      Unconfigure.</li>
490      <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
491         mso-list:l3 level1 lfo8;tab-stops:list .5in">
492                                                <ul>   When the Dialog opens click      Ok.</li>
                                                   <li>Select Red Dot Feature  
   1.0.0</li>  
                                                   <li>In the preview view  
 click  Unconfigure.</li>  
                                                   <li>When the Dialog opens  
  click Ok.</li>  
   
   
   
493                                                </ul>                                                </ul>
494    <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">The
495    workspace will shutdown and restart automatically.</p>
   
                                               <p class="MsoNormal"></p>  
   
   
   
                                               <blockquote>The workspace will  
   shut-down and restart automatically.</blockquote>  
   
   
   
                                                 <p class="MsoNormal"></p>  
   
   
   
                                                 <h4>   </h4>  
   
   
   
496                                                  <h3>Restore Configuration</h3>                                                  <h3>Restore Configuration</h3>
497    <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">We
498    shall now restore the configuration we added to preserve, so the feature will
499    be configured again.</p>
500                                                  <blockquote>We shall now  <h4>Verify the Feature is not available</h4>
501  restore  the configuration we added to preserve, so the feature will be configured  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">You
502    again.<br>  should not see the red button icon in the toolbar, meaning the feature was
503                                                      </blockquote>  not activated</p>
504    <ul type="Disc">
505      <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
506         mso-list:l14 level1 lfo9;tab-stops:list .5in">
507                                                    <h4>Verify the Feature   In the Configuration View,      expand Current Configuration.</li>
508  is  not available</h4>    <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
509         mso-list:l14 level1 lfo9;tab-stops:list .5in">
510     Expand the site.</li>
511      <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
512                                                    <blockquote>You should       mso-list:l14 level1 lfo9;tab-stops:list .5in">
513  not  see the red button icon in the toolbar, meaning  the feature was not   Verify Red Dot Feature 1.0.0      does NOT appear as an icon.</li>
514  activated<br>    <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
515                                                        </blockquote>       mso-list:l14 level1 lfo9;tab-stops:list .5in">
516     Click on the view toolbar      button 'show unconfigured features'</li>
517      <li>Verify Red Dot Feature 1.0.0      does appear</li>
   
                                                     <p class="MsoNormal"></p>  
   
   
   
                                                     <ul>  
                                                         <li>In the Configuration  
   View, expand Current Configuration.</li>  
                                                         <li>Expand the site.</li>  
                                                         <li>Verify Red Dot  
  Feature  1.0.0 does NOT appear as an icon.</li>  
                                                         <li>Click on the  
 view   toolbar button 'show unconfigured features'</li>  
                                                         <li>Verify Red Dot  
  Feature  1.0.0 does appear</li>  
   
   
   
518                                                      </ul>                                                      </ul>
519    <blockquote>
520      <div>
521                                                      <blockquote><img src="images/pic005.gif" alt="Unconfigured feature revealed" width="257" height="117">    <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">
522      </div>
523                                   </blockquote>    </div>
   
   
                                                       <blockquote>The icon <img src="images/unconf_feature_obj.gif" alt="Unconfigured Feature unconf_feature_obj.gif " width="16" height="16">  
     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.<br>  
524                                                          </blockquote>                                                          </blockquote>
525      <blockquote>
526        <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 ">
527      means the feature is still installed but not available at this time in
528    your workspace. To be able to use the feature we will need to configure the
529                                                          <h4>Revert to preserved  feature.</div>
530    configuration</h4>      </blockquote>
531        <h4>Revert to preserved configuration</h4>
532        <p class="MsoNormal">            We will now go back to the configuration
533    we had previously, in which Red Dot Feature 1.0.0 was configured.</p>
534        <ul type="Disc">
535                                                          <p class="MsoNormal">        <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
536                     We will now go back to the configuration we had previously       mso-list:l12 level1 lfo10;tab-stops:list .5in">
537    in which Red Dot Feature 1.0.0 was configured.</p>   Expand Preserved      Configurations</li>
538          <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
539         mso-list:l12 level1 lfo10;tab-stops:list .5in">
540     Select RedDot 1</li>
541          <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
542                                                          <ul>       mso-list:l12 level1 lfo10;tab-stops:list .5in">
543                                                            <li>Expand Preserved   In the preview view click      Restore</li>
544    Configurations</li>        <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
545                                                            <li>Select RedDot       mso-list:l12 level1 lfo10;tab-stops:list .5in">
546   1</li>   When the Dialog opens click      Ok.</li>
                                                           <li>In the preview  
   view click Restore</li>  
                                                           <li>When the Dialog  
   opens click Ok.</li>  
   
   
   
   
547                                                          </ul>                                                          </ul>
548        <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
549    The workspace will shutdown and restart automatically. After the workspace
550    restart, the feature is configured, based on the revert configuration.</p>
551        <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
552                                                          <blockquote>The workspace  There are different ways of configuring a feature. To know more about configuring
   will shut-down and restart automatically. After the workspace restart,  
 the  feature is configured, based on the revert configuration.</blockquote>  
   
   
   
   
                                                           <blockquote>There  
  are  different way of configuring a feature. To know more  about configuring  
553   and  unconfiguring features see: <a href="http://www.eclipse.org">  Configuring/Unconfiguring   and  unconfiguring features see: <a href="http://www.eclipse.org">  Configuring/Unconfiguring
554    features</a>    features</a>
555         .<br>   .</p>
556                                                              </blockquote>      <p class="MsoNormal">In this section you learnt how to find a feature
557    you want to install, how to install a feature, how to unconfigure a feature
558    and how to restore a preserved configuration. The rest of the book will go
559    into more details.</p>
560        <h2>The User Interface</h2>
561                                                              <p class="MsoNormal">      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
        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.<br>  
                                                                  </p>  
   
   
   
   
                                                             <h2>   The User  
  Interface</h2>  
   
   
   
   
                                                             <blockquote>  
562    This  section describes in details the User Interface of the Install/Update    This  section describes in details the User Interface of the Install/Update
563    perspective.  The perspective is composed of four different views: The  perspective. The perspective is composed of four different views: The Configuration
564  Configuration   View  to manage the configurations, the Updates View to manage  View to manage the configurations, the Updates View to manage update sites
565  update sites   and  features as well as searches. The Preview View is used  and features as well as searches. The Preview View is used to show the details
566  to show the details   of the element selected in the previous two views and  of the element selected in the previous two views and the Web View, which
567  the Web View, which   is used to browse HTML document from either sites or  is used to browse HTML document from either sites or features.</p>
568  features.</blockquote>      <h3>The Configuration View</h3>
569        <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
   
   
   
                                                               <h3>The Configuration  
   View</h3>  
   
   
   
   
                                                               <blockquote>  
570    The  configuration view helps you manage your configurations. A configuration    The  configuration view helps you manage your configurations. A configuration
571   is a list of configured and unconfigured features that determine what tool   is a list of configured and unconfigured features that determine what tool
572   are available fro you to use in your workspace. <br>   are available fro you to use in your workspace. <br>
573                                                                    <img src="images/pic006.gif" alt="Configuration View" width="251" height="251">      </p>
574                                                                    <br>      <blockquote><img border="0" width="251" height="251" id="_x0000_i1029" src="images%5Cpic006.gif" alt="Configuration View">
                                                                 </blockquote>  
   
   
   
   
                                                                 <h4>   Current  
   Configuration</h4>  
   
   
   
   
                                                                 <blockquote>  
   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/Unconfigued</a>  
        .<br>  
575                                                                    </blockquote>                                                                    </blockquote>
576          <h4>Current Configuration</h4>
577          <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
578     The current configuration is the configuration currently active. When you
579    expand the Current Configuration you can see the sites you are connected to.
580                                                                    <h4>  Expanding each site reveals the list of Features you have access to. Some
581  Configuration  History</h4>  feature may be configured, some may be unconfigured. The configured features
582    are the tools the Install/Update suggested the runtime to activate. To know
583    more about configured/Unconfigured features see: <a href="http://www.eclipse.org">
584     Configured/Unconfigured</a>
585     .</p>
586                                                                    <blockquote>        <h4>Configuration History</h4>
587          <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
588      The Configuration History folder contains the last <i>n</i>  configurations      The Configuration History folder contains the last <i>n</i>  configurations
589    you used. <i>n</i> is a number you can set in the Install/Update  preference    you used. <i>n</i> is a number you can set in the Install/Update  preference
590    page. See: <a href="http://www.eclipse.org">Install/Update Preference  page. See: <a href="http://www.eclipse.org">Install/Update Preference Page</a>
591  Page</a>   .</p>
592         .<br>        <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
593                                                                      </blockquote>   You can use the history list to see what are the different activities that
594    occurred as well as restoring an old configuration to make it the current
595    one.</p>
596          <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
597      Install/Update creates a new configuration history when one or more activities
598                                                                      <blockquote>  are performed (i.e. install, configure, unconfigure etc...). When the Install/Update
599      You can use the history list to see what are the different activities  creates a new configuration, it will add it to the list. If you already have
600  that  occurred as well as restoring an old configuration to make it the current  n configurations, the framework will automatically delete the oldest configuration
601    one.<br>  from the list. To know when the Install/Update creates new configuration history
602                                                                        </blockquote>  and what are the Activities see:<a href="http://www.eclipse.org">  Configuration
603    History</a>
604     .</p>
605          <h4>Preserved Configuration</h4>
606          <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
607                                                                        <blockquote>   The Preserved Configurations folder contains history configurations you
608       Install/Update creates a new configuration history when one  or more  want to keep. The framework does not automatically delete the configurations
609  activities  are performed (i.e. install, configure, unconfigure etc...).  in the Preserved Configurations folder; you have to explicitly delete them.</p>
610  When the Install/Update   creates a new configuration, it will add it to the        <h4>Configured/Unconfigured</h4>
611   list. If you already have n configurations, the framework will automatically        <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
  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>  
        .<br>  
                                                                         </blockquote>  
   
   
   
   
                                                                         <h4>  
      Preserved Configuration</h4>  
   
   
   
   
                                                                         <blockquote>  
     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.<br>  
   
   
   </blockquote>  
   
   
   
   
   
                                                                           <h4>  
        Configured/Unconfigured</h4>  
   
   
   
   
   
                                                                           <blockquote>  
   
   
   
   
   
                                                                             <p class="MsoNormal">  
612      You can decide to see only the configured features or both configured/unconfigured      You can decide to see only the configured features or both configured/unconfigured
613    features by clicking the 'Show Unconfigured Features' toggle button in  features by clicking the 'Show Unconfigured Features' toggle button in the
614  the   view tool bar. To know more about configured/unconfigured features  view tool bar. To know more about configured/unconfigured features see: <a href="http://www.eclipse.org">
615  see:   Configured/Unconfigured</a>
         <a href="http://www.eclipse.org">    Configured/Unconfigued</a>  
616         . </p>         . </p>
617          <h4>Local View Toolbar Actions</h4>
618          <h5>Show Unconfigured Feature</h5>
619          <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
      </blockquote>  
   
   
   
   
   
                                                                             <h4>  
     Local View Toolbar Actions</h4>  
   
   
   
   
   
                                                                             <h5>  
     Show Unconfigured Feature</h5>  
   
   
   
   
   
                                                                             <blockquote>  
   
   
   
   
   
                                                                               <p class="MsoNormal">  
620      This button allows you to see only the configured features or both configured      This button allows you to see only the configured features or both configured
621    and unconfigured features. Unconfigured features appear with a red circle    and unconfigured features. Unconfigured features appear with a red circle
622    around the icon. For more information about configuring/unconfiguring features    around the icon. For more information about configuring/unconfiguring features
623    see: <a href="http://www.eclipse.org">Configuring/Unconfiguring</a>    see: <a href="http://www.eclipse.org">Configuring/Unconfiguring</a>
624       .<br>   .</p>
625          <h4>Context Actions</h4>
626       </p>        <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
627     This section describes the different context actions available in the Configuration
628       </blockquote>  View.</p>
629          <h5>Go Home</h5>
630          <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
631     This action &lt;TODO be consistent with navigator&gt;</p>
632          <h5>Go Back</h5>
633          <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
634                                                                                <h4>   This action &lt;TODO be consistent with navigator&gt;</p>
635      Context Actions</h4>        <h5>Go Into</h5>
636          <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
637     This action &lt;TODO be consistent with navigator&gt;</p>
638          <h5>Show Details</h5>
639          <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
640     This action opens or refreshes the Preview View with the details of the
641                                                                                <blockquote>  selected element.</p>
642         This section describes the different context actions available in        <h5>Properties</h5>
643  the   Configuration View.<br>        <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
   
        </blockquote>  
   
   
   
   
   
                                                                                 <h5>  
        Go Home</h5>  
   
   
   
   
   
                                                                                 <blockquote>  
     This action &lt;TODO be consistent with navigator&gt;<br>  
   
          </blockquote>  
   
   
   
   
   
                                                                                   <h5>  
        Go Back</h5>  
   
   
   
   
   
                                                                                   <blockquote>  
     This action &lt;TODO be consistent with navigator&gt;<br>  
   
            </blockquote>  
   
   
   
   
   
                                                                                     <h5>  
        Go Into</h5>  
   
   
   
   
   
                                                                                     <blockquote>  
     This action &lt;TODO be consistent with navigator&gt;<br>  
   
              </blockquote>  
   
   
   
   
   
                                                                                       <h5>  
        Show Details</h5>  
   
   
   
   
   
                                                                                       <blockquote>  
     This action opens or refreshes the Preview View with the  details of  
 the   selected element.<br>  
   
                </blockquote>  
   
   
   
   
   
                                                                                         <h5>  
        Properties</h5>  
   
   
   
   
   
                                                                                         <blockquote>  
644      This opens a Dialog box that presents the label of the selected configuration.      This opens a Dialog box that presents the label of the selected configuration.
645    You are able to change the label of a configuration. Click Ok when you  You are able to change the label of a configuration. Click Ok when you have
646  have   finished and you want to preserve your changes or click Cancel if  finished and you want to preserve your changes or click Cancel if you do not
647  you do  not want to change the properties.<br>  want to change the properties.</p>
648          <h5>Add to Preserved</h5>
649                   </blockquote>        <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
650      This action adds the selected configuration in the Configuration History
651    folder to the list of preserved configuration.</p>
652          <h5>Remove from Preserved</h5>
653          <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
   
                                                                                           <h5>  
        Add to Preserved</h5>  
   
   
   
   
   
                                                                                           <blockquote>  
      This action adds the selected configuration in the Configuration  History  
   folder to the list of preserved configuration.<br>  
   
                    </blockquote>  
   
   
   
   
   
   
                                                                                             <h5>  
        Remove from Preserved</h5>  
   
   
   
   
   
   
                                                                                             <blockquote>  
654      This action removes the selected configuration from the  list of preserved      This action removes the selected configuration from the  list of preserved
655    configurations. This action will not delete any Site, Site  Bookmark or  configurations. This action will not delete any Site, Site Bookmark or Feature.
656  Feature.  This action will not delete the configuration it was  created from  This action will not delete the configuration it was created from or any other
657  or any  other configuration.<br>  configuration.</p>
658          <h5>Restore</h5>
659          <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
660      This action creates a new configuration based on the selected configuration
661    and marks it as current. Install/Update will automatically configure all the
662    features that were configured in the selected configuration you want to restore.
663    To know more about restoring or reverting to a configuration see: <a href="http://www.eclipse.org">
664    Restore a Configuration/Revert to previous configuration</a>
665     .</p>
666          <h3>The Updates View</h3>
667          <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
668     The Updates view allows you to manage the remote sites you can install from
669    to search for features as well as features you can install. <br>
670          </p>
671          <blockquote><img border="0" width="251" height="249" id="_x0000_i1030" src="images%5Cpic007.gif" alt="Updates View">
672            </blockquote>
673            <h4>My Computer</h4>
674            <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
675     My Computer lets you browse your computer and any mounted local file to
676    discover any site on your file system. You can also search My Computer to
677    discover sites: see <a href="http://www.eclipse.org">Search the file system</a>
678     .</p>
679            <h4>Places to Visit</h4>
680            <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
681     Places to visit are sites suggested by the features you installed for you
682    to visit. </p>
683            <h4>Available Updates</h4>
684            <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
685     Available Updates will let you search for updates of already installed features.
686    The search occurs in the background so you can still use the workbench while
687    searching for updates. To know more about searching: see <a href="http://www.eclipse.org">
688     Search</a>
689     .</p>
690            <h4>Sites Bookmark</h4>
691            <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
692     A site is a location that contains features. In the Updates View, the sites
693    contain features you can install. You can browse or search features in Site
694    bookmarks. There are two ways of adding a site bookmark. You can use the context
695    menu and the context action add site bookmarks, or you may browse My Computer
696    and add a site as a site bookmark. See <a href="http://www.eclipse.org"> Context
697    Action</a>
698      for more details. </p>
699            <h4>Search</h4>
700            <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
701     Search is a bookmark for a specific query that will retrieve features from
702    update sites. You can create a new specific query based on a template or execute
703    the query to fetch the features from the desired update sites. You can also
704    query your local file system. The resulting features appear on the same search
705    preview than the query. To know more about how to create your own query:
706    see <a href="http://www.eclipse.org">Context Action [new-&gt;Search]</a>
707     . To know how to search the file system: see <a href="http://www.eclipse.org">
708     Search the file system</a>
709     . To search for available updates: see <a href="http://www.eclipse.org">
710    Update Already Existing Features</a>
711     . To search for new features: see <a href="http://www.eclipse.org">Finding
712    New Features</a>
713     . To know more about the search Preview View: see <a href="http://www.eclipse.org">
714     Search Preview View</a>
715     .</p>
716            <h4>Folder</h4>
717            <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
718     Folders are placeholders in the Updates View. They are used to help you
719    categorize and organize the view. Folders can contain folders, update sites
720    and/or searches. You can change the label of a folder. To know more about
721    how to create a folder see: <a href="http://www.eclipse.org">Context Action
722    [new-&gt;folder]</a>
723     .</p>
724            <h4>Local View Toolbar Actions</h4>
725            <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
726     This section describes the local view toolbar actions of the Updates View.</p>
727            <h5>Show Feature Categories </h5>
728            <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
729     When this action is selected, you will see the features organized in categories.<br>
730            </p>
731            <blockquote><img border="0" width="253" height="193" id="_x0000_i1054" src="images%5Cpic008.gif" alt="Categories">
732              <br>
733                       </blockquote>                       </blockquote>
734              <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
735    When this action is not selected, you will see all the features as a list.<br>
736              </p>
737              <blockquote><img border="0" width="253" height="97" id="_x0000_i1032" src="images%5Cpic008b.gif" alt="No Categories">
   
   
                                                                                               <h5>  
        Restore</h5>  
   
   
   
   
   
   
                                                                                               <blockquote>  
      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>  
        .<br>  
   
738                         </blockquote>                         </blockquote>
739                <h5>Show My Computer Files </h5>
740                <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
741     When this action is selected, you will be able to browse the files when
742    you expand MyComputer.<br>
743                </p>
744                <blockquote><img border="0" width="251" height="249" id="_x0000_i1033" src="images%5Cpic009.gif" alt="Browse Files">
745                                                                                                  <h3>                </blockquote>
746      The Updates View</h3>                <h4>Context Actions</h4>
747                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
748     This section describes the different context actions available in the Updates
749    View. </p>
750                  <h5>New-&gt;Site Bookmark...</h5>
751                  <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
752     Creates a new Site bookmark. This opens a Dialog box that presents the properties
753    of the Bookmark Site you want to create. The properties of a Bookmark Site
754    are the label you want to see in the View as well as the Address of the physical
755    site. You have to enter the Site URL. Optionally you can enter the Site Name.
756    If you o not enter a Site Name, it will default to the Site URL. Click Ok
757    when you have finished and you want to preserve your changes or click Cancel
758    if you do not want to create a new Site Bookmark.</p>
759                  <h5>New-&gt;Folder</h5>
760                  <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
761     This action lets you create a new Folder. When you select this action, a
762    dialog will open.<br>
763                  </p>
764                                                                                                  <blockquote>                                                                                                  <blockquote>
765         The Updates view allows you to manage the remote sites you can install                  <div align="Left"><img border="0" width="438" height="481" id="_x0000_i1034" src="images%5Cpic011.gif" alt="New Folder Dialog">
   from to search for features as well as features you can install. <br>  
   
                            <img src="images/pic007.gif" alt="Updates View" width="251" height="249">  
   
766                             <br>                             <br>
767                    </div>
768                           </blockquote>                           </blockquote>
769                    <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
770    Type the label of the folder in the 'Name;' entry field.<br>
771      Type the name of the parent folder in the 'Create in:' entry field, or
772    select  it in the 'Existing folders:' tree view. If no parent is selected,
773    the newly  created folder will appear in the updates view as a root folder.<br>
   
                                                                                                   <h4>  
     My Computer</h4>  
   
   
   
   
   
   
                                                                                                   <blockquote>  
     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>  
        .<br>  
   
                            </blockquote>  
   
   
   
   
   
   
                                                                                                     <h4>  
     Places to Visit</h4>  
   
   
   
   
   
   
                                                                                                     <blockquote>  
     Places to visit are sites suggested by the features you installed  for  
  you  to visit. <br>  
   
                              </blockquote>  
   
   
   
   
   
   
                                                                                                       <p class="MsoNormal">  
        </p>  
   
   
   
   
   
   
                                                                                                       <h4>  
     Available Updates</h4>  
   
   
   
   
   
   
                                                                                                       <blockquote>  
     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>  
        .<br>  
   
                                </blockquote>  
   
   
   
   
   
   
                                                                                                         <h4>  
     Sites Bookmark</h4>  
   
   
   
   
   
   
                                                                                                         <blockquote>  
   
   
   
   
   
   
                                                                                                           <p class="MsoNormal">  
     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. <br>  
   
774                                   </p>                                   </p>
775                    <blockquote><img border="0" width="251" height="249" id="_x0000_i1035" src="images%5Cpic010.gif" alt="folders">
776                      <img border="0" width="32" height="32" id="_x0000_i1036" src="pic010.gif" alt="folders">
777                                   </blockquote>                                   </blockquote>
778                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "></p>
779                      <h5>New-&gt;Search</h5>
780                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
781     This action will create a new Search. It will open a dialog window.  Enter
782    the name of the search you desire in Name. Select the folder you want the
783    Search to appear in by selecting the appropriate folder under the existing
784                                                                                                            <h4>  folders tree or by typing its name in the Create in entry field. Open the
785         Search</h4>  Category combo box and select the search you want. You can change the category
786    of a search after it has been created: see <a href="http://www.eclipse.org">
   
   
   
   
   
                                                                                                           <blockquote>  
   
   
   
   
   
   
                                                                                                             <p class="MsoNormal">  
 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 availables updates: see <a href="http://www.eclipse.org">  
 Update Already Existing Fetaures</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">  
787  Search Preview View</a>  Search Preview View</a>
788     . Click finish to close the dialog and create the search or click Cancel
789    to close the dialog and abort the creation. To know more about the different
790    type of search: see <a href="http://www.eclipse.org">Searching New Features</a>
791     .</p>
792                      <h5>Show Details</h5>
793                      <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
794     This action opens or refreshes the Preview View with the details of the
795    selected element.</p>
796                      <h5>Refresh</h5>
797                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
798     This action re-initializes the content of an element &lt;TODO see dejan&gt;</p>
799                      <h5>Bookmark Location</h5>
800                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
801     This action lets you create bookmark site for a site found on your local
802    file system. This opens a Dialog box that presents the properties of the selected
803    site. The properties of a Site are the label you want to see in the View
804    as well as the Address of the site. You are able to change the Site Name.
805    Click Ok when you have finished and you want to preserve your changes or
806    click Cancel if you do not want to change the properties.</p>
807                      <h5>Properties</h5>
808                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
809     This action opens a Dialog box that presents the properties of the selected
810    site. The properties of a Site are the label you want to see in the View as
811    well as the Address of the site. If the element you selected was a bookmark,
812    you are able to change both the Site Name and the Site Address of the site.
813    If you change the Site Address of a Bookmark Site you will need to 'refresh'
814    the Bookmark Site to access its new content. Click Ok when you have finished
815    and you want to preserve your changes or click Cancel if you do not want to
816    change the properties.</p>
817                      <h5>Delete</h5>
818                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
819     This action removes the Bookmark Site from the workbench. This does not
820    erase the content of the Site nor the physical remote or local Site itself.</p>
821                      <h3>The WebView</h3>
822                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
823     The Web View is &lt;TODO &gt;</p>
824                      <h3>The flat concept (see Dejan)</h3>
825                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
826     &lt;TODO&gt;</p>
827                      <h3>The Preview View</h3>
828                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
829     The preview shows information about the selected element. The preview view
830    is different for each selected element.</p>
831                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
832     You can open the preview view by either selecting an element in the updates
833    or Configuration view, by opening a context menu on any element in the Updates
834    or Configuration View and selecting Show Details or by open the Preview View
835    from the Workbench menu. Select Window-&gt;Show View-&gt;Other to open the
836    list of available Views. Expand Update Manager Folder, select Preview and
837    Click Ok.</p>
838                      <h4>The 'Home' Preview view.</h4>
839                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
840     You can open the 'Home' Preview by clicking on the home in the local tool
841    bar menu if the View. This view summarizes the different tasks you can achieve
842    through the Install/Update. By using the flat concept you are able to &lt;TODO
843    dejan&gt;</p>
844                      <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">
845                      </p>
846                      <h4>The current configuration Preview view</h4>
847                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
848     This Preview shows information about the product you are using. The content
849    of the view depends on the product you launched. </p>
850                      <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">
851                      </p>
852                      <h4>The Site and Site Bookmark Preview View</h4>
853                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
854     This Preview shows the Site Address of the selected Site or Bookmark Site.</p>
855                      <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">
856                      </p>
857                      <h4>The Feature Preview View</h4>
858                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
859     This Preview View shows information about a feature.</p>
860                      <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">
861                      </p>
862                      <h5>Provider</h5>
863                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
864     The name of the provider of the feature.</p>
865                      <h5>Version</h5>
866                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
867     The version of the feature.</p>
868                      <h5>Installed Version</h5>
869                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
870     The list of already installed version of this feature or 'Not Installed'
871    if no version of this feature has been configured in the current configuration.</p>
872                      <h5>Download Size</h5>
873                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
874     The maximum download size for the feature. If the site you will install
875    the feature in already contains some of the files the feature require, the
876    files will not be installed twice, and thus the downloaded and installed
877    size will be smaller than the maximum one.</p>
878                      <h5>Supported Platforms</h5>
879                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
880     This expandable category shows the different supported platforms for this
881    feature. The categories are Operating Systems, Windowing Systems, Architectures
882    and Languages.</p>
883                      <ul type="Disc">
884                        <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
885         mso-list:l9 level1 lfo11;tab-stops:list .5in">
886     Operating Systems: the list      of supported Operating Systems.</li>
887                        <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
888         mso-list:l9 level1 lfo11;tab-stops:list .5in">
889     Windowing Systems: the list      of supported Windowing Systems.</li>
890                        <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
891         mso-list:l9 level1 lfo11;tab-stops:list .5in">
892     Supported Architectures: the      list of supported processor architecture.</li>
893                        <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
894         mso-list:l9 level1 lfo11;tab-stops:list .5in">
895     Supported Languages: the      list of supported languages.</li>
896                      </ul>
897                      <h5>Description </h5>
898                      <p class="MsoNormal" style="margin-bottom: 12pt; ">The
899    description of the Feature</p>
900                      <h5>More Info </h5>
901                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
902     Opens a page with more information about the feature. The page may be found
903    locally or remotely.</p>
904                      <h5>License</h5>
905                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
906     Opens a page with the license of the Feature.</p>
907                      <h5>Copyright</h5>
908                      <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
909     Opens a page with the copyright of the Feature.</p>
910                      <h5>Actions</h5>
911                      <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
912     In the lower left side of the Preview View for a feature you may see one
913    or multiple buttons. They provide you with actions you can take on the Feature
914    depending of its configuration. If a change is pending for this feature, no
915    actions will be available until the workbench is restarted.</p>
916                      <ul type="Disc">
917                        <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
918         mso-list:l5 level1 lfo12;tab-stops:list .5in">
919     Install: this launches the      Install Wizard for this feature. See <a href="http://www.eclipse.org">
920     Installing      a Feature</a>
921     .</li>
922                        <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
923         mso-list:l5 level1 lfo12;tab-stops:list .5in">
924     Unconfigure: this launches      the Unconfigure Wizard for this configured
925    feature. See <a href="http://www.eclipse.org">Configuring/Unconfiguring a
926    Feature</a>
927  .<br>  .<br>
928           Configure: this launches the Configure Wizard for this unconfigured
929                                     </p>        feature. See <a href="http://www.eclipse.org">Configuring/Unconfiguring
930    a      Feature</a>
931                                     </blockquote>   .<br>
932           Uninstall: this removes the unconfigure feature from the file system.
933    See <a href="http://www.eclipse.org">Removing a Feature</a>
934     .</li>
935                      </ul>
936                      <h4>The Configuration Preview View</h4>
937                      <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
938                                                                                                              <h4>   This preview shows information about the select configuration.</p>
939         Folder</h4>                    <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">
940                      </p>
941                      <p class="MsoNormal"><!--[if !supportEmptyParas]--><!--[endif]--><o:p></o:p></p>
942                      <h5>Created On</h5>
943                      <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
944     The date in the current locale, the configuration was created on.</p>
945                      <h5>Current Configuration</h5>
946                                                                                                              <blockquote>                    <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
947     If the selected configuration is the active configuration.</p>
948                      <h5>Activities</h5>
949                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
950     List of activities that led to the creation of the configuration. For more
951    information about the different activities, see <a href="http://www.eclipse.org">
952     Activities</a>
   
                                                                                                               <p class="MsoNormal">  
 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 chan 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>  
953  .</p>  .</p>
954                      <h5>Configuration Reversal</h5>
955                                       </blockquote>                    <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
956     In the lower left side of the Preview View for a configuration you may see
957    one button. It provides you with actions you can take on the Configuration
958    depending if it is the current configuration or another one. If a change is
959    pending for a feature, no actions will be available until the workbench is
960    restarted.</p>
961                      <ul type="Disc">
962                        <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
963                                                                                                                <h4>       mso-list:l6 level1 lfo13;tab-stops:list .5in">
964      Local View Toolbar Actions</h4>   Restore: this restores the      selected configuration. See <a href="http://www.eclipse.org">
965     Restore a      Configuration/Revert to previous configuration</a>
966     .</li>
967                        <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
968         mso-list:l6 level1 lfo13;tab-stops:list .5in">
969     Revert: this revert the      current configuration to the previous configuration.
970    See <a href="http://www.eclipse.org">Restore a Configuration/Revert to previous
971          configuration</a>
972                                                                                                                <blockquote>   .</li>
973      This section describes the local view toolbar actions of the Updates                    </ul>
974  View.<br>                    <h4>The search Preview View</h4>
975                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
976                                         </blockquote>   This view allows you to change the search query, enter the appropriate settings
977    for the query, set the scope of the search, run the query and see the result
978    of the query. The settings are different for each query.</p>
979                      <h5>Change the query</h5>
980                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
981     To change the category of the query, expand Query Settings. Expand the Search
982    Category Settings and select the desired search category.</p>
983                      <h5>Enter the settings</h5>
984                                                                                                                  <h5>                    <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
985      Show Feature Categories </h5>   Each category has its own settings. For more information about the different
986    settings for a category: see <a href="http://www.eclipse.org">Searching New
987    Features</a>
988     .</p>
989                      <h5>Set the scope</h5>
990                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
991     To change the scope of the search, expand Scope Settings. You can select
992    to search the local file system, the discovery sites in 'places to visit'
993                                                                                                                  <blockquote>  and/or the bookmarked sites you created. When searching the local file system,
994      When this action is selected,  you will see the features organized in  click Settings to select which root folder will be searched.</p>
995  categories.<br>                    <h5>Run the query</h5>
996                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
997                                             <img src="images/pic008.gif" alt="Categories" width="253" height="193">   Click Search Now to run the query.</p>
998                      <h5>See the results</h5>
999                                             <br>                    <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1000     The result will appear at the bottom of the View. Select Show Results in
1001    Extended Form to have more information about the features.</p>
1002                      <h3>The Install/Update Preference Page</h3>
1003                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1004     You can open the preference page from the Workbench main menu. Click Window-&gt;preferences
1005    to open the Preference Dialog. Select Install/Update to reveal the Install/Update
1006    preference Page. In this page, you can modify the number of history configuration
1007    you want the workbench to manage as well as decide which browser to open.</p>
1008                      <h4>Maximum number of 'History' configurations entry field.</h4>
1009                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1010     Enter the number of history configurations you want the Install/Update to
1011    keep. See <a href="http://www.eclipse.org">Configuration History</a>
1012      for more information.</p>
1013                      <h4>Web Links radio buttons.</h4>
1014                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1015     When opening Web links. It allows you to choose between opening the internal
1016    WebView and opening an external browser.</p>
1017                      <h2>Finding features</h2>
1018                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1019     This section will explain how to find the features to install. There are
1020    different way of looking for features; you may know exactly which feature
1021    you need and where it is located, or you may want to search for an update
1022    of an already installed feature is available, finally you may just decide
1023    to browse or search to discover new sites and new features. </p>
1024                      <h3>Find a specific feature </h3>
1025                      <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1026     This section will focus on finding a feature when you know exactly where
1027    to find it. To find a feature you may either add the Update Site that contains
1028    this feature and browse the site to find the feature, or open the WebView
1029    and browse to the Feature WebPage.</p>
1030                      <h4>Add a new Update Site </h4>
1031                      <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1032     To add a new Update site, open the context Menu in the Updates View and
1033    select New-&gt;Site Bookmark....  This opens a Dialog box that presents the
1034    properties of the Bookmark Site you want to create. The properties of a Bookmark
1035    Site are the label you want to see in the View as well as the URL of the
1036    physical site. You have to enter the Site URL. Optionally you can enter the
1037    Site Name. If you do not enter a Site Name, it will default to the Site URL.
1038    Click Ok when you have finished and you want to preserve your changes or
1039    click Cancel if you do not want to create a new Site Bookmark.  </p>
1040                      <h4>Find the feature   </h4>
1041                      <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1042     Expand the site to find the feature you want. You can find the feature by
1043    looking at the label or selecting a feature and reading the preview view.
1044    To know more about preview view:  See <a href="http://www.eclipse.org">Preview
1045    View</a>
1046     .</p>
1047                      <h4>Browse WebPages </h4>
1048                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1049     Open the <a href="http://www.eclipse.org">WebView</a>
1050      and enter the URL for the feature web page. Follow the indication of the
1051    web page. &lt;TODO web install&gt;</p>
1052                      <h3>Update already existing features</h3>
1053                      <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1054     This section will focus on updating features that are configured in your
1055    current configuration. To know how to configure/unconfigure a feature: see:
1056                <a href="http://www.eclipse.org">Configuring/Unconfiguring</a>
1057     .</p>
1058                      <h4>Search for updates</h4>
1059                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1060     To search for available updates, select Available Updates in the Updates
1061    View. In the preview view, press Search now.  This will search the site the
1062    configured feature come from for new version the installed and configured
1063    feature. During the search you will see the progress monitor move, indicating
1064    the search is in progress. When new version of configured features are found,
1065    they will appear under the progress monitor.  You can decide to see the result
1066    in a short form or an extended form by checking the 'Show results in extended
1067    form' box, under the Scope Settings section in the preview view.</p>
1068                      <h4>Search the file system</h4>
1069                      <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1070     You can decide to search the file system for updates by checking the 'Include
1071    my computer in the search' box, under the Scope Settings section in the preview
1072    view. Click on the Settings... button to customize which part of the file
1073    system you want to search.</p>
1074                      <h4>Customize Search</h4>
1075                      <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1076     You can customize the search for updates by creating a new search. To know
1077    how to create a new search: see <a href="http://www.eclipse.org">Updates View:
1078    Context Action [new-&gt;search]</a>
1079     .</p>
1080                      <h3>Browse to discover</h3>
1081                      <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1082     This section will focus on browsing update sites to find the features you
1083    want to install. The entire update site appears in the Updates View. There
1084    are different places in the view where you can find sites to browse. You may
1085    have sites in the folder 'Places to visit' or you may have sites on your file
1086    system. You can also add some update site if you know their URL.</p>
1087                      <h4>Browse already existing sites</h4>
1088                      <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1089     If you expand the folder 'Places to visit' you may see some sites. They
1090    were automatically added to the folder by the feature you installed. You
1091    can expand the site and browse the features.</p>
1092                      <h4>Browse the file system</h4>
1093                      <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1094     To browse the file system, expand 'My Computer'.  &lt;TODO what more to
1095    say?&gt;</p>
1096                      <h4>Add a new Update Site </h4>
1097                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1098     You can add a new update site from the context menu. Select new-&gt;Site
1099    Bookmark... This opens a Dialog box that presents the properties of the Bookmark
1100    Site you want to create. The properties of a Bookmark Site are the label you
1101    want to see in the View as well as the Address of the physical site. You
1102    have to enter the Site URL. Optionally you can enter the Site Name. If you
1103    do not enter a Site Name, it will default to the Site URL. Click Ok when you
1104    have finished and you want to preserve your changes or click Cancel if you
1105    do not want to create a new Site Bookmark. Once the site has been created,
1106    expand the icon to see the categories and or the available features.</p>
1107                      <h4>Add a bookmark of a file system site.</h4>
1108                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1109     When you browse the file system, you can add a file system site as a bookmark.
1110    Select the site. Open the context menu. Select  'Bookmark Location'. This
1111    action lets you create bookmark site for a site found on your local file system.
1112    This opens a Dialog box that presents the properties of the selected site.
1113    The properties of a Site are the label you want to see in the View as well
1114    as the Address of the site. You are able to change the Site Name. Click Ok
1115    when you have finished and you want to preserve your changes or click Cancel
1116    if you do not want to change the properties. Once the site has been created,
1117    expand the icon to see the categories and or the available features.</p>
1118                      <h3>Searching Features</h3>
1119                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1120     This section will explain how to find features by using the search mechanism.
1121    It will first focus on finding update of configured features, then it will
1122    explain how to search the file system, finally it will expose how to customize
1123    a search by presenting the three default search categories.</p>
1124                      <h4>Search for updates</h4>
1125                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1126     To search for available updates, select Available Updates in the Updates
1127    View. In the preview view, press Search now.  This will search the site the
1128    configured features come from for new versions. During the search you will
1129    see the progress monitor move, indicating the search is in progress. When
1130    new version of configured features are found, they will appear under the progress
1131    monitor.  You can decide to see the result in a short form or an extended
1132    form by checking the 'Show results in extended form' box, under the Scope
1133    Settings section in the preview view.</p>
1134                      <h4>Search the file system</h4>
1135                      <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1136     You can decide to search the file system for updates by checking the 'Include
1137    my computer in the search' box, under the Scope Settings section in the preview
1138    view. Click on the Settings... button to customize which part of the file
1139    system you want to search.</p>
1140                      <h4>Customize Search</h4>
1141                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1142     Three default categories of search are provided: Search for available updates,
1143    search features based on regular expression and search features that contain
1144    a specific plugin. You may see other categories. Check the user documentation
1145    of the features that provide the extra categories to learn more about them.</p>
1146                      <h5>Available Updates</h5>
1147                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1148     This search attempts to find update of configured features. There are no
1149    special settings to fill when running this query. The query will find all
1150    new version of configured features based on the search scope. To know more
1151    about the scope of the search: see <a href="http://www.eclipse.org">Search
1152    Preview View</a>
1153     .</p>
1154                      <h5>Regular Expression</h5>
1155                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1156     This search attempts to find features based on a simple regular expression
1157    query. You must change the settings of the query before running it. Select
1158    the query in the Updates View. In the preview view, expand Query Settings.</p>
1159                      <ul type="Disc">
1160                        <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
1161         mso-list:l7 level1 lfo14;tab-stops:list .5in">
1162     Type the string you want to      search for in the Expression Entry Field.</li>
1163                        <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
1164         mso-list:l7 level1 lfo14;tab-stops:list .5in">
1165     Check the check box if you      want the search to be case sensitive. A
1166    case sensitive search will consider      Uppercase and Lowercase character
1167    as different.</li>
1168                        <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
1169         mso-list:l7 level1 lfo14;tab-stops:list .5in">
1170     Selection where you want the      search to occur by checking Feature Name,
1171    Feature Provider and/or Feature      Description.</li>
1172                      </ul>
1173                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1174     The query will find the features that match the query based on the scope.
1175    To know more about the scope of the search: see <a href="http://www.eclipse.org">
1176     Search Preview View</a>
1177     .</p>
1178                      <h5>Plug-ins</h5>
1179                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1180     This search attempts to find feature that contain a specific plug-in. You
1181    must change the settings of the query before running it. Select the query
1182    in the Updates View. In the preview view, expand Query Settings.</p>
1183                      <ul type="Disc">
1184                        <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
1185         mso-list:l8 level1 lfo15;tab-stops:list .5in">
1186     Click New to add a specific plug-in.      &lt;TODO doesn't work in 0423&gt;</li>
1187                      </ul>
1188                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1189     The query will find the features that match the query based on the scope.
1190    To know more about the scope of the search: see <a href="http://www.eclipse.org">
1191     Search Preview View</a>
1192     .</p>
1193                      <h2>Installing a Feature</h2>
1194                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1195     This section will describe the Wizard used to install, configure, unconfigure
1196    and remove a feature as well as the verification task that may occur when
1197    installing a new feature. The first part will focus on the three tab that
1198    are part of the Wizard, while the second part will deal with verification
1199    and security issues when installing a feature.</p>
1200                      <h3>Install Wizard</h3>
1201                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1202     The Wizard will help you install, configure, unconfigure and remove a feature.
1203    It will allow you to review any license agreement and to choose the Site in
1204    which you wish to install the feature.</p>
1205                      <h4>The Preview Tab</h4>
1206                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1207     This tab summarizes the action you are going to take. </p>
1208                      <div align="Center">
1209                      <p class="MsoNormal"><img border="0" width="500" height="500" id="_x0000_i1042" src="images%5Cpic002.gif" alt="Install Wizard Preview Tab PIC002.gif">
1210                      </p>
1211                      </div>
1212                      <h4> The License Tab</h4>
1213                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1214     This tab will present you the license you have to agree with to install
1215    the product. Click on agree if you agree with the whole license and whish
1216    to continue or click cancel to abort the installation</p>
1217                      <h4>Site location Tab</h4>
1218                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1219     This tab has three main goals. The first one is to show you the available
1220    sites on your local file system, the second is the ability to create a new
1221    site if the one proposed are not satisfactory, finally you will be able to
1222    see the space left on the selected site and the size in kilobyte of the feature
1223    you are about to install.</p>
1224                      <h4>Verification </h4>
1225                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1226     Verification is an important part of the install process. It will allow
1227    you to verify if the feature you are about to install has been digitally
1228    signed, not digitally signed or tempered with. When a feature or a file has
1229    been digitally signed, you will be able to see the certificate used to sign
1230    the feature. A certificate will contain information about the entity that
1231    signed the feature, and information about the entity that authenticated the
1232    first entity. If the entity authenticated itself, you will only see one entity.</p>
1233                      <h5>Signed</h5>
1234                      <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1235     A dialog with the following will appear if the feature or one of its files
1236    has been signed. A signed feature means the signer has digitally signed the
1237    file, and the authenticator has authenticated the signer.</p>
1238                      <blockquote>
1239                        <p class="MsoNormal"><img border="0" width="251" height="85" id="_x0000_i1043" src="images%5Cpic018.gif" alt="Signed Feature">
1240                        </p>
1241                        </blockquote>
1242                        <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1243      The authenticator can be the same entity as the signer, in which case you
1244    will see such a dialog. You have to be very careful with self-signed certificate,
1245    as the authentication of the signer cannot be verified.</p>
1246                        <blockquote>
1247                          <p class="MsoNormal"><img border="0" width="600" height="189" id="_x0000_i1044" src="images%5Cpic019.gif" alt="Self Sigend Certificate">
1248                          </p>
1249                          </blockquote>
1250                          <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1251     In some cases, the authenticator is a different entity than the signer.<br>
1252      If you do not authorize the authenticator, you will see such a dialog.
1253    You have to be very careful with signed certificate you didn't authorize,
1254    as the authenticator of the certificate is not one of the worldwide known
1255    authenticator.</p>
1256                          <blockquote>
1257                            <p class="MsoNormal"><img border="0" width="600" height="234" id="_x0000_i1045" src="images%5Cpic020.gif" alt="Root not trusted">
1258                            </p>
1259                            </blockquote>
1260                            <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1261     If the signature of the authenticator has been authorized before, you will
1262    see such a dialog &lt;PICTURE&gt;. You have to be careful with signed certificate
1263    you authorized, as the authenticator of the certificate only validates that
1264    the signer has been authenticated. It does not provide any guarantee as to
1265    the feature you are going to install. Only install if you trust the signer.</p>
1266                            <blockquote>
1267                              <p class="MsoNormal"><img border="0" width="600" height="265" id="_x0000_i1046" src="images%5Cpic021.gif" alt="Root Trusted">
1268                              </p>
1269                              </blockquote>
1270                              <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1271     Click continue or install only if you trust the signer of the feature file
1272    and you want to install the feature, or click cancel if you want to abort
1273    the installation.<br>
1274                                             <br>                                             <br>
1275    When this action is not selected, you will see all the features as a list.<br>    To learn more about how to authorize an authenticator: see <a href="http://www.eclipse.org">
1276     Security and Keystore Management</a>
1277                                             <img src="images/pic008b.gif" alt="No Categories" width="253" height="97">   .</p>
1278                              <h5>Non Signed</h5>
1279                                           </blockquote>                            <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1280     A dialog like the following will appear if the feature or one of its files
1281    has not been signed.</p>
1282                              <blockquote>
1283                                <p class="MsoNormal"><img border="0" width="289" height="84" id="_x0000_i1047" src="images%5Cpic016.gif" alt="Non Signed Feature">
1284                                </p>
1285                                </blockquote>
1286                                <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1287                                                                                                                    <h5>   When a feature has not been signed, we cannot authenticate the sender of
1288      Show My Computer Files </h5>  the package, nor can we certify the validity of any of the file. Click continue
1289    or install only if you want to install the feature, or click cancel if you
1290    want to abort the installation.</p>
1291                                <h5>Corrupted </h5>
1292                                <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1293     If the content of a feature has changed since it has been signed, you will
1294    see such a dialog.</p>
1295                                <blockquote>
1296                                                                                                                    <blockquote>                                <p class="MsoNormal"><img border="0" width="599" height="187" id="_x0000_i1048" src="images%5Cpic017.gif" alt="Corrupted Feature">
1297      When this action is seelcted, you will be able to browse the files when                                </p>
1298   you expand MyComputer.<br>                                </blockquote>
1299                                  <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1300                                               <img src="images/pic009.gif" alt="Browse Files" width="251" height="249">   This means the content has been tempered with since the feature has been
1301    signed. The content of the feature has been changed since it has been packaged.
1302                                               <br>  You should notify the signer of the package. Install/Update will prevent you
1303    from installing such a feature. Click cancel if you want to abort the installation
1304                                             </blockquote>  and contact the provider of the feature and/or the site. </p>
1305                                  <h5>Persistence of the answer</h5>
1306                                  <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1307     If click continue or install on a verification dialog, the Install/Update
1308    component will remember your action and will not prompt you again if one of
1309    the file of the feature is about to show the exact same verification dialog.
   
   
                                                                                                                     <h4>  
     Context Actions</h4>  
   
   
   
   
   
   
   
                                                                                                                     <blockquote>  
     This section describes the different context actions available in the  
 Updates  View.  
                                                         </blockquote>  
   
   
   
   
   
   
   
                                                                                                                       <h5>  
     New-&gt;Site Bookmark...</h5>  
   
   
   
   
   
   
   
                                                                                                                       <blockquote>  
   
   
   
   
   
   
   
                                                                                                                         <p class="MsoNormal">  
     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.<br>  
   
                                                </p>  
   
                                                </blockquote>  
   
   
   
   
   
   
   
                                                                                                                         <h5>  
        New-&gt;Folder</h5>  
   
   
   
   
   
   
   
                                                                                                                         <blockquote>  
   This action lets you create a new Folder. When you select this action,  
 a  dialog will open.<br>  
   
                                                    <img src="images/pic011.gif" alt="New Folder Dialog" width="438" height="481">  
   
                                                    <br>  
   
                                                    <br>  
   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 are selected,  
 the newly  created folder will appear in the updates view as a root folder.<br>  
   
                                                    <img src="images/pic010.gif" alt="folders" width="251" height="249">  
  <img src="pic010.gif" alt="folders">  
   
                                                    <br>  
   
                                                  </blockquote>  
   
   
   
   
   
   
   
                                                                                                                           <h5>  
     New-&gt;Search</h5>  
   
   
   
   
   
   
   
                                                                                                                           <blockquote>  
 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>  
 .<br>  
   
                                                    </blockquote>  
   
   
   
   
   
   
   
                                                                                                                             <h5>  
     Show Details</h5>  
   
   
   
   
   
   
   
                                                                                                                             <blockquote>  
   
   
   
   
   
   
   
                                                                                                                               <p class="MsoNormal">  
     This action opens or refreshes the Preview View with the details  of  
 the   selected element.<br>  
        </p>  
   
                                                      </blockquote>  
   
   
   
   
   
   
   
                                                                                                                               <h5>  
     Refresh</h5>  
   
   
   
   
   
   
   
                                                                                                                               <blockquote>  
     This action re-initializes the content of an element &lt;TODO  see dejan&gt;<br>  
   
                                                        </blockquote>  
   
   
   
   
   
   
   
                                                                                                                                 <h5>  
     Bookmark Location</h5>  
   
   
   
   
   
   
   
                                                                                                                                 <blockquote>  
     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.<br>  
   
                                                          </blockquote>  
   
   
   
   
   
   
   
   
                                                                                                                                   <h5>  
     Properties</h5>  
   
   
   
   
   
   
   
   
                                                                                                                                   <blockquote>  
     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.<br>  
   
                                                            </blockquote>  
   
   
   
   
   
   
   
   
                                                                                                                                     <h5>  
     Delete</h5>  
   
   
   
   
   
   
   
   
                                                                                                                                     <blockquote>  
     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.<br>  
   
                                                              </blockquote>  
   
   
   
   
   
   
   
   
                                                                                                                                       <h3>  
     The WebView</h3>  
   
   
   
   
   
   
   
   
                                                                                                                                       <blockquote>  
     The Web View is &lt;TODO &gt;<br>  
   
                                                                </blockquote>  
   
   
   
   
   
   
   
   
                                                                                                                                         <h3>  
     The flat concept (see Dejan)</h3>  
   
   
   
   
   
   
   
   
                                                                                                                                         <blockquote>  
     &lt;TODO&gt;<br>  
   
                                                                  </blockquote>  
   
   
   
   
   
   
   
   
                                                                                                                                           <h3>  
     The Preview View</h3>  
   
   
   
   
   
   
   
   
                                                                                                                                           <blockquote>  
     The preview shows information about the selected element. The preview  
  view  is different for each selected element.<br>  
   
                                                                    </blockquote>  
   
   
   
   
   
   
   
   
                                                                                                                                             <h4>  
        </h4>  
   
   
   
   
   
   
   
   
                                                                                                                                             <blockquote>  
     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.<br>  
   
                                                                      </blockquote>  
   
   
   
   
   
   
   
   
                                                                                                                                               <h4>  
        The 'Home' Preview view.</h4>  
   
   
   
   
   
   
   
   
                                                                                                                                               <blockquote>  
     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  link&gt;<br>  
   
   
   
   
                                                                                                                                                 <div align="Center"><img src="images/pic012.gif" alt="Home Preview" width="507" height="503">  
   
   
                                                                                                                                                 <br>  
   
                                                                        </div>  
   
   
                                                                                                                                                 </blockquote>  
   
   
   
   
   
   
   
   
                                                                                                                                                 <h4>  
        The current configuration Preview view</h4>  
   
   
   
   
   
   
   
   
                                                                                                                                                 <blockquote>  
     This Preview shows information about the product you are  using. The  
 content   of the view depends on the product you launched. <br>  
   
   
   
   
   
                                                                                                                                                   <div align="Center"><img src="images/pic012b.gif" alt="product preview" width="507" height="503">  
   
   
   <br>  
   
   
                                                                                                                                                   </div>  
   
   
   </blockquote>  
   
   
   
   
   
   
   
   
                                                                                                                                                   <h4>  
        The Site and Site Bookmark Preview View</h4>  
   
   
   
   
   
   
   
   
                                                                                                                                                   <blockquote>  
     This Preview shows the Site Address of the selected Site or  Bookmark  
 Site.<br>  
   
   
   
   
   
                                                                                                                                                     <div align="Center"><img src="images/pic012c.gif" alt="Site Preview" width="507" height="503">  
   
   
     <br>  
   
   
   
   
     </div>  
   
   
     </blockquote>  
   
   
   
   
   
   
   
   
   
                                                                                                                                                     <h4>  
        The Feature Preview View</h4>  
   
   
   
   
   
   
   
   
   
                                                                                                                                                     <blockquote>  
     This Preview View shows information about a feature.<br>  
   
   
   
   
   
                                                                                                                                                       <div align="Center"><img src="images/pic012d.gif" alt="Feature Preview" width="507" height="669">  
     
   
        <br>  
   
   
     </div>  
   
   
       </blockquote>  
   
   
   
   
   
   
   
   
   
                                                                                                                                                       <h5>  
        Provider</h5>  
   
   
   
   
   
   
   
   
   
                                                                                                                                                       <blockquote>  
     The name of the provider of the feature.<br>  
   
   
       </blockquote>  
   
   
   
   
   
   
   
   
   
                                                                                                                                                         <h5>  
        Version</h5>  
   
   
   
   
   
   
   
   
   
                                                                                                                                                         <blockquote>  
     The version of the feature.<br>  
   
   
         </blockquote>  
   
   
   
   
   
   
   
   
   
                                                                                                                                                           <h5>  
        Installed Version</h5>  
   
   
   
   
   
   
   
   
   
                                                                                                                                                           <blockquote>  
     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.<br>  
   
   
           </blockquote>  
   
   
   
   
   
   
   
   
   
                                                                                                                                                             <h5>  
        Download Size</h5>  
   
   
   
   
   
   
   
   
   
                                                                                                                                                             <blockquote>  
     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.<br>  
   
   
             </blockquote>  
   
   
   
   
   
   
   
   
   
                                                                                                                                                               <h5>  
        Supported Platforms</h5>  
   
   
   
   
   
   
   
   
   
                                                                                                                                                               <blockquote>  
     This expandable category shows the different supported  platforms for  
 this  feature. The categories are Operating Systems, Windowing  Systems, Architectures  
  and Languages.<br>  
   
   
               </blockquote>  
   
   
   
   
   
   
   
   
   
                                                                                                                                                                 <ul>  
   
   
                 <li>    Operating Systems: the list of supported Operating  
  Systems.</li>  
   
   
                 <li>    Windowing Systems: the list of supported Windowing  
  Systems.</li>  
   
   
                 <li>    Supported Architectures: the list of supported processor  
  architecture.</li>  
   
   
                 <li>    Supported Languages: the list of supported languages.<br>  
        </li>  
   
   
   
   
   
   
   
   
   
                                                                                                                                                                 </ul>  
   
   
   
   
   
   
   
   
   
                                                                                                                                                                 <h5>  
     Description </h5>  
   
   
   
   
   
   
   
   
   
                                                                                                                                                                 <p class="MsoNormal">  
     The description of the Feature<br>  
        <br>  
   
   
               </p>  
   
   
   
   
   
   
   
   
   
                                                                                                                                                                 <h5>  
     More Info &lt;TODO should we say it is optional ?&gt;</h5>  
   
   
   
   
   
   
   
   
   
                                                                                                                                                                 <blockquote>  
     Opens a page with more information about the feature.  The page may be  
  found  locally or remotely.<br>  
   
   
                 </blockquote>  
   
   
   
   
   
   
   
   
   
                                                                                                                                                                   <h5>  
     License</h5>  
   
   
   
   
   
   
   
   
   
                                                                                                                                                                   <blockquote>  
     Opens a page with the license of the Feature.<br>  
   
   
                   </blockquote>  
   
   
   
   
   
   
   
   
   
                                                                                                                                                                     <h5>  
        Copyright</h5>  
   
   
   
   
   
   
   
   
   
                                                                                                                                                                     <blockquote>  
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                       <p class="MsoNormal">  
     Opens a page with the copyright of the Feature.<br>  
   
   
                     </p>  
   
   
                     </blockquote>  
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                       <h5>  
        Actions</h5>  
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                       <blockquote>  
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                         <p class="MsoNormal">  
     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.<br>  
   
   
                       </p>  
   
   
                       </blockquote>  
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                         <ul>  
   
   
                         <li>    <span style="mso-spacerun: yes"></span>Install:  
  this launches the Install Wizard for this feature.  See <a href="http://www.eclipse.org">  
    Installing a Feature</a>  
        .<br>  
   
   
                         </li>  
   
   
                         <li>    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>  
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                         <blockquote>  
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                           <p class="MsoNormal">  
     This preview shows information about the select configuration.<br>  
   
   
                          </p>  
   
   
   
                                                                                                                                                                           <div align="Center"><img src="images/pic013.gif" alt="Configuration Preview" width="621" height="488">  
   
   
                          <br>  
   
   
                          </div>  
   
   
                          </blockquote>  
   
   
   
                                                                                                                                                                           <p class="MsoNormal"><br>  
   
   
                          </p>  
   
   
   
                                                                                                                                                                           <h5>  
  Created On</h5>  
   
   
   
                                                                                                                                                                           <blockquote>  
   
   
   
                                                                                                                                                                             <p class="MsoNormal">  
  The date in the current locale, the configuration was created on.<br>  
   
   
                            </p>  
   
   
                            </blockquote>  
   
   
   
                                                                                                                                                                             <h5>  
  Current Configuration</h5>  
   
   
   
                                                                                                                                                                             <blockquote>  
   
   
   
                                                                                                                                                                               <p class="MsoNormal">  
  If the selected configuration is the active configuration.<br>  
   
   
                              </p>  
   
   
                              </blockquote>  
   
   
   
                                                                                                                                                                               <h5>  
  Activities</h5>  
   
   
   
                                                                                                                                                                               <blockquote>  
  List of activities that led to the creation of the configuration. For more  
 information about the differents activities, see <a href="http://www.eclipse.org">  
  Activities</a>  
  .<br>  
   
   
                                </blockquote>  
   
   
   
                                                                                                                                                                                 <p class="MsoNormal"></p>  
   
   
   
                                                                                                                                                                                 <h5>  
  Configuration Reversal</h5>  
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                 <blockquote>  
     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.</blockquote>  
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                   <ul>  
   
   
                             <li> Restore: this restores the selected configuration.  
  See <a href="http://www.eclipse.org"> Restore a Configuration/Revert to previous  
  configuration</a>  
     .<br>  
   
   
                             </li>  
   
   
                             <li> 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>  
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                   <p class="MsoNormal"></p>  
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                   <h4>  
     The search Preview View</h4>  
                                                                                                                                                                                   <blockquote>  
   
   
   
   
   
   
   
   
   
                                     This view allows you to change the search  
 query, enter the appropriate settings for the query, set the scope of the  
 serahc, run the query and see the result of the query. The settings  are  
 different for each query.<br>  
                                                                                                                                                                                     </blockquote>  
                                                                                                                                                                                     <h5>  
 Change the query</h5>  
                                                                                                                                                                                     <blockquote>  
 To change the category of the query, expand Query Settings. Expand the Search  
 Category Settings and select the desired search category.<br>  
                                                                                                                                                                                       </blockquote>  
                                                                                                                                                                                       <h5>  
 Enter the settings</h5>  
                                                                                                                                                                                       <blockquote>  
 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>  
 .<br>  
                                                                                                                                                                                         </blockquote>  
                                                                                                                                                                                         <h5>  
 Set the scope</h5>  
                                                                                                                                                                                         <blockquote>  
 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.<br>  
                                                                                                                                                                                           </blockquote>  
                                                                                                                                                                                           <h5>  
 Run the query</h5>  
                                                                                                                                                                                           <blockquote>  
 Click Search Now to run the query.<br>  
                                                                                                                                                                                             </blockquote>  
                                                                                                                                                                                             <h5>  
 See the results</h5>  
                                                                                                                                                                                             <blockquote>  
 The result will appear at the bottom of the View. Select  Show Results in  
 Extended Form to have more information about the features.<br>  
                                                                                                                                                                                               </blockquote>  
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                               <h3>  
     The Install/Update Preference Page</h3>  
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                               <blockquote>  
     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   .<br>  
   
   
                               </blockquote>  
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                 <p class="MsoNormal"></p>  
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                 <h4>  
  Maximum number of 'History' configurations entry field.<br>  
   
   
                               </h4>  
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                 <blockquote>  
     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.<br>  
   
   
                                 </blockquote>  
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                   <h4>  
     Web Links radio buttons.</h4>  
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                   <blockquote>  
     When opening Web links. Allows you to choose between opening the internal  
   WebView or opening an external browser.<br>  
   
   
                                   </blockquote>  
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                     <h2>  
     Finding features</h2>  
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                     <blockquote>  
        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. <br>  
   
   
                                     </blockquote>  
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                       <h3>  
        Find a specific feature </h3>  
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                       <blockquote>  
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                         <p class="MsoNormal">  
     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 you can  
 open the  WebView and browe to the Feature WebPage.</p>  
   
   
                                       </blockquote>  
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                         <h4>  
     Add a new Update Site </h4>  
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                         <blockquote>  
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                           <p class="MsoNormal">  
     To add a new Update site, open the context  Menu in the Updates View  
 and   select New-&gt;Site Bookmerk....  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>  
   
   
                                         </blockquote>  
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                           <h4>  
     Find the feature   </h4>  
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                           <blockquote>  
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                             <p class="MsoNormal">  
     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>  
   
   
                                           </blockquote>  
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                             <h4>  
     Browse WebPages </h4>  
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                             <blockquote>  
     Open the <a href="http://www.eclipse.org">WebView</a>  
        and enter the URL for the feature web page. Follow the indication  
 of  the  webpage. &lt;TODO web install&gt;<br>  
   
   
                                             </blockquote>  
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                               <h3>  
     Update already existing features</h3>  
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                               <blockquote>  
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                 <p class="MsoNormal">  
     This section will focus on updating features  that are configured in  
 your   current configuration.To know how to configure/unconfigure a fetaure;  
 see:  
   
                                                  <a href="http://www.eclipse.org">  
     Configuring/Unconfiguring</a>  
      .&lt;TODO only configured features ?&gt;  </p>  
   
   
                                               </blockquote>  
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                 <h4>  
     Search for updates</h4>  
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                 <blockquote>  
     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.<br>  
   
   
                                                 </blockquote>  
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                   <h4>  
     Search the file system</h4>  
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                   <blockquote>  
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                     <p class="MsoNormal">  
     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>  
   
   
                                                   </blockquote>  
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                     <h4>  
     Customize Search</h4>  
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                     <blockquote>  
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                       <p class="MsoNormal">  
     You can cutomize 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>  
   
   
                                                     </blockquote>  
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                       <h3>  
     Browse to discover</h3>  
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                       <blockquote>  
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                         <p class="MsoNormal">  
     This section will focus on browsing update sites to find the features  
 you  want to install. All the update site appear 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.<br>  
      </p>  
   
   
                                                       </blockquote>  
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                         <h4>  
     Browse already existing sites</h4>  
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                         <blockquote>  
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                           <p class="MsoNormal">  
     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>  
   
   
                                                         </blockquote>  
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                           <h4>  
     Browse the file system</h4>  
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                           <blockquote>  
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                             <p class="MsoNormal">  
     To browse the file system, expand 'My Computer'.  &lt;TODO what more  
 to say?&gt;</p>  
   
   
                                                           </blockquote>  
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                             <h4>  
     Add a new Update Site </h4>  
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                             <blockquote>  
     You can add a new update site from the context menu. Select new-&gt;SiteBookmark...  
   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 youdo  
 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.<br>  
   
   
                                                             </blockquote>  
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                               <h4>  
     Add a bookmark of a file system site.</h4>  
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                               <blockquote>  
     When you browse the file syste, 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.<br>  
   
   
                                                               </blockquote>  
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                 <h3>  
     Searching Features</h3>  
                                                                                                                                                                                                                                 <blockquote>  
 This section will explain how to find features by using the search mecanism.  
 It will first focus on finding features that are update of already installed  
 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.<br>  
                                                                                                                                                                                                                                   </blockquote>  
                                                                                                                                                                                                                                   <h4></h4>  
                                                                                                                                                                                                                                   <h5></h5>  
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                   <h4>  
     Search for updates</h4>  
                                                                                                                                                                                                                                   <blockquote>  
 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.<br>  
                                                                                                                                                                                                                                     </blockquote>  
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                     <h4>  
     Search the file system</h4>  
                                                                                                                                                                                                                                     <blockquote>  
                                                                                                                                                                                                                                       <p class="MsoNormal">  
     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>  
                                                                                                                                                                                                                                       </blockquote>  
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                       <h4>  
     Customize Search</h4>  
                                                                                                                                                                                                                                       <blockquote>  
 Three default categories of search are provided: Search for availables updates,  
 search features based on regular expression and search features that containf  
 a specific plugins. You may see other categories. Check the user documentation  
 of the features that provide the extra categories to learn more about them.<br>  
                                                                                                                                                                                                                                         </blockquote>  
                                                                                                                                                                                                                                         <h5>  
 Available Updates</h5>  
                                                                                                                                                                                                                                         <blockquote>  
 This search attemps to find update of already installed features. There is  
 no special settings to fill when running this query. The query will find  
 all new version of installed features based on the scope. To know more about  
 the scope of the search: see <a href="http://www.eclipse.org">Search Preview  
 View</a>  
 .<br>  
                                                                                                                                                                                                                                           </blockquote>  
                                                                                                                                                                                                                                           <h5>  
 Regular Expression</h5>  
                                                                                                                                                                                                                                           <blockquote>  
 This search attemps 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.<br>  
                                                                                                                                                                                                                                             </blockquote>  
                                                                                                                                                                                                                                             <ul>  
                                                                                                                                                                                                                                               <li>  
 Type the string you want to search for in the Expression Entry Field.</li>  
                                                                                                                                                                                                                                               <li>  
 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>  
 Selection where you want the search to occur by checking Feature Name, Feature  
 Provider and/or Feature Description.</li>  
                                                                                                                                                                                                                                             </ul>  
                                                                                                                                                                                                                                             <blockquote>  
 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>  
  .</blockquote>  
                                                                                                                                                                                                                                               <h5>  
 Plug-ins</h5>  
                                                                                                                                                                                                                                               <blockquote>  
 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.<br>  
                                                                                                                                                                                                                                                 </blockquote>  
                                                                                                                                                                                                                                                 <ul>  
                                                                                                                                                                                                                                                   <li>  
 Click New to add a specific plugin. &lt;TODO doesn't work in 0423&gt;</li>  
                                                                                                                                                                                                                                                 </ul>  
                                                                                                                                                                                                                                                 <blockquote>  
 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>  
   .<br>  
                                                                                                                                                                                                                                                   </blockquote>  
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                                   <h2>  
        Installing a Feature</h2>  
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                                   <blockquote>  
        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.<br>  
   
   
                                                                 </blockquote>  
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                                     <h3>  
        Install Wizard</h3>  
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                                     <blockquote>  
        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.<br>  
   
   
                                                                   </blockquote>  
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                                       <h4>  
     The Preview Tab</h4>  
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                                       <blockquote>  
     This tab summarizes the action you are going to take. <br>  
   
   
                                                                     </blockquote>  
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                                         <div align="Left"><img src="images/pic002.gif" alt="Install Wizard Preview Tab PIC002.gif" width="500" height="500">  
   
   
                                                                    <br>  
   
   
                                                                     </div>  
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                                         <h4>  
      The License Tab</h4>  
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                                         <blockquote>  
     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<br>  
   
   
                                                                       </blockquote>  
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                                           <h4>  
        Site location Tab</h4>  
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                                           <blockquote>  
     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.<br>  
   
   
                                                                         </blockquote>  
   
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                                             <h4>  
     Verification &lt;TODO explain basic certificate &gt;</h4>  
   
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                                             <blockquote>  
        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.<br>  
   
   
   
   
   
   
         </blockquote>  
   
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                                               <h5>  
        Signed</h5>  
   
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                                               <blockquote>  
     A dialog with the following &lt;PICTURE&gt; will appear if the feature  
  or  one of its file has been signed. A signed feature means the file has  
 been  digitally signed by the signer, and the signer has been authenticated  
 by the authenticator. The authenticator can be the same entity as the signer,  
  in which case you will see such a dialog &lt;PICTURE&gt;. In some cases,  
 the authenticator is a different entity than the signer, in which case you  
 will see such a dialog. &lt;PICTURE&gt;. If the authenticator has never been  
 authenticated by you, you will see such a dialog &lt;PICTURE&gt;. If the  
 signature of the authenticator has been authorized before, you will see such  
 a dialog &lt;PICTURE&gt;. 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>  
   
   
   
   
   
   
   
   
   
      </blockquote>  
   
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                                                 <h5>  
     Non Signed</h5>  
   
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                                                 <blockquote>  
     A dialog  like the following &lt;PICTURE&gt; will appear if the feature  
  or one of its file has not been signed. 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.<br>  
   
   
   
      </blockquote>  
   
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                                                   <h5>  
      Corrupted  </h5>  
   
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                                                   <blockquote>  
   
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                                                     <p class="MsoNormal">  
      If the content of a feature has changed since it has been signed, you  
  will  see such a dialog &lt;PICTURE&gt;. This means the content has been  
 tempered  with. 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>  
   
   
   
        </blockquote>  
   
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                                                     <h5>  
     Feature verification dialog</h5>  
   
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                                                     <blockquote>  
   
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                                                       <p class="MsoNormal">  
     &lt;TODO explain the dialog with feature/ install/ cancel&gt;</p>  
   
   
   
          </blockquote>  
   
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                                                       <h5>  
     Feature file verification dialog</h5>  
   
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                                                       <blockquote>  
   
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                                                         <p class="MsoNormal">  
     &lt;TODO explain the dialog with feature file/ continue/ cancel&gt;</p>  
   
   
   
            </blockquote>  
   
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                                                         <h5>  
     Persistence of the answer</h5>  
   
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                                                         <blockquote>  
   
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                                                           <p class="MsoNormal">  
     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.  
   
   
   
           <br>  
       </p>  
   
   
   
              </blockquote>  
   
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                                                           <h2>  
        Configuring/Unconfiguring a Feature</h2>  
   
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                                                           <blockquote>  
        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>  
        . <br>  
   
   
   
                </blockquote>  
   
   
   
   
   
   
   
   
   
   
   
   
   
                                                                                                                                                                                                                                                                             <h3>  
        Checking if a feature is configured or unconfigured.<br>  
   
   
   
                </h3>