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

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

revision 1.1, Thu Apr 18 14:53:17 2002 UTC revision 1.2, Mon Apr 22 18:31:43 2002 UTC
# Line 92  Line 92 
92    <h3>Find new Feature</h3>    <h3>Find new Feature</h3>
93    
94    <blockquote>This section will focus on finding a feature to install. There    <blockquote>This section will focus on finding a feature to install. There
95   are different ways of finding a feature. The one we are going to focus in    are different ways of finding a feature. The one we are going to focus
96   this section is <a href="http://www.eclipse.org">browsing a site</a>  in   this section is <a href="http://www.eclipse.org">browsing a site</a>
97      . For more information about other ways of finding a feature, look at        . For more information about other ways of finding a feature, look
98  the  <a href="http://www.eclipse.org">Find Features</a>  at  the  <a href="http://www.eclipse.org">Find Features</a>
99      section.<br>      section.<br>
100       </blockquote>       </blockquote>
101    
# Line 115  Line 115 
115           <li>Open the context menu </li>           <li>Open the context menu </li>
116           <li>Select new-&gt;site bookmark...</li>           <li>Select new-&gt;site bookmark...</li>
117           <li>In the Site Name entry field type: Test Site</li>           <li>In the Site Name entry field type: Test Site</li>
118           <li>In the Site URL entry field type the URL where you installed             <li>In the Site Address entry field type the URL where you installed
119  the  mockup site. (i.e. file:c:/eclipse/site)</li>  the  mockup site. (i.e. file:c:/eclipse/site)</li>
120           <li>Click Ok </li>           <li>Click Ok </li>
121    
# Line 131  Line 131 
131          <blockquote>You can expand the site and the categories to see the          <blockquote>You can expand the site and the categories to see the
132  Features.  In this site you should see one category:  Red Dot Versions,  and  Features.  In this site you should see one category:  Red Dot Versions,  and
133  two features:   Red Dot Feature 1.0.0 and Red Dot Feature 2.0.0. <br>  two features:   Red Dot Feature 1.0.0 and Red Dot Feature 2.0.0. <br>
134    
135            <ul>            <ul>
136              <li>Select Red Dot Feature 1.0.0</li>              <li>Select Red Dot Feature 1.0.0</li>
137    
138            </ul>            </ul>
139             </blockquote>             </blockquote>
140    
# Line 168  Line 170 
170                    <ul>                    <ul>
171                       <li>The first page of the Wizard summarizes the action                       <li>The first page of the Wizard summarizes the action
172  you are going to take. Click Next.</li>  you are going to take. Click Next.</li>
173                       <li>The second page shows the license you have to accept                         <li>The second page shows the license you have to
174  to install  the feature. Click next of you accept the presented license otherwise  accept  to install  the feature. Click next of you accept the presented license
175  click  cancel.</li>  otherwise  click  cancel.</li>
176                       <li>The last page of the Wizard presents the list of                         <li>The last page of the Wizard presents the list
177  Site you can  install your feature in. You can create a new site from this  of  Site you can  install your feature in. You can create a new site from
178  page. For more  information about creating new Site see:  <a href="http://www.eclipse.org">  this  page. For more  information about creating new Site see:  <a href="http://www.eclipse.org">
179      Site Location Tab</a>      Site Location Tab</a>
180      . 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
181  the  workbench is installed. Click Finish.</li>  the  workbench is installed. Click Finish.</li>
# Line 181  Line 183 
183                    </ul>                    </ul>
184    
185                    <blockquote>   The feature will then be downloaded, verified                    <blockquote>   The feature will then be downloaded, verified
186  and installed  in the site. You can see the progress monitor showing you the   and installed  in the site. You can see the progress monitor showing you
187  evolution of  theses tasks. &lt;TODO: verification task&gt;<br>  the evolution of  theses tasks. During verification, you may be prompted to
188    accept the verification. Click 'Ok' when prompted.<br>
189                       </blockquote>                       </blockquote>
190    
191                      <blockquote>   When the feature has been installed &lt;TODO                      <blockquote>   When the feature has been installed you
192  automatic restart  ?&gt;.<br>  will need to restart the workbench for the changes to take effect. Click 'Ok'
193    on the dialog box.<br>
194                         </blockquote>                         </blockquote>
195    
196                        <p class="MsoNormal"></p>                        <p class="MsoNormal"></p>
# Line 198  Line 202 
202  customize your perspective  and add the Red Dot Set Action Set:<br>  customize your perspective  and add the Red Dot Set Action Set:<br>
203                           </blockquote>                           </blockquote>
204    
205    
206                          <p class="MsoNormal"></p>                          <p class="MsoNormal"></p>
207    
208    
209                          <ul>                          <ul>
210                             <li>Open the menu Window</li>                             <li>Open the menu Window</li>
211                             <li>Select Customize Perspective</li>                             <li>Select Customize Perspective</li>
# Line 207  Line 213 
213                             <li>Check Red Dot Set</li>                             <li>Check Red Dot Set</li>
214                             <li>Click Ok</li>                             <li>Click Ok</li>
215    
216    
217                          </ul>                          </ul>
218    
219    
220                          <blockquote>You should now se a red button icon on                          <blockquote>You should now se a red button icon on
221  the toolbar. If you click  on it the following dialog box should appear, meaning   the toolbar. If you click  on it the following dialog box should appear,
222  the feature and associated  plug-ins have been successfully installed and  meaning the feature and associated  plug-ins have been successfully installed
223  configured.<br>  and configured.<br>
224                             </blockquote>                             </blockquote>
225    
226    
227                            <blockquote>   We will now see how to manage your                            <blockquote>   We will now see how to manage your
228  feature in your configuration.<br>  feature in your configuration.<br>
229                               </blockquote>                               </blockquote>
230    
231    
232                              <h3>   Configure Environment</h3>                              <h3>   Configure Environment</h3>
233    
234    
235                              <blockquote>   A feature that is installed may                              <blockquote>   A feature that is installed may
236  be configured or unconfigured for  your workspace. A configured feature means  be configured or unconfigured for  your workspace. A configured feature means
237  that Install/Update will 'suggests'  that the runtime configures the feature  that Install/Update will 'suggests'  that the runtime configures the feature
238  to be available. An unconfigured feature means that Install/Update will make   to be available. An unconfigured feature means that Install/Update will
239  the feature unavailable to the user.<br>  make  the feature unavailable to the user.<br>
240                                 </blockquote>                                 </blockquote>
241    
242    
243                                <blockquote>When you installed Red Dot Feature                                <blockquote>When you installed Red Dot Feature
244  1.0.0, Install/Update installed  and configured the feature for you. You can   1.0.0, Install/Update installed  and configured the feature for you. You
245  see that in the Configuration  History. For more information about Configuration  can see that in the Configuration  History. For more information about Configuration
246  History see <a href="http:/ww.eclipse.org">  Configuration History</a>  History see <a href="http:/ww.eclipse.org">  Configuration History</a>
247      .<br>      .<br>
248                                   </blockquote>                                   </blockquote>
249    
250    
251                                  <blockquote>A configuration is a list of configured                                  <blockquote>A configuration is a list of configured
252  and unconfigured features  that determine what tool you can use.<br>  and unconfigured features  that determine what tool you can use.<br>
253   The current configuration is the configuration currently active.<br>   The current configuration is the configuration currently active.<br>
254                                     </blockquote>                                     </blockquote>
255    
256                                    <blockquote>For more information about &lt;TODO  
257  configure&gt;<br>                                    <blockquote>For more information about configuration,
258    see <a href="http://www.eclipse.org">Configuring/Unconfiguring</a>
259     .<br>
260                                       </blockquote>                                       </blockquote>
261    
262    
263                                      <blockquote>In this section we will add                                      <blockquote>In this section we will add
264  the current history configuration to  the list of preserved configuration.  the current history configuration to  the list of preserved configuration.
265  We will unconfigure Red Dot 1.0.0, so  the feature will be unavailable. Then  We will unconfigure Red Dot 1.0.0, so  the feature will be unavailable. Then
# Line 251  Line 267 
267  feature.<br>  feature.<br>
268                                         </blockquote>                                         </blockquote>
269    
270    
271                                        <h4>Add configuration to preserved</h4>                                        <h4>Add configuration to preserved</h4>
272    
273    
274                                        <blockquote>To add the current configuration,                                        <blockquote>To add the current configuration,
275  we will first need to find  it in the list of configurations and then add  we will first need to find  it in the list of configurations and then add
276  it to the list of preserved  configurations. The current configuration is  it to the list of preserved  configurations. The current configuration is
277  the configuration in the configuration  history folder with an icon with a   the configuration in the configuration  history folder with an icon with
278  running person. It is the last configuration  in the list.<br>  a running person. It is the last configuration  in the list.<br>
279                                           </blockquote>                                           </blockquote>
280    
281    
282                                          <p class="MsoNormal"></p>                                          <p class="MsoNormal"></p>
283    
284    
285                                          <ul>                                          <ul>
286                                             <li>Select the current configuration.</li>                                             <li>Select the current configuration.</li>
287                                             <li>Open the context menu.</li>                                             <li>Open the context menu.</li>
# Line 269  Line 289 
289                                             <li>The configuration now appears                                             <li>The configuration now appears
290  under the Preserved Configurations  folder.</li>  under the Preserved Configurations  folder.</li>
291    
292    
293                                          </ul>                                          </ul>
294    
295    
296                                          <h4>Rename configuration</h4>                                          <h4>Rename configuration</h4>
297    
298    
299                                          <blockquote>We will rename the configuration                                          <blockquote>We will rename the configuration
300  to give it a meaningfull name.<br>  to give it a meaningfull name.<br>
301                                             </blockquote>                                             </blockquote>
302    
303    
304                                            <p class="MsoNormal"></p>                                            <p class="MsoNormal"></p>
305    
306    
307                                            <ul>                                            <ul>
308                                               <li>Select the configuration.</li>                                               <li>Select the configuration.</li>
309                                               <li>Open the context menu and                                                 <li>Open the context menu
310  click Properties.</li>  and  click Properties.</li>
311                                               <li>Change the name of the configuration                                                 <li>Change the name of the
312  to: RedDot 1</li>  configuration  to: RedDot 1</li>
313                                               <li>Click Ok.</li>                                               <li>Click Ok.</li>
314    
315    
316                                            </ul>                                            </ul>
317    
318    
319                                            <h4>Unconfigure Feature</h4>                                            <h4>Unconfigure Feature</h4>
320    
321    
322                                            <blockquote>We will now unconfigure                                            <blockquote>We will now unconfigure
323  the feature.<br>  the feature.<br>
324                                               </blockquote>                                               </blockquote>
325    
326    
327                                              <p class="MsoNormal"></p>                                              <p class="MsoNormal"></p>
328    
329    
330                                              <ul>                                              <ul>
331                                                 <li>Expand Current Configuration;</li>                                                 <li>Expand Current Configuration;</li>
332                                                   <li>Expand the site</li>
333    
334                                              </ul>                                              </ul>
335    
336                                              <div align="Center">                                              <blockquote>
337    
338                                              <p class="MsoNormal">&lt;PICTURE                                                <div align="Left"><img src="images/PIC004.gif" alt="Expand Current Configuration to reveal the configured Feature." width="202" height="118">
339  show expansion as people may believe we are talking  about the preserved configuration&gt;<br>                                                 <br>
                                              </p>  
340                                               </div>                                               </div>
341                                                   </blockquote>
342    
343                                              <ul>                                              <ul>
                                                <li>Expand the site</li>  
