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

Parent Directory Parent Directory | Revision Log Revision Log

Revision 1.2 - (view) (download) (as text)

1 : celek 1.1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 :     <html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns="http://www.w3.org/TR/REC-html40">
3 :     <head>
4 : celek 1.2
5 : celek 1.1 <meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
6 : celek 1.2
7 : celek 1.1 <meta name="ProgId" content="Word.Document">
8 : celek 1.2
9 : celek 1.1 <meta name="Generator" content="Microsoft Word 9">
10 : celek 1.2
11 : celek 1.1 <meta name="Originator" content="Microsoft Word 9">
12 : celek 1.2
13 : celek 1.1 <link rel="File-List" href="./user%20guide%20structure_files/filelist.xml">
14 : celek 1.2 <!--[if gte mso 9]><xml>
15 : celek 1.1 <o:DocumentProperties>
16 :     <o:Author>Labuser</o:Author>
17 :     <o:LastAuthor>Labuser</o:LastAuthor>
18 :     <o:Revision>3</o:Revision>
19 :     <o:TotalTime>23</o:TotalTime>
20 :     <o:Created>2002-04-12T13:24:00Z</o:Created>
21 :     <o:LastSaved>2002-04-13T17:21:00Z</o:LastSaved>
22 :     <o:Pages>12</o:Pages>
23 :     <o:Words>3593</o:Words>
24 :     <o:Characters>20485</o:Characters>
25 :     <o:Company>IBM Canada Ltd.</o:Company>
26 :     <o:Lines>170</o:Lines>
27 :     <o:Paragraphs>40</o:Paragraphs>
28 :     <o:CharactersWithSpaces>25157</o:CharactersWithSpaces>
29 :     <o:Version>9.2720</o:Version>
30 :     </o:DocumentProperties>
31 :     </xml><![endif]--><!--[if gte mso 9]><xml>
32 :     <w:WordDocument>
33 :     <w:View>Normal</w:View>
34 :     </w:WordDocument>
35 :     </xml><![endif]-->
36 : celek 1.2
37 : celek 1.1 <style>
38 :     <!--
39 :     /* Style Definitions */
40 :     p.MsoNormal, li.MsoNormal, div.MsoNormal
41 :     {mso-style-parent:"";
42 :     margin:0in;
43 :     margin-bottom:.0001pt;
44 :     mso-pagination:widow-orphan;
45 :     font-size:12.0pt;
46 :     font-family:"Times New Roman";
47 :     mso-fareast-font-family:"Times New Roman";
48 :     mso-bidi-font-family:"Times New Roman";}
49 :     a:link, span.MsoHyperlink
50 :     {color:blue;
51 :     text-decoration:underline;
52 :     text-underline:single;}
53 :     a:visited, span.MsoHyperlinkFollowed
54 :     {color:blue;
55 :     text-decoration:underline;
56 :     text-underline:single;}
57 :     @page Section1
58 :     {size:8.5in 11.0in;
59 :     margin:1.0in 1.25in 1.0in 1.25in;
60 :     mso-header-margin:.5in;
61 :     mso-footer-margin:.5in;
62 :     mso-paper-source:0;}
63 :     div.Section1
64 :     {page:Section1;}
65 :     -->
66 :     </style> <!--[if gte mso 9]><xml>
67 :     <o:shapedefaults v:ext="edit" spidmax="1026"/>
68 :     </xml><![endif]--><!--[if gte mso 9]><xml>
69 :     <o:shapelayout v:ext="edit">
70 :     <o:idmap v:ext="edit" data="1"/>
71 :     </o:shapelayout></xml><![endif]-->
72 :     </head>
73 :     <body lang="EN-US" link="blue" vlink="blue" style="tab-interval:.5in">
74 : celek 1.2
75 :     <div class="Section1">
76 : celek 1.1 <h1> </h1>
77 : celek 1.2
78 :     <div align="Center">
79 : celek 1.1 <h1>Install/Update User Guide</h1>
80 : celek 1.2 </div>
81 :    
82 : celek 1.1 <p class="MsoNormal"><!--[if !supportEmptyParas]--> <!--[endif]--><o:p></o:p></p>
83 : celek 1.2
84 : celek 1.1 <h2>Getting Started: Install/Update in three steps</h2>
85 : celek 1.2
86 : celek 1.1 <blockquote> This section will teach you how to install a new Feature and
87 : celek 1.2 how to revert to a previous state in three easy steps. Before you start,
88 :     make sure you installed the 'mockup' site following the <a href="http://www.eclipse.org">
89 :     install mockup site</a>
90 :     instructions.</blockquote>
91 :    
92 : celek 1.1 <h3>Find new Feature</h3>
93 : celek 1.2
94 : celek 1.1 <blockquote>This section will focus on finding a feature to install. There
95 : celek 1.2 are different ways of finding a feature. The one we are going to focus
96 :     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
98 :     at the <a href="http://www.eclipse.org">Find Features</a>
99 :     section.<br>
100 :     </blockquote>
101 :    
102 : celek 1.1 <blockquote>Before browsing a site, we will have to create a site bookmark
103 : celek 1.2 to access it.<br>
104 :     </blockquote>
105 :    
106 : celek 1.1 <p class="MsoNormal"></p>
107 : celek 1.2
108 : celek 1.1 <h4>Create a new site bookmark</h4>
109 : celek 1.2
110 : celek 1.1 <p class="MsoNormal"></p>
111 : celek 1.2
112 : celek 1.1 <ul>
113 : celek 1.2 <li>Open the Install/Update perspective (TODO: menu path + key)</li>
114 :     <li>Select the Updates View.</li>
115 :     <li>Open the context menu </li>
116 :     <li>Select new-&gt;site bookmark...</li>
117 :     <li>In the Site Name entry field type: Test Site</li>
118 :     <li>In the Site Address entry field type the URL where you installed
119 :     the mockup site. (i.e. file:c:/eclipse/site)</li>
120 :     <li>Click Ok </li>
121 :    
122 : celek 1.1 </ul>
123 : celek 1.2
124 : celek 1.1 <blockquote> The Site should appear on the view. The provider of a feature
125 :     should give you the URL of their site so you can  find their feature. We
126 :     will now browse the site to discover the features.<br>
127 : celek 1.2 </blockquote>
128 :    
129 : celek 1.1 <h4> Choose Feature</h4>
130 : celek 1.2
131 : celek 1.1 <blockquote>You can expand the site and the categories to see the
132 : celek 1.2 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>
134 :    
135 : celek 1.1 <ul>
136 : celek 1.2 <li>Select Red Dot Feature 1.0.0</li>
137 :    
138 : celek 1.1 </ul>
139 : celek 1.2 </blockquote>
140 :    
141 : celek 1.1 <blockquote>The Preview page should now look like the following
142 : celek 1.2 picture:<br>
143 :     </blockquote>
144 :    
145 : celek 1.1 <div align="Center">         <img src="images/PIC001.gif" alt="PIC001.gif Preview Page of Red Dot 1.0.0" width="678" height="518">
146 : celek 1.2 <br>
147 :     </div>
148 :    
149 : celek 1.1 <blockquote>You may want to check the license and copyright or
150 : celek 1.2 decide to have more information about the Feature you are about to install.
151 :     'Click' on the appropriate link at the bottom of the view to automatically
152 :     open a browser that will show you the desired page.<br>
153 :     </blockquote>
154 :    
155 : celek 1.1 <blockquote>&lt;TIP the preference page lets you decide if you
156 :     want to view the HTML page within the workbench or by launching an external
157 : celek 1.2 browser&gt;<br>
158 :     </blockquote>
159 :    
160 : celek 1.1 <h3> Install Feature</h3>
161 : celek 1.2
162 : celek 1.1 <blockquote>When you are ready to install the feature click
163 : celek 1.2 on the Install button in the Preview View. This will launch the Install Wizard.<br>
164 :     </blockquote>
165 :    
166 : celek 1.1 <h4>Install Wizard</h4>
167 : celek 1.2
168 : celek 1.1 <p class="MsoNormal"></p>
169 : celek 1.2
170 : celek 1.1 <ul>
171 : celek 1.2 <li>The first page of the Wizard summarizes the action
172 :     you are going to take. Click Next.</li>
173 :     <li>The second page shows the license you have to
174 :     accept to install the feature. Click next of you accept the presented license
175 :     otherwise click cancel.</li>
176 :     <li>The last page of the Wizard presents the list
177 :     of Site you can install your feature in. You can create a new site from
178 :     this page. For more information about creating new Site see:  <a href="http://www.eclipse.org">
179 :     Site Location Tab</a>
180 :     . You should see only one site and it should point to the path where
181 :     the workbench is installed. Click Finish.</li>
182 :    
183 : celek 1.1 </ul>
184 : celek 1.2
185 : celek 1.1 <blockquote> The feature will then be downloaded, verified
186 : celek 1.2 and installed in the site. You can see the progress monitor showing you
187 :     the evolution of theses tasks. During verification, you may be prompted to
188 :     accept the verification. Click 'Ok' when prompted.<br>
189 : celek 1.1 </blockquote>
190 : celek 1.2
191 :     <blockquote> When the feature has been installed you
192 :     will need to restart the workbench for the changes to take effect. Click 'Ok'
193 :     on the dialog box.<br>
194 :     </blockquote>
195 :    
196 : celek 1.1 <p class="MsoNormal"></p>
197 : celek 1.2
198 : celek 1.1 <h4>Verify the feature has been installed</h4>
199 : celek 1.2
200 : celek 1.1 <blockquote>The feature you installed will add a red
201 : celek 1.2 button icon to the tool bar when activated. To activate this specific feature
202 :     customize your perspective and add the Red Dot Set Action Set:<br>
203 :     </blockquote>
204 :    
205 :    
206 : celek 1.1 <p class="MsoNormal"></p>
207 : celek 1.2
208 :    
209 : celek 1.1 <ul>
210 : celek 1.2 <li>Open the menu Window</li>
211 :     <li>Select Customize Perspective</li>
212 :     <li>Expand Action Sets</li>
213 :     <li>Check Red Dot Set</li>
214 :     <li>Click Ok</li>
215 :    
216 :    
217 : celek 1.1 </ul>
218 : celek 1.2
219 :    
220 : celek 1.1 <blockquote>You should now se a red button icon on
221 : celek 1.2 the toolbar. If you click on it the following dialog box should appear,
222 :     meaning the feature and associated plug-ins have been successfully installed
223 :     and configured.<br>
224 :     </blockquote>
225 :    
226 :    
227 : celek 1.1 <blockquote> We will now see how to manage your
228 : celek 1.2 feature in your configuration.<br>
229 :     </blockquote>
230 :    
231 :    
232 : celek 1.1 <h3> Configure Environment</h3>
233 : celek 1.2
234 :    
235 : celek 1.1 <blockquote> A feature that is installed may
236 : celek 1.2 be configured or unconfigured for your workspace. A configured feature means
237 :     that Install/Update will 'suggests' that the runtime configures the feature
238 :     to be available. An unconfigured feature means that Install/Update will
239 :     make the feature unavailable to the user.<br>
240 :     </blockquote>
241 :    
242 :    
243 : celek 1.1 <blockquote>When you installed Red Dot Feature
244 : celek 1.2 1.0.0, Install/Update installed and configured the feature for you. You
245 :     can see that in the Configuration History. For more information about Configuration
246 :     History see <a href="http:/ww.eclipse.org"> Configuration History</a>
247 :     .<br>
248 :     </blockquote>
249 :    
250 :    
251 : celek 1.1 <blockquote>A configuration is a list of configured
252 :     and unconfigured features that determine what tool you can use.<br>
253 : celek 1.2 The current configuration is the configuration currently active.<br>
254 : celek 1.1 </blockquote>
255 : celek 1.2
256 :    
257 :     <blockquote>For more information about configuration,
258 :     see <a href="http://www.eclipse.org">Configuring/Unconfiguring</a>
259 :     .<br>
260 :     </blockquote>
261 :    
262 :    
263 : celek 1.1 <blockquote>In this section we will add
264 : celek 1.2 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
266 :     we will restore the preserved configuration, which will re-configure the
267 :     feature.<br>
268 :     </blockquote>
269 :    
270 :    
271 : celek 1.1 <h4>Add configuration to preserved</h4>
272 : celek 1.2
273 :    
274 : celek 1.1 <blockquote>To add the current configuration,
275 : celek 1.2 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
277 :     the configuration in the configuration history folder with an icon with
278 :     a running person. It is the last configuration in the list.<br>
279 :     </blockquote>
280 :    
281 :    
282 : celek 1.1 <p class="MsoNormal"></p>
283 : celek 1.2
284 :    
285 : celek 1.1 <ul>
286 : celek 1.2 <li>Select the current configuration.</li>
287 :     <li>Open the context menu.</li>
288 :     <li>Select Add to preserved.</li>
289 :     <li>The configuration now appears
290 :     under the Preserved Configurations folder.</li>
291 :    
292 :    
293 : celek 1.1 </ul>
294 : celek 1.2
295 :    
296 : celek 1.1 <h4>Rename configuration</h4>
297 : celek 1.2
298 :    
299 : celek 1.1 <blockquote>We will rename the configuration
300 : celek 1.2 to give it a meaningfull name.<br>
301 :     </blockquote>
302 :    
303 :    
304 : celek 1.1 <p class="MsoNormal"></p>
305 : celek 1.2
306 :    
307 : celek 1.1 <ul>
308 : celek 1.2 <li>Select the configuration.</li>
309 :     <li>Open the context menu
310 :     and click Properties.</li>
311 :     <li>Change the name of the
312 :     configuration to: RedDot 1</li>
313 :     <li>Click Ok.</li>
314 :    
315 :    
316 : celek 1.1 </ul>
317 : celek 1.2
318 :    
319 : celek 1.1 <h4>Unconfigure Feature</h4>
320 : celek 1.2
321 :    
322 : celek 1.1 <blockquote>We will now unconfigure
323 : celek 1.2 the feature.<br>
324 :     </blockquote>
325 :    
326 :    
327 : celek 1.1 <p class="MsoNormal"></p>
328 : celek 1.2
329 :    
330 : celek 1.1 <ul>
331 : celek 1.2 <li>Expand Current Configuration;</li>
332 : celek 1.1 <li>Expand the site</li>
333 :    
334 :     </ul>
335 :    
336 : celek 1.2 <blockquote>
337 :    
338 :     <div align="Left"><img src="images/PIC004.gif" alt="Expand Current Configuration to reveal the configured Feature." width="202" height="118">
339 :     <br>
340 :     </div>
341 :     </blockquote>
342 : celek 1.1
343 : celek 1.2 <ul>
344 :     <li>Select Red Dot Feature
345 :     1.0.0</li>
346 :     <li>In the preview view
347 :     click Unconfigure.</li>
348 :     <li>When the Dialog opens
349 :     click Ok.</li>
350 :    
351 :    
352 :     </ul>
353 :    
354 :    
355 : celek 1.1 <p class="MsoNormal"></p>
356 : celek 1.2
357 :    
358 :     <blockquote>The workspace will
359 :     shut-down and restart automatically.</blockquote>
360 :    
361 :    
362 :     <p class="MsoNormal"></p>
363 :    
364 :    
365 :     <h4> </h4>
366 :    
367 :    
368 :     <h3>Restore Configuration</h3>
369 :    
370 :    
371 :     <blockquote>We shall now restore
372 :     the configuration we added to preserve, so the feature will be configured
373 :     again.<br>
374 : celek 1.1 </blockquote>
375 : celek 1.2
376 :    
377 :    
378 :     <h4>Verify the Feature is
379 :     not available</h4>
380 :    
381 :    
382 :    
383 :     <blockquote>You should not
384 :     see the red button icon in the toolbar, meaning the feature was not activated<br>
385 : celek 1.1 </blockquote>
386 : celek 1.2
387 :    
388 :    
389 :     <p class="MsoNormal"></p>
390 :    
391 :    
392 :    
393 : celek 1.1 <ul>
394 : celek 1.2 <li>In the Configuration
395 :     View, expand Current Configuration.</li>
396 :     <li>Expand the site.</li>
397 :     <li>Verify Red Dot
398 :     Feature 1.0.0 does NOT appear as an icon.</li>
399 :     <li>Click on the view
400 :     toolbar button 'show unconfigured features'</li>
401 :     <li>Verify Red Dot
402 :     Feature 1.0.0 does appear</li>
403 :    
404 :    
405 :    
406 : celek 1.1 </ul>
407 :    
408 : celek 1.2 <blockquote><img src="images/pic005.gif" alt="Unconfigured feature revealed" width="257" height="117">
409 :    
410 :     </blockquote>
411 : celek 1.1
412 : celek 1.2 <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
414 :     your workspace. To be able to use the feature we will need to configure
415 :     the feature.<br>
416 :     </blockquote>
417 :    
418 :    
419 :    
420 :     <h4>Revert to preserved
421 :     configuration</h4>
422 :    
423 :    
424 :    
425 :     <p class="MsoNormal">
426 :                 We will now go back to the configuration we had previously
427 :     in which Red Dot Feature 1.0.0 was configured.</p>
428 :    
429 :    
430 :    
431 :     <ul>
432 :     <li>Expand Preserved
433 :     Configurations</li>
434 :     <li>Select RedDot
435 :     1</li>
436 :     <li>In the preview
437 :     view click Restore</li>
438 :     <li>When the Dialog
439 :     opens click Ok.</li>
440 :    
441 :    
442 :    
443 :     </ul>
444 :    
445 :    
446 :    
447 :     <blockquote>The workspace
448 :     will shut-down and restart automatically. After the workspace restart, the
449 :     feature is configured, based on the revert configuration.</blockquote>
450 :    
451 :    
452 :    
453 :     <blockquote>There
454 :     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>
457 :     .<br>
458 :     </blockquote>
459 :    
460 :    
461 :    
462 :     <p class="MsoNormal">
463 :     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
465 :     a preserved configuration. The rest of the book will go into more details.<br>
466 :     </p>
467 :    
468 :    
469 :    
470 :     <h2> The User
471 :     Interface</h2>
472 :    
473 :    
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
481 :     is used to browse HTML document from either sites or features.</blockquote>
482 :    
483 :    
484 :    
485 :     <h3>The Configuration
486 :     View</h3>
487 :    
488 :    
489 :    
490 :     <blockquote>
491 :     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 : celek 1.1 </blockquote>
497 : celek 1.2
498 :    
499 :    
500 :     <h4> Current
501 :     Configuration</h4>
502 :    
503 :    
504 :    
505 :     <blockquote>
506 :     The current configuration is the configuration currently active. When
507 :     you expand the Current Configuration you can see the sites you are connected
508 :     to. Expanding each site reveals the list of Features you have access to.
509 :     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>
513 :     .<br>
514 : celek 1.1 </blockquote>
515 : celek 1.2
516 :    
517 :    
518 :     <h4> Configuration
519 :     History</h4>
520 :    
521 :    
522 :    
523 :     <blockquote>
524 :     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
526 :     page. See: <a href="http://www.eclipse.org">Install/Update Preference Page</a>
527 :     .<br>
528 : celek 1.1 </blockquote>
529 : celek 1.2
530 :    
531 :    
532 :     <blockquote>
533 :     You can use the history list to see what are the different activities
534 :     that occurred as well as restoring an old configuration to make it the current
535 :     one.<br>
536 :     </blockquote>
537 :    
538 :    
539 :    
540 :     <blockquote>
541 :      Install/Update creates a new configuration history when one or more
542 :     activities are performed (i.e. install, configure, unconfigure etc...).
543 :     When the Install/Update  creates a new configuration, it will add it to
544 :     the list. If you already have n configurations, the framework will automatically
545 :     delete  the oldest configuration from the list. To know when the Install/Update
546 :     creates new configuration history and what are the Activities see:  <a href="http://www.eclipse.org">
547 :     Configuration History</a>
548 :     .<br>
549 :     </blockquote>
550 :    
551 :    
552 :    
553 :     <h4>
554 :     Preserved Configuration</h4>
555 :    
556 :    
557 : celek 1.1
558 : celek 1.2 <blockquote>
559 :     The Preserved Configurations folder contains history configurations you
560 :     want to keep. The framework does not automatically delete the configurations
561 :     in the Preserved Configurations folder, you have to explicitly delete them.<br>
562 :    
563 :     </blockquote>
564 :    
565 :    
566 :    
567 :     <h4>
568 :     Configured/Unconfigured</h4>
569 :    
570 :    
571 :    
572 :     <blockquote>
573 :    
574 :    
575 :    
576 :    
577 :     <p class="MsoNormal">
578 :     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
580 :     view tool bar. To know more about configured/unconfigured features see:
581 :    
582 :     <a href="http://www.eclipse.org"> Configured/Unconfigued</a>
583 :     . </p>
584 :    
585 :    
586 :    
587 :     </blockquote>
588 :    
589 :    
590 :    
591 :    
592 :     <h4>
593 :     Local View Toolbar Actions</h4>
594 :    
595 :    
596 :    
597 :    
598 :     <h5>
599 :     Show Unconfigured Feature</h5>
600 :    
601 :    
602 :    
603 :    
604 :     <blockquote>
605 :    
606 :    
607 :    
608 :    
609 :     <p class="MsoNormal">
610 :     This button allows you to see only the configured features or both configured
611 :     and unconfigured features. Unconfigured features appear with a red circle
612 :     around the icon. For more information about configuring/unconfiguring features
613 :     see: <a href="http://www.eclipse.org">Configuring/Unconfiguring</a>
614 : celek 1.1 .<br>
615 : celek 1.2
616 :     </p>
617 :    
618 :     </blockquote>
619 :    
620 :    
621 :    
622 :    
623 :     <h4>
624 :     Context Actions</h4>
625 :    
626 :    
627 :    
628 :    
629 :     <blockquote>
630 :     This section describes the different context actions available in the
631 :     Configuration View.<br>
632 :    
633 :     </blockquote>
634 :    
635 :    
636 :    
637 :    
638 :     <h5>
639 :     Go Home</h5>
640 :    
641 :    
642 :    
643 :    
644 :     <blockquote>
645 :     This action &lt;TODO be consistent with navigator&gt;<br>
646 :    
647 :     </blockquote>
648 :    
649 :    
650 :    
651 :    
652 :     <h5>
653 :     Go Back</h5>
654 :    
655 :    
656 :    
657 :    
658 :     <blockquote>
659 :     This action &lt;TODO be consistent with navigator&gt;<br>
660 :    
661 :     </blockquote>
662 :    
663 :    
664 :    
665 :    
666 :     <h5>
667 :     Go Into</h5>
668 :    
669 :    
670 :    
671 :    
672 :     <blockquote>
673 :     This action &lt;TODO be consistent with navigator&gt;<br>
674 :    
675 :     </blockquote>
676 :    
677 :    
678 :    
679 :    
680 :     <h5>
681 :     Show Details</h5>
682 :    
683 :    
684 :    
685 :    
686 :     <blockquote>
687 :     This action opens or refreshes the Preview View with the details of the
688 :     selected element.<br>
689 :    
690 :     </blockquote>
691 :    
692 :    
693 :    
694 :    
695 :     <h5>
696 :     Properties</h5>
697 :    
698 :    
699 :    
700 :    
701 :     <blockquote>
702 :     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
704 :     finished and you want to preserve your changes or click Cancel if you do
705 :     not want to change the properties.<br>
706 :    
707 :     </blockquote>
708 :    
709 :    
710 :    
711 :    
712 :     <h5>
713 :     Add to Preserved</h5>
714 :    
715 :    
716 :    
717 :    
718 :     <blockquote>
719 :      This action adds the selected configuration in the Configuration History
720 :     folder to the list of preserved configuration.<br>
721 :    
722 :     </blockquote>
723 :    
724 :    
725 :    
726 :    
727 :     <h5>
728 :     Remove from Preserved</h5>
729 :    
730 :    
731 :    
732 :    
733 :     <blockquote>
734 :     This action removes the selected configuration from the list of preserved
735 :     configurations. This action will not delete any Site, Site Bookmark or Feature.
736 :     This action will not delete the configuration it was created from or any
737 :     other configuration.<br>
738 :    
739 :     </blockquote>
740 :    
741 :    
742 :    
743 :    
744 :     <h5>
745 :     Restore</h5>
746 :    
747 :    
748 :    
749 :    
750 :     <blockquote>
751 :      This action creates a new configuration based on the selected configuration
752 :     and marks it as current. Install/Update will automatically configure all
753 :     the features that were configured in the selected configuration you want to
754 :     restore. To know more about restoring or reverting to a configuration see:
755 :    
756 :     <a href="http://www.eclipse.org"> Restore a Configuration/Revert
757 :     to previous configuration</a>
758 :     .<br>
759 :    
760 :     </blockquote>
761 :    
762 :    
763 :    
764 :    
765 :     <h3>
766 :     The Updates View</h3>
767 :    
768 :    
769 :    
770 :    
771 :     <blockquote>
772 :     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>
774 :    
775 :     <img src="images/PIC007.gif" alt="Updates View" width="251" height="249">
776 :    
777 :     <br>
778 :    
779 :     </blockquote>
780 :    
781 :    
782 :    
783 :    
784 :     <h4>
785 :     My Computer</h4>
786 :    
787 :    
788 :    
789 :    
790 :     <blockquote>
791 :     My Computer lets you browse your computer and any mounted local file
792 :     to discover any site on your file system. You can also search My Computer
793 :     to discover sites: see <a href="http://www.eclipse.org">Search the file
794 :     system</a>
795 :     .<br>
796 :    
797 :     </blockquote>
798 :    
799 :    
800 :    
801 :    
802 :    
803 :     <h4>
804 :     Places to Visit</h4>
805 :    
806 :    
807 :    
808 :    
809 :    
810 :     <blockquote>
811 :     Places to visit are sites suggested by the features you installed for
812 :     you to visit. <br>
813 :    
814 :     </blockquote>
815 :    
816 :    
817 :    
818 :    
819 :    
820 :     <p class="MsoNormal">
821 :     </p>
822 :    
823 :    
824 :    
825 :    
826 :    
827 :     <h4>
828 :     Available Updates</h4>
829 :    
830 :    
831 :    
832 :    
833 :    
834 :     <blockquote>
835 :     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
837 :     while searching for updates. To know more about searching: see <a href="http://www.eclipse.org">
838 :     Search</a>
839 :     . <br>
840 :    
841 :     </blockquote>
842 :    
843 :    
844 :    
845 :    
846 :    
847 :     <h4>
848 :     Sites Bookmark</h4>
849 :    
850 :    
851 :    
852 :    
853 :    
854 :     <blockquote>
855 :    
856 :    
857 :    
858 :    
859 :    
860 :     <p class="MsoNormal">
861 :     A site is a location that contains features. In the Updates View, the
862 :     sites contain features you can install. You can browse or search features
863 :     in Site bookmarks. There are two ways of adding a site bookmark. You can
864 :     use the context menu and the context action add site bookmarks, or you may
865 :     browse My Computer and add a site as a site bookmark. See <a href="http://www.eclipse.org">
866 :     Context Action</a>
867 :     for more details. <br>
868 :    
869 :     </p>
870 :    
871 :     </blockquote>
872 :    
873 :    
874 :    
875 :    
876 :    
877 :     <h4>
878 :     Search</h4>
879 :    
880 :    
881 :    
882 :    
883 :    
884 :     <blockquote>
885 :    
886 :    
887 :    
888 :    
889 :    
890 :     <p class="MsoNormal">
891 :     &lt;TODO&gt;<br>
892 :    
893 :     </p>
894 :    
895 :     </blockquote>
896 :    
897 :    
898 :    
899 :    
900 :    
901 :     <h4>
902 :     Folder</h4>
903 :    
904 :    
905 :    
906 :    
907 :    
908 :     <blockquote>
909 :    
910 :    
911 :    
912 :    
913 :    
914 :     <p class="MsoNormal">
915 :     &lt;TODO what can I store in a folder ?&gt;</p>
916 :    
917 :     </blockquote>
918 :    
919 :    
920 :    
921 :    
922 :    
923 :     <h4>
924 :     Local View Toolbar Actions</h4>
925 :    
926 :    
927 :    
928 :    
929 :    
930 :     <blockquote>
931 :     This section describes the local view toolbar actions of the Updates View.<br>
932 :    
933 :     </blockquote>
934 :    
935 :    
936 :    
937 :    
938 :    
939 :     <h5>
940 :     Show Feature Categories </h5>
941 :    
942 :    
943 :    
944 :    
945 :    
946 :     <blockquote>
947 :     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>
960 :    
961 :    
962 :    
963 :    
964 :    
965 :     <h5>
966 :     Show My Computer Files </h5>
967 :    
968 :    
969 :    
970 :    
971 :    
972 :     <blockquote>
973 :     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>
981 :    
982 :    
983 :    
984 :    
985 :    
986 :     <h4>
987 :     Context Actions</h4>
988 :    
989 :    
990 :    
991 :    
992 :    
993 :     <blockquote>
994 :     This section describes the different context actions available in the
995 :     Updates View.
996 :     </blockquote>
997 :    
998 :    
999 :    
1000 :    
1001 :    
1002 :     <h5>
1003 :     New-&gt;Site Bookmark...</h5>
1004 :    
1005 :    
1006 :    
1007 :    
1008 :    
1009 :     <blockquote>
1010 :    
1011 :    
1012 :    
1013 :    
1014 :    
1015 :     <p class="MsoNormal">
1016 :     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
1018 :     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
1020 :     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
1022 :     or click Cancel if you do not want to create a new Site Bookmark.<br>
1023 :    
1024 :     </p>
1025 :    
1026 :     </blockquote>
1027 :    
1028 :    
1029 :    
1030 :    
1031 :    
1032 :     <h5>
1033 :     New-&gt;Folder</h5>
1034 :    
1035 :    
1036 :    
1037 :    
1038 :    
1039 :     <blockquote>
1040 :     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>
1064 :    
1065 :    
1066 :    
1067 :    
1068 : celek 1.1
1069 : celek 1.2 <h5>
1070 :     New-&gt;Search</h5>
1071 :    
1072 :    
1073 :    
1074 :    
1075 : celek 1.1
1076 : celek 1.2 <blockquote>
1077 :     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
1079 :     search doc ?&gt;<br>
1080 :    
1081 :     </blockquote>
1082 :    
1083 :    
1084 :    
1085 :    
1086 :    
1087 :    
1088 :     <h5>
1089 :     Show Details</h5>
1090 :    
1091 :    
1092 :    
1093 :    
1094 :    
1095 :    
1096 :     <blockquote>
1097 :    
1098 :    
1099 :    
1100 :    
1101 :    
1102 :    
1103 :     <p class="MsoNormal">
1104 :     This action opens or refreshes the Preview View with the details of the
1105 :     selected element.<br>
1106 :     </p>
1107 :    
1108 :     </blockquote>
1109 :    
1110 :    
1111 :    
1112 :    
1113 :    
1114 :    
1115 :     <h5>
1116 :     Refresh</h5>
1117 :    
1118 :    
1119 :    
1120 :    
1121 :    
1122 :    
1123 :     <blockquote>
1124 :     This action re-initializes the content of an element &lt;TODO see dejan&gt;<br>
1125 :    
1126 :     </blockquote>
1127 :    
1128 :    
1129 :    
1130 :    
1131 :    
1132 :    
1133 :     <h5>
1134 :     Bookmark Location</h5>
1135 :    
1136 :    
1137 :    
1138 :    
1139 :    
1140 :    
1141 :     <blockquote>
1142 :     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
1144 :     selected site. The properties of a Site are the label you want to see in
1145 :     the View as well as the Address of the site. You are able to change the Site
1146 :     Name. Click Ok when you have finished and you want to preserve your changes
1147 :     or click Cancel if you do not want to change the properties.<br>
1148 :    
1149 :     </blockquote>
1150 :    
1151 :    
1152 :    
1153 :    
1154 :    
1155 :    
1156 :     <h5>
1157 :     Properties</h5>
1158 :    
1159 :    
1160 :    
1161 :    
1162 :    
1163 :    
1164 :     <blockquote>
1165 :     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
1167 :     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 Address of the site.
1169 :     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
1171 :     and you want to preserve your changes or click Cancel if you do not want
1172 :     to change the properties.<br>
1173 :    
1174 :     </blockquote>
1175 :    
1176 :    
1177 :    
1178 :    
1179 :    
1180 :    
1181 :     <h5>
1182 :     Delete</h5>
1183 :    
1184 :    
1185 :    
1186 :    
1187 :    
1188 :    
1189 :     <blockquote>
1190 :     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>
1192 :    
1193 :     </blockquote>
1194 :    
1195 :    
1196 :    
1197 :    
1198 :    
1199 :    
1200 :     <h3>
1201 :     The WebView</h3>
1202 :    
1203 :    
1204 :    
1205 :    
1206 :    
1207 :    
1208 :     <blockquote>
1209 :     The Web View is &lt;TODO &gt;<br>
1210 :    
1211 :     </blockquote>
1212 :    
1213 :    
1214 :    
1215 :    
1216 :    
1217 :    
1218 :     <h3>
1219 :     The flat concept (see Dejan)</h3>
1220 :    
1221 :    
1222 :    
1223 :    
1224 :    
1225 :    
1226 :     <blockquote>
1227 :     &lt;TODO&gt;<br>
1228 :    
1229 :     </blockquote>
1230 :    
1231 :    
1232 :    
1233 :    
1234 :    
1235 :    
1236 :     <h3>
1237 :     The Preview View</h3>
1238 :    
1239 :    
1240 :    
1241 :    
1242 :    
1243 :    
1244 :     <blockquote>
1245 :     The preview shows information about the selected element. The preview
1246 :     view is different for each selected element.<br>
1247 :    
1248 :     </blockquote>
1249 :    
1250 :    
1251 :    
1252 :    
1253 :    
1254 :    
1255 :     <h4>
1256 :     </h4>
1257 :    
1258 :    
1259 :    
1260 :    
1261 :    
1262 :    
1263 :     <blockquote>
1264 :     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
1266 :     or Configuration View and selecting Show Details or by open the Preview
1267 :     View from the Workbench menu. Select Window-&gt;Show View-&gt;Other to open
1268 :     the list of available Views. Expand Update Manager Folder, select Preview
1269 :     and Click Ok.<br>
1270 :    
1271 :     </blockquote>
1272 :    
1273 :    
1274 :    
1275 :    
1276 :    
1277 :    
1278 :     <h4>
1279 :     The 'Home' Preview view.</h4>
1280 :    
1281 :    
1282 :    
1283 :    
1284 :    
1285 :    
1286 :     <blockquote>
1287 :     You can open the 'Home' Preview by clicking on the home in the local
1288 :     tool bar menu if the View. This view summarizes the different tasks you
1289 :     can achieve through the Install/Update. By using the flat concept you are
1290 :     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>
1300 :    
1301 :    
1302 :    
1303 :    
1304 :    
1305 :    
1306 :     <h4>
1307 :     The current configuration Preview view</h4>
1308 :    
1309 :    
1310 :    
1311 :    
1312 :    
1313 :    
1314 :     <blockquote>
1315 :     This Preview shows information about the product you are using. The content
1316 :     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>
1329 :    
1330 :    
1331 :    
1332 :    
1333 :    
1334 :    
1335 :     <h4>
1336 :     The Site and Site Bookmark Preview View</h4>
1337 :    
1338 :    
1339 :    
1340 :    
1341 :    
1342 :    
1343 :     <blockquote>
1344 :     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>
1361 :    
1362 :    
1363 :    
1364 :    
1365 :    
1366 :    
1367 :    
1368 :     <h4>
1369 :     The Feature Preview View</h4>
1370 :    
1371 :    
1372 :    
1373 :    
1374 :    
1375 :    
1376 :    
1377 :     <blockquote>
1378 :     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>
1392 :    
1393 :    
1394 :    
1395 :    
1396 :    
1397 :    
1398 :    
1399 :     <h5>
1400 :     Provider</h5>
1401 :    
1402 :    
1403 :    
1404 :    
1405 :    
1406 :    
1407 :    
1408 :     <blockquote>
1409 :     The name of the provider of the feature.<br>
1410 :    
1411 :    
1412 :     </blockquote>
1413 :    
1414 :    
1415 :    
1416 :    
1417 :    
1418 :    
1419 :    
1420 :     <h5>
1421 :     Version</h5>
1422 :    
1423 :    
1424 :    
1425 :    
1426 :    
1427 :    
1428 :    
1429 :     <blockquote>
1430 :     The version of the feature.<br>
1431 :    
1432 :    
1433 :     </blockquote>
1434 :    
1435 :    
1436 :    
1437 :    
1438 :    
1439 :    
1440 :    
1441 :     <h5>
1442 :     Installed Version</h5>
1443 :    
1444 :    
1445 :    
1446 :    
1447 :    
1448 :    
1449 :    
1450 :     <blockquote>
1451 :     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>
1453 :    
1454 :    
1455 :     </blockquote>
1456 :    
1457 :    
1458 :    
1459 :    
1460 :    
1461 :    
1462 :    
1463 :     <h5>
1464 :     Download Size</h5>
1465 :    
1466 :    
1467 :    
1468 :    
1469 :    
1470 :    
1471 :    
1472 :     <blockquote>
1473 :     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
1475 :     files will not be installed twice, and thus the downloaded and installed
1476 :     size will be smaller than the maximum one.<br>
1477 :    
1478 :    
1479 :     </blockquote>
1480 :    
1481 :    
1482 :    
1483 :    
1484 :    
1485 :    
1486 :    
1487 :     <h5>
1488 :     Supported Platforms</h5>
1489 :    
1490 :    
1491 :    
1492 :    
1493 :    
1494 :    
1495 :    
1496 :     <blockquote>
1497 :     This expandable category shows the different supported platforms for
1498 :     this feature. The categories are Operating Systems, Windowing Systems,
1499 :     Architectures and Languages.<br>
1500 :    
1501 :    
1502 :     </blockquote>
1503 :    
1504 :    
1505 :    
1506 :    
1507 :    
1508 :    
1509 :    
1510 :     <ul>
1511 :    
1512 :    
1513 :     <li> Operating Systems: the list of supported Operating
1514 :     Systems.</li>
1515 :    
1516 :    
1517 :     <li> Windowing Systems: the list of supported Windowing
1518 :     Systems.</li>
1519 :    
1520 :    
1521 :     <li> Supported Architectures: the list of supported processor
1522 :     architecture.</li>
1523 :    
1524 :    
1525 :     <li> Supported Languages: the list of supported languages.<br>
1526 :     </li>
1527 :    
1528 :    
1529 :    
1530 :    
1531 :    
1532 :    
1533 :    
1534 :     </ul>
1535 :    
1536 :    
1537 :    
1538 :    
1539 :    
1540 :    
1541 :    
1542 :     <h5>
1543 :     Description </h5>
1544 :    
1545 :    
1546 :    
1547 :    
1548 :    
1549 :    
1550 :    
1551 :     <p class="MsoNormal">
1552 :     The description of the Feature<br>
1553 :     <br>
1554 :    
1555 :    
1556 :     </p>
1557 :    
1558 :    
1559 :    
1560 :    
1561 :    
1562 :    
1563 :    
1564 :     <h5>
1565 :     More Info &lt;TODO should we say it is optional ?&gt;</h5>
1566 :    
1567 :    
1568 :    
1569 :    
1570 :    
1571 :    
1572 :    
1573 :     <blockquote>
1574 :     Opens a page with more information about the feature. The page may be
1575 :     found locally or remotely.<br>
1576 :    
1577 :    
1578 :     </blockquote>
1579 :    
1580 :    
1581 :    
1582 :    
1583 :    
1584 :    
1585 :    
1586 :     <h5>
1587 :     License</h5>
1588 :    
1589 :    
1590 :    
1591 :    
1592 :    
1593 :    
1594 :    
1595 :     <blockquote>
1596 :     Opens a page with the license of the Feature.<br>
1597 :    
1598 :    
1599 :     </blockquote>
1600 :    
1601 :    
1602 :    
1603 :    
1604 :    
1605 :    
1606 :    
1607 :     <h5>
1608 :     Copyright</h5>
1609 :    
1610 :    
1611 :    
1612 :    
1613 :    
1614 :    
1615 :    
1616 :     <blockquote>
1617 :    
1618 :    
1619 :    
1620 :    
1621 :    
1622 :    
1623 :    
1624 :     <p class="MsoNormal">
1625 :     Opens a page with the copyright of the Feature.<br>
1626 :    
1627 :    
1628 :     </p>
1629 :    
1630 :    
1631 :     </blockquote>
1632 :    
1633 :    
1634 :    
1635 :    
1636 :    
1637 :    
1638 :    
1639 :     <h5>
1640 :     Actions</h5>
1641 :    
1642 :    
1643 :    
1644 :    
1645 :    
1646 :    
1647 :    
1648 :     <blockquote>
1649 :    
1650 :    
1651 :    
1652 :    
1653 :    
1654 :    
1655 :    
1656 :     <p class="MsoNormal">
1657 :     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
1659 :     depending of its configuration. If a change is pending for this feature,
1660 :     no actions will be available until the workbench is restarted.<br>
1661 :    
1662 :    
1663 :     </p>
1664 :    
1665 :    
1666 :     </blockquote>
1667 :    
1668 :    
1669 :    
1670 :    
1671 :    
1672 :    
1673 :    
1674 :     <ul>
1675 :    
1676 :    
1677 :     <li> <span style="mso-spacerun: yes"></span>Install:
1678 :     this launches the Install Wizard for this feature. See <a href="http://www.eclipse.org">
1679 :     Installing a Feature</a>
1680 :     .<br>
1681 :    
1682 :    
1683 :     </li>
1684 :    
1685 :    
1686 :     <li> Unconfigure: this launches the Unconfigure
1687 :     Wizard for this configured feature. See <a href="http://www.eclipse.org">
1688 :     Configuring/Unconfiguring a Feature</a>
1689 :     .<br>
1690 :     Configure: this launches the Configure Wizard for this unconfigured
1691 :     feature. See <a href="http://www.eclipse.org">Configuring/Unconfiguring
1692 :     a Feature</a>
1693 :     .<br>
1694 :     Uninstall: this removes the unconfigure feature from the file system.
1695 :     See <a href="http://www.eclipse.org">Removing a Feature</a>
1696 :     .</li>
1697 :    
1698 :    
1699 :    
1700 :    
1701 :    
1702 :    
1703 :    
1704 :     </ul>
1705 :    
1706 :    
1707 :    
1708 :    
1709 :    
1710 :    
1711 :    
1712 :     <h4>
1713 :     The Configuration Preview View</h4>
1714 :    
1715 :    
1716 :    
1717 :    
1718 :    
1719 :    
1720 :    
1721 :     <blockquote>
1722 :    
1723 :    
1724 :    
1725 :    
1726 :    
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>
1760 :     <p class="MsoNormal"></p>
1761 :     <h5>
1762 :     Configuration Reversal</h5>
1763 :    
1764 :    
1765 :    
1766 :    
1767 :    
1768 :    
1769 :    
1770 :     <blockquote>
1771 :     In the lower left side of the Preview View for a configuration you may
1772 :     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
1774 :     is pending for a feature, no actions will be available until the workbench
1775 :     is restarted.</blockquote>
1776 :    
1777 :    
1778 :    
1779 :    
1780 :    
1781 :    
1782 :    
1783 :    
1784 :     <ul>
1785 :    
1786 :    
1787 :     <li> Restore: this restores the selected configuration.
1788 :     See <a href="http://www.eclipse.org"> Restore a Configuration/Revert to
1789 :     previous configuration</a>
1790 :     .<br>
1791 :    
1792 :    
1793 :     </li>
1794 :    
1795 :    
1796 :     <li> Revert: this revert the current configuration
1797 :     to the previous configuration. See <a href="http://www.eclipse.org">Restore
1798 :     a Configuration/Revert to previous configuration</a>
1799 :     .</li>
1800 :    
1801 :    
1802 :    
1803 :    
1804 :    
1805 :    
1806 :    
1807 :    
1808 :     </ul>
1809 :    
1810 :    
1811 :    
1812 :    
1813 :    
1814 :    
1815 :    
1816 :    
1817 :     <p class="MsoNormal"></p>
1818 :    
1819 :    
1820 :    
1821 :    
1822 :    
1823 :    
1824 :    
1825 :    
1826 :     <h4>
1827 :     The search Preview View</h4>
1828 :    
1829 :    
1830 :    
1831 :    
1832 :    
1833 :    
1834 :    
1835 :    
1836 :     <blockquote>
1837 :     &lt;TODO depending on the search&gt;<br>
1838 :    
1839 :    
1840 :     </blockquote>
1841 :    
1842 :    
1843 :    
1844 :    
1845 :    
1846 :    
1847 :    
1848 :    
1849 :     <h3>
1850 :     The Install/Update Preference Page</h3>
1851 :    
1852 :    
1853 :    
1854 :    
1855 :    
1856 :    
1857 :    
1858 :    
1859 :     <blockquote>
1860 :     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
1862 :     preference Page. In this page, you can modify the number of history configuration
1863 :     you want the workbench to manage as well as decide which browser to open
1864 :     .<br>
1865 :    
1866 :    
1867 :     </blockquote>
1868 :    
1869 :    
1870 :    
1871 :    
1872 :    
1873 :    
1874 :    
1875 :    
1876 :     <p class="MsoNormal"></p>
1877 :    
1878 :    
1879 :    
1880 :    
1881 :    
1882 :    
1883 :    
1884 :    
1885 :     <h4>
1886 :     Maximum number of 'History' configurations entry field.<br>
1887 :    
1888 :    
1889 :     </h4>
1890 :    
1891 :    
1892 :    
1893 :    
1894 :    
1895 :    
1896 :    
1897 :    
1898 :     <blockquote>
1899 :     Enter the number of history configurations you want the Install/Update
1900 :     to keep. See <a href="http://www.eclipse.org">Configuration History</a>
1901 :     for more information.<br>
1902 :    
1903 :    
1904 :     </blockquote>
1905 :    
1906 :    
1907 :    
1908 :    
1909 :    
1910 :    
1911 :    
1912 :    
1913 :     <h4>
1914 :     Web Links radio buttons.</h4>
1915 :    
1916 :    
1917 :    
1918 :    
1919 :    
1920 :    
1921 :    
1922 :    
1923 :     <blockquote>
1924 :     When opening Web links. Allows you to choose between opening the internal
1925 :     WebView or opening an external browser.<br>
1926 :    
1927 :    
1928 :     </blockquote>
1929 :    
1930 :    
1931 :    
1932 :    
1933 :    
1934 :    
1935 :    
1936 :    
1937 :     <h2>
1938 :     Finding features</h2>
1939 :    
1940 :    
1941 :    
1942 :    
1943 :    
1944 :    
1945 :    
1946 :    
1947 :     <blockquote>
1948 :     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
1950 :     you need and where it is located, or you may want to search for an update
1951 :     of an already installed feature is available, finally you may just decide
1952 :     to browse or search to discover new sites and new features. <br>
1953 :    
1954 :    
1955 :     </blockquote>
1956 :    
1957 :    
1958 :    
1959 :    
1960 :    
1961 :    
1962 :    
1963 :    
1964 :     <h3>
1965 :     Find a specific feature </h3>
1966 :    
1967 :    
1968 :    
1969 :    
1970 :    
1971 :    
1972 :    
1973 :    
1974 :     <blockquote>
1975 :    
1976 :    
1977 :    
1978 :    
1979 :    
1980 :    
1981 :    
1982 :    
1983 :     <p class="MsoNormal">
1984 :     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
1986 :     this feature and browse the site to find the feature or you can open the
1987 :     WebView and browe to the Feature WebPage.</p>
1988 :    
1989 :    
1990 :     </blockquote>
1991 :    
1992 :    
1993 :    
1994 :    
1995 :    
1996 :    
1997 :    
1998 :    
1999 :     <h4>
2000 :     Add a new Update Site </h4>
2001 :    
2002 :    
2003 :    
2004 :    
2005 :    
2006 :    
2007 :    
2008 :    
2009 :     <blockquote>
2010 :    
2011 :    
2012 :    
2013 :    
2014 :    
2015 :    
2016 :    
2017 :    
2018 :     <p class="MsoNormal">
2019 :     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
2021 :     the properties of the Bookmark Site you want to create. The properties of
2022 :     a Bookmark Site are the label you want to see in the View as well as the
2023 :     URL of the physical site. You have to enter the Site URL. Optionally you
2024 :     can enter the Site Name. If you do not enter a Site Name, it will default
2025 :     to the Site URL. Click Ok when you have finished and you want to preserve
2026 :     your changes or click Cancel if you do not want to create a new Site Bookmark.
2027 :      </p>
2028 :    
2029 :    
2030 :     </blockquote>
2031 :    
2032 :    
2033 :    
2034 :    
2035 :    
2036 :    
2037 :    
2038 :    
2039 :     <h4>
2040 :     Find the feature   </h4>
2041 :    
2042 :    
2043 :    
2044 :    
2045 :    
2046 :    
2047 :    
2048 :    
2049 :     <blockquote>
2050 :    
2051 :    
2052 :    
2053 :    
2054 :    
2055 :    
2056 :    
2057 :    
2058 :     <p class="MsoNormal">
2059 :     Expand the site to find the feature you want. You can find the feature
2060 :     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">
2062 :     Preview View</a>
2063 :     .</p>
2064 :    
2065 :    
2066 :     </blockquote>
2067 :    
2068 :    
2069 :    
2070 :    
2071 :    
2072 :    
2073 :    
2074 :    
2075 :     <h4>
2076 :     Browse WebPages </h4>
2077 :    
2078 :    
2079 :    
2080 :    
2081 :    
2082 :    
2083 :    
2084 :    
2085 :     <blockquote>
2086 :     Open the <a href="http://www.eclipse.org">WebView</a>
2087 :     and enter the URL for the feature web page. Follow the indication of
2088 :     the webpage. &lt;TODO web install&gt;<br>
2089 :    
2090 :    
2091 :     </blockquote>
2092 :    
2093 :    
2094 :    
2095 :    
2096 :    
2097 :    
2098 :    
2099 :    
2100 :     <h3>
2101 :     Update already existing features</h3>
2102 :    
2103 :    
2104 :    
2105 :    
2106 :    
2107 :    
2108 :    
2109 :    
2110 :     <blockquote>
2111 :    
2112 :    
2113 :    
2114 :    
2115 :    
2116 :    
2117 :    
2118 :    
2119 :     <p class="MsoNormal">
2120 :     This section will focus on updating features that are configured in your
2121 :     current configuration.To know how to configure/unconfigure a fetaure; see:
2122 :    
2123 :    
2124 :     <a href="http://www.eclipse.org">
2125 :     Configuring/Unconfiguring</a>
2126 :     .&lt;TODO only configured features ?&gt;  </p>
2127 :    
2128 :    
2129 :     </blockquote>
2130 :    
2131 :    
2132 :    
2133 :    
2134 :    
2135 :    
2136 :    
2137 :    
2138 :     <h4>
2139 :     Search for updates</h4>
2140 :    
2141 :    
2142 :    
2143 :    
2144 :    
2145 :    
2146 :    
2147 :    
2148 :     <blockquote>
2149 :      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
2151 :     configured feature come from for new version the installed and configured
2152 :     feature. During the search you will see the progress monitor move, indicating
2153 :     the search is in progress. When new version of configured features are found,
2154 :     they will appear under the progress monitor.  You can decide to see the result
2155 :     in a short form or an extended form by checking the 'Show results in extended
2156 :     form' box, under the Scope Settings section in the preview view.<br>
2157 :    
2158 :    
2159 :     </blockquote>
2160 :    
2161 :    
2162 :    
2163 :    
2164 :    
2165 :    
2166 :    
2167 :    
2168 :     <h4>
2169 :     Search the file system</h4>
2170 :    
2171 :    
2172 :    
2173 :    
2174 :    
2175 :    
2176 :    
2177 :    
2178 :     <blockquote>
2179 :    
2180 :    
2181 :    
2182 :    
2183 :    
2184 :    
2185 :    
2186 :    
2187 :    
2188 :     <p class="MsoNormal">
2189 :     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
2191 :     view. Click on the Settings... button to customize which part of the file
2192 :     system you want to search.</p>
2193 :    
2194 :    
2195 :     </blockquote>
2196 :    
2197 :    
2198 :    
2199 :    
2200 :    
2201 :    
2202 :    
2203 :    
2204 :    
2205 :     <h4>
2206 :     Customize Search</h4>
2207 :    
2208 :    
2209 :    
2210 :    
2211 :    
2212 :    
2213 :    
2214 :    
2215 :    
2216 :     <blockquote>
2217 :    
2218 :    
2219 :    
2220 :    
2221 :    
2222 :    
2223 :    
2224 :    
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>
2232 :    
2233 :    
2234 :    
2235 :    
2236 :    
2237 :    
2238 :    
2239 :    
2240 :    
2241 :     <h3>
2242 :     Browse to discover</h3>
2243 :    
2244 :    
2245 :    
2246 :    
2247 :    
2248 :    
2249 :    
2250 :    
2251 :    
2252 :     <blockquote>
2253 :    
2254 :    
2255 :    
2256 :    
2257 :    
2258 :    
2259 :    
2260 :    
2261 :    
2262 :     <p class="MsoNormal">
2263 :     This section will focus on browsing update sites to find the features
2264 :     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>
2272 :    
2273 :    
2274 :    
2275 :    
2276 :    
2277 :    
2278 :    
2279 :    
2280 :    
2281 :     <h4>
2282 :     Browse already existing sites</h4>
2283 :    
2284 :    
2285 :    
2286 :    
2287 :    
2288 :    
2289 :    
2290 :    
2291 :    
2292 :     <blockquote>
2293 :    
2294 :    
2295 :    
2296 :    
2297 :    
2298 :    
2299 :    
2300 :    
2301 :    
2302 :     <p class="MsoNormal">
2303 :     If you expand the folder 'Places to visit' you may see some sites. They
2304 :     were automatically added to the folder by the feature you installed. You
2305 :     can expand the site and browse the features.</p>
2306 :    
2307 :    
2308 :     </blockquote>
2309 :    
2310 :    
2311 :    
2312 :    
2313 :    
2314 :    
2315 :    
2316 :    
2317 :    
2318 :     <h4>
2319 :     Browse the file system</h4>
2320 :    
2321 :    
2322 :    
2323 :    
2324 :    
2325 :    
2326 :    
2327 :    
2328 :    
2329 :     <blockquote>
2330 :    
2331 :    
2332 :    
2333 :    
2334 :    
2335 :    
2336 :    
2337 :    
2338 :    
2339 :     <p class="MsoNormal">
2340 :     To browse the file system, expand 'My Computer'.  &lt;TODO what more to
2341 :     say?&gt;</p>
2342 :    
2343 :    
2344 :     </blockquote>
2345 :    
2346 :    
2347 :    
2348 :    
2349 :    
2350 :    
2351 :    
2352 :    
2353 :    
2354 :     <h4>
2355 :     Add a new Update Site </h4>
2356 :    
2357 :    
2358 :    
2359 :    
2360 :    
2361 :    
2362 :    
2363 :    
2364 :    
2365 :     <blockquote>
2366 :     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>
2378 :    
2379 :    
2380 :    
2381 :    
2382 :    
2383 :    
2384 :    
2385 :    
2386 :    
2387 :     <h4>
2388 :     Add a bookmark of a file system site.</h4>
2389 :    
2390 :    
2391 :    
2392 :    
2393 :    
2394 :    
2395 :    
2396 :    
2397 :    
2398 :     <blockquote>
2399 :     When you browse the file syste, you can add a file system site as a bookmark.
2400 :     Select the site. Open the context menu. Select  'Bookmark Location'. This
2401 :     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>
2411 :    
2412 :    
2413 :    
2414 :    
2415 :    
2416 :    
2417 :    
2418 :    
2419 :    
2420 :     <h3>
2421 :     Searching Features</h3>
2422 :     &lt;TODO&gt;<br>
2423 :    
2424 :    
2425 :    
2426 :    
2427 :    
2428 :    
2429 :    
2430 :    
2431 :    
2432 :     <h4>
2433 :     Search for updates</h4>
2434 :     &lt;TODO&gt;<br>
2435 :    
2436 :    
2437 :    
2438 :    
2439 :    
2440 :    
2441 :    
2442 :    
2443 :    
2444 :     <h4>
2445 :     Search the file system</h4>
2446 :     &lt;TODO&gt;<br>
2447 :    
2448 :    
2449 :    
2450 :    
2451 :    
2452 :    
2453 :    
2454 :    
2455 :    
2456 :     <h4>
2457 :     Customize Search</h4>
2458 :     &lt;TODO&gt;<br>
2459 :    
2460 :    
2461 :    
2462 :    
2463 :    
2464 :    
2465 :    
2466 :    
2467 :    
2468 :     <h2>
2469 :     Installing a Feature</h2>
2470 :    
2471 :    
2472 :    
2473 :    
2474 :    
2475 :    
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 :    
2486 :    
2487 :     </blockquote>
2488 :    
2489 :    
2490 :    
2491 :    
2492 :    
2493 :    
2494 :    
2495 :    
2496 :    
2497 :     <h3>
2498 :     Install Wizard</h3>
2499 :    
2500 :    
2501 :    
2502 :    
2503 :    
2504 :    
2505 :    
2506 :    
2507 :    
2508 :     <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 :    
2517 :    
2518 :    
2519 :    
2520 :    
2521 :    
2522 :    
2523 :    
2524 :     <h4>
2525 :     The Preview Tab</h4>
2526 :    
2527 :    
2528 :    
2529 :    
2530 :    
2531 :    
2532 :    
2533 :    
2534 :    
2535 :     <blockquote>
2536 :     This tab summarizes the action you are going to take. <br>
2537 :    
2538 :    
2539 :     </blockquote>
2540 :    
2541 :    
2542 :    
2543 :    
2544 :    
2545 :    
2546 :    
2547 :    
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 :    
2554 :    
2555 :     </div>
2556 :    
2557 :    
2558 :    
2559 :    
2560 :    
2561 :    
2562 :    
2563 :    
2564 :    
2565 :     <h4>
2566 :      The License Tab</h4>
2567 :    
2568 :    
2569 :    
2570 :    
2571 :    
2572 :    
2573 :    
2574 :    
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>
2583 :    
2584 :    
2585 :    
2586 :    
2587 :    
2588 :    
2589 :    
2590 :    
2591 :    
2592 :     <h4>
2593 :     Site location Tab</h4>
2594 :    
2595 :    
2596 :    
2597 :    
2598 :    
2599 :    
2600 :    
2601 :    
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>
2612 :    
2613 :    
2614 :    
2615 :    
2616 :    
2617 :    
2618 :    
2619 :    
2620 :    
2621 :     <h4>
2622 :     Verification &lt;TODO explain basic certificate &gt;</h4>
2623 :    
2624 :    
2625 :    
2626 :    
2627 :    
2628 :    
2629 :    
2630 :    
2631 :    
2632 :     <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 :    
2903 :    
2904 :     <blockquote>
2905 :     This section will focus on configuring and unconfiguring the feature
2906 :     you can manage in your current configuration. A configuration is a list
2907 :     of configured and unconfigured features that determine what tool are available
2908 :     for you to use in your workspace.  To know more about configuration see:
2909 :     <a href="http://www.eclipse.org"> Configuration</a>
2910 :     . <br>
2911 :    
2912 :    
2913 :    
2914 :     </blockquote>
2915 :    
2916 :    
2917 :    
2918 :    
2919 :    
2920 :    
2921 :    
2922 :    
2923 :    
2924 :    
2925 :     <h3>
2926 :     Checking if a feature is configured or unconfigured.<br>
2927 :    
2928 :    
2929 :    
2930 :     </h3>
2931 :    
2932 :    
2933 :    
2934 :    
2935 :    
2936 :    
2937 :    
2938 :    
2939 :    
2940 :    
2941 :     <blockquote>
2942 :     Feature you installed appear in the Configuration View. Expand the Current
2943 :     Configuration to see the configured sites. Expand the site to see the Features.
2944 :     Use the local view toolbar button to switch between configured features
2945 :     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">
2946 :    
2947 :    
2948 :    
2949 :     <br>
2950 :    
2951 :    
2952 :    
2953 :     </blockquote>
2954 :    
2955 :    
2956 :    
2957 :    
2958 :    
2959 :    
2960 :    
2961 :    
2962 :    
2963 :    
2964 :     <h3>
2965 :     Configure/Unconfigure Wizard</h3>
2966 :    
2967 :    
2968 :    
2969 :    
2970 :    
2971 :    
2972 :    
2973 :    
2974 :    
2975 :    
2976 :     <blockquote>
2977 :    
2978 :    
2979 :    
2980 :    
2981 :    
2982 :    
2983 :    
2984 :    
2985 :    
2986 :    
2987 :     <p class="MsoNormal">
2988 :     The Wizard will help you configure or unconfigure a feature. <br>
2989 :    
2990 :    
2991 :    
2992 :     </p>
2993 :    
2994 :    
2995 :    
2996 :     </blockquote>
2997 :    
2998 :    
2999 :    
3000 :    
3001 :    
3002 :    
3003 :    
3004 :    
3005 :    
3006 :    
3007 :     <h4>
3008 :     Preview Tab</h4>
3009 :    
3010 :    
3011 :    
3012 :    
3013 :    
3014 :    
3015 :    
3016 :    
3017 :    
3018 :    
3019 :     <blockquote>
3020 :     This tab summarizes the action you are going to take. <br>
3021 :    
3022 :    
3023 :    
3024 :    
3025 :    
3026 :    
3027 :    
3028 :    
3029 :    
3030 :    
3031 :     <div align="Left"><img src="images/PIC003.gif" alt="PIC003.gif Configure Wizard Preview Tab" width="500" height="500">
3032 :    
3033 :    
3034 :    
3035 :     <br>
3036 :    
3037 :    
3038 :    
3039 :     </div>
3040 :     <div align="Left">
3041 :    
3042 :    
3043 :    
3044 :     </div>
3045 :     </blockquote>
3046 :    
3047 :    
3048 :    
3049 :    
3050 :    
3051 :    
3052 :    
3053 :    
3054 :    
3055 :    
3056 :     <h2>
3057 :     Configuration</h2>
3058 :    
3059 :    
3060 :    
3061 :    
3062 :    
3063 :    
3064 :    
3065 :    
3066 :    
3067 :    
3068 :     <blockquote>
3069 :    
3070 : celek 1.1
3071 :    
3072 :    
3073 :    
3074 :    
3075 :    
3076 :    
3077 :    
3078 : celek 1.2
3079 :     <p class="MsoNormal">
3080 :     A configuration is a list of configured and unconfigured features that
3081 :     determine what tool are available for you to use in your workspace. A configuration
3082 :     determines what task you can execute. There are three types of configuraions:
3083 :     the current configuration, the history configuration and the preserved
3084 :     configuration.<br>
3085 :     </p>
3086 : celek 1.1
3087 :    
3088 :    
3089 : celek 1.2 </blockquote>
3090 : celek 1.1
3091 :    
3092 :    
3093 :    
3094 :    
3095 :    
3096 :    
3097 :    
3098 :    
3099 : celek 1.2
3100 :     <h3>
3101 :     Current Configuration</h3>
3102 : celek 1.1
3103 :    
3104 :    
3105 :    
3106 :    
3107 :    
3108 :    
3109 :    
3110 :    
3111 : celek 1.2
3112 :     <blockquote>
3113 : celek 1.1
3114 :    
3115 :    
3116 :    
3117 :    
3118 :    
3119 :    
3120 :    
3121 :    
3122 :    
3123 : celek 1.2 <p class="MsoNormal">
3124 :     The current configuration is the configuration currently active.</p>
3125 : celek 1.1
3126 :    
3127 :    
3128 :     </blockquote>
3129 :    
3130 :    
3131 : celek 1.2
3132 :    
3133 :    
3134 :    
3135 :    
3136 :    
3137 :    
3138 :    
3139 :    
3140 :     <h3>
3141 :     Configuration History or Preserved Configuration</h3>
3142 :    
3143 :    
3144 :    
3145 :    
3146 :    
3147 :    
3148 :    
3149 :    
3150 :    
3151 :    
3152 :    
3153 :     <blockquote>
3154 :    
3155 :    
3156 :    
3157 :    
3158 :    
3159 :    
3160 :    
3161 :    
3162 :    
3163 :    
3164 :    
3165 :     <p class="MsoNormal">
3166 :     Configuration History are automatically created by the Install/Update
3167 :     as a snapshot of your current configuration at a certain time, before an
3168 :     activity occurs. Preserved Configuration are configuration in the History
3169 :     Configuration you want to persist.</p>
3170 :    
3171 :    
3172 : celek 1.1
3173 :     </blockquote>
3174 :    
3175 :    
3176 :    
3177 :    
3178 :    
3179 :    
3180 :    
3181 :    
3182 :    
3183 :    
3184 : celek 1.2
3185 :     <h3>
3186 :     Configuration History</h3>
3187 :    
3188 :    
3189 :    
3190 :    
3191 : celek 1.1
3192 :    
3193 :    
3194 :    
3195 :    
3196 :    
3197 : celek 1.2
3198 :     <blockquote>
3199 : celek 1.1
3200 :    
3201 :    
3202 :    
3203 :    
3204 :    
3205 :    
3206 :    
3207 :    
3208 :    
3209 : celek 1.2
3210 :     <p class="MsoNormal">
3211 :     When you install a feature, the install/update component will copy your
3212 :     current configuration in the history configuration, and then install and
3213 :     configure the feature in you current configuration. You will end up with
3214 :     two configurations, one without the feature installed and configured and
3215 :     one with the feature installed and configured. The install/update will also
3216 :     copy your current configuration when you install or remove a site, when you
3217 :     configure or unconfigure a feature or when a reconciliation is needed. Each
3218 :     actvity will be recorded in the configuration. For each configuration selected
3219 :     in the history configuration folder, you can see in the preview view the
3220 :     list of activities that were executed. See <a href="http://www.eclipse.org">
3221 :     Activities </a>
3222 :     for more information about the different activities.</p>
3223 : celek 1.1
3224 :    
3225 :    
3226 : celek 1.2 </blockquote>
3227 : celek 1.1
3228 :    
3229 :    
3230 :    
3231 :    
3232 :    
3233 :    
3234 :    
3235 :    
3236 :    
3237 : celek 1.2
3238 :     <blockquote>
3239 :     The install/update will keep a certain number of configuration in the
3240 :     configuration history folder. After this number has been reached, if a new
3241 :     configuration is created, the oldest configuration inside Configuration
3242 :     History folder will be deleted. <br>
3243 : celek 1.1
3244 :    
3245 :    
3246 : celek 1.2 </blockquote>
3247 : celek 1.1
3248 :    
3249 :    
3250 :    
3251 :    
3252 :    
3253 :    
3254 :    
3255 :    
3256 :    
3257 : celek 1.2
3258 :     <h4>
3259 :     Renaming an history configuration</h4>
3260 : celek 1.1
3261 :    
3262 :    
3263 :    
3264 :    
3265 :    
3266 :    
3267 :    
3268 :    
3269 :    
3270 : celek 1.2
3271 :     <blockquote>
3272 : celek 1.1
3273 :    
3274 :    
3275 :    
3276 :    
3277 :    
3278 :    
3279 :    
3280 :    
3281 :    
3282 : celek 1.2
3283 :     <p class="MsoNormal">
3284 :     You can rename any configuration in the Configuration History folder.
3285 :     To change the label of a Configuration, select the configuration, open the
3286 :     context menu and click Properties. This will open a dialog where you can
3287 :     change the label of the selected configuration. Click Ok if you want to save
3288 :     the label  or click cancel if you do not want to change the label of the
3289 :     configuration.</p>
3290 : celek 1.1
3291 :    
3292 :    
3293 : celek 1.2 </blockquote>
3294 : celek 1.1
3295 :    
3296 :    
3297 :    
3298 :    
3299 :    
3300 :    
3301 :    
3302 :    
3303 :    
3304 : celek 1.2
3305 :     <h4>
3306 :     Revert the current configuration to the previous configuration</h4>
3307 : celek 1.1
3308 :    
3309 :    
3310 :    
3311 :    
3312 :    
3313 :    
3314 :    
3315 :    
3316 :    
3317 : celek 1.2
3318 :     <blockquote>
3319 : celek 1.1
3320 :    
3321 :    
3322 :    
3323 :    
3324 :    
3325 :    
3326 :    
3327 :    
3328 :    
3329 : celek 1.2
3330 :     <p class="MsoNormal">
3331 :     You can revert the current configuration to the previous configuration.
3332 :     &lt;TODO explain better&gt; <br>
3333 : celek 1.1
3334 :    
3335 :    
3336 : celek 1.2 </p>
3337 : celek 1.1
3338 :    
3339 :    
3340 : celek 1.2 </blockquote>
3341 : celek 1.1
3342 :    
3343 :    
3344 :    
3345 :    
3346 :    
3347 :    
3348 :    
3349 :    
3350 :    
3351 : celek 1.2
3352 :     <h3>
3353 :      Preserved Configuration</h3>
3354 : celek 1.1
3355 :    
3356 :    
3357 :    
3358 :    
3359 :    
3360 :    
3361 :    
3362 :    
3363 :    
3364 : celek 1.2
3365 :     <blockquote>
3366 :     &lt;TODO&gt;<br>
3367 : celek 1.1
3368 :    
3369 :    
3370 : celek 1.2 </blockquote>
3371 : celek 1.1
3372 :    
3373 :    
3374 :    
3375 :    
3376 :    
3377 :    
3378 :    
3379 :    
3380 :    
3381 : celek 1.2
3382 :     <h4>
3383 :     Add a Configuration in the preserved folder</h4>
3384 : celek 1.1
3385 :    
3386 :    
3387 :    
3388 :    
3389 :    
3390 :    
3391 :    
3392 :    
3393 :    
3394 : celek 1.2
3395 :     <blockquote>
3396 :     &lt;TODO&gt;<br>
3397 : celek 1.1
3398 :    
3399 :    
3400 : celek 1.2 </blockquote>
3401 : celek 1.1
3402 :    
3403 :    
3404 :    
3405 :    
3406 :    
3407 :    
3408 :    
3409 :    
3410 :    
3411 : celek 1.2
3412 :     <h4>
3413 :     Remove a Configuration in the preserved folder   </h4>
3414 : celek 1.1
3415 :    
3416 :    
3417 :    
3418 :    
3419 :    
3420 :    
3421 :    
3422 :    
3423 :    
3424 : celek 1.2
3425 :     <blockquote>
3426 : celek 1.1
3427 :    
3428 :    
3429 :    
3430 :    
3431 :    
3432 :    
3433 :    
3434 :    
3435 :    
3436 : celek 1.2
3437 :     <p>
3438 :     &lt;TODO&gt; </p>
3439 : celek 1.1
3440 :    
3441 :    
3442 : celek 1.2 </blockquote>
3443 : celek 1.1
3444 :    
3445 :    
3446 :    
3447 :    
3448 :    
3449 :    
3450 :    
3451 :    
3452 :    
3453 : celek 1.2
3454 :     <h4>
3455 :     Rename a Preserved Configuration</h4>
3456 : celek 1.1
3457 :    
3458 :    
3459 :    
3460 :    
3461 :    
3462 :    
3463 :    
3464 :    
3465 :    
3466 : celek 1.2
3467 :     <blockquote>
3468 : celek 1.1
3469 :    
3470 :    
3471 :    
3472 :    
3473 :    
3474 :    
3475 :    
3476 :    
3477 :    
3478 : celek 1.2
3479 :     <p class="MsoNormal">
3480 :     You can rename any configuration in the Preserved Configurations folder.
3481 :     To change the label of a Configuration, select the configuration, open the
3482 :     context menu and click Properties. This will open a dialog where you can
3483 :     change the label of the selected configuration. Click Ok if you want to save
3484 :     the label  or click cancel if you do not want to change the label of the configuration.</p>
3485 : celek 1.1
3486 :    
3487 :    
3488 : celek 1.2 </blockquote>
3489 : celek 1.1
3490 :    
3491 :    
3492 :    
3493 :    
3494 :    
3495 :    
3496 :    
3497 :    
3498 :    
3499 : celek 1.2
3500 :     <p class="MsoNormal"><br>
3501 : celek 1.1
3502 :    
3503 :    
3504 : celek 1.2 </p>
3505 : celek 1.1
3506 :    
3507 :    
3508 :    
3509 :    
3510 :    
3511 :    
3512 :    
3513 :    
3514 :    
3515 : celek 1.2
3516 :     <h3>
3517 :     Restore a Configuration/Revert to previous configuration</h3>
3518 : celek 1.1
3519 :    
3520 :    
3521 :    
3522 :    
3523 :    
3524 :    
3525 :    
3526 :    
3527 :    
3528 : celek 1.2
3529 :     <p class="MsoNormal">
3530 :         &lt;TODO&gt;</p>
3531 : celek 1.1
3532 :    
3533 :    
3534 :    
3535 :    
3536 :    
3537 :    
3538 :    
3539 :    
3540 :    
3541 : celek 1.2
3542 :     <p class="MsoNormal"><br>
3543 : celek 1.1
3544 :    
3545 :    
3546 : celek 1.2 </p>
3547 : celek 1.1
3548 :    
3549 :    
3550 :    
3551 :    
3552 :    
3553 :    
3554 :    
3555 :    
3556 :    
3557 : celek 1.2
3558 :     <h3>
3559 :     The Activities </h3>
3560 :     <blockquote>
3561 :     Activities are tasks that are part of a configuration. Activities are the
3562 :     actions are were taken to create the Configuration. You can see activities
3563 :     in the preview view when you select a configuration.<br>
3564 :     <div align="Center"><img src="images/pic014.gif" alt="activities" width="594" height="151">
3565 :     <br>
3566 :     </div>
3567 :     </blockquote>
3568 :     <div align="Center">
3569 :     <div align="Left">
3570 :     <h5>
3571 :     Date</h5>
3572 :     </div>
3573 :     </div>
3574 :     <blockquote>
3575 :     <div align="Center">
3576 :     <div align="Left">
3577 :     The date using the locale format ate which the action took place.<br>
3578 :     </div>
3579 :     </div>
3580 :     </blockquote>
3581 :     <div align="Center">
3582 :     <div align="Left">
3583 :     <h5>
3584 :     Target</h5>
3585 :     </div>
3586 :     </div>
3587 :     <blockquote>
3588 :     <div align="Center">
3589 :     <div align="Left">
3590 :     The identifier of the target of the action (see the different type of activities)<br>
3591 :     </div>
3592 :     </div>
3593 :     </blockquote>
3594 :     <div align="Center">
3595 :     <div align="Left">
3596 :     <h5>
3597 :     Action</h5>
3598 :     </div>
3599 :     </div>
3600 :     <blockquote>
3601 :     <div align="Center">
3602 :     <div align="Left">
3603 :     The label of the action (see the different types of activities)<br>
3604 :     </div>
3605 :     </div>
3606 :     </blockquote>
3607 :     <div align="Center">
3608 :     <div align="Left">
3609 :     <h5>
3610 :     Status</h5>
3611 :     </div>
3612 :     </div>
3613 :     <blockquote>
3614 :     <div align="Center">
3615 :     <div align="Left">
3616 :     The status of the action. Sucess if teh action was sucessful.<br>
3617 :     </div>
3618 :     </div>
3619 :     </blockquote>
3620 : celek 1.1
3621 :    
3622 :    
3623 :    
3624 :    
3625 :    
3626 :    
3627 :    
3628 :    
3629 :    
3630 : celek 1.2
3631 :     <blockquote>
3632 :     There are nine different actions that create an activity in a configuration.<br>
3633 : celek 1.1
3634 :    
3635 :    
3636 : celek 1.2 </blockquote>
3637 : celek 1.1
3638 :    
3639 :    
3640 :    
3641 :    
3642 :    
3643 :    
3644 :    
3645 :    
3646 :    
3647 : celek 1.2
3648 :     <h4>
3649 :     Feature Installed   </h4>
3650 : celek 1.1
3651 :    
3652 :    
3653 :    
3654 :    
3655 :    
3656 :    
3657 :    
3658 :    
3659 :    
3660 : celek 1.2
3661 :     <blockquote>
3662 : celek 1.1
3663 :    
3664 :    
3665 :    
3666 :    
3667 :    
3668 :    
3669 :    
3670 :    
3671 :    
3672 : celek 1.2
3673 :     <p class="MsoNormal">
3674 :     When a new feature is installed in a configured site.<br>
3675 :     The target in the preview view is the identifier of the installed feature.<br>
3676 : celek 1.1
3677 :    
3678 :    
3679 : celek 1.2 </p>
3680 : celek 1.1
3681 :    
3682 :    
3683 : celek 1.2 </blockquote>
3684 : celek 1.1
3685 :    
3686 :    
3687 :    
3688 :    
3689 :    
3690 :    
3691 :    
3692 :    
3693 :    
3694 : celek 1.2
3695 :     <h4>
3696 :     Feature Removed</h4>
3697 : celek 1.1
3698 :    
3699 :    
3700 :    
3701 :    
3702 :    
3703 :    
3704 :    
3705 :    
3706 :    
3707 : celek 1.2
3708 :     <blockquote>
3709 : celek 1.1
3710 :    
3711 :    
3712 :    
3713 :    
3714 :    
3715 :    
3716 :    
3717 :    
3718 :    
3719 : celek 1.2
3720 :     <p class="MsoNormal">
3721 :     When a new feature is physically removed from a configured site.<br>
3722 :     The target in the preview view is the identifier of the removed feature.<br>
3723 : celek 1.1
3724 :    
3725 :    
3726 : celek 1.2 </p>
3727 : celek 1.1
3728 :    
3729 :    
3730 : celek 1.2 </blockquote>
3731 : celek 1.1
3732 :    
3733 :    
3734 :    
3735 :    
3736 :    
3737 :    
3738 :    
3739 :    
3740 :    
3741 : celek 1.2
3742 :     <h4>
3743 :     Site Installed</h4>
3744 : celek 1.1
3745 :    
3746 :    
3747 :    
3748 :    
3749 :    
3750 :    
3751 :    
3752 :    
3753 :    
3754 :    
3755 : celek 1.2 <blockquote>
3756 :    
3757 : celek 1.1
3758 :    
3759 :    
3760 :    
3761 :    
3762 :    
3763 :    
3764 :    
3765 :    
3766 :    
3767 : celek 1.2
3768 :     <p class="MsoNormal">
3769 :     When a Site is added to the current configuration.</p>
3770 : celek 1.1
3771 :    
3772 :    
3773 :    
3774 :    
3775 :    
3776 :    
3777 :    
3778 :    
3779 :    
3780 :    
3781 :    
3782 : celek 1.2 <p class="MsoNormal">
3783 :     The target in the preview view is the Address of the site</p>
3784 : celek 1.1
3785 :    
3786 :    
3787 : celek 1.2 </blockquote>
3788 : celek 1.1
3789 :    
3790 :    
3791 :    
3792 :    
3793 :    
3794 :    
3795 :    
3796 :    
3797 :    
3798 :    
3799 : celek 1.2
3800 :     <h4>
3801 :     Site Removed</h4>
3802 : celek 1.1
3803 :    
3804 :