344                                                 <li>Select Red Dot Feature                                                 <li>Select Red Dot Feature
345  1.0.0</li>  1.0.0</li>
346                                                 <li>In the preview view click                                                   <li>In the preview view
347  Unconfigure.</li>  click  Unconfigure.</li>
348                                                 <li>When the Dialog opens                                                 <li>When the Dialog opens
349  click Ok.</li>  click Ok.</li>
350    
351    
352                                              </ul>                                              </ul>
353    
354    
355                                              <p class="MsoNormal"></p>                                              <p class="MsoNormal"></p>
356    
357    
358                                              <blockquote>The workspace will                                              <blockquote>The workspace will
359  shut-down and restart automatically.</blockquote>  shut-down and restart automatically.</blockquote>
360    
361    
362                                                <p class="MsoNormal"></p>                                                <p class="MsoNormal"></p>
363    
364    
365                                                <h4>   </h4>                                                <h4>   </h4>
366    
367    
368                                                <h3>Restore Configuration</h3>                                                <h3>Restore Configuration</h3>
369    
370    
371                                                <blockquote>We shall now restore                                                <blockquote>We shall now restore
372  the configuration we added to preserve, so the feature will be configured  the configuration we added to preserve, so the feature will be configured
373  again.<br>  again.<br>
374                                                   </blockquote>                                                   </blockquote>
375    
376    
377    
378                                                  <h4>Verify the Feature is                                                  <h4>Verify the Feature is
379  not available</h4>  not available</h4>
380    
381    
382    
383                                                  <blockquote>You should not                                                  <blockquote>You should not
384  see the red button icon in the toolbar, meaning  the feature was not activated<br>  see the red button icon in the toolbar, meaning  the feature was not activated<br>
385                                                     </blockquote>                                                     </blockquote>
386    
387    
388    
389                                                    <p class="MsoNormal"></p>                                                    <p class="MsoNormal"></p>
390    
391    
392    
393                                                    <ul>                                                    <ul>
394                                                       <li>In the Configuration                                                       <li>In the Configuration
395  View, expand Current Configuration.</li>  View, expand Current Configuration.</li>
396                                                       <li>Expand the site.</li>                                                       <li>Expand the site.</li>
397                                                       <li>Verify Red Dot Feature                                                         <li>Verify Red Dot
398  1.0.0 does NOT appear as an icon.</li>  Feature  1.0.0 does NOT appear as an icon.</li>
399                                                       <li>Click on the view                                                       <li>Click on the view
400  toolbar button 'show unconfigured features'</li>  toolbar button 'show unconfigured features'</li>
401                                                       <li>Verify Red Dot Feature                                                         <li>Verify Red Dot
402  1.0.0 does appear </li>  Feature  1.0.0 does appear</li>
403    
404    
405    
406                                                    </ul>                                                    </ul>
407    
408                                                        <blockquote><img src="images/pic005.gif" alt="Unconfigured feature revealed" width="257" height="117">
409    
410                                    </blockquote>
411    
412                                                    <blockquote>The icon <img src="images/unconf_feature_obj.gif" alt="Unconfigured Feature unconf_feature_obj.gif " width="16" height="16">                                                    <blockquote>The icon <img src="images/unconf_feature_obj.gif" alt="Unconfigured Feature unconf_feature_obj.gif " width="16" height="16">
413   means the feature is still installed  but not available at this time in   means the feature is still installed  but not available at this time in
414  your workspace. To be able to use the feature  we will need to configure  your workspace. To be able to use the feature  we will need to configure
415  the feature.<br>  the feature.<br>
416                                                       </blockquote>                                                       </blockquote>
417    
418    
419    
420                                                      <h4>Revert to preserved                                                      <h4>Revert to preserved
421  configuration</h4>  configuration</h4>
422    
423    
424    
425                                                      <p class="MsoNormal">                                                      <p class="MsoNormal">
426                  We will now go back to the configuration we had previously                  We will now go back to the configuration we had previously
427   in which Red Dot Feature 1.0.0 was configured.</p>   in which Red Dot Feature 1.0.0 was configured.</p>
428    
429    
430    
431                                                      <ul>                                                      <ul>
432                                                         <li>Expand Preserved                                                         <li>Expand Preserved
433  Configurations</li>  Configurations</li>
# Line 381  Line 438 
438                                                         <li>When the Dialog                                                         <li>When the Dialog
439  opens click Ok.</li>  opens click Ok.</li>
440    
441    
442    
443                                                      </ul>                                                      </ul>
444    
445    
446    
447                                                      <blockquote>The workspace                                                      <blockquote>The workspace
448  will shut-down and restart automatically.</blockquote>   will shut-down and restart automatically. After the workspace restart, the
449    feature is configured, based on the revert configuration.</blockquote>
450    
451    
452                                                        <blockquote>There are  
453  different way of configuring a feature. To know more  about configuring and                                                            <blockquote>There
454  unconfiguring features see: <a href="http://www.eclipse.org">  Configuring/Unconfiguring  are  different way of configuring a feature. To know more  about configuring
455    and  unconfiguring features see: <a href="http://www.eclipse.org">  Configuring/Unconfiguring
456  features</a>  features</a>
457      .<br>      .<br>
458                                                           </blockquote>                                                           </blockquote>
459    
460    
461    
462                                                          <p class="MsoNormal">                                                          <p class="MsoNormal">
     <br>  
463      In this section you learnt how to find a feature you want to install,      In this section you learnt how to find a feature you want to install,
464  how  to install a feature, how to unconfigure a feature and how to restore  how  to install a feature, how to unconfigure a feature and how to restore
465  a preserved  configuration. The rest of the book will go into more details.<br>  a preserved  configuration. The rest of the book will go into more details.<br>
     <br>  
466                                                           </p>                                                           </p>
467    
                                                         <h2>   The User Interface</h2>  
468    
469                                                          <blockquote>   This  
470  section describes in details the User Interface of the Install/Update  perspective.                                                              <h2>   The User
471  The perspective is composed of four different views: The Configuration  View  Interface</h2>
472  to manage the configurations, the Updates View to manage update sites  and  
473  features as well as searches. The Preview View is used to show the details  
474    
475                                                                <blockquote>
476     This  section describes in details the User Interface of the Install/Update
477     perspective.  The perspective is composed of four different views: The Configuration
478     View  to manage the configurations, the Updates View to manage update sites
479     and  features as well as searches. The Preview View is used to show the details
480   of the element selected in the previous two views and the Web View, which   of the element selected in the previous two views and the Web View, which
481   is used to browse HTML document from either sites or features.</blockquote>   is used to browse HTML document from either sites or features.</blockquote>
482    
483    
484    
485                                                            <h3>The Configuration                                                            <h3>The Configuration
486  View</h3>  View</h3>
487    
488                                                            <blockquote>The  
489  configuration view helps you manage your configurations. A configuration is  
490  a list of configured and unconfigured features that determine what tool are                                                                <blockquote>
491  available fro you to use in your workspace. <br>   The  configuration view helps you manage your configurations. A configuration
492    is a list of configured and unconfigured features that determine what tool
493    are available fro you to use in your workspace. <br>
494                                                                     <img src="images/pic006.gif" alt="Configuration View" width="251" height="251">
495                                                                     <br>
496                                                               </blockquote>                                                               </blockquote>
497    
498    
499    
500                                                              <h4>   Current                                                              <h4>   Current
501  Configuration</h4>  Configuration</h4>
502    
503                                                              <blockquote>The  
504  current configuration is the configuration currently active.  When you expand  
505  the Current Configuration you can see the sites you are connected  to. Expanding                                                                  <blockquote>
506  each site reveals the list of Features you have access to. Some feature may   The  current configuration is the configuration currently active.  When
507  be configured, some may be unconfigured. The configured features are the tools  you expand  the Current Configuration you can see the sites you are connected
508  the Install/Update suggested the runtime to activate. To know more about   to. Expanding  each site reveals the list of Features you have access to.
509  configured/Unconfigured features see: <a href="http://www.eclipse.org">  Some feature may  be configured, some may be unconfigured. The configured
510    features are the tools the Install/Update suggested the runtime to activate.
511    To know more about configured/Unconfigured features see: <a href="http://www.eclipse.org">
512   Configured/Unconfigued</a>   Configured/Unconfigued</a>
513      .<br>      .<br>
514                                                                 </blockquote>                                                                 </blockquote>
515    
516    
517    
518                                                                <h4>   Configuration                                                                <h4>   Configuration
519  History</h4>  History</h4>
520    
521    
522    
523                                                                <blockquote>                                                                <blockquote>
524   The Configuration History folder contains the last <i>n</i>  configurations   The Configuration History folder contains the last <i>n</i>  configurations
525  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
# Line 444  Line 527 
527      .<br>      .<br>
528                                                                   </blockquote>                                                                   </blockquote>
529    
530    
531    
532                                                                  <blockquote>                                                                  <blockquote>
533   You can use the history list to see what are the different activities that     You can use the history list to see what are the different activities
534  occurred as well as restoring an old configuration to make it the current  that  occurred as well as restoring an old configuration to make it the current
535  one.<br>  one.<br>
536                                                                     </blockquote>                                                                     </blockquote>
537    
538    
539    
540                                                                    <blockquote>                                                                    <blockquote>
541    Install/Update creates a new configuration history when one  or more activities      Install/Update creates a new configuration history when one  or more
542  are performed (i.e. install, configure, unconfigure etc...).  When the Install/Update   activities  are performed (i.e. install, configure, unconfigure etc...).
543  creates a new configuration, it will add it to the  list. If you already have   When the Install/Update   creates a new configuration, it will add it to
544  n configurations, the framework will automatically  delete  the oldest configuration  the  list. If you already have n configurations, the framework will automatically
545  from the list. To know when the Install/Update  creates new configuration   delete  the oldest configuration from the list. To know when the Install/Update
546  history and what are the Activities see:  <a href="http://www.eclipse.org">   creates new configuration history and what are the Activities see:  <a href="http://www.eclipse.org">
547      Configuration History</a>      Configuration History</a>
548      .<br>      .<br>
549                                                                       </blockquote>                                                                       </blockquote>
550    
551    
552    
553                                                                      <h4>                                                                      <h4>
554    Preserved Configuration</h4>    Preserved Configuration</h4>
555    
556    
557    
558                                                                      <blockquote>                                                                      <blockquote>
559   The Preserved Configurations folder contains history configurations  you   The Preserved Configurations folder contains history configurations  you
560  want to keep. The framework does not automatically delete the configurations  want to keep. The framework does not automatically delete the configurations
561   in the Preserved Configurations folder, you have to explicitly delete them.<br>   in the Preserved Configurations folder, you have to explicitly delete them.<br>
562    
563                                                                         </blockquote>                                                                         </blockquote>
564    
565    
566    
567                                                                        <h4>                                                                        <h4>
568      Configured/Unconfigured</h4>      Configured/Unconfigured</h4>
569    
570    
571    
572                                                                        <blockquote>                                                                        <blockquote>
573    
574    
575    
576    
577                                                                          <p class="MsoNormal">                                                                          <p class="MsoNormal">
578   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
579  features by clicking the 'Show Unconfigured Features' toggle button in the  features by clicking the 'Show Unconfigured Features' toggle button in the
580  view tool bar. To know more about configured/unconfigured features see: <a href="http://www.eclipse.org">   view tool bar. To know more about configured/unconfigured features see:
581    Configured/Unconfigued</a>  
582      <a href="http://www.eclipse.org">    Configured/Unconfigued</a>
583      . </p>      . </p>
584    
585    
586    
587                                                                          </blockquote>                                                                          </blockquote>
588    
589    
590    
591    
592                                                                          <h4>                                                                          <h4>
593   Local View Toolbar Actions</h4>   Local View Toolbar Actions</h4>
594    
595    
596    
597    
598                                                                          <h5>                                                                          <h5>
599   Show Unconfigured Feature</h5>   Show Unconfigured Feature</h5>
600    
601    
602    
603    
604                                                                          <blockquote>                                                                          <blockquote>
605    
606    
607    
608    
609                                                                            <p class="MsoNormal">                                                                            <p class="MsoNormal">
610   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
611  and unconfigured features. Unconfigured features appear with a red circle  and unconfigured features. Unconfigured features appear with a red circle
# Line 507  Line 618 
618    </blockquote>    </blockquote>
619    
620    
621    
622    
623                                                                            <h4>                                                                            <h4>
624   Context Actions</h4>   Context Actions</h4>
625    
626    
627    
628    
629                                                                            <blockquote>                                                                            <blockquote>
630      This section describes the different context actions available in the      This section describes the different context actions available in the
631  Configuration View.<br>  Configuration View.<br>
# Line 518  Line 633 
633      </blockquote>      </blockquote>
634    
635    
636    
637    
638                                                                              <h5>                                                                              <h5>
639      Go Home</h5>      Go Home</h5>
640    
641    
642    
643    
644                                                                              <blockquote>                                                                              <blockquote>
645   This action &lt;TODO be consistent with navigator&gt;<br>   This action &lt;TODO be consistent with navigator&gt;<br>
646    
647        </blockquote>        </blockquote>
648    
649    
650    
651    
652                                                                                <h5>                                                                                <h5>
653      Go Back</h5>      Go Back</h5>
654    
655    
656    
657    
658                                                                                <blockquote>                                                                                <blockquote>
659   This action &lt;TODO be consistent with navigator&gt;<br>   This action &lt;TODO be consistent with navigator&gt;<br>
660    
661          </blockquote>          </blockquote>
662    
663    
664    
665    
666                                                                                  <h5>                                                                                  <h5>
667      Go Into</h5>      Go Into</h5>
668    
669    
670    
671    
672                                                                                  <blockquote>                                                                                  <blockquote>
673   This action &lt;TODO be consistent with navigator&gt;<br>   This action &lt;TODO be consistent with navigator&gt;<br>
674    
675            </blockquote>            </blockquote>
676    
677    
678    
679    
680                                                                                    <h5>                                                                                    <h5>
681      Show Details</h5>      Show Details</h5>
682    
683    
684    
685    
686                                                                                    <blockquote>                                                                                    <blockquote>
687   This action opens or refreshes the Preview View with the  details of the   This action opens or refreshes the Preview View with the  details of the
688  selected element.<br>  selected element.<br>
# Line 559  Line 690 
690              </blockquote>              </blockquote>
691    
692    
693    
694    
695                                                                                      <h5>                                                                                      <h5>
696      Properties</h5>      Properties</h5>
697    
698    
699    
700    
701                                                                                      <blockquote>                                                                                      <blockquote>
702   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.
703  You are able to change the label of a configuration. Click Ok when you have  You are able to change the label of a configuration. Click Ok when you have
704  finished and you want to preserve your changes or click Cancel if you do not   finished and you want to preserve your changes or click Cancel if you do
705  want to change the properties.<br>  not want to change the properties.<br>
706    
707                </blockquote>                </blockquote>
708    
709    
710    
711    
712                                                                                        <h5>                                                                                        <h5>
713      Add to Preserved</h5>      Add to Preserved</h5>
714    
715    
716    
717    
718                                                                                        <blockquote>                                                                                        <blockquote>
719    This action adds the selected configuration in the Configuration  History    This action adds the selected configuration in the Configuration  History
720  folder to the list of preserved configuration.<br>  folder to the list of preserved configuration.<br>
# Line 583  Line 722 
722                  </blockquote>                  </blockquote>
723    
724    
725    
726    
727                                                                                          <h5>                                                                                          <h5>
728      Remove from Preserved</h5>      Remove from Preserved</h5>
729    
730    
731    
732    
733                                                                                          <blockquote>                                                                                          <blockquote>
734   This action removes the selected configuration from the  list of preserved   This action removes the selected configuration from the  list of preserved
735  configurations. This action will not delete any Site, Site  Bookmark or Feature.  configurations. This action will not delete any Site, Site  Bookmark or Feature.
# Line 596  Line 739 
739                    </blockquote>                    </blockquote>
740    
741    
742    
743    
744                                                                                            <h5>                                                                                            <h5>
745      Restore</h5>      Restore</h5>
746    
747    
748    
749    
750                                                                                            <blockquote>                                                                                            <blockquote>
751    This action creates a new configuration based on the selected  configuration    This action creates a new configuration based on the selected  configuration
752  and marks it as current. Install/Update will automatically configure all the   and marks it as current. Install/Update will automatically configure all
753  features that were configured in the selected configuration you want to restore.  the features that were configured in the selected configuration you want to
754  To know more about restoring or reverting to a configuration see:  restore. To know more about restoring or reverting to a configuration see:
755    
756               <a href="http://www.eclipse.org"> Restore a Configuration/Revert               <a href="http://www.eclipse.org"> Restore a Configuration/Revert
757  to previous  configuration</a>  to previous  configuration</a>
# Line 613  Line 760 
760                      </blockquote>                      </blockquote>
761    
762    
763    
764    
765                                                                                              <h3>                                                                                              <h3>
766   The Updates View</h3>   The Updates View</h3>
767    
768    
769    
770    
771                                                                                              <blockquote>                                                                                              <blockquote>
772      The Updates view allows you to manage the remote sites you can install      The Updates view allows you to manage the remote sites you can install
773  from to search for features as well as features you can install. <br>  from to search for features as well as features you can install. <br>
774    
775                              <img src="images/PIC007.gif" alt="Updates View" width="251" height="249">
776    
777                              <br>
778    
779                        </blockquote>                        </blockquote>
780    
781    
782    
783    
784                                                                                                <h4>                                                                                                <h4>
785   My Computer</h4>   My Computer</h4>
786    
787    
788    
789    
790                                                                                                <blockquote>                                                                                                <blockquote>
791   My Computer lets you browse your computer and any mounted local  file to     My Computer lets you browse your computer and any mounted local  file
792  discover any site on your file system. You can also search My Computer  to  to  discover any site on your file system. You can also search My Computer
793  discover sites: see <a href="http://www.eclipse.org">Search the file system</a>   to  discover sites: see <a href="http://www.eclipse.org">Search the file
794    system</a>
795      .<br>      .<br>
796    
797                          </blockquote>                          </blockquote>
798    
799    
800    
801    
802    
803                                                                                                  <h4>                                                                                                  <h4>
804   Places to Visit</h4>   Places to Visit</h4>
805    
806    
807    
808    
809    
810                                                                                                  <blockquote>                                                                                                  <blockquote>
811   Places to visit are sites suggested by the features you installed  for you     Places to visit are sites suggested by the features you installed  for
812  to visit. <br>  you  to visit. <br>
813    
814                            </blockquote>                            </blockquote>
815    
816    
817    
818    
819    
820                                                                                                    <p class="MsoNormal">                                                                                                    <p class="MsoNormal">
821      </p>      </p>
822    
823    
824    
825    
826    
827                                                                                                    <h4>                                                                                                    <h4>
828   Available Updates</h4>   Available Updates</h4>
829    
830    
831    
832    
833    
834                                                                                                    <blockquote>                                                                                                    <blockquote>
835   Available Updates will let you search for updates of already installed   Available Updates will let you search for updates of already installed
836  features. The search occurs in the background so you can still use the workbench  features. The search occurs in the background so you can still use the workbench
# Line 666  Line 841 
841                              </blockquote>                              </blockquote>
842    
843    
844    
845    
846    
847                                                                                                      <h4>                                                                                                      <h4>
848   Sites Bookmark</h4>   Sites Bookmark</h4>
849    
850    
851    
852    
853    
854                                                                                                      <blockquote>                                                                                                      <blockquote>
855    
856    
857    
858    
859    
860                                                                                                        <p class="MsoNormal">                                                                                                        <p class="MsoNormal">
861   A site is a location that contains features. In the Updates  View, the sites     A site is a location that contains features. In the Updates  View, the
862  contain features you can install. You can browse or search  features in Site  sites  contain features you can install. You can browse or search  features
863  bookmarks. There are two ways of adding a site bookmark.  You can use the  in Site  bookmarks. There are two ways of adding a site bookmark.  You can
864  context menu and the context action add site bookmarks, or  you may browse  use the  context menu and the context action add site bookmarks, or  you may
865  My Computer and add a site as a site bookmark. See <a href="http://www.eclipse.org">  browse  My Computer and add a site as a site bookmark. See <a href="http://www.eclipse.org">
866     Context Action</a>     Context Action</a>
867      for more details. <br>      for more details. <br>
868    
# Line 687  Line 871 
871                                </blockquote>                                </blockquote>
872    
873    
874    
875    
876    
877                                                                                                        <h4>                                                                                                        <h4>
878      Search</h4>      Search</h4>
879    
880    
881    
882    
883    
884                                                                                                        <blockquote>                                                                                                        <blockquote>
885    
886    
887    
888    
889    
890                                                                                                          <p class="MsoNormal">                                                                                                          <p class="MsoNormal">
891   &lt;TODO&gt;<br>   &lt;TODO&gt;<br>
892    
# Line 702  Line 895 
895                                  </blockquote>                                  </blockquote>
896    
897    
898    
899    
900    
901                                                                                                          <h4>                                                                                                          <h4>
902      Folder</h4>      Folder</h4>
903    
904    
905    
906    
907    
908                                                                                                          <blockquote>                                                                                                          <blockquote>
909    
910    
911    
912    
913    
914                                                                                                            <p class="MsoNormal">                                                                                                            <p class="MsoNormal">
915   &lt;TODO what can I store in a folder ?&gt;</p>   &lt;TODO what can I store in a folder ?&gt;</p>
916    
917                                    </blockquote>                                    </blockquote>
918    
919    
920    
921    
922    
923                                                                                                            <h4>                                                                                                            <h4>
924   Local View Toolbar Actions</h4>   Local View Toolbar Actions</h4>
925    
926    
927    
928    
929    
930                                                                                                            <blockquote>                                                                                                            <blockquote>
931   This section describes the local view toolbar actions of the Updates View.<br>   This section describes the local view toolbar actions of the Updates View.<br>
932    
933                                      </blockquote>                                      </blockquote>
934    
935    
936    
937    
938    
939                                                                                                              <h5>                                                                                                              <h5>
940   Show Feature Categories &lt;TODO&gt;</h5>     Show Feature Categories </h5>
941    
942    
943    
944    
945    
946                                                                                                              <blockquote>                                                                                                              <blockquote>
947   &lt;TODO&gt;<br>     When this action is selected,  you will see the features organized in
948    categories.<br>
949    
950                                              <img src="images/pic008.gif" alt="Categories" width="253" height="193">
951    
952                                              <br>
953    
954                                              <br>
955     When this action is not selected, you will see all the features as a list.<br>
956    
957                                              <img src="images/pic008b.gif" alt="No Categories" width="253" height="97">
958    
959                                        </blockquote>                                        </blockquote>
960    
961    
962    
963    
964    
965                                                                                                                <h5>                                                                                                                <h5>
966   Show My Computer Files &lt;TODO&gt;</h5>     Show My Computer Files </h5>
967    
968    
969    
970    
971    
972                                                                                                                <blockquote>                                                                                                                <blockquote>
973   &lt;TODO&gt;<br>     When this action is seelcted, you will be able to browse the files when
974    you expand MyComputer.<br>
975    
976                                                <img src="images/pic009.gif" alt="Browse Files" width="251" height="249">
977    
978                                                <br>
979    
980                                          </blockquote>                                          </blockquote>
981    
982    
983    
984    
985    
986                                                                                                                  <h4>                                                                                                                  <h4>
987   Context Actions</h4>   Context Actions</h4>
988    
989    
                                                                                                                 <blockquote>  
  This section describes the different context actions available in the Updates  
 View.<br>  
990    
991    
992    
993                                                                                                                        <blockquote>
994       This section describes the different context actions available in the
995    Updates  View.
996                                            </blockquote>                                            </blockquote>
997    
998    
999    
1000    
1001    
1002                                                                                                                    <h5>                                                                                                                    <h5>
1003   New-&gt;Site Bookmark...</h5>   New-&gt;Site Bookmark...</h5>
1004    
1005    
1006    
1007    
1008    
1009                                                                                                                    <blockquote>                                                                                                                    <blockquote>
1010    
1011    
1012    
1013    
1014    
1015                                                                                                                      <p class="MsoNormal">                                                                                                                      <p class="MsoNormal">
1016   Creates a new Site bookmark. This opens a Dialog box that presents  the   Creates a new Site bookmark. This opens a Dialog box that presents  the
1017  properties of the Bookmark Site you want to create. The properties of  a  properties of the Bookmark Site you want to create. The properties of  a
1018  Bookmark Site are the label you want to see in the View as well as the URL  Bookmark Site are the label you want to see in the View as well as the Address
1019  of the physical site. You have to enter the Site URL. Optionally you can  of the physical site. You have to enter the Site URL. Optionally you can
1020  enter the Site Name. If you o not enter a Site Name, it will default to the  enter the Site Name. If you o not enter a Site Name, it will default to the
1021  Site URL. Click Ok when you have finished and you want to preserve your changes  Site URL. Click Ok when you have finished and you want to preserve your changes
# Line 777  Line 1026 
1026                                              </blockquote>                                              </blockquote>
1027    
1028    
1029                                                                                                                      <h5>  
1030    
1031    
1032                                                                                                                            <h5>
1033      New-&gt;Folder</h5>      New-&gt;Folder</h5>
1034    
1035    
1036    
1037    
1038    
1039                                                                                                                      <blockquote>                                                                                                                      <blockquote>
1040   Creates a new Folder. &lt;TODO see dejan, can contain only searches ?&gt;<br>   This action lets you create a new Folder. When you select this action, a
1041    dialog will open.<br>
1042    
1043                                                      <img src="images/pic011.gif" alt="New Folder Dialog" width="438" height="481">
1044    
1045                                                      <br>
1046    
1047                                                      <br>
1048     Type the label of the folder in the 'Name;' entry field.<br>
1049     Type the name of the parent folder in the 'Create in:' entry field, or select
1050    it in the 'Existing folders:' tree view. If no parent are selected, the newly
1051    created folder will appear in the updates view as a root folder.<br>
1052    
1053                                                      <br>
1054    
1055                                                      <img src="pic010.gif" alt="folders">
1056    
1057                                                      <img src="images/pic010.gif" alt="folders" width="251" height="249">
1058    
1059                                                      <img src="pic010.gif" alt="folders">
1060    
1061                                                      <br>
1062    
1063                                                </blockquote>                                                </blockquote>
1064    
1065    
1066    
1067    
1068    
1069                                                                                                                        <h5>                                                                                                                        <h5>
1070   New-&gt;Search</h5>   New-&gt;Search</h5>
1071    
1072    
1073    
1074    
1075    
1076                                                                                                                        <blockquote>                                                                                                                        <blockquote>
1077   Creates a new Search. &lt;TODO elaborate as we may have multiples  searches   Creates a new Search. &lt;TODO elaborate as we may have multiples  searches
1078  ? do we have extension point in the help framework so other can plugin their  ? do we have extension point in the help framework so other can plugin their
# Line 799  Line 1081 
1081                                                  </blockquote>                                                  </blockquote>
1082    
1083    
1084    
1085    
1086    
1087    
1088                                                                                                                          <h5>                                                                                                                          <h5>
1089   Show Details</h5>   Show Details</h5>
1090    
1091    
1092    
1093    
1094    
1095    
1096                                                                                                                          <blockquote>                                                                                                                          <blockquote>
1097    
1098    
1099    
1100    
1101    
1102    
1103                                                                                                                            <p class="MsoNormal">                                                                                                                            <p class="MsoNormal">
1104   This action opens or refreshes the Preview View with the details  of the   This action opens or refreshes the Preview View with the details  of the
1105  selected element.<br>  selected element.<br>
# Line 814  Line 1108 
1108                                                    </blockquote>                                                    </blockquote>
1109    
1110    
1111    
1112    
1113    
1114    
1115                                                                                                                            <h5>                                                                                                                            <h5>
1116   Refresh</h5>   Refresh</h5>
1117    
1118    
1119    
1120    
1121    
1122    
1123                                                                                                                            <blockquote>                                                                                                                            <blockquote>
1124   This action re-initializes the content of an element &lt;TODO  see dejan&gt;<br>   This action re-initializes the content of an element &lt;TODO  see dejan&gt;<br>
1125    
1126                                                      </blockquote>                                                      </blockquote>
1127    
1128    
1129    
1130    
1131    
1132    
1133                                                                                                                              <h5>                                                                                                                              <h5>
1134   Bookmark Location</h5>   Bookmark Location</h5>
1135    
1136    
1137    
1138    
1139    
1140    
1141                                                                                                                              <blockquote>                                                                                                                              <blockquote>
1142   This action lets you create bookmark site for a site found on your local   This action lets you create bookmark site for a site found on your local
1143  file system. This opens a Dialog box that presents the properties  of the  file system. This opens a Dialog box that presents the properties  of the
1144  selected site. The properties of a Site are the label you want to see in the   selected site. The properties of a Site are the label you want to see in
1145  View as well as the URL of the site. You are able to change the Site Name.  the View as well as the Address of the site. You are able to change the Site
1146  Click Ok when you have finished and you want to preserve your changes or click  Name.  Click Ok when you have finished and you want to preserve your changes
1147  Cancel if you do not want to change the properties.<br>  or click Cancel if you do not want to change the properties.<br>
1148    
1149                                                        </blockquote>                                                        </blockquote>
1150    
1151    
1152    
1153    
1154    
1155    
1156                                                                                                                                <h5>                                                                                                                                <h5>
1157   Properties</h5>   Properties</h5>
1158    
1159    
1160    
1161    
1162    
1163    
1164                                                                                                                                <blockquote>                                                                                                                                <blockquote>
1165   This action opens a Dialog box that presents the properties of the  selected   This action opens a Dialog box that presents the properties of the  selected
1166  site. The properties of a Site are the label you want to see in the View as   site. The properties of a Site are the label you want to see in the View
1167  well as the URL of the site. If the element you selected was a bookmark,  as well as the Address of the site. If the element you selected was a bookmark,
1168   you are able to change both the Site Name and the Site URL of the site.    you are able to change both the Site Name and the Site Address of the site.
1169  If  you change the Site URL of a Bookmark Site you will need to 'refresh'   If  you change the Site Address of a Bookmark Site you will need to 'refresh'
1170  the  Bookmark Site to access its new content. Click Ok when you have finished  the  Bookmark Site to access its new content. Click Ok when you have finished
1171  and you want to preserve your changes or click Cancel if you do not want  and you want to preserve your changes or click Cancel if you do not want
1172  to change the properties.<br>  to change the properties.<br>
# Line 856  Line 1174 
1174                                                          </blockquote>                                                          </blockquote>
1175    
1176    
1177    
1178    
1179    
1180    
1181                                                                                                                                  <h5>                                                                                                                                  <h5>
1182   Delete</h5>   Delete</h5>
1183    
1184    
1185    
1186    
1187    
1188    
1189                                                                                                                                  <blockquote>                                                                                                                                  <blockquote>
1190   This action removes the Bookmark Site from the workbench. This  does not   This action removes the Bookmark Site from the workbench. This  does not
1191  erase the content of the Site nor the physical remote or local Site  itself.<br>  erase the content of the Site nor the physical remote or local Site  itself.<br>
# Line 867  Line 1193 
1193                                                            </blockquote>                                                            </blockquote>
1194    
1195    
1196    
1197    
1198    
1199    
1200                                                                                                                                    <h3>                                                                                                                                    <h3>
1201   The WebView</h3>   The WebView</h3>
1202    
1203    
1204    
1205    
1206    
1207    
1208                                                                                                                                    <blockquote>                                                                                                                                    <blockquote>
1209   The Web View is &lt;TODO &gt;<br>   The Web View is &lt;TODO &gt;<br>
1210    
1211                                                              </blockquote>                                                              </blockquote>
1212    
1213    
1214    
1215    
1216    
1217    
1218                                                                                                                                      <h3>                                                                                                                                      <h3>
1219   The flat concept (see Dejan)</h3>   The flat concept (see Dejan)</h3>
1220    
1221    
1222    
1223    
1224    
1225    
1226                                                                                                                                      <blockquote>                                                                                                                                      <blockquote>
1227   &lt;TODO&gt;<br>   &lt;TODO&gt;<br>
1228    
1229                                                                </blockquote>                                                                </blockquote>
1230    
1231    
1232    
1233    
1234    
1235    
1236                                                                                                                                        <h3>                                                                                                                                        <h3>
1237   The Preview View</h3>   The Preview View</h3>
1238    
1239    
1240    
1241    
1242    
1243    
1244                                                                                                                                        <blockquote>                                                                                                                                        <blockquote>
1245   The preview shows information about the selected element. The preview  view     The preview shows information about the selected element. The preview
1246  is different for each selected element.<br>   view  is different for each selected element.<br>
1247    
1248                                                                  </blockquote>                                                                  </blockquote>
1249    
1250    
1251    
1252    
1253    
1254    
1255                                                                                                                                          <h4>                                                                                                                                          <h4>
1256      </h4>      </h4>
1257    
1258    
1259    
1260    
1261    
1262    
1263                                                                                                                                          <blockquote>                                                                                                                                          <blockquote>
1264   You can open the preview view by either selecting an element  in the updates   You can open the preview view by either selecting an element  in the updates
1265  or Configuration view, by opening a context menu on any element  in the Updates  or Configuration view, by opening a context menu on any element  in the Updates
1266  or Configuration View and selecting Show Details or by open  the Preview View   or Configuration View and selecting Show Details or by open  the Preview
1267  from the Workbench menu. Select Window-&gt;Show View-&gt;Other  to open the  View from the Workbench menu. Select Window-&gt;Show View-&gt;Other  to open
1268  list of available Views. Expand Update Manager Folder, select  Preview and  the list of available Views. Expand Update Manager Folder, select  Preview
1269  Click Ok.<br>  and Click Ok.<br>
1270    
1271                                                                    </blockquote>                                                                    </blockquote>
1272    
1273    
1274    
1275    
1276    
1277    
1278                                                                                                                                            <h4>                                                                                                                                            <h4>
1279      The 'Home' Preview view.</h4>      The 'Home' Preview view.</h4>
1280    
1281    
1282    
1283    
1284    
1285    
1286                                                                                                                                            <blockquote>                                                                                                                                            <blockquote>
1287   You can open the 'Home' Preview by clicking on the home  in the local tool     You can open the 'Home' Preview by clicking on the home  in the local
1288  bar menu if the View. This view summarizes the different  tasks you can achieve  tool  bar menu if the View. This view summarizes the different  tasks you
1289  through the Install/Update. By using the flat concept  you are able to &lt;TODO  can achieve  through the Install/Update. By using the flat concept  you are
1290  link&gt;<br>  able to &lt;TODO  link&gt;<br>
1291    
1292    
1293                                                                                                                                                    <div align="Center"><img src="images/pic012.gif" alt="Home Preview" width="507" height="503">
1294    
1295                                                                            <br>
1296    
1297                                                                          </div>
1298    
1299                                                                      </blockquote>                                                                      </blockquote>
1300    
1301    
1302    
1303    
1304    
1305    
1306                                                                                                                                              <h4>                                                                                                                                              <h4>
1307      The current configuration Preview view</h4>      The current configuration Preview view</h4>
1308    
1309    
1310    
1311    
1312    
1313    
1314                                                                                                                                              <blockquote>                                                                                                                                              <blockquote>
1315   This Preview shows information about the product you are  using. The content   This Preview shows information about the product you are  using. The content
1316  of the view depends on the product you launched. <br>  of the view depends on the product you launched. <br>
1317    
1318    
1319    
1320                                                                                                                                                      <div align="Center"><img src="images/pic012b.gif" alt="product preview" width="507" height="503">
1321    
1322    
1323     <br>
1324    
1325                                                                            </div>
1326    
1327    
1328                                                                        </blockquote>                                                                        </blockquote>
1329    
1330    
1331    
1332    
1333    
1334    
1335                                                                                                                                                <h4>                                                                                                                                                <h4>
1336      The Site and Site Bookmark Preview View</h4>      The Site and Site Bookmark Preview View</h4>
1337    
1338    
1339    
1340    
1341    
1342    
1343                                                                                                                                                <blockquote>                                                                                                                                                <blockquote>
1344   This Preview shows the Site URL of the selected Site or  Bookmark Site.<br>     This Preview shows the Site Address of the selected Site or  Bookmark
1345    Site.<br>
1346    
1347    
1348    
1349                                                                                                                                                        <div align="Center"><img src="images/pic012c.gif" alt="Site Preview" width="507" height="503">
1350    
1351    
1352       <br>
1353    
1354    
1355    
1356    
1357       </div>
1358    
1359    
1360                                                                          </blockquote>                                                                          </blockquote>
1361    
1362    
1363    
1364    
1365    
1366    
1367    
1368                                                                                                                                                  <h4>                                                                                                                                                  <h4>
1369      The Feature Preview View</h4>      The Feature Preview View</h4>
1370    
1371    
1372    
1373    
1374    
1375    
1376    
1377                                                                                                                                                  <blockquote>                                                                                                                                                  <blockquote>
1378   This Preview View shows information about a feature.<br>   This Preview View shows information about a feature.<br>
1379    
1380    
1381    
1382                                                                                                                                                          <div align="Center"><img src="images/pic012d.gif" alt="Feature Preview" width="507" height="669">
1383     
1384    
1385          <br>
1386    
1387    
1388       </div>
1389    
1390    
1391   </blockquote>   </blockquote>
1392    
1393    
1394    
1395    
1396    
1397    
1398    
1399                                                                                                                                                    <h5>                                                                                                                                                    <h5>
1400      Provider</h5>      Provider</h5>
1401    
1402    
1403    
1404    
1405    
1406    
1407    
1408                                                                                                                                                    <blockquote>                                                                                                                                                    <blockquote>
1409   The name of the provider of the feature.<br>   The name of the provider of the feature.<br>
1410    
# Line 972  Line 1413 
1413    
1414    
1415    
1416    
1417    
1418    
1419    
1420                                                                                                                                                      <h5>                                                                                                                                                      <h5>
1421      Version</h5>      Version</h5>
1422    
1423    
1424    
1425    
1426    
1427    
1428    
1429                                                                                                                                                      <blockquote>                                                                                                                                                      <blockquote>
1430   The version of the feature.<br>   The version of the feature.<br>
1431    
# Line 985  Line 1434 
1434    
1435    
1436    
1437    
1438    
1439    
1440    
1441                                                                                                                                                        <h5>                                                                                                                                                        <h5>
1442      Installed Version</h5>      Installed Version</h5>
1443    
1444    
1445    
1446    
1447    
1448    
1449    
1450                                                                                                                                                        <blockquote>                                                                                                                                                        <blockquote>
1451   The list of already installed version of this feature  or 'Not Installed'   The list of already installed version of this feature  or 'Not Installed'
1452  if no version of this feature has been configured in the  current configuration.<br>  if no version of this feature has been configured in the  current configuration.<br>
# Line 999  Line 1456 
1456    
1457    
1458    
1459    
1460    
1461    
1462    
1463                                                                                                                                                          <h5>                                                                                                                                                          <h5>
1464      Download Size</h5>      Download Size</h5>
1465    
1466    
1467    
1468    
1469    
1470    
1471    
1472                                                                                                                                                          <blockquote>                                                                                                                                                          <blockquote>
1473   The maximum download size for the feature. If the site you will install   The maximum download size for the feature. If the site you will install
1474  the feature in already contains some of the files the feature require, the  the feature in already contains some of the files the feature require, the
# Line 1015  Line 1480 
1480    
1481    
1482    
1483    
1484    
1485    
1486    
1487                                                                                                                                                            <h5>                                                                                                                                                            <h5>
1488      Supported Platforms</h5>      Supported Platforms</h5>
1489    
1490    
1491    
1492    
1493    
1494    
1495    
1496                                                                                                                                                            <blockquote>                                                                                                                                                            <blockquote>
1497   This expandable category shows the different supported  platforms for this     This expandable category shows the different supported  platforms for
1498  feature. The categories are Operating Systems, Windowing  Systems, Architectures  this  feature. The categories are Operating Systems, Windowing  Systems,
1499  and Languages.<br>  Architectures  and Languages.<br>
1500    
1501    
1502             </blockquote>             </blockquote>
1503    
1504    
1505    
1506    
1507    
1508    
1509    
1510                                                                                                                                                              <ul>                                                                                                                                                              <ul>
1511    
1512    
1513               <li>    Operating Systems: the list of supported Operating Systems.</li>                 <li>    Operating Systems: the list of supported Operating
1514    Systems.</li>
1515    
1516    
1517               <li>    Windowing Systems: the list of supported Windowing Systems.</li>                 <li>    Windowing Systems: the list of supported Windowing
1518    Systems.</li>
1519    
1520    
1521               <li>    Supported Architectures: the list of supported processor               <li>    Supported Architectures: the list of supported processor
# Line 1048  Line 1527 
1527    
1528    
1529    
1530    
1531    
1532    
1533    
1534                                                                                                                                                              </ul>                                                                                                                                                              </ul>
1535    
1536    
1537    
1538    
1539    
1540    
1541    
1542                                                                                                                                                              <h5>                                                                                                                                                              <h5>
1543   Description </h5>   Description </h5>
1544    
1545    
1546    
1547    
1548    
1549    
1550    
1551                                                                                                                                                              <p class="MsoNormal">                                                                                                                                                              <p class="MsoNormal">
1552   The description of the Feature<br>   The description of the Feature<br>
1553      <br>      <br>
# Line 1066  Line 1557 
1557    
1558    
1559    
1560    
1561    
1562    
1563    
1564                                                                                                                                                              <h5>                                                                                                                                                              <h5>
1565   More Info &lt;TODO should we say it is optional ?&gt;</h5>   More Info &lt;TODO should we say it is optional ?&gt;</h5>
1566    
1567    
1568    
1569    
1570    
1571    
1572    
1573                                                                                                                                                              <blockquote>                                                                                                                                                              <blockquote>
1574   Opens a page with more information about the feature.  The page may be found     Opens a page with more information about the feature.  The page may be
1575  locally or remotely.<br>  found  locally or remotely.<br>
1576    
1577    
1578               </blockquote>               </blockquote>
1579    
1580    
1581    
1582    
1583    
1584    
1585    
1586                                                                                                                                                                <h5>                                                                                                                                                                <h5>
1587   License</h5>   License</h5>
1588    
1589    
1590    
1591    
1592    
1593    
1594    
1595                                                                                                                                                                <blockquote>                                                                                                                                                                <blockquote>
1596   Opens a page with the license of the Feature.<br>   Opens a page with the license of the Feature.<br>
1597    
# Line 1093  Line 1600 
1600    
1601    
1602    
1603    
1604    
1605    
1606    
1607                                                                                                                                                                  <h5>                                                                                                                                                                  <h5>
1608      Copyright</h5>      Copyright</h5>
1609    
1610    
1611    
1612    
1613    
1614    
1615    
1616                                                                                                                                                                  <blockquote>                                                                                                                                                                  <blockquote>
1617    
1618    
1619    
1620    
1621    
1622    
1623    
1624                                                                                                                                                                    <p class="MsoNormal">                                                                                                                                                                    <p class="MsoNormal">
1625   Opens a page with the copyright of the Feature.<br>   Opens a page with the copyright of the Feature.<br>
1626    
# Line 1113  Line 1632 
1632    
1633    
1634    
1635                                                                                                                                                                    <h5>  
1636    
1637    
1638    
1639                                                                                                                                                                          <h5>
1640      Actions</h5>      Actions</h5>
1641    
1642    
1643    
1644    
1645    
1646    
1647    
1648                                                                                                                                                                    <blockquote>                                                                                                                                                                    <blockquote>
1649    
1650    
1651    
1652    
1653    
1654    
1655    
1656                                                                                                                                                                      <p class="MsoNormal">                                                                                                                                                                      <p class="MsoNormal">
1657   In the lower left side of the Preview View for a feature you may see one   In the lower left side of the Preview View for a feature you may see one
1658  or multiple buttons. They provide you with actions  you can take on the Feature  or multiple buttons. They provide you with actions  you can take on the Feature
# Line 1136  Line 1667 
1667    
1668    
1669    
1670    
1671    
1672    
1673    
1674                                                                                                                                                                      <ul>                                                                                                                                                                      <ul>
1675    
1676    
# Line 1148  Line 1683 
1683                       </li>                       </li>
1684    
1685    
1686                       <li>    Unconfigure: this launches the Unconfigure Wizard                         <li>    Unconfigure: this launches the Unconfigure
1687  for this  configured feature. See <a href="http://www.eclipse.org">Configuring/Unconfiguring  Wizard for this  configured feature. See <a href="http://www.eclipse.org">
1688   a Feature</a>   Configuring/Unconfiguring  a Feature</a>
1689      .<br>      .<br>
1690      Configure: this launches the Configure Wizard for this  unconfigured      Configure: this launches the Configure Wizard for this  unconfigured
1691  feature. See <a href="http://www.eclipse.org">Configuring/Unconfiguring  feature. See <a href="http://www.eclipse.org">Configuring/Unconfiguring
# Line 1162  Line 1697 
1697    
1698    
1699    
1700    
1701    
1702    
1703    
1704                                                                                                                                                                      </ul>                                                                                                                                                                      </ul>
1705    
1706    
1707    
1708    
1709    
1710    
1711    
1712                                                                                                                                                                      <h4>                                                                                                                                                                      <h4>
1713   The Configuration Preview View</h4>   The Configuration Preview View</h4>
1714    
1715    
1716    
1717    
1718    
1719    
1720    
1721                                                                                                                                                                      <blockquote>                                                                                                                                                                      <blockquote>
1722    
1723    
1724    
                                                                                                                                                                       <p class="MsoNormal">  
  &lt;TODO&gt;<br>  
1725    
1726    
                      </p>  
1727    
1728    
1729                                                                                                                                                                              <p class="MsoNormal">
1730       This preview shows information about the select configuration.<br>
1731                                                                                                                                                                              </p>
1732                                                                                                                                                                              <div align="Center"><img src="images/pic013.gif" alt="Configuration Preview" width="621" height="488">
1733                                                                                                                                                                              <br>
1734                                                                                                                                                                              </div>
1735                                                                                                                                                                              </blockquote>
1736                                                                                                                                                                              <p class="MsoNormal"><br>
1737                                                                                                                                                                              </p>
1738                                                                                                                                                                              <h5>
1739    Created On</h5>
1740                                                                                                                                                                              <blockquote>
1741                                                                                                                                                                                <p class="MsoNormal">
1742    The date in the current locale, the configuration was created on.<br>
1743                                                                                                                                                                                </p>
1744                                                                                                                                                                                </blockquote>
1745                                                                                                                                                                                <h5>
1746    Current Configuration</h5>
1747                                                                                                                                                                                <blockquote>
1748                                                                                                                                                                                  <p class="MsoNormal">
1749    If the selected configuration is the active configuration.<br>
1750                                                                                                                                                                                  </p>
1751                                                                                                                                                                                  </blockquote>
1752                                                                                                                                                                                  <h5>
1753    Activities</h5>
1754                                                                                                                                                                                  <blockquote>
1755    List of activities that led to the creation of the configuration. For more
1756    information about the differents activities, see <a href="http://www.eclipse.org">
1757    Activities</a>
1758    .<br>
1759                       </blockquote>                       </blockquote>
1760                                                                                                                                                                                    <p class="MsoNormal"></p>
1761                                                                                                                                                                                    <h5>
1762    Configuration Reversal</h5>
1763    
1764    
1765    
1766    
                                                                                                                                                                       <h5>  
     Actions</h5>  
1767    
1768    
1769    
1770                                                                                                                                                                        <blockquote>                                                                                                                                                                        <blockquote>
1771   In the lower left side of the Preview View for a configuration you may see     In the lower left side of the Preview View for a configuration you may
1772  one button. It provides you with actions  you can take on the Configuration  see  one button. It provides you with actions  you can take on the Configuration
1773  depending if it is the current configuration or another one. If a change is   depending if it is the current configuration or another one. If a change
1774   pending for a feature, no actions will be available until the workbench  is  pending for a feature, no actions will be available until the workbench
1775    is restarted.</blockquote>    is restarted.</blockquote>
1776    
1777    
1778    
1779    
1780    
1781    
1782    
1783    
1784                                                                                                                                                                          <ul>                                                                                                                                                                          <ul>
1785    
1786    
1787                           <li> Restore: this restores the selected configuration.                           <li> Restore: this restores the selected configuration.
1788  See <a href="http://www.eclipse.org"> Restore a Configuration/Revert to previous   See <a href="http://www.eclipse.org"> Restore a Configuration/Revert to
1789  configuration</a>  previous  configuration</a>
1790   .<br>   .<br>
1791    
1792    
# Line 1219  Line 1800 
1800    
1801    
1802    
1803    
1804    
1805    
1806    
1807    
1808                                                                                                                                                                          </ul>                                                                                                                                                                          </ul>
1809    
1810    
1811    
1812    
1813    
1814    
1815    
1816    
1817                                                                                                                                                                          <p class="MsoNormal"></p>                                                                                                                                                                          <p class="MsoNormal"></p>
1818    
1819    
1820    
1821    
1822    
1823    
1824    
1825    
1826                                                                                                                                                                          <h4>                                                                                                                                                                          <h4>
1827   The search Preview View</h4>   The search Preview View</h4>
1828    
1829    
1830    
1831    
1832    
1833    
1834    
1835    
1836                                                                                                                                                                          <blockquote>                                                                                                                                                                          <blockquote>
1837   &lt;TODO&gt;<br>     &lt;TODO depending on the search&gt;<br>
1838    
1839    
1840                           </blockquote>                           </blockquote>
1841    
1842    
1843    
1844    
1845    
1846    
1847    
1848    
1849                                                                                                                                                                            <h3>                                                                                                                                                                            <h3>
1850   The Install/Update Preference Page</h3>   The Install/Update Preference Page</h3>
1851    
1852    
1853    
1854    
1855    
1856    
1857    
1858    
1859                                                                                                                                                                            <blockquote>                                                                                                                                                                            <blockquote>
1860   You can open the preference page from the Workbench main menu. Click  Window-&gt;preferences   You can open the preference page from the Workbench main menu. Click  Window-&gt;preferences
1861  to open the Preference Dialog. Select Install/Update  to reveal the Install/Update  to open the Preference Dialog. Select Install/Update  to reveal the Install/Update
# Line 1257  Line 1868 
1868    
1869    
1870    
1871    
1872    
1873    
1874    
1875    
1876                                                                                                                                                                              <p class="MsoNormal"></p>                                                                                                                                                                              <p class="MsoNormal"></p>
1877    
1878    
1879    
1880    
1881    
1882    
1883    
1884    
1885                                                                                                                                                                              <h4>                                                                                                                                                                              <h4>
1886   Number of &lt;TODO&gt; configurations entry field.<br>  Maximum number of 'History' configurations entry field.<br>
1887    
1888    
1889                             </h4>                             </h4>
1890    
1891    
1892    
1893    
1894    
1895    
1896    
1897    
1898                                                                                                                                                                              <blockquote>                                                                                                                                                                              <blockquote>
1899   Enter the number of history configurations you want the Install/Update to     Enter the number of history configurations you want the Install/Update
1900  keep. See <a href="http://www.eclipse.org">Configuration History</a>  to  keep. See <a href="http://www.eclipse.org">Configuration History</a>
1901    for more information.<br>    for more information.<br>
1902    
1903    
# Line 1279  Line 1905 
1905    
1906    
1907    
1908    
1909    
1910    
1911    
1912    
1913                                                                                                                                                                                <h4>                                                                                                                                                                                <h4>
1914   Web Links radio buttons.</h4>   Web Links radio buttons.</h4>
1915    
1916    
1917    
1918    
1919    
1920    
1921    
1922    
1923                                                                                                                                                                                <blockquote>                                                                                                                                                                                <blockquote>
1924   When opening Web links. Allows you to choose between opening the internal   When opening Web links. Allows you to choose between opening the internal
1925  WebView or opening an external browser.<br>  WebView or opening an external browser.<br>
# Line 1293  Line 1929 
1929    
1930    
1931    
1932    
1933    
1934    
1935    
1936    
1937                                                                                                                                                                                  <h2>                                                                                                                                                                                  <h2>
1938   Finding features</h2>   Finding features</h2>
1939    
1940    
1941    
1942    
1943    
1944    
1945    
1946    
1947                                                                                                                                                                                  <blockquote>                                                                                                                                                                                  <blockquote>
1948      This section will explain how to find the features  to install. There      This section will explain how to find the features  to install. There
1949  are different way of looking for features; you may know exactly which feature  are different way of looking for features; you may know exactly which feature
# Line 1310  Line 1956 
1956    
1957    
1958    
1959    
1960    
1961    
1962    
1963    
1964                                                                                                                                                                                    <h3>                                                                                                                                                                                    <h3>
1965      Find a specific feature </h3>      Find a specific feature </h3>
1966    
1967    
1968    
1969    
1970    
1971    
1972    
1973    
1974                                                                                                                                                                                    <blockquote>                                                                                                                                                                                    <blockquote>
1975    
1976    
1977    
1978    
1979    
1980    
1981    
1982    
1983                                                                                                                                                                                      <p class="MsoNormal">                                                                                                                                                                                      <p class="MsoNormal">
1984   This section will focus on finding a feature when you know exactly  where   This section will focus on finding a feature when you know exactly  where
1985  to find it. To find a feature you may either add the Update Site that  contains  to find it. To find a feature you may either add the Update Site that  contains
1986  this feature and browse the site to find the feature or you can open the WebView   this feature and browse the site to find the feature or you can open the
1987  and browe to the Feature WebPage.</p>  WebView and browe to the Feature WebPage.</p>
1988    
1989    
1990                                     </blockquote>                                     </blockquote>
1991    
1992    
1993    
1994    
1995    
1996    
1997    
1998    
1999                                                                                                                                                                                      <h4>                                                                                                                                                                                      <h4>
2000   Add a new Update Site </h4>   Add a new Update Site </h4>
2001    
2002    
2003    
2004    
2005    
2006    
2007    
2008    
2009                                                                                                                                                                                      <blockquote>                                                                                                                                                                                      <blockquote>
2010    
2011    
2012    
2013    
2014    
2015    
2016    
2017    
2018                                                                                                                                                                                        <p class="MsoNormal">                                                                                                                                                                                        <p class="MsoNormal">
2019   To add a new Update site, open the context  Menu in the Updates View and   To add a new Update site, open the context  Menu in the Updates View and
2020  select New-&gt;Site Bookmerk....  This opens  a Dialog box that presents the   select New-&gt;Site Bookmerk....  This opens  a Dialog box that presents
2021  properties of the Bookmark Site you want to  create. The properties of a  the properties of the Bookmark Site you want to  create. The properties of
2022  Bookmark Site are the label you want to see in  the View as well as the URL  a Bookmark Site are the label you want to see in  the View as well as the
2023  of the physical site. You have to enter the Site  URL. Optionally you can  URL of the physical site. You have to enter the Site  URL. Optionally you
2024  enter the Site Name. If you do not enter a Site Name,  it will default to  can enter the Site Name. If you do not enter a Site Name,  it will default
2025  the Site URL. Click Ok when you have finished and you want to preserve your  to the Site URL. Click Ok when you have finished and you want to preserve
2026  changes or click Cancel if you do not want to create a new Site Bookmark.  your changes or click Cancel if you do not want to create a new Site Bookmark.
2027   </p>   </p>
2028    
2029    
# Line 1355  Line 2031 
2031    
2032    
2033    
2034    
2035    
2036    
2037    
2038    
2039                                                                                                                                                                                        <h4>                                                                                                                                                                                        <h4>
2040   Find the feature   </h4>   Find the feature   </h4>
2041    
2042    
2043    
2044    
2045    
2046    
2047    
2048    
2049                                                                                                                                                                                        <blockquote>                                                                                                                                                                                        <blockquote>
2050    
2051    
2052    
2053    
2054    
2055    
2056    
2057    
2058                                                                                                                                                                                          <p class="MsoNormal">                                                                                                                                                                                          <p class="MsoNormal">
2059   Expand the site to find the feature you want. You can find the feature by     Expand the site to find the feature you want. You can find the feature
2060  looking at the label or selecting a feature and reading the preview view.  by  looking at the label or selecting a feature and reading the preview view.
2061  To know more about preview view:  See <a href="http://www.eclipse.org">  Preview   To know more about preview view:  See <a href="http://www.eclipse.org">
2062  View</a>  Preview View</a>
2063     .</p>     .</p>
2064    
2065    
# Line 1376  Line 2067 
2067    
2068    
2069    
2070    
2071    
2072    
2073    
2074    
2075                                                                                                                                                                                          <h4>                                                                                                                                                                                          <h4>
2076   Browse WebPages </h4>   Browse WebPages </h4>
2077    
2078    
2079    
2080    
2081    
2082    
2083    
2084    
2085                                                                                                                                                                                          <blockquote>                                                                                                                                                                                          <blockquote>
2086   Open the <a href="http://www.eclipse.org">WebView</a>   Open the <a href="http://www.eclipse.org">WebView</a>
2087      and enter the URL for the feature web page. Follow the indication of      and enter the URL for the feature web page. Follow the indication of
# Line 1391  Line 2092 
2092    
2093    
2094    
2095    
2096    
2097    
2098    
2099    
2100                                                                                                                                                                                            <h3>                                                                                                                                                                                            <h3>
2101   Update already existing features</h3>   Update already existing features</h3>
2102    
2103    
2104    
2105    
2106    
2107    
2108    
2109    
2110                                                                                                                                                                                            <blockquote>                                                                                                                                                                                            <blockquote>
2111    
2112    
2113    
2114    
2115    
2116    
2117    
2118    
2119                                                                                                                                                                                              <p class="MsoNormal">                                                                                                                                                                                              <p class="MsoNormal">
2120   This section will focus on updating features  that are configured in your   This section will focus on updating features  that are configured in your
2121  current configuration.To know how to configure/unconfigure a fetaure; see:  current configuration.To know how to configure/unconfigure a fetaure; see:
# Line 1414  Line 2130 
2130    
2131    
2132    
2133    
2134    
2135    
2136    
2137    
2138                                                                                                                                                                                              <h4>                                                                                                                                                                                              <h4>
2139   Search for updates</h4>   Search for updates</h4>
2140    
2141    
2142    
2143    
2144    
2145    
2146    
2147    
2148                                                                                                                                                                                              <blockquote>                                                                                                                                                                                              <blockquote>
2149    To search for available updates, select Available Updates in the Updates    To search for available updates, select Available Updates in the Updates
2150  View. In the preview view, press Search now.  This will search the site the  View. In the preview view, press Search now.  This will search the site the
# Line 1434  Line 2160 
2160    
2161    
2162    
2163    
2164    
2165    
2166    
2167    
2168                                                                                                                                                                                                <h4>                                                                                                                                                                                                <h4>
2169   Search the file system</h4>   Search the file system</h4>
2170    
2171    
2172    
2173    
2174    
2175    
2176    
2177    
2178                                                                                                                                                                                                <blockquote>                                                                                                                                                                                                <blockquote>
2179    
2180    
2181    
2182    
2183    
2184    
2185    
2186    
2187    
2188                                                                                                                                                                                                  <p class="MsoNormal">                                                                                                                                                                                                  <p class="MsoNormal">
2189   You can decide to search the file system for updates by checking the 'Include   You can decide to search the file system for updates by checking the 'Include
2190  my computer in the search' box, under the Scope Settings section in the preview  my computer in the search' box, under the Scope Settings section in the preview
# Line 1454  Line 2196 
2196    
2197    
2198    
                                                                                                                                                                                                 <h4>  
  Customize Search</h4>  
2199    
2200    
2201    
                                                                                                                                                                                                 <blockquote>  
2202    
2203    
2204    
2205                                                                                                                                                                                                    <p class="MsoNormal">                                                                                                                                                                                                            <h4>
2206   You can cutomize the search for updates by creating a new search. To know     Customize Search</h4>
2207  how to create a new search &lt;TODO&gt;</p>  
2208    
2209    
                                                  </blockquote>  
2210    
2211    
2212    
                                                                                                                                                                                                   <h3>  
  Browse to discover</h3>  
2213    
2214    
2215    
# Line 1481  Line 2217 
2217    
2218    
2219    
                                                                                                                                                                                                     <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>  
2220    
2221    
                                                    </blockquote>  
2222    
2223    
2224    
                                                                                                                                                                                                     <h4>  
  Browse already existing sites</h4>  
2225    
2226                                                                                                                                                                                                                <p class="MsoNormal">
2227       You can cutomize the search for updates by creating a new search. To know
2228     how to create a new search &lt;TODO&gt;</p>
2229    
2230    
2231                                                                                                                                                                                                      <blockquote>                                                     </blockquote>
2232    
2233    
2234    
                                                                                                                                                                                                       <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>  
2235    
2236    
                                                      </blockquote>  
2237    
2238    
2239    
2240                                                                                                                                                                                                        <h4>  
2241   Browse the file system</h4>                                                                                                                                                                                                              <h3>
2242       Browse to discover</h3>
2243    
2244    
2245    
2246    
2247    
2248    
2249    
2250    
2251    
# Line 1522  Line 2253 
2253    
2254    
2255    
2256    
2257    
2258    
2259    
2260    
2261    
2262                                                                                                                                                                                                          <p class="MsoNormal">                                                                                                                                                                                                          <p class="MsoNormal">
2263   To browse the file system, expand 'My Computer'.  &lt;TODO what more to     This section will focus on browsing update sites to find the features
2264  say ?&gt;</p>  you  want to install. All the update site appear in the Updates View. There
2265    are  different places in the view where you can find sites to browse. You
2266    may have sites in the folder 'Places to visit' or you may have sites on your
2267    file system. You can also add some update site if you know their URL.<br>
2268        </p>
2269    
2270    
2271                                                         </blockquote>                                                         </blockquote>
2272    
2273    
2274    
2275    
2276    
2277    
2278    
2279    
2280    
2281                                                                                                                                                                                                          <h4>                                                                                                                                                                                                          <h4>
2282   Add a new Update Site </h4>     Browse already existing sites</h4>
2283    
2284    
2285    
2286    
2287    
2288    
2289    
2290    
2291    
2292                                                                                                                                                                                                          <blockquote>                                                                                                                                                                                                          <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 URL 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>  
2293    
2294    
                                                          </blockquote>  
2295    
2296    
2297    
                                                                                                                                                                                                           <h4>  
  Add a bookmark of a file system site.</h4>  
2298    
2299    
2300    
2301                                                                                                                                                                                                            <blockquote>  
2302   When you browse the file syste, you can add a file system site as a bookmark.                                                                                                                                                                                                                  <p class="MsoNormal">
2303  Select the site. Open the context menu. Select  'Bookmark Location'.  This     If you expand the folder 'Places to visit' you may see some sites. They
2304  action lets you create bookmark site for a site found on your local file system.   were automatically added to the folder by the feature you installed. You
2305  This opens a Dialog box that presents the properties of the selected site.  can expand the site and browse the features.</p>
 The properties of a Site are the label you want to see in the View as well  
 as the URL 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>  
2306    
2307    
2308                                                             </blockquote>                                                             </blockquote>
2309    
2310    
2311    
                                                                                                                                                                                                             <h3>  
  Searching Features</h3>  
  &lt;TODO&gt;<br>  
2312    
2313    
2314    
                                                                                                                                                                                                             <h4>  
  Search for updates</h4>  
  &lt;TODO&gt;<br>  
2315    
2316    
2317    
2318                                                                                                                                                                                                              <h4>                                                                                                                                                                                                              <h4>
2319   Search the file system</h4>     Browse the file system</h4>
  &lt;TODO&gt;<br>  
2320    
2321    
2322    
                                                                                                                                                                                                             <h4>  
  Customize Search</h4>  
  &lt;TODO&gt;<br>  
2323    
2324    
2325    
                                                                                                                                                                                                             <h2>  
     Installing a Feature</h2>  
2326    
2327    
2328    
2329                                                                                                                                                                                                              <blockquote>                                                                                                                                                                                                              <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>  
2330    
2331    
                                                              </blockquote>  
2332    
2333    
2334    
                                                                                                                                                                                                               <h3>  
     Install Wizard</h3>  
2335    
2336    
2337    
2338                                                                                                                                                                                                                <blockquote>  
2339      The Wizard will help you install, configure, unconfigure and remove                                                                                                                                                                                                                    <p class="MsoNormal">
2340  a feature. It will allow you to review any license agreement and to choose     To browse the file system, expand 'My Computer'.  &lt;TODO what more to
2341   the Site in which you wish to install the feature.<br>  say?&gt;</p>
2342    
2343    
2344                                                                 </blockquote>                                                                 </blockquote>
2345    
2346    
2347    
2348    
2349    
2350    
2351    
2352    
2353    
2354                                                                                                                                                                                                                  <h4>                                                                                                                                                                                                                  <h4>
2355   The Preview Tab</h4>     Add a new Update Site </h4>
2356    
2357    
2358    
2359    
2360    
2361    
2362    
2363    
2364    
2365                                                                                                                                                                                                                  <blockquote>                                                                                                                                                                                                                  <blockquote>
2366   This tab summarizes the action you are going to take. <br>     You can add a new update site from the context menu. Select new-&gt;SiteBookmark...
2367      This opens a Dialog box that presents the properties of the Bookmark Site
2368      you want to create. The properties of a Bookmark Site are the label you
2369    want  to see in the View as well as the Address of the physical site. You
2370    have  to enter  the Site URL. Optionally you can enter the Site Name. If
2371    youdo not enter a Site Name, it will default to the Site URL. Click Ok when
2372    you have finished  and you want to preserve your changes or click Cancel
2373    if you do not want to create a new Site Bookmark. Once the site has been
2374    created, expand the icon to see the categories and or the available features.<br>
2375    
2376    
2377                                                                   </blockquote>                                                                   </blockquote>
2378    
2379    
2380    
                                                                                                                                                                                                                   <div align="Center"><img src="images/PIC002.gif" alt="Install Wizard Preview Tab PIC002.gif" width="500" height="500">  
                                                                                                                                                                                                                   <br>  
2381    
2382    
2383                                                                   </div>  
2384    
2385    
2386    
2387                                                                                                                                                                                                                    <h4>                                                                                                                                                                                                                    <h4>
2388    The License Tab</h4>     Add a bookmark of a file system site.</h4>
2389    
2390    
2391    
2392    
2393    
2394    
2395    
2396    
2397    
2398                                                                                                                                                                                                                    <blockquote>                                                                                                                                                                                                                    <blockquote>
2399   This tab will present you the license you have to agree with  to install     When you browse the file syste, you can add a file system site as a bookmark.
2400  the product. Click on agree if you agree with the whole license  and whish   Select the site. Open the context menu. Select  'Bookmark Location'.  This
2401  to continue or click cancel to abort the installation<br>   action lets you create bookmark site for a site found on your local file
2402    system. This opens a Dialog box that presents the properties of the selected
2403    site. The properties of a Site are the label you want to see in the View as
2404    well as the Address of the site. You are able to change the Site Name. Click
2405    Ok when you have finished and you want to preserve your changes or click
2406    Cancel if you do not want to change the properties. Once the site has been
2407    created, expand the icon to see the categories and or the available features.<br>
2408    
2409    
2410                                                                     </blockquote>                                                                     </blockquote>
2411    
2412    
2413    
                                                                                                                                                                                                                     <h4>  
     Site location Tab</h4>  
2414    
2415    
2416    
                                                                                                                                                                                                                     <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>  
2417    
2418    
2419                                                                       </blockquote>  
2420                                                                                                                                                                                                                          <h3>
2421       Searching Features</h3>
2422       &lt;TODO&gt;<br>
2423    
2424    
2425    
                                                                                                                                                                                                                       <h4>  
  Verification &lt;TODO explain basic certificate &gt;</h4>  
2426    
2427    
2428    
                                                                                                                                                                                                                       <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>  
2429    
2430    
                                                                        </blockquote>  
2431    
2432                                                                                                                                                                                                                          <h4>
2433       Search for updates</h4>
2434       &lt;TODO&gt;<br>
2435    
2436    
                                                                                                                                                                                                                         <h5>  
     Signed</h5>  
2437    
2438    
2439    
                                                                                                                                                                                                                         <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>  
2440    
2441    
2442    
                                                                                                                                                                                                                           </blockquote>  
2443    
2444                                                                                                                                                                                                                          <h4>
2445       Search the file system</h4>
2446       &lt;TODO&gt;<br>
2447    
2448    
2449    
                                                                                                                                                                                                                           <h5>  
  Non Signed</h5>  
2450    
2451    
2452    
                                                                                                                                                                                                                           <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>  
2453    
2454    
2455    
2456    </blockquote>                                                                                                                                                                                                                        <h4>
2457       Customize Search</h4>
2458       &lt;TODO&gt;<br>
2459    
2460    
2461    
2462    
                                                                                                                                                                                                                             <h5>  
   Corrupted  </h5>  
2463    
2464    
2465    
2466    
                                                                                                                                                                                                                             <blockquote>  
2467    
2468                                                                                                                                                                                                                          <h2>
2469          Installing a Feature</h2>
2470    
2471    
2472    
                                                                                                                                                                                                                               <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>  
2473    
2474    
2475    
     </blockquote>  
2476    
2477    
2478    
2479                                                                                                                                                                                                                          <blockquote>
2480          This section will describe the Wizard used to install, configure, unconfigure
2481      and remove a feature as well as the verification task that may occur when
2482      installing a new feature. The first part will focus on the three tab that
2483      are part of the Wizard, while the second part will deal with verification
2484      and security issues when installing a feature.<br>
2485    
                                                                                                                                                                                                                               <h5>  
  Feature verification dialog</h5>  
2486    
2487                                                                   </blockquote>
2488    
2489    
2490    
                                                                                                                                                                                                                               <blockquote>  
2491    
2492    
2493    
2494    
                                                                                                                                                                                                                                 <p class="MsoNormal">  
  &lt;TODO explain the dialog with feature/ install/ cancel&gt;</p>  
2495    
2496    
2497                                                                                                                                                                                                                            <h3>
2498          Install Wizard</h3>
2499    
       </blockquote>  
2500    
2501    
2502    
2503    
                                                                                                                                                                                                                                 <h5>  
  Feature file verification dialog</h5>  
2504    
2505    
2506    
2507    
2508                                                                                                                                                                                                                                  <blockquote>                                                                                                                                                                                                                                  <blockquote>
2509          The Wizard will help you install, configure, unconfigure and remove
2510     a feature. It will allow you to review any license agreement and to choose
2511      the Site in which you wish to install the feature.<br>
2512    
2513    
2514                                                                     </blockquote>
2515    
2516    
                                                                                                                                                                                                                                   <p class="MsoNormal">  
  &lt;TODO explain the dialog with feature file/ continue/ cancel&gt;</p>  
2517    
2518    
2519    
         </blockquote>  
2520    
2521    
2522    
2523    
2524                                                                                                                                                                                                                                    <h5>                                                                                                                                                                                                                            <h4>
2525   Persistence of the answer</h5>     The Preview Tab</h4>
2526    
2527    
2528    
2529    
2530    
2531    
2532    
2533    
2534    
2535                                                                                                                                                                                                                                    <blockquote>                                                                                                                                                                                                                                    <blockquote>
2536       This tab summarizes the action you are going to take. <br>
2537    
2538    
2539                                                                       </blockquote>
2540    
2541    
                                                                                                                                                                                                                                     <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.  
2542    
2543    
2544    
          <br>  
    </p>  
2545    
2546    
2547    
           </blockquote>  
2548    
2549                                                                                                                                                                                                                                <div align="Left"><img src="images/PIC002.gif" alt="Install Wizard Preview Tab PIC002.gif" width="500" height="500">
2550    
2551    
2552                                                                      <br>
2553    
                                                                                                                                                                                                                                     <h2>  
     Configuring/Unconfiguring a Feature</h2>  
2554    
2555                                                                       </div>
2556    
2557    
2558    
                                                                                                                                                                                                                                     <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>  
2559    
2560    
2561    
             </blockquote>  
2562    
2563    
2564    
2565                                                                                                                                                                                                                                <h4>
2566        The License Tab</h4>
2567    
                                                                                                                                                                                                                                       <h3>  
     Checking if a feature is configured or unconfigured.<br>  
2568    
2569    
2570    
             </h3>  
2571    
2572    
2573    
2574    
                                                                                                                                                                                                                                       <blockquote>  
  Feature you installed appear in the Configuration View. Expand the Current  
 Configuration to see the configured sites. Expand the site to see the Features.  
 Use the local view toolbar button to switch between configured  features and  
 all the features. Unconfigured features appear with such icon <img src="images/unconf_feature_obj.gif" alt="unconf_feature_obj.gif Unconfigured Feature" width="16" height="16">  
                                                                                                                                                                                                                                         <br>  
2575    
2576                                                                                                                                                                                                                                <blockquote>
2577       This tab will present you the license you have to agree with  to install
2578     the product. Click on agree if you agree with the whole license  and whish
2579     to continue or click cancel to abort the installation<br>
2580    
2581    
2582                </blockquote>                </blockquote>
# Line 1882  Line 2584 
2584    
2585    
2586    
                                                                                                                                                                                                                                         <h3>  
     Configure/Unconfigure Wizard</h3>  
2587    
2588    
2589    
2590    
2591                                                                                                                                                                                                                                          <blockquote>  
2592                                                                                                                                                                                                                                  <h4>
2593          Site location Tab</h4>
2594    
2595    
2596    
2597    
2598    
                                                                                                                                                                                                                                           <p class="MsoNormal">  
  &lt;TODO&gt;<br>  
2599    
2600    
2601    
                 </p>  
2602    
2603                                                                                                                                                                                                                                  <blockquote>
2604       This tab has three main goals. The first one is to show you  the available
2605     sites on your local file system, the second is the ability to create a new
2606     site if the one proposed are not satisfactory, finally you will be able to
2607     see the space left on the selected site and the size in kilobyte  of the
2608    feature you are about to install.<br>
2609    
2610    
2611                  </blockquote>                  </blockquote>
# Line 1907  Line 2613 
2613    
2614    
2615    
2616    
2617    
2618    
2619    
2620    
2621                                                                                                                                                                                                                                            <h4>                                                                                                                                                                                                                                            <h4>
2622   Preview Tab</h4>     Verification &lt;TODO explain basic certificate &gt;</h4>
2623    
2624    
2625    
2626    
                                                                                                                                                                                                                                           <blockquote>  
  This tab summarizes the action you are going to take. <br>  
2627    
2628    
2629    
2630    
2631                                                                                                                                                                                                                                              <div align="Center"><img src="images/PIC003.gif" alt="PIC003.gif Configure Wizard Preview Tab" width="500" height="500">  
2632                                                                                                                                                                                                                                              <br>                                                                                                                                                                                                                                  <blockquote>
2633          Verification is an important part of the install process. It will
2634    allow  you to verify if the feature you are about to install has been digitally
2635     signed, not digitally signed or tempered with.<br>
2636    
2637    
2638    
2639                                                                                                                                                                                                                                      </blockquote>
2640    
2641    
2642    
2643    
2644    
2645    
2646    
2647    
2648    
2649                                                                                                                                                                                                                                      <h5>
2650          Signed</h5>
2651    
2652    
2653    
2654    
2655    
2656    
2657    
2658    
2659    
2660                                                                                                                                                                                                                                      <blockquote>
2661       A dialog with the following &lt;PICTURE&gt; will appear if the feature
2662    or  one of its file has been signed. A signed feature means the file has been
2663     digitally signed by the signer, and the signer has been authenticated by
2664    the authenticator. The authenticator can be the same entity as the signer,
2665    in which case you will see such a dialog &lt;PICTURE&gt;. In some cases, the
2666    authenticator is a different entity than the signer, in which case you will
2667    see such a dialog. &lt;PICTURE&gt;. If the authenticator has never been authenticated
2668    by you, you will see such a dialog &lt;PICTURE&gt;. If the signature of the
2669    authenticator has been authorized before, you will see such a dialog &lt;PICTURE&gt;.
2670    Click continue or install only if you trust the signer of the feature file
2671    and you want to install the feature, or click cancel if you want to abort
2672    the installation.<br>
2673    
2674    
2675    
2676    
2677    
2678    
2679    
2680    
2681    
2682        </blockquote>
2683    
2684    
2685    
2686    
2687    
2688    
2689    
2690    
2691    
2692    
2693                                                                                                                                                                                                                                        <h5>
2694       Non Signed</h5>
2695    
2696    
2697    
2698    
2699    
2700    
2701    
2702    
2703    
2704    
2705                                                                                                                                                                                                                                        <blockquote>
2706       A dialog  like the following &lt;PICTURE&gt; will appear if the feature
2707     or one of its file has not been signed. When a feature has not been signed,
2708     we cannot authenticate the sender of the package, nor can we certify the
2709    validity of any of the file. Click continue or install only if you want to
2710    install the feature, or click cancel if you want to abort the installation.<br>
2711    
2712    
2713    
2714        </blockquote>
2715    
2716    
2717    
2718    
2719    
2720    
2721    
2722    
2723    
2724    
2725                                                                                                                                                                                                                                          <h5>
2726        Corrupted  </h5>
2727    
2728    
2729    
2730    
2731    
2732    
2733    
2734    
2735    
2736    
2737                                                                                                                                                                                                                                          <blockquote>
2738    
2739    
2740    
2741    
2742    
2743    
2744    
2745    
2746    
2747    
2748                                                                                                                                                                                                                                            <p class="MsoNormal">
2749        If the content of a feature has changed since it has been signed, you
2750    will  see such a dialog &lt;PICTURE&gt;. This means the content has been tempered
2751     with. Install/Update will prevent you from installing such a feature. Click
2752     cancel if you want to abort the installation and contact the provider of
2753    the feature and/or the site. </p>
2754    
2755    
2756    
2757          </blockquote>
2758    
2759    
2760    
2761    
2762    
2763    
2764    
2765    
2766    
2767    
2768                                                                                                                                                                                                                                            <h5>
2769       Feature verification dialog</h5>
2770    
2771    
2772    
2773    
2774    
2775    
2776    
2777    
2778    
2779    
2780                                                                                                                                                                                                                                            <blockquote>
2781    
2782    
2783    
2784    
2785    
2786    
2787    
2788    
2789    
2790    
2791                                                                                                                                                                                                                                              <p class="MsoNormal">
2792       &lt;TODO explain the dialog with feature/ install/ cancel&gt;</p>
2793    
2794    
2795    
2796            </blockquote>
2797    
2798    
2799    
2800    
2801    
2802    
2803    
2804    
2805    
2806    
2807                                                                                                                                                                                                                                              <h5>
2808       Feature file verification dialog</h5>
2809    
2810    
2811    
2812    
2813    
2814    
2815    
2816    
2817    
2818    
2819                                                                                                                                                                                                                                              <blockquote>
2820    
2821    
2822    
2823    
2824    
2825    
2826    
2827    
2828    
2829    
2830                                                                                                                                                                                                                                                <p class="MsoNormal">
2831       &lt;TODO explain the dialog with feature file/ continue/ cancel&gt;</p>
2832    
2833    
2834    
2835              </blockquote>
2836    
2837    
2838    
2839    
2840    
2841    
2842    
2843    
2844    
2845    
2846                                                                                                                                                                                                                                                <h5>
2847       Persistence of the answer</h5>
2848    
2849    
2850    
2851    
2852    
2853    
2854    
2855    
2856    
2857    
2858                                                                                                                                                                                                                                                <blockquote>
2859    
2860    
2861    
2862    
2863    
2864    
2865    
2866    
2867    
2868    
2869                                                                                                                                                                                                                                                  <p class="MsoNormal">
2870       If click continue or install on a verification dialog, the Install/Update
2871      component will remember your action and will not prompt you again if one
2872     of the file of the feature is about to show the exact same verification
2873    dialog.
2874    
2875    
2876                      <br>
2877         </p>
2878    
2879    
2880    
2881                </blockquote>
2882    
2883    
2884    
2885    
2886    
2887    
2888    
2889    
2890    
2891    
2892                                                                                                                                                                                                                                                  <h2>
2893          Configuring/Unconfiguring a Feature</h2>
2894    
2895    
2896    
2897    
2898    
2899    
2900    
2901    
2902