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

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.4 - (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.4
5 : celek 1.1 <meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
6 : celek 1.4
7 : celek 1.1 <meta name="ProgId" content="Word.Document">
8 : celek 1.4
9 : celek 1.1 <meta name="Generator" content="Microsoft Word 9">
10 : celek 1.4
11 : celek 1.1 <meta name="Originator" content="Microsoft Word 9">
12 : celek 1.4
13 : celek 1.1 <link rel="File-List" href="./user%20guide%20structure_files/filelist.xml">
14 : celek 1.4 <!--[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.4
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.4
75 :     <div class="Section1">
76 : celek 1.1 <h1> </h1>
77 : celek 1.4
78 :     <div align="Center">
79 : celek 1.1 <h1>Install/Update User Guide</h1>
80 : celek 1.4 </div>
81 :    
82 : celek 1.1 <p class="MsoNormal"><!--[if !supportEmptyParas]--> <!--[endif]--><o:p></o:p></p>
83 : celek 1.4
84 : celek 1.1 <h2>Getting Started: Install/Update in three steps</h2>
85 : celek 1.4
86 :     <blockquote> This section will teach you how to install a new Feature and
87 :     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.4
94 :     <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
96 :     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 : celek 1.2 at the <a href="http://www.eclipse.org">Find Features</a>
99 : celek 1.4 section.<br>
100 :     </blockquote>
101 : celek 1.2
102 : celek 1.4 <blockquote>Before browsing a site, we will have to create a site bookmark
103 :     to access it.<br>
104 :     </blockquote>
105 :    
106 : celek 1.1 <p class="MsoNormal"></p>
107 : celek 1.4
108 : celek 1.1 <h4>Create a new site bookmark</h4>
109 : celek 1.4
110 : celek 1.1 <p class="MsoNormal"></p>
111 : celek 1.4
112 : celek 1.1 <ul>
113 : celek 1.4 <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.4
124 :     <blockquote> The Site should appear on the view. The provider of a
125 :     feature should give you the URL of their site so you can  find their feature.
126 :     We will now browse the site to discover the features.<br>
127 :     </blockquote>
128 :    
129 : celek 1.1 <h4> Choose Feature</h4>
130 : celek 1.4
131 :     <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,
133 :      and 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.4 <li>Select Red Dot Feature 1.0.0</li>
137 :    
138 : celek 1.1 </ul>
139 : celek 1.4 </blockquote>
140 :    
141 :     <blockquote>The Preview page should now look like the following
142 :     picture:<br>
143 :     </blockquote>
144 :    
145 : celek 1.3 <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.4 <br>
147 :     </div>
148 :    
149 :     <blockquote>You may want to check the license and copyright or
150 :     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 :     <blockquote>&lt;TIP the preference page lets you decide if
156 :     you want to view the HTML page within the workbench or by launching an external
157 :     browser&gt;<br>
158 :     </blockquote>
159 :    
160 : celek 1.1 <h3> Install Feature</h3>
161 : celek 1.4
162 :     <blockquote>When you are ready to install the feature click
163 :     on the Install button in the Preview View. This will launch the Install
164 :     Wizard.<br>
165 :     </blockquote>
166 :    
167 :    
168 : celek 1.1 <h4>Install Wizard</h4>
169 : celek 1.4
170 :    
171 : celek 1.1 <p class="MsoNormal"></p>
172 : celek 1.4
173 :    
174 : celek 1.1 <ul>
175 : celek 1.4 <li>The first page of the Wizard summarizes the action
176 :     you are going to take. Click Next.</li>
177 :     <li>The second page shows the license you have to
178 :     accept to install the feature. Click next of you accept the presented license
179 :     otherwise click cancel.</li>
180 :     <li>The last page of the Wizard presents the list
181 :     of Site you can install your feature in. You can create a new site from
182 : celek 1.2 this page. For more information about creating new Site see:  <a href="http://www.eclipse.org">
183 : celek 1.4 Site Location Tab</a>
184 :     . You should see only one site and it should point to the path where
185 : celek 1.2 the workbench is installed. Click Finish.</li>
186 : celek 1.4
187 :    
188 : celek 1.1 </ul>
189 : celek 1.4
190 :    
191 :     <blockquote> The feature will then be downloaded, verified
192 :     and installed in the site. You can see the progress monitor showing you
193 :     the evolution of theses tasks. During verification, you may be prompted
194 :     to accept the verification. Click 'Ok' when prompted.<br>
195 :     </blockquote>
196 :    
197 :    
198 :     <blockquote> When the feature has been installed you
199 :     will need to restart the workbench for the changes to take effect. Click
200 :     'Ok' on the dialog box.<br>
201 :     </blockquote>
202 :    
203 :    
204 : celek 1.1 <p class="MsoNormal"></p>
205 : celek 1.4
206 :    
207 : celek 1.1 <h4>Verify the feature has been installed</h4>
208 : celek 1.4
209 :    
210 :     <blockquote>The feature you installed will add a red
211 :     button icon to the tool bar when activated. To activate this specific
212 :     feature customize your perspective and add the Red Dot Set Action Set:<br>
213 :     </blockquote>
214 : celek 1.2
215 : celek 1.4
216 : celek 1.1 <p class="MsoNormal"></p>
217 : celek 1.2
218 : celek 1.4
219 : celek 1.1 <ul>
220 : celek 1.4 <li>Open the menu Window</li>
221 :     <li>Select Customize Perspective</li>
222 :     <li>Expand Action Sets</li>
223 :     <li>Check Red Dot Set</li>
224 :     <li>Click Ok</li>
225 : celek 1.2
226 : celek 1.4
227 : celek 1.1 </ul>
228 : celek 1.2
229 : celek 1.4
230 :     <blockquote>You should now se a red button icon on
231 :     the toolbar. If you click on it the following dialog box should appear,
232 :     meaning the feature and associated plug-ins have been successfully installed
233 :     and configured.<br>
234 :     </blockquote>
235 : celek 1.2
236 : celek 1.4
237 :     <blockquote> We will now see how to manage your
238 :     feature in your configuration.<br>
239 :     </blockquote>
240 : celek 1.2
241 : celek 1.4
242 : celek 1.1 <h3> Configure Environment</h3>
243 : celek 1.2
244 : celek 1.4
245 :     <blockquote> A feature that is installed may
246 :     be configured or unconfigured for your workspace. A configured feature
247 :     means that Install/Update will 'suggests' that the runtime configures the
248 :     feature to be available. An unconfigured feature means that Install/Update
249 :     will make the feature unavailable to the user.<br>
250 :     </blockquote>
251 :    
252 :    
253 :     <blockquote>When you installed Red Dot Feature
254 :     1.0.0, Install/Update installed and configured the feature for you. You
255 :     can see that in the Configuration History. For more information about Configuration
256 :     History see <a href="http:/ww.eclipse.org"> Configuration History</a>
257 :     .<br>
258 :     </blockquote>
259 :    
260 :    
261 :     <blockquote>A configuration is a list of
262 :     configured and unconfigured features that determine what tool you can use.<br>
263 :     The current configuration is the configuration currently active.<br>
264 :     </blockquote>
265 :    
266 :    
267 :     <blockquote>For more information about
268 :     configuration, see <a href="http://www.eclipse.org">Configuring/Unconfiguring</a>
269 :     .<br>
270 :     </blockquote>
271 : celek 1.2
272 :    
273 : celek 1.4
274 :     <blockquote>In this section we will add
275 :     the current history configuration to the list of preserved configuration.
276 :     We will unconfigure Red Dot 1.0.0, so the feature will be unavailable.
277 :     Then we will restore the preserved configuration, which will re-configure
278 :     the feature.<br>
279 :     </blockquote>
280 : celek 1.2
281 :    
282 : celek 1.4
283 : celek 1.1 <h4>Add configuration to preserved</h4>
284 : celek 1.2
285 :    
286 : celek 1.4
287 :     <blockquote>To add the current configuration,
288 :     we will first need to find it in the list of configurations and then add
289 :     it to the list of preserved configurations. The current configuration
290 :     is the configuration in the configuration history folder with an icon
291 :     with a running person. It is the last configuration in the list.<br>
292 :     </blockquote>
293 :    
294 :    
295 :    
296 : celek 1.1 <p class="MsoNormal"></p>
297 : celek 1.2
298 : celek 1.4
299 :    
300 : celek 1.1 <ul>
301 : celek 1.4 <li>Select the current configuration.</li>
302 :     <li>Open the context menu.</li>
303 :     <li>Select Add to preserved.</li>
304 :     <li>The configuration now appears
305 :     under the Preserved Configurations folder.</li>
306 :    
307 : celek 1.2
308 : celek 1.4
309 : celek 1.1 </ul>
310 : celek 1.2
311 : celek 1.4
312 :    
313 : celek 1.1 <h4>Rename configuration</h4>
314 : celek 1.2
315 :    
316 : celek 1.4
317 :     <blockquote>We will rename the configuration
318 :     to give it a meaningfull name.<br>
319 :     </blockquote>
320 :    
321 :    
322 :    
323 : celek 1.1 <p class="MsoNormal"></p>
324 : celek 1.2
325 : celek 1.4
326 :    
327 : celek 1.1 <ul>
328 : celek 1.4 <li>Select the configuration.</li>
329 :     <li>Open the context menu
330 : celek 1.2 and click Properties.</li>
331 : celek 1.4 <li>Change the name of the
332 :     configuration to: RedDot 1</li>
333 :     <li>Click Ok.</li>
334 : celek 1.2
335 : celek 1.4
336 :    
337 : celek 1.1 </ul>
338 : celek 1.2
339 : celek 1.4
340 :    
341 : celek 1.1 <h4>Unconfigure Feature</h4>
342 : celek 1.2
343 :    
344 : celek 1.4
345 :     <blockquote>We will now unconfigure
346 :     the feature.<br>
347 :     </blockquote>
348 :    
349 :    
350 :    
351 : celek 1.1 <p class="MsoNormal"></p>
352 : celek 1.2
353 : celek 1.4
354 :    
355 : celek 1.1 <ul>
356 : celek 1.4 <li>Expand Current Configuration;</li>
357 :     <li>Expand the site</li>
358 :    
359 :    
360 : celek 1.1 </ul>
361 : celek 1.4
362 :    
363 :     <blockquote>
364 :    
365 :    
366 : celek 1.3 <div align="Left"><img src="images/pic004.gif" alt="Expand Current Configuration to reveal the configured Feature." width="202" height="118">
367 : celek 1.4 <br>
368 :     </div>
369 :     </blockquote>
370 :    
371 :    
372 : celek 1.2 <ul>
373 : celek 1.4 <li>Select Red Dot Feature
374 :     1.0.0</li>
375 :     <li>In the preview view
376 : celek 1.2 click Unconfigure.</li>
377 : celek 1.4 <li>When the Dialog opens
378 : celek 1.2 click Ok.</li>
379 :    
380 : celek 1.4
381 :    
382 : celek 1.2 </ul>
383 :    
384 : celek 1.4
385 :    
386 : celek 1.1 <p class="MsoNormal"></p>
387 : celek 1.2
388 : celek 1.4
389 :    
390 :     <blockquote>The workspace will
391 :     shut-down and restart automatically.</blockquote>
392 : celek 1.2
393 :    
394 : celek 1.4
395 : celek 1.2 <p class="MsoNormal"></p>
396 :    
397 :    
398 : celek 1.4
399 : celek 1.2 <h4> </h4>
400 :    
401 :    
402 : celek 1.4
403 : celek 1.2 <h3>Restore Configuration</h3>
404 :    
405 :    
406 : celek 1.4
407 :     <blockquote>We shall now
408 :     restore the configuration we added to preserve, so the feature will be configured
409 :     again.<br>
410 :     </blockquote>
411 : celek 1.2
412 :    
413 : celek 1.4
414 :     <h4>Verify the Feature
415 :     is not available</h4>
416 : celek 1.2
417 :    
418 : celek 1.4
419 :     <blockquote>You should
420 :     not see the red button icon in the toolbar, meaning the feature was not
421 :     activated<br>
422 :     </blockquote>
423 : celek 1.2
424 :    
425 : celek 1.4
426 : celek 1.2 <p class="MsoNormal"></p>
427 :    
428 :    
429 : celek 1.4
430 : celek 1.1 <ul>
431 : celek 1.4 <li>In the Configuration
432 :     View, expand Current Configuration.</li>
433 :     <li>Expand the site.</li>
434 :     <li>Verify Red Dot
435 :     Feature 1.0.0 does NOT appear as an icon.</li>
436 :     <li>Click on the
437 :     view toolbar button 'show unconfigured features'</li>
438 :     <li>Verify Red Dot
439 :     Feature 1.0.0 does appear</li>
440 : celek 1.2
441 :    
442 : celek 1.4
443 : celek 1.1 </ul>
444 : celek 1.4
445 :    
446 : celek 1.2 <blockquote><img src="images/pic005.gif" alt="Unconfigured feature revealed" width="257" height="117">
447 :    
448 : celek 1.4 </blockquote>
449 :    
450 :    
451 : celek 1.2 <blockquote>The icon <img src="images/unconf_feature_obj.gif" alt="Unconfigured Feature unconf_feature_obj.gif " width="16" height="16">
452 : celek 1.4 means the feature is still installed but not available at this time
453 :     in your workspace. To be able to use the feature we will need to configure
454 : celek 1.2 the feature.<br>
455 : celek 1.4 </blockquote>
456 :    
457 :    
458 : celek 1.2
459 : celek 1.4
460 :     <h4>Revert to preserved
461 :     configuration</h4>
462 : celek 1.2
463 :    
464 :    
465 : celek 1.4
466 : celek 1.2 <p class="MsoNormal">
467 : celek 1.4             We will now go back to the configuration we had previously
468 : celek 1.2 in which Red Dot Feature 1.0.0 was configured.</p>
469 :    
470 :    
471 : celek 1.4
472 :    
473 : celek 1.2 <ul>
474 : celek 1.4 <li>Expand Preserved
475 :     Configurations</li>
476 :     <li>Select RedDot
477 :     1</li>
478 :     <li>In the preview
479 :     view click Restore</li>
480 :     <li>When the Dialog
481 :     opens click Ok.</li>
482 :    
483 :    
484 :    
485 :    
486 :     </ul>
487 :    
488 :    
489 :    
490 :    
491 :     <blockquote>The workspace
492 :     will shut-down and restart automatically. After the workspace restart,
493 :     the feature is configured, based on the revert configuration.</blockquote>
494 :    
495 :    
496 :    
497 :    
498 :     <blockquote>There
499 :     are different way of configuring a feature. To know more about configuring
500 :     and unconfiguring features see: <a href="http://www.eclipse.org"> Configuring/Unconfiguring
501 :     features</a>
502 :     .<br>
503 :     </blockquote>
504 :    
505 :    
506 :    
507 :    
508 :     <p class="MsoNormal">
509 :     In this section you learnt how to find a feature you want to install,
510 :     how to install a feature, how to unconfigure a feature and how to restore
511 :     a preserved configuration. The rest of the book will go into more details.<br>
512 :     </p>
513 :    
514 :    
515 :    
516 :    
517 :     <h2> The User
518 :     Interface</h2>
519 :    
520 :    
521 :    
522 :    
523 :     <blockquote>
524 :     This section describes in details the User Interface of the Install/Update
525 :     perspective. The perspective is composed of four different views: The
526 :     Configuration View to manage the configurations, the Updates View to manage
527 :     update sites and features as well as searches. The Preview View is used
528 :     to show the details of the element selected in the previous two views and
529 :     the Web View, which is used to browse HTML document from either sites or
530 :     features.</blockquote>
531 :    
532 :    
533 :    
534 :    
535 :     <h3>The Configuration
536 :     View</h3>
537 :    
538 :    
539 :    
540 :    
541 :     <blockquote>
542 :     The configuration view helps you manage your configurations. A configuration
543 :     is a list of configured and unconfigured features that determine what tool
544 :     are available fro you to use in your workspace. <br>
545 :     <img src="images/pic006.gif" alt="Configuration View" width="251" height="251">
546 :     <br>
547 :     </blockquote>
548 :    
549 :    
550 :    
551 :    
552 :     <h4> Current
553 :     Configuration</h4>
554 :    
555 :    
556 :    
557 :    
558 :     <blockquote>
559 :     The current configuration is the configuration currently active. When
560 :     you expand the Current Configuration you can see the sites you are connected
561 :     to. Expanding each site reveals the list of Features you have access to.
562 :     Some feature may be configured, some may be unconfigured. The configured
563 :     features are the tools the Install/Update suggested the runtime to activate.
564 :     To know more about configured/Unconfigured features see: <a href="http://www.eclipse.org">
565 :     Configured/Unconfigued</a>
566 :     .<br>
567 :     </blockquote>
568 :    
569 :    
570 :    
571 :    
572 :     <h4>
573 :     Configuration History</h4>
574 :    
575 :    
576 :    
577 :    
578 :     <blockquote>
579 :     The Configuration History folder contains the last <i>n</i> configurations
580 :     you used. <i>n</i> is a number you can set in the Install/Update preference
581 :     page. See: <a href="http://www.eclipse.org">Install/Update Preference
582 :     Page</a>
583 :     .<br>
584 :     </blockquote>
585 :    
586 :    
587 :    
588 :    
589 :     <blockquote>
590 :     You can use the history list to see what are the different activities
591 :     that occurred as well as restoring an old configuration to make it the current
592 :     one.<br>
593 :     </blockquote>
594 :    
595 :    
596 :    
597 :    
598 :     <blockquote>
599 :      Install/Update creates a new configuration history when one or more
600 :     activities are performed (i.e. install, configure, unconfigure etc...).
601 :     When the Install/Update  creates a new configuration, it will add it to the
602 :     list. If you already have n configurations, the framework will automatically
603 :     delete  the oldest configuration from the list. To know when the Install/Update
604 :     creates new configuration history and what are the Activities see:  <a href="http://www.eclipse.org">
605 :     Configuration History</a>
606 :     .<br>
607 :     </blockquote>
608 :    
609 :    
610 :    
611 :    
612 :     <h4>
613 :     Preserved Configuration</h4>
614 :    
615 :    
616 :    
617 :    
618 :     <blockquote>
619 :     The Preserved Configurations folder contains history configurations
620 :     you want to keep. The framework does not automatically delete the configurations
621 :     in the Preserved Configurations folder, you have to explicitly delete
622 :     them.<br>
623 :    
624 :    
625 :     </blockquote>
626 :    
627 :    
628 :    
629 :    
630 :    
631 :     <h4>
632 :     Configured/Unconfigured</h4>
633 :    
634 :    
635 :    
636 :    
637 :    
638 :     <blockquote>
639 :    
640 :    
641 :    
642 :    
643 :    
644 :     <p class="MsoNormal">
645 :     You can decide to see only the configured features or both configured/unconfigured
646 :     features by clicking the 'Show Unconfigured Features' toggle button in
647 :     the view tool bar. To know more about configured/unconfigured features
648 :     see:
649 :     <a href="http://www.eclipse.org"> Configured/Unconfigued</a>
650 :     . </p>
651 :    
652 :    
653 :    
654 :     </blockquote>
655 :    
656 :    
657 :    
658 :    
659 :    
660 :     <h4>
661 :     Local View Toolbar Actions</h4>
662 :    
663 :    
664 :    
665 :    
666 :    
667 :     <h5>
668 :     Show Unconfigured Feature</h5>
669 :    
670 :    
671 :    
672 :    
673 :    
674 :     <blockquote>
675 :    
676 :    
677 :    
678 :    
679 :    
680 :     <p class="MsoNormal">
681 :     This button allows you to see only the configured features or both configured
682 :     and unconfigured features. Unconfigured features appear with a red circle
683 :     around the icon. For more information about configuring/unconfiguring features
684 :     see: <a href="http://www.eclipse.org">Configuring/Unconfiguring</a>
685 :     .<br>
686 :    
687 :     </p>
688 :    
689 :     </blockquote>
690 :    
691 :    
692 :    
693 :    
694 :    
695 :     <h4>
696 :     Context Actions</h4>
697 :    
698 :    
699 :    
700 :    
701 :    
702 :     <blockquote>
703 :     This section describes the different context actions available in
704 :     the Configuration View.<br>
705 :    
706 :     </blockquote>
707 :    
708 :    
709 :    
710 :    
711 :    
712 :     <h5>
713 :     Go Home</h5>
714 :    
715 :    
716 :    
717 :    
718 :    
719 :     <blockquote>
720 :     This action &lt;TODO be consistent with navigator&gt;<br>
721 :    
722 :     </blockquote>
723 :    
724 :    
725 :    
726 :    
727 :    
728 :     <h5>
729 :     Go Back</h5>
730 :    
731 :    
732 :    
733 :    
734 :    
735 :     <blockquote>
736 :     This action &lt;TODO be consistent with navigator&gt;<br>
737 :    
738 :     </blockquote>
739 :    
740 :    
741 :    
742 :    
743 :    
744 :     <h5>
745 :     Go Into</h5>
746 :    
747 :    
748 :    
749 :    
750 :    
751 :     <blockquote>
752 :     This action &lt;TODO be consistent with navigator&gt;<br>
753 :    
754 :     </blockquote>
755 :    
756 :    
757 :    
758 :    
759 :    
760 :     <h5>
761 :     Show Details</h5>
762 :    
763 :    
764 :    
765 :    
766 :    
767 :     <blockquote>
768 :     This action opens or refreshes the Preview View with the details of
769 :     the selected element.<br>
770 :    
771 :     </blockquote>
772 :    
773 :    
774 :    
775 :    
776 :    
777 :     <h5>
778 :     Properties</h5>
779 :    
780 :    
781 :    
782 :    
783 :    
784 :     <blockquote>
785 :     This opens a Dialog box that presents the label of the selected configuration.
786 :     You are able to change the label of a configuration. Click Ok when you
787 :     have finished and you want to preserve your changes or click Cancel if
788 :     you do not want to change the properties.<br>
789 :    
790 :     </blockquote>
791 :    
792 :    
793 :    
794 :    
795 :    
796 :     <h5>
797 :     Add to Preserved</h5>
798 :    
799 :    
800 :    
801 :    
802 :    
803 :     <blockquote>
804 :      This action adds the selected configuration in the Configuration History
805 :     folder to the list of preserved configuration.<br>
806 :    
807 :     </blockquote>
808 :    
809 :    
810 :    
811 :    
812 :    
813 :    
814 :     <h5>
815 :     Remove from Preserved</h5>
816 :    
817 :    
818 :    
819 :    
820 :    
821 :    
822 :     <blockquote>
823 :     This action removes the selected configuration from the list of preserved
824 :     configurations. This action will not delete any Site, Site Bookmark or
825 :     Feature. This action will not delete the configuration it was created from
826 :     or any other configuration.<br>
827 :    
828 :     </blockquote>
829 :    
830 :    
831 :    
832 :    
833 :    
834 :    
835 :     <h5>
836 :     Restore</h5>
837 :    
838 :    
839 :    
840 :    
841 :    
842 :    
843 :     <blockquote>
844 :      This action creates a new configuration based on the selected configuration
845 :     and marks it as current. Install/Update will automatically configure all
846 :     the features that were configured in the selected configuration you want
847 :     to restore. To know more about restoring or reverting to a configuration
848 :     see:
849 :     <a href="http://www.eclipse.org"> Restore a Configuration/Revert
850 :     to previous configuration</a>
851 :     .<br>
852 :    
853 :     </blockquote>
854 :    
855 :    
856 :    
857 :    
858 :    
859 :    
860 :     <h3>
861 :     The Updates View</h3>
862 :    
863 :    
864 :    
865 :    
866 :    
867 :    
868 :     <blockquote>
869 :     The Updates view allows you to manage the remote sites you can install
870 :     from to search for features as well as features you can install. <br>
871 :    
872 :     <img src="images/pic007.gif" alt="Updates View" width="251" height="249">
873 :    
874 :     <br>
875 :    
876 :     </blockquote>
877 :    
878 :    
879 :    
880 :    
881 :    
882 :    
883 :     <h4>
884 :     My Computer</h4>
885 :    
886 :    
887 :    
888 :    
889 :    
890 :    
891 :     <blockquote>
892 :     My Computer lets you browse your computer and any mounted local file
893 :     to discover any site on your file system. You can also search My Computer
894 :     to discover sites: see <a href="http://www.eclipse.org">Search the file
895 :     system</a>
896 :     .<br>
897 :    
898 :     </blockquote>
899 :    
900 :    
901 :    
902 :    
903 :    
904 :    
905 :     <h4>
906 :     Places to Visit</h4>
907 :    
908 :    
909 :    
910 :    
911 :    
912 :    
913 :     <blockquote>
914 :     Places to visit are sites suggested by the features you installed for
915 :     you to visit. <br>
916 :    
917 :     </blockquote>
918 :    
919 :    
920 :    
921 :    
922 :    
923 :    
924 :     <p class="MsoNormal">
925 :     </p>
926 :    
927 :    
928 :    
929 :    
930 :    
931 :    
932 :     <h4>
933 :     Available Updates</h4>
934 :    
935 :    
936 :    
937 :    
938 :    
939 :    
940 :     <blockquote>
941 :     Available Updates will let you search for updates of already installed
942 :     features. The search occurs in the background so you can still use the
943 :     workbench while searching for updates. To know more about searching: see
944 :     <a href="http://www.eclipse.org">
945 :     Search</a>
946 :     .<br>
947 :    
948 :     </blockquote>
949 :    
950 :    
951 :    
952 :    
953 :    
954 :    
955 :     <h4>
956 :     Sites Bookmark</h4>
957 :    
958 :    
959 :    
960 :    
961 :    
962 :    
963 :     <blockquote>
964 :    
965 :    
966 :    
967 :    
968 :    
969 :    
970 :     <p class="MsoNormal">
971 :     A site is a location that contains features. In the Updates View, the
972 :     sites contain features you can install. You can browse or search features
973 :     in Site bookmarks. There are two ways of adding a site bookmark. You can
974 :     use the context menu and the context action add site bookmarks, or you
975 :     may browse My Computer and add a site as a site bookmark. See <a href="http://www.eclipse.org">
976 :     Context Action</a>
977 :     for more details. <br>
978 :    
979 :     </p>
980 :    
981 :     </blockquote>
982 :    
983 :    
984 :    
985 :    
986 :    
987 :    
988 :     <h4>
989 :     Search</h4>
990 :    
991 :    
992 :    
993 :    
994 :    
995 :    
996 :     <blockquote>
997 :    
998 :    
999 :    
1000 :    
1001 :    
1002 :    
1003 :     <p class="MsoNormal">
1004 :     Search is a bookmark for a specific query that will retrieve features from
1005 :     update sites. You can create a new specific query based on a template or
1006 :     execute the query to fetch the features from the desired update sites. You
1007 :     can also query your local file system. The resulting features appear on the
1008 :     same search preview than the query. To know more about how to create your
1009 :     own query: see <a href="http://www.eclipse.org">Context Action [new-&gt;Search]</a>
1010 :     . To know how to search the file system: see <a href="http://www.eclipse.org">
1011 :     Search the file system</a>
1012 :     . To search for availables updates: see <a href="http://www.eclipse.org">
1013 :     Update Already Existing Fetaures</a>
1014 :     . To search for new features: see <a href="http://www.eclipse.org">Finding
1015 :     New Features</a>
1016 :     . To know more about the search Preview View: see <a href="http://www.eclipse.org">
1017 :     Search Preview View</a>
1018 :     .<br>
1019 :    
1020 :     </p>
1021 :    
1022 :     </blockquote>
1023 :    
1024 :    
1025 :    
1026 :    
1027 :    
1028 :    
1029 :     <h4>
1030 :     Folder</h4>
1031 :    
1032 :    
1033 :    
1034 :    
1035 :    
1036 :    
1037 :     <blockquote>
1038 :    
1039 :    
1040 :    
1041 :    
1042 :    
1043 :    
1044 :    
1045 :     <p class="MsoNormal">
1046 :     Folders are placeholders in the Updates View. They are used to help you categorize
1047 :     and organize the view. Folders can contain folders, update sites and/or searches.
1048 :     You chan change the label of a folder. To know more about how to create a
1049 :     folder see: <a href="http://www.eclipse.org">Context Action [new-&gt;folder]</a>
1050 :     .</p>
1051 :    
1052 :     </blockquote>
1053 :    
1054 :    
1055 :    
1056 :    
1057 :    
1058 :    
1059 :    
1060 :     <h4>
1061 :     Local View Toolbar Actions</h4>
1062 :    
1063 :    
1064 :    
1065 :    
1066 :    
1067 :    
1068 :    
1069 :     <blockquote>
1070 :     This section describes the local view toolbar actions of the Updates
1071 :     View.<br>
1072 :    
1073 :     </blockquote>
1074 :    
1075 :    
1076 :    
1077 :    
1078 :    
1079 :    
1080 :    
1081 :     <h5>
1082 :     Show Feature Categories </h5>
1083 :    
1084 :    
1085 :    
1086 :    
1087 :    
1088 :    
1089 :    
1090 :     <blockquote>
1091 :     When this action is selected,  you will see the features organized in
1092 :     categories.<br>
1093 :    
1094 :     <img src="images/pic008.gif" alt="Categories" width="253" height="193">
1095 :    
1096 :     <br>
1097 :    
1098 :     <br>
1099 :     When this action is not selected, you will see all the features as a list.<br>
1100 :    
1101 :     <img src="images/pic008b.gif" alt="No Categories" width="253" height="97">
1102 :    
1103 :     </blockquote>
1104 :    
1105 :    
1106 :    
1107 :    
1108 :    
1109 :    
1110 :    
1111 :     <h5>
1112 :     Show My Computer Files </h5>
1113 :    
1114 :    
1115 :    
1116 :    
1117 :    
1118 :    
1119 :    
1120 :     <blockquote>
1121 :     When this action is seelcted, you will be able to browse the files when
1122 :     you expand MyComputer.<br>
1123 :    
1124 :     <img src="images/pic009.gif" alt="Browse Files" width="251" height="249">
1125 :    
1126 :     <br>
1127 :    
1128 :     </blockquote>
1129 :    
1130 :    
1131 :    
1132 :    
1133 :    
1134 :    
1135 :    
1136 :     <h4>
1137 :     Context Actions</h4>
1138 :    
1139 :    
1140 :    
1141 :    
1142 :    
1143 :    
1144 :    
1145 :     <blockquote>
1146 :     This section describes the different context actions available in the
1147 :     Updates View.
1148 :     </blockquote>
1149 :    
1150 :    
1151 :    
1152 :    
1153 :    
1154 :    
1155 :    
1156 :     <h5>
1157 :     New-&gt;Site Bookmark...</h5>
1158 :    
1159 :    
1160 :    
1161 :    
1162 :    
1163 :    
1164 :    
1165 :     <blockquote>
1166 :    
1167 :    
1168 :    
1169 :    
1170 :    
1171 :    
1172 :    
1173 :     <p class="MsoNormal">
1174 :     Creates a new Site bookmark. This opens a Dialog box that presents the
1175 :     properties of the Bookmark Site you want to create. The properties of a
1176 :     Bookmark Site are the label you want to see in the View as well as the Address
1177 :     of the physical site. You have to enter the Site URL. Optionally you can enter
1178 :     the Site Name. If you o not enter a Site Name, it will default to the Site
1179 :     URL. Click Ok when you have finished and you want to preserve your changes
1180 :     or click Cancel if you do not want to create a new Site Bookmark.<br>
1181 :    
1182 :     </p>
1183 :    
1184 :     </blockquote>
1185 :    
1186 :    
1187 :    
1188 :    
1189 :    
1190 :    
1191 :    
1192 :     <h5>
1193 :     New-&gt;Folder</h5>
1194 :    
1195 :    
1196 :    
1197 :    
1198 :    
1199 :    
1200 :    
1201 :     <blockquote>
1202 :     This action lets you create a new Folder. When you select this action,
1203 :     a dialog will open.<br>
1204 :    
1205 :     <img src="images/pic011.gif" alt="New Folder Dialog" width="438" height="481">
1206 :    
1207 :     <br>
1208 :    
1209 :     <br>
1210 :     Type the label of the folder in the 'Name;' entry field.<br>
1211 :     Type the name of the parent folder in the 'Create in:' entry field, or
1212 :     select it in the 'Existing folders:' tree view. If no parent are selected,
1213 :     the newly created folder will appear in the updates view as a root folder.<br>
1214 :    
1215 :     <img src="images/pic010.gif" alt="folders" width="251" height="249">
1216 :     <img src="pic010.gif" alt="folders">
1217 :    
1218 :     <br>
1219 :    
1220 :     </blockquote>
1221 :    
1222 :    
1223 :    
1224 :    
1225 :    
1226 :    
1227 :    
1228 :     <h5>
1229 :     New-&gt;Search</h5>
1230 :    
1231 :    
1232 :    
1233 :    
1234 :    
1235 :    
1236 :    
1237 :     <blockquote>
1238 :     This action will create a new Search. It will open a dialog window.  Enter
1239 :     the name of the search you desire in Name. Select the folder you want the
1240 :     Search to appear in by selecting the appropriate folder under the existing
1241 :     folders tree or by typing its name in the Create in entry field. Open the
1242 :     Category combo box and select the search you want. You can change the category
1243 :     of a search after it has been created: see <a href="http://www.eclipse.org">
1244 :     Search Preview View</a>
1245 :     . Click finish to close the dialog and create the search or click Cancel
1246 :     to close the dialog and abort the creation. To know more about the different
1247 :     type of search: see <a href="http://www.eclipse.org">Searching New Features</a>
1248 :     .<br>
1249 :    
1250 :     </blockquote>
1251 :    
1252 :    
1253 :    
1254 :    
1255 :    
1256 :    
1257 :    
1258 :     <h5>
1259 :     Show Details</h5>
1260 :    
1261 :    
1262 :    
1263 :    
1264 :    
1265 :    
1266 :    
1267 :     <blockquote>
1268 :    
1269 :    
1270 :    
1271 :    
1272 :    
1273 :    
1274 :    
1275 :     <p class="MsoNormal">
1276 :     This action opens or refreshes the Preview View with the details of
1277 :     the selected element.<br>
1278 :     </p>
1279 :    
1280 :     </blockquote>
1281 :    
1282 :    
1283 :    
1284 :    
1285 :    
1286 :    
1287 :    
1288 :     <h5>
1289 :     Refresh</h5>
1290 :    
1291 :    
1292 :    
1293 :    
1294 :    
1295 :    
1296 :    
1297 :     <blockquote>
1298 :     This action re-initializes the content of an element &lt;TODO see dejan&gt;<br>
1299 :    
1300 :     </blockquote>
1301 :    
1302 :    
1303 :    
1304 :    
1305 :    
1306 :    
1307 :    
1308 :     <h5>
1309 :     Bookmark Location</h5>
1310 :    
1311 :    
1312 :    
1313 :    
1314 :    
1315 :    
1316 :    
1317 :     <blockquote>
1318 :     This action lets you create bookmark site for a site found on your local
1319 :     file system. This opens a Dialog box that presents the properties of the
1320 :     selected site. The properties of a Site are the label you want to see in
1321 :     the View as well as the Address of the site. You are able to change the
1322 :     Site Name. Click Ok when you have finished and you want to preserve your
1323 :     changes or click Cancel if you do not want to change the properties.<br>
1324 :    
1325 :     </blockquote>
1326 :    
1327 :    
1328 :    
1329 :    
1330 :    
1331 :    
1332 :    
1333 :    
1334 :     <h5>
1335 :     Properties</h5>
1336 :    
1337 :    
1338 :    
1339 :    
1340 :    
1341 :    
1342 :    
1343 :    
1344 :     <blockquote>
1345 :     This action opens a Dialog box that presents the properties of the selected
1346 :     site. The properties of a Site are the label you want to see in the View
1347 :     as well as the Address of the site. If the element you selected was a bookmark,
1348 :     you are able to change both the Site Name and the Site Address of the site.
1349 :     If you change the Site Address of a Bookmark Site you will need to 'refresh'
1350 :     the Bookmark Site to access its new content. Click Ok when you have finished
1351 :     and you want to preserve your changes or click Cancel if you do not want
1352 :     to change the properties.<br>
1353 :    
1354 :     </blockquote>
1355 :    
1356 :    
1357 :    
1358 :    
1359 :    
1360 :    
1361 :    
1362 :    
1363 :     <h5>
1364 :     Delete</h5>
1365 :    
1366 :    
1367 :    
1368 :    
1369 :    
1370 :    
1371 :    
1372 :    
1373 :     <blockquote>
1374 :     This action removes the Bookmark Site from the workbench. This does
1375 :     not erase the content of the Site nor the physical remote or local Site
1376 :     itself.<br>
1377 :    
1378 :     </blockquote>
1379 :    
1380 :    
1381 :    
1382 :    
1383 :    
1384 :    
1385 :    
1386 :    
1387 :     <h3>
1388 :     The WebView</h3>
1389 :    
1390 :    
1391 :    
1392 :    
1393 :    
1394 :    
1395 :    
1396 :    
1397 :     <blockquote>
1398 :     The Web View is &lt;TODO &gt;<br>
1399 :    
1400 :     </blockquote>
1401 :    
1402 :    
1403 :    
1404 :    
1405 :    
1406 :    
1407 :    
1408 :    
1409 :     <h3>
1410 :     The flat concept (see Dejan)</h3>
1411 :    
1412 :    
1413 :    
1414 :    
1415 :    
1416 :    
1417 :    
1418 :    
1419 :     <blockquote>
1420 :     &lt;TODO&gt;<br>
1421 :    
1422 :     </blockquote>
1423 :    
1424 :    
1425 :    
1426 :    
1427 :    
1428 :    
1429 :    
1430 :    
1431 :     <h3>
1432 :     The Preview View</h3>
1433 :    
1434 :    
1435 :    
1436 :    
1437 :    
1438 :    
1439 :    
1440 :    
1441 :     <blockquote>
1442 :     The preview shows information about the selected element. The preview
1443 :     view is different for each selected element.<br>
1444 :    
1445 :     </blockquote>
1446 :    
1447 :    
1448 :    
1449 :    
1450 :    
1451 :    
1452 :    
1453 :    
1454 :     <h4>
1455 :     </h4>
1456 :    
1457 :    
1458 :    
1459 :    
1460 :    
1461 :    
1462 :    
1463 :    
1464 :     <blockquote>
1465 :     You can open the preview view by either selecting an element in the
1466 :     updates or Configuration view, by opening a context menu on any element
1467 :     in the Updates or Configuration View and selecting Show Details or by open
1468 :     the Preview View from the Workbench menu. Select Window-&gt;Show View-&gt;Other
1469 :     to open the list of available Views. Expand Update Manager Folder, select
1470 :     Preview and Click Ok.<br>
1471 :    
1472 :     </blockquote>
1473 :    
1474 :    
1475 :    
1476 :    
1477 :    
1478 :    
1479 :    
1480 :    
1481 :     <h4>
1482 :     The 'Home' Preview view.</h4>
1483 :    
1484 :    
1485 :    
1486 :    
1487 :    
1488 :    
1489 :    
1490 :    
1491 :     <blockquote>
1492 :     You can open the 'Home' Preview by clicking on the home in the local
1493 :     tool bar menu if the View. This view summarizes the different tasks you
1494 :     can achieve through the Install/Update. By using the flat concept you are
1495 :     able to &lt;TODO link&gt;<br>
1496 :    
1497 :    
1498 :    
1499 :    
1500 :     <div align="Center"><img src="images/pic012.gif" alt="Home Preview" width="507" height="503">
1501 :    
1502 :    
1503 :     <br>
1504 :    
1505 :     </div>
1506 :    
1507 :    
1508 :     </blockquote>
1509 :    
1510 :    
1511 :    
1512 :    
1513 :    
1514 :    
1515 :    
1516 :    
1517 :     <h4>
1518 :     The current configuration Preview view</h4>
1519 :    
1520 :    
1521 :    
1522 :    
1523 :    
1524 :    
1525 :    
1526 :    
1527 :     <blockquote>
1528 :     This Preview shows information about the product you are using. The
1529 :     content of the view depends on the product you launched. <br>
1530 :    
1531 :    
1532 :    
1533 :    
1534 :    
1535 :     <div align="Center"><img src="images/pic012b.gif" alt="product preview" width="507" height="503">
1536 :    
1537 :    
1538 :     <br>
1539 :    
1540 :    
1541 :     </div>
1542 :    
1543 :    
1544 :     </blockquote>
1545 :    
1546 :    
1547 :    
1548 :    
1549 :    
1550 :    
1551 :    
1552 :    
1553 :     <h4>
1554 :     The Site and Site Bookmark Preview View</h4>
1555 :    
1556 :    
1557 :    
1558 :    
1559 :    
1560 :    
1561 :    
1562 :    
1563 :     <blockquote>
1564 :     This Preview shows the Site Address of the selected Site or Bookmark
1565 :     Site.<br>
1566 :    
1567 :    
1568 :    
1569 :    
1570 :    
1571 :     <div align="Center"><img src="images/pic012c.gif" alt="Site Preview" width="507" height="503">
1572 :    
1573 :    
1574 :     <br>
1575 :    
1576 :    
1577 :    
1578 :    
1579 :     </div>
1580 :    
1581 :    
1582 :     </blockquote>
1583 :    
1584 :    
1585 :    
1586 :    
1587 :    
1588 :    
1589 :    
1590 :    
1591 :    
1592 :     <h4>
1593 :     The Feature Preview View</h4>
1594 :    
1595 :    
1596 :    
1597 :    
1598 :    
1599 :    
1600 :    
1601 :    
1602 :    
1603 :     <blockquote>
1604 :     This Preview View shows information about a feature.<br>
1605 :    
1606 :    
1607 :    
1608 :    
1609 :    
1610 :     <div align="Center"><img src="images/pic012d.gif" alt="Feature Preview" width="507" height="669">
1611 :      
1612 :    
1613 :     <br>
1614 :    
1615 :    
1616 :     </div>
1617 :    
1618 :    
1619 :     </blockquote>
1620 :    
1621 :    
1622 :    
1623 :    
1624 :    
1625 :    
1626 :    
1627 :    
1628 :    
1629 :     <h5>
1630 :     Provider</h5>
1631 :    
1632 :    
1633 :    
1634 :    
1635 :    
1636 :    
1637 :    
1638 :    
1639 :    
1640 :     <blockquote>
1641 :     The name of the provider of the feature.<br>
1642 :    
1643 :    
1644 :     </blockquote>
1645 :    
1646 :    
1647 :    
1648 :    
1649 :    
1650 :    
1651 :    
1652 :    
1653 :    
1654 :     <h5>
1655 :     Version</h5>
1656 :    
1657 :    
1658 :    
1659 :    
1660 :    
1661 :    
1662 :    
1663 :    
1664 :    
1665 :     <blockquote>
1666 :     The version of the feature.<br>
1667 :    
1668 :    
1669 :     </blockquote>
1670 :    
1671 :    
1672 :    
1673 :    
1674 :    
1675 :    
1676 :    
1677 :    
1678 :    
1679 :     <h5>
1680 :     Installed Version</h5>
1681 :    
1682 :    
1683 :    
1684 :    
1685 :    
1686 :    
1687 :    
1688 :    
1689 :    
1690 :     <blockquote>
1691 :     The list of already installed version of this feature or 'Not Installed'
1692 :     if no version of this feature has been configured in the current configuration.<br>
1693 :    
1694 :    
1695 :     </blockquote>
1696 :    
1697 :    
1698 :    
1699 :    
1700 :    
1701 :    
1702 :    
1703 :    
1704 :    
1705 :     <h5>
1706 :     Download Size</h5>
1707 :    
1708 :    
1709 :    
1710 :    
1711 :    
1712 :    
1713 :    
1714 :    
1715 :    
1716 :     <blockquote>
1717 :     The maximum download size for the feature. If the site you will install
1718 :     the feature in already contains some of the files the feature require, the
1719 :     files will not be installed twice, and thus the downloaded and installed
1720 :     size will be smaller than the maximum one.<br>
1721 :    
1722 :    
1723 :     </blockquote>
1724 :    
1725 :    
1726 :    
1727 :    
1728 :    
1729 :    
1730 :    
1731 :    
1732 :    
1733 :     <h5>
1734 :     Supported Platforms</h5>
1735 :    
1736 :    
1737 :    
1738 :    
1739 :    
1740 :    
1741 :    
1742 :    
1743 :    
1744 :     <blockquote>
1745 :     This expandable category shows the different supported platforms for
1746 :     this feature. The categories are Operating Systems, Windowing Systems, Architectures
1747 :     and Languages.<br>
1748 :    
1749 :    
1750 :     </blockquote>
1751 :    
1752 :    
1753 :    
1754 :    
1755 :    
1756 :    
1757 :    
1758 :    
1759 :    
1760 :     <ul>
1761 :    
1762 :    
1763 :     <li> Operating Systems: the list of supported Operating
1764 :     Systems.</li>
1765 :    
1766 :    
1767 :     <li> Windowing Systems: the list of supported Windowing
1768 :     Systems.</li>
1769 :    
1770 :    
1771 :     <li> Supported Architectures: the list of supported processor
1772 :     architecture.</li>
1773 :    
1774 :    
1775 :     <li> Supported Languages: the list of supported languages.<br>
1776 :     </li>
1777 :    
1778 :    
1779 :    
1780 :    
1781 :    
1782 :    
1783 :    
1784 :    
1785 :    
1786 :     </ul>
1787 :    
1788 :    
1789 :    
1790 :    
1791 :    
1792 :    
1793 :    
1794 :    
1795 :    
1796 :     <h5>
1797 :     Description </h5>
1798 :    
1799 :    
1800 :    
1801 :    
1802 :    
1803 :    
1804 :    
1805 :    
1806 :    
1807 :     <p class="MsoNormal">
1808 :     The description of the Feature<br>
1809 :     <br>
1810 :    
1811 :    
1812 :     </p>
1813 :    
1814 :    
1815 :    
1816 :    
1817 :    
1818 :    
1819 :    
1820 :    
1821 :    
1822 :     <h5>
1823 :     More Info &lt;TODO should we say it is optional ?&gt;</h5>
1824 :    
1825 :    
1826 :    
1827 :    
1828 :    
1829 :    
1830 :    
1831 :    
1832 :    
1833 :     <blockquote>
1834 :     Opens a page with more information about the feature. The page may be
1835 :     found locally or remotely.<br>
1836 :    
1837 :    
1838 :     </blockquote>
1839 :    
1840 :    
1841 :    
1842 :    
1843 :    
1844 :    
1845 :    
1846 :    
1847 :    
1848 :     <h5>
1849 :     License</h5>
1850 :    
1851 :    
1852 :    
1853 :    
1854 :    
1855 :    
1856 :    
1857 :    
1858 :    
1859 :     <blockquote>
1860 :     Opens a page with the license of the Feature.<br>
1861 :    
1862 :    
1863 :     </blockquote>
1864 :    
1865 :    
1866 :    
1867 :    
1868 :    
1869 :    
1870 :    
1871 :    
1872 :    
1873 :     <h5>
1874 :     Copyright</h5>
1875 :    
1876 :    
1877 :    
1878 :    
1879 :    
1880 :    
1881 :    
1882 :    
1883 :    
1884 :     <blockquote>
1885 :    
1886 :    
1887 :    
1888 :    
1889 :    
1890 :    
1891 :    
1892 :    
1893 :    
1894 :    
1895 :     <p class="MsoNormal">
1896 :     Opens a page with the copyright of the Feature.<br>
1897 :    
1898 :    
1899 :     </p>
1900 :    
1901 :    
1902 :     </blockquote>
1903 :    
1904 :    
1905 :    
1906 :    
1907 :    
1908 :    
1909 :    
1910 :    
1911 :    
1912 :    
1913 :     <h5>
1914 :     Actions</h5>
1915 :    
1916 :    
1917 :    
1918 :    
1919 :    
1920 :    
1921 :    
1922 :    
1923 :    
1924 :    
1925 :     <blockquote>
1926 :    
1927 :    
1928 :    
1929 :    
1930 :    
1931 :    
1932 :    
1933 :    
1934 :    
1935 :    
1936 :     <p class="MsoNormal">
1937 :     In the lower left side of the Preview View for a feature you may see
1938 :     one or multiple buttons. They provide you with actions you can take on
1939 :     the Feature depending of its configuration. If a change is pending for
1940 :     this feature, no actions will be available until the workbench is restarted.<br>
1941 :    
1942 :    
1943 :     </p>
1944 :    
1945 :    
1946 :     </blockquote>
1947 :    
1948 :    
1949 :    
1950 :    
1951 :    
1952 :    
1953 :    
1954 :    
1955 :    
1956 :    
1957 :     <ul>
1958 :    
1959 :    
1960 :     <li> <span style="mso-spacerun: yes"></span>Install:
1961 :     this launches the Install Wizard for this feature. See <a href="http://www.eclipse.org">
1962 :     Installing a Feature</a>
1963 :     .<br>
1964 :    
1965 :    
1966 :     </li>
1967 :    
1968 :    
1969 :     <li> Unconfigure: this launches the Unconfigure
1970 :     Wizard for this configured feature. See <a href="http://www.eclipse.org">
1971 :     Configuring/Unconfiguring a Feature</a>
1972 :     .<br>
1973 :     Configure: this launches the Configure Wizard for this unconfigured
1974 :     feature. See <a href="http://www.eclipse.org">Configuring/Unconfiguring
1975 :     a Feature</a>
1976 :     .<br>
1977 :     Uninstall: this removes the unconfigure feature from the file system.
1978 :     See <a href="http://www.eclipse.org">Removing a Feature</a>
1979 :     .</li>
1980 :    
1981 :    
1982 :    
1983 :    
1984 :    
1985 :    
1986 :    
1987 :    
1988 :    
1989 :    
1990 :     </ul>
1991 :    
1992 :    
1993 :    
1994 :    
1995 :    
1996 :    
1997 :    
1998 :    
1999 :    
2000 :    
2001 :     <h4>
2002 :     The Configuration Preview View</h4>
2003 :    
2004 :    
2005 :    
2006 :    
2007 :    
2008 :    
2009 :    
2010 :    
2011 :    
2012 :    
2013 :     <blockquote>
2014 :    
2015 :    
2016 :    
2017 :    
2018 :    
2019 :    
2020 :    
2021 :    
2022 :    
2023 :    
2024 :     <p class="MsoNormal">
2025 :     This preview shows information about the select configuration.<br>
2026 :    
2027 :    
2028 :     </p>
2029 :    
2030 :    
2031 :    
2032 :     <div align="Center"><img src="images/pic013.gif" alt="Configuration Preview" width="621" height="488">
2033 :    
2034 :    
2035 :     <br>
2036 :    
2037 :    
2038 :     </div>
2039 :    
2040 :    
2041 :     </blockquote>
2042 :    
2043 :    
2044 :    
2045 :     <p class="MsoNormal"><br>
2046 :    
2047 :    
2048 :     </p>
2049 :    
2050 :    
2051 :    
2052 :     <h5>
2053 :     Created On</h5>
2054 :    
2055 :    
2056 :    
2057 :     <blockquote>
2058 :    
2059 :    
2060 :    
2061 :     <p class="MsoNormal">
2062 :     The date in the current locale, the configuration was created on.<br>
2063 :    
2064 :    
2065 :     </p>
2066 :    
2067 :    
2068 :     </blockquote>
2069 :    
2070 :    
2071 :    
2072 :     <h5>
2073 :     Current Configuration</h5>
2074 :    
2075 :    
2076 :    
2077 :     <blockquote>
2078 :    
2079 :    
2080 :    
2081 :     <p class="MsoNormal">
2082 :     If the selected configuration is the active configuration.<br>
2083 :    
2084 :    
2085 :     </p>
2086 :    
2087 :    
2088 :     </blockquote>
2089 :    
2090 :    
2091 :    
2092 :     <h5>
2093 :     Activities</h5>
2094 :    
2095 :    
2096 :    
2097 :     <blockquote>
2098 :     List of activities that led to the creation of the configuration. For more
2099 :     information about the differents activities, see <a href="http://www.eclipse.org">
2100 :     Activities</a>
2101 :     .<br>
2102 :    
2103 :    
2104 :     </blockquote>
2105 :    
2106 :    
2107 :    
2108 :     <p class="MsoNormal"></p>
2109 :    
2110 :    
2111 :    
2112 :     <h5>
2113 :     Configuration Reversal</h5>
2114 :    
2115 :    
2116 :    
2117 :    
2118 :    
2119 :    
2120 :    
2121 :    
2122 :    
2123 :    
2124 :     <blockquote>
2125 :     In the lower left side of the Preview View for a configuration you may
2126 :     see one button. It provides you with actions you can take on the Configuration
2127 :     depending if it is the current configuration or another one. If a change
2128 :     is pending for a feature, no actions will be available until the workbench
2129 :     is restarted.</blockquote>
2130 :    
2131 :    
2132 :    
2133 :    
2134 :    
2135 :    
2136 :    
2137 :    
2138 :    
2139 :    
2140 :     <ul>
2141 :    
2142 :    
2143 :     <li> Restore: this restores the selected configuration.
2144 :     See <a href="http://www.eclipse.org"> Restore a Configuration/Revert to previous
2145 :     configuration</a>
2146 :     .<br>
2147 :    
2148 :    
2149 :     </li>
2150 :    
2151 :    
2152 :     <li> Revert: this revert the current configuration
2153 :     to the previous configuration. See <a href="http://www.eclipse.org">Restore
2154 :     a Configuration/Revert to previous configuration</a>
2155 :     .</li>
2156 :    
2157 :    
2158 :    
2159 :    
2160 :    
2161 :    
2162 :    
2163 :    
2164 :    
2165 :    
2166 :     </ul>
2167 :    
2168 :    
2169 :    
2170 :    
2171 :    
2172 :    
2173 :    
2174 :    
2175 :    
2176 :    
2177 :     <p class="MsoNormal"></p>
2178 :    
2179 :    
2180 :    
2181 :    
2182 :    
2183 :    
2184 :    
2185 :    
2186 :    
2187 :    
2188 :     <h4>
2189 :     The search Preview View</h4>
2190 :     <blockquote>
2191 :    
2192 :    
2193 :    
2194 :    
2195 :    
2196 :    
2197 :    
2198 :    
2199 :    
2200 :     This view allows you to change the search
2201 :     query, enter the appropriate settings for the query, set the scope of the
2202 :     serahc, run the query and see the result of the query. The settings  are
2203 :     different for each query.<br>
2204 :     </blockquote>
2205 :     <h5>
2206 :     Change the query</h5>
2207 :     <blockquote>
2208 :     To change the category of the query, expand Query Settings. Expand the Search
2209 :     Category Settings and select the desired search category.<br>
2210 :     </blockquote>
2211 :     <h5>
2212 :     Enter the settings</h5>
2213 :     <blockquote>
2214 :     Each category has its own settings. For more information about the different
2215 :     settings for a category: see <a href="http://www.eclipse.org">Searching New
2216 :     Features</a>
2217 :     .<br>
2218 :     </blockquote>
2219 :     <h5>
2220 :     Set the scope</h5>
2221 :     <blockquote>
2222 :     To change the scope of the search, expand Scope Settings. You can select
2223 :     to search the local file system, the discovery sites in 'places to visit'
2224 :     and/or the bookmarked sites you created. When searching the local file system,
2225 :     click Settings to select which root folder will be searched.<br>
2226 :     </blockquote>
2227 :     <h5>
2228 :     Run the query</h5>
2229 :     <blockquote>
2230 :     Click Search Now to run the query.<br>
2231 :     </blockquote>
2232 :     <h5>
2233 :     See the results</h5>
2234 :     <blockquote>
2235 :     The result will appear at the bottom of the View. Select  Show Results in
2236 :     Extended Form to have more information about the features.<br>
2237 :     </blockquote>
2238 :    
2239 :    
2240 :    
2241 :    
2242 :    
2243 :    
2244 :    
2245 :    
2246 :    
2247 :    
2248 :    
2249 :    
2250 :     <h3>
2251 :     The Install/Update Preference Page</h3>
2252 :    
2253 :    
2254 :    
2255 :    
2256 :    
2257 : celek 1.2
2258 :    
2259 :    
2260 :    
2261 : celek 1.4
2262 :     <blockquote>
2263 :     You can open the preference page from the Workbench main menu. Click
2264 :      Window-&gt;preferences to open the Preference Dialog. Select Install/Update
2265 :     to reveal the Install/Update preference Page. In this page, you can modify
2266 :     the number of history configuration you want the workbench to manage as
2267 :     well as decide which browser to open .<br>
2268 : celek 1.2
2269 :    
2270 : celek 1.4 </blockquote>
2271 : celek 1.2
2272 :    
2273 :    
2274 :    
2275 :    
2276 :    
2277 :    
2278 :    
2279 :    
2280 : celek 1.4
2281 :     <p class="MsoNormal"></p>
2282 : celek 1.2
2283 :    
2284 :    
2285 :    
2286 :    
2287 :    
2288 :    
2289 :    
2290 :    
2291 : celek 1.4
2292 :     <h4>
2293 :     Maximum number of 'History' configurations entry field.<br>
2294 : celek 1.2
2295 :    
2296 : celek 1.4 </h4>
2297 : celek 1.2
2298 :    
2299 :    
2300 :    
2301 :    
2302 :    
2303 :    
2304 :    
2305 :    
2306 : celek 1.4
2307 :     <blockquote>
2308 :     Enter the number of history configurations you want the Install/Update
2309 :     to keep. See <a href="http://www.eclipse.org">Configuration History</a>
2310 :     for more information.<br>
2311 : celek 1.2
2312 :    
2313 : celek 1.4 </blockquote>
2314 : celek 1.2
2315 :    
2316 :    
2317 :    
2318 :    
2319 :    
2320 :    
2321 :    
2322 :    
2323 : celek 1.4
2324 :     <h4>
2325 :     Web Links radio buttons.</h4>
2326 : celek 1.2
2327 :    
2328 :    
2329 :    
2330 :    
2331 :    
2332 :    
2333 :    
2334 :    
2335 : celek 1.4
2336 :     <blockquote>
2337 :     When opening Web links. Allows you to choose between opening the internal
2338 :     WebView or opening an external browser.<br>
2339 : celek 1.2
2340 :    
2341 : celek 1.4 </blockquote>
2342 : celek 1.2
2343 :    
2344 :    
2345 :    
2346 :    
2347 :    
2348 :    
2349 :    
2350 :    
2351 : celek 1.4
2352 :     <h2>
2353 :     Finding features</h2>
2354 : celek 1.2
2355 :    
2356 :    
2357 :    
2358 :    
2359 :    
2360 :    
2361 :    
2362 :    
2363 : celek 1.4
2364 :     <blockquote>
2365 :     This section will explain how to find the features  to install. There
2366 :     are different way of looking for features; you may know exactly which feature
2367 :     you need and where it is located, or you may want to search for an update
2368 :     of an already installed feature is available, finally you may just decide
2369 :     to browse or search to discover new sites and new features. <br>
2370 : celek 1.2
2371 :    
2372 : celek 1.4 </blockquote>
2373 : celek 1.2
2374 :    
2375 :    
2376 :    
2377 :    
2378 :    
2379 :    
2380 :    
2381 :    
2382 :    
2383 : celek 1.4
2384 :     <h3>
2385 :     Find a specific feature </h3>
2386 : celek 1.2
2387 :    
2388 :    
2389 :    
2390 :    
2391 :    
2392 :    
2393 :    
2394 :    
2395 :    
2396 : celek 1.4
2397 :     <blockquote>
2398 : celek 1.2
2399 :    
2400 :    
2401 :    
2402 :    
2403 :    
2404 :    
2405 :    
2406 :    
2407 :    
2408 : celek 1.4
2409 :     <p class="MsoNormal">
2410 :     This section will focus on finding a feature when you know exactly where
2411 :     to find it. To find a feature you may either add the Update Site that
2412 :     contains this feature and browse the site to find the feature or you can
2413 :     open the WebView and browe to the Feature WebPage.</p>
2414 : celek 1.2
2415 :    
2416 : celek 1.4 </blockquote>
2417 : celek 1.2
2418 :    
2419 :    
2420 :    
2421 :    
2422 :    
2423 :    
2424 :    
2425 :    
2426 :    
2427 : celek 1.4
2428 :     <h4>
2429 :     Add a new Update Site </h4>
2430 : celek 1.2
2431 :    
2432 :    
2433 :    
2434 :    
2435 :    
2436 :    
2437 :    
2438 :    
2439 :    
2440 : celek 1.4
2441 :     <blockquote>
2442 : celek 1.2
2443 :    
2444 :    
2445 :    
2446 :    
2447 :    
2448 :    
2449 :    
2450 :    
2451 :    
2452 : celek 1.4
2453 :     <p class="MsoNormal">
2454 :     To add a new Update site, open the context Menu in the Updates View
2455 :     and select New-&gt;Site Bookmerk....  This opens a Dialog box that presents
2456 :     the properties of the Bookmark Site you want to create. The properties
2457 :     of a Bookmark Site are the label you want to see in the View as well as
2458 :     the URL of the physical site. You have to enter the Site URL. Optionally
2459 :     you can enter the Site Name. If you do not enter a Site Name, it will default
2460 :     to the Site URL. Click Ok when you have finished and you want to preserve
2461 :     your changes or click Cancel if you do not want to create a new Site Bookmark.
2462 :      </p>
2463 : celek 1.2
2464 :    
2465 : celek 1.4 </blockquote>
2466 : celek 1.2
2467 :    
2468 :    
2469 :    
2470 :    
2471 :    
2472 :    
2473 :    
2474 :    
2475 :    
2476 : celek 1.4
2477 :     <h4>
2478 :     Find the feature   </h4>
2479 : celek 1.2
2480 :    
2481 :    
2482 :    
2483 :    
2484 :    
2485 :    
2486 :    
2487 :    
2488 :    
2489 : celek 1.4
2490 :     <blockquote>
2491 : celek 1.2
2492 :    
2493 :    
2494 :    
2495 :    
2496 :    
2497 :    
2498 :    
2499 :    
2500 :    
2501 : celek 1.4
2502 :     <p class="MsoNormal">
2503 :     Expand the site to find the feature you want. You can find the feature
2504 :     by looking at the label or selecting a feature and reading the preview
2505 :     view. To know more about preview view:  See <a href="http://www.eclipse.org">
2506 :     Preview View</a>
2507 :     .</p>
2508 : celek 1.2
2509 :    
2510 : celek 1.4 </blockquote>
2511 : celek 1.2
2512 :    
2513 :    
2514 :    
2515 :    
2516 :    
2517 :    
2518 :    
2519 :    
2520 :    
2521 : celek 1.4
2522 :     <h4>
2523 :     Browse WebPages </h4>
2524 : celek 1.2
2525 :    
2526 :    
2527 :    
2528 :    
2529 :    
2530 :    
2531 :    
2532 :    
2533 :    
2534 : celek 1.4
2535 :     <blockquote>
2536 :     Open the <a href="http://www.eclipse.org">WebView</a>
2537 :     and enter the URL for the feature web page. Follow the indication
2538 :     of the webpage. &lt;TODO web install&gt;<br>
2539 : celek 1.2
2540 :    
2541 : celek 1.4 </blockquote>
2542 : celek 1.2
2543 :    
2544 :    
2545 :    
2546 :    
2547 :    
2548 :    
2549 :    
2550 :    
2551 :    
2552 : celek 1.4
2553 :     <h3>
2554 :     Update already existing features</h3>
2555 : celek 1.2
2556 :    
2557 :    
2558 :    
2559 :    
2560 :    
2561 :    
2562 :    
2563 :    
2564 :    
2565 : celek 1.4
2566 :     <blockquote>
2567 : celek 1.2
2568 :    
2569 :    
2570 :    
2571 :    
2572 :    
2573 :    
2574 :    
2575 :    
2576 :    
2577 : celek 1.4
2578 :     <p class="MsoNormal">
2579 :     This section will focus on updating features that are configured in
2580 :     your current configuration.To know how to configure/unconfigure a fetaure;
2581 :     see:
2582 :    
2583 :     <a href="http://www.eclipse.org">
2584 :     Configuring/Unconfiguring</a>
2585 :     .&lt;TODO only configured features ?&gt;  </p>
2586 : celek 1.2
2587 :    
2588 : celek 1.4 </blockquote>
2589 : celek 1.2
2590 :    
2591 :    
2592 :    
2593 :    
2594 :    
2595 :    
2596 :    
2597 :    
2598 :    
2599 : celek 1.4
2600 :     <h4>
2601 :     Search for updates</h4>
2602 : celek 1.2
2603 :    
2604 :    
2605 :    
2606 :    
2607 :    
2608 :    
2609 :    
2610 :    
2611 :    
2612 : celek 1.4
2613 :     <blockquote>
2614 :     To search for available updates, select Available Updates in the Updates
2615 :     View. In the preview view, press Search now.  This will search the site
2616 :     the configured feature come from for new version the installed and configured
2617 :     feature. During the search you will see the progress monitor move, indicating
2618 :     the search is in progress. When new version of configured features are
2619 :     found, they will appear under the progress monitor.  You can decide to
2620 :     see the result in a short form or an extended form by checking the 'Show
2621 :     results in extended form' box, under the Scope Settings section in the preview
2622 :     view.<br>
2623 : celek 1.2
2624 :    
2625 : celek 1.4 </blockquote>
2626 : celek 1.2
2627 :    
2628 :    
2629 :    
2630 :    
2631 :    
2632 :    
2633 :    
2634 :    
2635 :    
2636 : celek 1.4
2637 :     <h4>
2638 :     Search the file system</h4>
2639 : celek 1.2
2640 :    
2641 :    
2642 :    
2643 :    
2644 :    
2645 :    
2646 :    
2647 :    
2648 :    
2649 : celek 1.4
2650 :     <blockquote>
2651 : celek 1.2
2652 :    
2653 :    
2654 :    
2655 :    
2656 :    
2657 :    
2658 :    
2659 :    
2660 :    
2661 : celek 1.4
2662 :     <p class="MsoNormal">
2663 :     You can decide to search the file system for updates by checking the
2664 :     'Include my computer in the search' box, under the Scope Settings section
2665 :     in the preview view. Click on the Settings... button to customize which
2666 :     part of the file system you want to search.</p>
2667 : celek 1.2
2668 :    
2669 : celek 1.4 </blockquote>
2670 : celek 1.2
2671 :    
2672 :    
2673 :    
2674 :    
2675 :    
2676 :    
2677 :    
2678 :    
2679 :    
2680 : celek 1.4
2681 :     <h4>
2682 :     Customize Search</h4>
2683 : celek 1.2
2684 :    
2685 :    
2686 :    
2687 :    
2688 :    
2689 :    
2690 :    
2691 :    
2692 :    
2693 : celek 1.4
2694 :     <blockquote>
2695 : celek 1.2
2696 :    
2697 :    
2698 :    
2699 :    
2700 :    
2701 :    
2702 :    
2703 :    
2704 :    
2705 : celek 1.4
2706 :     <p class="MsoNormal">
2707 :     You can cutomize the search for updates by creating a new search. To
2708 :     know how to create a new search: see <a href="http://www.eclipse.org">Updates
2709 :     View: Context Action [new-&gt;search]</a>
2710 :     .</p>
2711 : celek 1.2
2712 :    
2713 : celek 1.4 </blockquote>
2714 : celek 1.2
2715 :    
2716 :    
2717 :    
2718 :    
2719 :    
2720 :    
2721 :    
2722 :    
2723 :    
2724 : celek 1.4
2725 :     <h3>
2726 :     Browse to discover</h3>
2727 : celek 1.2
2728 :    
2729 :    
2730 :    
2731 :    
2732 :    
2733 :    
2734 :    
2735 :    
2736 :    
2737 : celek 1.4
2738 :     <blockquote>
2739 : celek 1.2
2740 :    
2741 :    
2742 :    
2743 :    
2744 :    
2745 :    
2746 :    
2747 :    
2748 :    
2749 :    
2750 : celek 1.4
2751 :     <p class="MsoNormal">
2752 :     This section will focus on browsing update sites to find the features
2753 :     you want to install. All the update site appear in the Updates View. There
2754 :     are different places in the view where you can find sites to browse. You
2755 :     may have sites in the folder 'Places to visit' or you may have sites on your
2756 :     file system. You can also add some update site if you know their URL.<br>
2757 :     </p>
2758 : celek 1.2
2759 :    
2760 : celek 1.4 </blockquote>
2761 : celek 1.2
2762 :    
2763 :    
2764 :    
2765 :    
2766 :    
2767 :    
2768 :    
2769 :    
2770 :    
2771 :    
2772 : celek 1.4
2773 :     <h4>
2774 :     Browse already existing sites</h4>
2775 : celek 1.2
2776 :    
2777 :    
2778 :    
2779 :    
2780 :    
2781 :    
2782 :    
2783 :    
2784 :    
2785 :    
2786 : celek 1.4
2787 :     <blockquote>
2788 : celek 1.2
2789 :    
2790 :    
2791 :    
2792 :    
2793 :    
2794 :    
2795 :    
2796 :    
2797 :    
2798 :    
2799 : celek 1.4
2800 :     <p class="MsoNormal">
2801 :     If you expand the folder 'Places to visit' you may see some sites. They
2802 :     were automatically added to the folder by the feature you installed. You
2803 :     can expand the site and browse the features.</p>
2804 : celek 1.2
2805 :    
2806 : celek 1.4 </blockquote>
2807 : celek 1.2
2808 :    
2809 :    
2810 :    
2811 :    
2812 :    
2813 :    
2814 :    
2815 :    
2816 :    
2817 :    
2818 : celek 1.4
2819 :     <h4>
2820 :     Browse the file system</h4>
2821 : celek 1.2
2822 :    
2823 :    
2824 :    
2825 :    
2826 :    
2827 :    
2828 :    
2829 :    
2830 :    
2831 :    
2832 : celek 1.4
2833 :     <blockquote>
2834 : celek 1.2
2835 :    
2836 :    
2837 :    
2838 :    
2839 :    
2840 :    
2841 :    
2842 :    
2843 :    
2844 :    
2845 : celek 1.4
2846 :     <p class="MsoNormal">
2847 :     To browse the file system, expand 'My Computer'.  &lt;TODO what more
2848 :     to say?&gt;</p>
2849 : celek 1.2
2850 :    
2851 : celek 1.4 </blockquote>
2852 : celek 1.2
2853 :    
2854 :    
2855 :    
2856 :    
2857 :    
2858 :    
2859 :    
2860 :    
2861 :    
2862 :    
2863 : celek 1.4
2864 :     <h4>
2865 :     Add a new Update Site </h4>
2866 : celek 1.2
2867 :    
2868 :    
2869 :    
2870 :    
2871 :    
2872 :    
2873 :    
2874 :    
2875 :    
2876 :    
2877 : celek 1.4
2878 :     <blockquote>
2879 :     You can add a new update site from the context menu. Select new-&gt;SiteBookmark...
2880 :     This opens a Dialog box that presents the properties of the Bookmark Site
2881 :     you want to create. The properties of a Bookmark Site are the label you
2882 :     want to see in the View as well as the Address of the physical site. You
2883 :     have to enter the Site URL. Optionally you can enter the Site Name. If youdo
2884 :     not enter a Site Name, it will default to the Site URL. Click Ok when you
2885 :     have finished and you want to preserve your changes or click Cancel if you
2886 :     do not want to create a new Site Bookmark. Once the site has been created,
2887 :     expand the icon to see the categories and or the available features.<br>
2888 : celek 1.2
2889 :    
2890 : celek 1.4 </blockquote>
2891 : celek 1.2
2892 :    
2893 :    
2894 :    
2895 :    
2896 :    
2897 :    
2898 :    
2899 :    
2900 :    
2901 :    
2902 : celek 1.4
2903 :     <h4>
2904 :     Add a bookmark of a file system site.</h4>
2905 : celek 1.2
2906 :    
2907 :    
2908 :    
2909 :    
2910 :    
2911 :    
2912 :    
2913 :    
2914 :    
2915 :    
2916 : celek 1.4
2917 :     <blockquote>
2918 :     When you browse the file syste, you can add a file system site as a bookmark.
2919 :     Select the site. Open the context menu. Select  'Bookmark Location'. This
2920 :     action lets you create bookmark site for a site found on your local file
2921 :     system. This opens a Dialog box that presents the properties of the selected
2922 :     site. The properties of a Site are the label you want to see in the View
2923 :     as well as the Address of the site. You are able to change the Site Name.
2924 :     Click Ok when you have finished and you want to preserve your changes or
2925 :     click Cancel if you do not want to change the properties. Once the site has
2926 :     been created, expand the icon to see the categories and or the available
2927 :     features.<br>
2928 : celek 1.2
2929 :    
2930 : celek 1.4 </blockquote>
2931 : celek 1.2
2932 :    
2933 :    
2934 :    
2935 :    
2936 :    
2937 :    
2938 :    
2939 :    
2940 :    
2941 :    
2942 : celek 1.4
2943 :     <h3>
2944 :     Searching Features</h3>
2945 :     <blockquote>
2946 :     This section will explain how to find features by using the search mecanism.
2947 :     It will first focus on finding features that are update of already installed
2948 :     features, then it will explain how to search the file system, finally it
2949 :     will expose how to customize a search by presenting the three default search
2950 :     categories.<br>
2951 :     </blockquote>
2952 :     <h4></h4>
2953 :     <h5></h5>
2954 : celek 1.2
2955 :    
2956 :    
2957 :    
2958 :    
2959 :    
2960 :    
2961 :    
2962 :    
2963 :    
2964 :    
2965 : celek 1.4
2966 :     <h4>
2967 :     Search for updates</h4>
2968 :     <blockquote>
2969 :     To search for available updates, select Available Updates in the Updates
2970 :     View. In the preview view, press Search now.  This will search the site
2971 :     the configured feature come from for new version the installed and configured
2972 :     feature. During the search you will see the progress monitor move, indicating
2973 :     the search is in progress. When new version of configured features are
2974 :     found, they will appear under the progress monitor.  You can decide to
2975 :     see the result in a short form or an extended form by checking the 'Show
2976 :     results in extended form' box, under the Scope Settings section in the preview
2977 :     view.<br>
2978 :     </blockquote>
2979 : celek 1.2
2980 :    
2981 :    
2982 :    
2983 :    
2984 :    
2985 :    
2986 :    
2987 :    
2988 :    
2989 :    
2990 : celek 1.4
2991 :     <h4>
2992 :     Search the file system</h4>
2993 :     <blockquote>
2994 :     <p class="MsoNormal">
2995 :     You can decide to search the file system for updates by checking the
2996 :     'Include my computer in the search' box, under the Scope Settings section
2997 :     in the preview view. Click on the Settings... button to customize which
2998 :     part of the file system you want to search.</p>
2999 :     </blockquote>
3000 : celek 1.2
3001 :    
3002 :    
3003 :    
3004 :    
3005 :    
3006 :    
3007 :    
3008 :    
3009 :    
3010 :    
3011 : celek 1.4
3012 :     <h4>
3013 :     Customize Search</h4>
3014 :     <blockquote>
3015 :     Three default categories of search are provided: Search for availables updates,
3016 :     search features based on regular expression and search features that containf
3017 :     a specific plugins. You may see other categories. Check the user documentation
3018 :     of the features that provide the extra categories to learn more about them.<br>
3019 :     </blockquote>
3020 :     <h5>
3021 :     Available Updates</h5>
3022 :     <blockquote>
3023 :     This search attemps to find update of already installed features. There is
3024 :     no special settings to fill when running this query. The query will find
3025 :     all new version of installed features based on the scope. To know more about
3026 :     the scope of the search: see <a href="http://www.eclipse.org">Search Preview
3027 :     View</a>
3028 :     .<br>
3029 :     </blockquote>
3030 :     <h5>
3031 :     Regular Expression</h5>
3032 :     <blockquote>
3033 :     This search attemps to find features based on a simple regular expression
3034 :     query. You must change the settings of the query before running it. Select
3035 :     the query in the Updates View. In the preview view, expand Query Settings.<br>
3036 :     </blockquote>
3037 :     <ul>
3038 :     <li>
3039 :     Type the string you want to search for in the Expression Entry Field.</li>
3040 :     <li>
3041 :     Check the check box if you want the search to be case sensitive. A case sensitive
3042 :     search will consider UpperCase and LowerCase character as different.</li>
3043 :     <li>
3044 :     Selection where you want the search to occur by checking Feature Name, Feature
3045 :     Provider and/or Feature Description.</li>
3046 :     </ul>
3047 :     <blockquote>
3048 :     The query will find the features that match the query based on the scope.
3049 :     To know more about the scope of the search: see <a href="http://www.eclipse.org">
3050 :     Search Preview View</a>
3051 :     .</blockquote>
3052 :     <h5>
3053 :     Plug-ins</h5>
3054 :     <blockquote>
3055 :     This search attempts to find feature that contain a specific plug-in.You
3056 :     must change the settings of the query before running it. Select the query
3057 :     in the Updates View. In the preview view, expand Query Settings.<br>
3058 :     </blockquote>
3059 :     <ul>
3060 :     <li>
3061 :     Click New to add a specific plugin. &lt;TODO doesn't work in 0423&gt;</li>
3062 :     </ul>
3063 :     <blockquote>
3064 :     The query will find the features that match the query based on the scope.
3065 :     To know more about the scope of the search: see <a href="http://www.eclipse.org">
3066 :     Search Preview View</a>
3067 :     .<br>
3068 :     </blockquote>
3069 : celek 1.2
3070 :    
3071 :    
3072 :    
3073 :    
3074 :    
3075 :    
3076 :    
3077 :    
3078 :    
3079 :    
3080 : celek 1.4
3081 :     <h2>
3082 :     Installing a Feature</h2>
3083 : celek 1.2
3084 :    
3085 :    
3086 :    
3087 :    
3088 :    
3089 :    
3090 :    
3091 :    
3092 :    
3093 :    
3094 : celek 1.4
3095 :     <blockquote>
3096 :     This section will describe the Wizard used to install, configure,
3097 :     unconfigure and remove a feature as well as the verification task that
3098 :     may occur when installing a new feature. The first part will focus on
3099 :     the three tab that are part of the Wizard, while the second part will
3100 :     deal with verification and security issues when installing a feature.<br>
3101 : celek 1.2
3102 :    
3103 : celek 1.4 </blockquote>
3104 : celek 1.2
3105 :    
3106 :    
3107 :    
3108 :    
3109 :    
3110 :    
3111 :    
3112 :    
3113 :    
3114 :    
3115 : celek 1.4
3116 :     <h3>
3117 :     Install Wizard</h3>
3118 : celek 1.2
3119 :    
3120 :    
3121 :    
3122 :    
3123 :    
3124 :    
3125 :    
3126 :    
3127 :    
3128 :    
3129 : celek 1.4
3130 :     <blockquote>
3131 :     The Wizard will help you install, configure, unconfigure and remove
3132 :     a feature. It will allow you to review any license agreement and to choose
3133 :     the Site in which you wish to install the feature.<br>
3134 : celek 1.2
3135 :    
3136 : celek 1.4 </blockquote>
3137 : celek 1.2
3138 :    
3139 :    
3140 :    
3141 :    
3142 :    
3143 :    
3144 :    
3145 :    
3146 :    
3147 :    
3148 : celek 1.4
3149 :     <h4>
3150 :     The Preview Tab</h4>
3151 : celek 1.2
3152 :    
3153 :    
3154 :    
3155 :    
3156 :    
3157 :    
3158 :    
3159 :    
3160 :    
3161 :    
3162 : celek 1.4
3163 :     <blockquote>
3164 :     This tab summarizes the action you are going to take. <br>
3165 : celek 1.2
3166 :    
3167 : celek 1.4 </blockquote>
3168 : celek 1.2
3169 :    
3170 :    
3171 :    
3172 :    
3173 :    
3174 :    
3175 :    
3176 :    
3177 :    
3178 :    
3179 : celek 1.4
3180 :     <div align="Left"><img src="images/pic002.gif" alt="Install Wizard Preview Tab PIC002.gif" width="500" height="500">
3181 : celek 1.2
3182 :    
3183 : celek 1.4 <br>
3184 : celek 1.2
3185 :    
3186 : celek 1.4 </div>
3187 : celek 1.2
3188 :    
3189 :    
3190 :    
3191 :    
3192 :    
3193 :    
3194 :    
3195 :    
3196 :    
3197 :    
3198 : celek 1.4
3199 :     <h4>
3200 :      The License Tab</h4>
3201 : celek 1.2
3202 :    
3203 :    
3204 :    
3205 :    
3206 :    
3207 :    
3208 :    
3209 :    
3210 :    
3211 :    
3212 : celek 1.4
3213 :     <blockquote>
3214 :     This tab will present you the license you have to agree with to install
3215 :     the product. Click on agree if you agree with the whole license and whish
3216 :     to continue or click cancel to abort the installation<br>
3217 : celek 1.2
3218 :    
3219 : celek 1.4 </blockquote>
3220 : celek 1.2
3221 :    
3222 :    
3223 :    
3224 :    
3225 :    
3226 :    
3227 :    
3228 :    
3229 :    
3230 :    
3231 : celek 1.4
3232 :     <h4>
3233 :     Site location Tab</h4>
3234 : celek 1.2
3235 :    
3236 :    
3237 :    
3238 :    
3239 :    
3240 :    
3241 :    
3242 :    
3243 :    
3244 :    
3245 : celek 1.4
3246 :     <blockquote>
3247 :     This tab has three main goals. The first one is to show you the available
3248 :     sites on your local file system, the second is the ability to create a
3249 :     new site if the one proposed are not satisfactory, finally you will be
3250 :     able to see the space left on the selected site and the size in kilobyte
3251 :     of the feature you are about to install.<br>
3252 : celek 1.2
3253 :    
3254 : celek 1.4 </blockquote>
3255 : celek 1.2
3256 :    
3257 :    
3258 :    
3259 :    
3260 :    
3261 :    
3262 :    
3263 :    
3264 :    
3265 :    
3266 :    
3267 : celek 1.4
3268 :     <h4>
3269 :     Verification &lt;TODO explain basic certificate &gt;</h4>
3270 : celek 1.2
3271 :    
3272 :    
3273 :    
3274 :    
3275 :    
3276 :    
3277 :    
3278 :    
3279 :    
3280 :    
3281 :    
3282 : celek 1.4
3283 :     <blockquote>
3284 :     Verification is an important part of the install process. It will
3285 :     allow you to verify if the feature you are about to install has been digitally
3286 :     signed, not digitally signed or tempered with.<br>
3287 : celek 1.2
3288 :    
3289 :    
3290 :    
3291 :    
3292 :    
3293 : celek 1.4 </blockquote>
3294 : celek 1.2
3295 :    
3296 :    
3297 :    
3298 :    
3299 :    
3300 :    
3301 :    
3302 :    
3303 :    
3304 :    
3305 :    
3306 : celek 1.4
3307 :     <h5>
3308 :     Signed</h5>
3309 : celek 1.2
3310 :    
3311 :    
3312 :    
3313 :    
3314 :    
3315 :    
3316 :    
3317 :    
3318 :    
3319 :    
3320 :    
3321 : celek 1.4
3322 :     <blockquote>
3323 :     A dialog with the following &lt;PICTURE&gt; will appear if the feature
3324 :     or one of its file has been signed. A signed feature means the file has
3325 :     been digitally signed by the signer, and the signer has been authenticated
3326 :     by the authenticator. The authenticator can be the same entity as the signer,
3327 :     in which case you will see such a dialog &lt;PICTURE&gt;. In some cases,
3328 :     the authenticator is a different entity than the signer, in which case you
3329 :     will see such a dialog. &lt;PICTURE&gt;. If the authenticator has never been
3330 :     authenticated by you, you will see such a dialog &lt;PICTURE&gt;. If the
3331 :     signature of the authenticator has been authorized before, you will see such
3332 :     a dialog &lt;PICTURE&gt;. Click continue or install only if you trust the
3333 :     signer of the feature file and you want to install the feature, or click
3334 :     cancel if you want to abort the installation.<br>
3335 : celek 1.2
3336 :    
3337 :    
3338 :    
3339 :    
3340 :    
3341 :    
3342 :    
3343 :    
3344 : celek 1.4 </blockquote>
3345 : celek 1.2
3346 :    
3347 :    
3348 :    
3349 :    
3350 :    
3351 :    
3352 :    
3353 :    
3354 :    
3355 :    
3356 :    
3357 : celek 1.4
3358 :     <h5>
3359 :     Non Signed</h5>
3360 : celek 1.2
3361 :    
3362 :    
3363 :    
3364 :    
3365 :    
3366 :    
3367 :    
3368 :    
3369 :    
3370 :    
3371 :    
3372 : celek 1.4
3373 :     <blockquote>
3374 :     A dialog  like the following &lt;PICTURE&gt; will appear if the feature
3375 :     or one of its file has not been signed. When a feature has not been signed,
3376 :     we cannot authenticate the sender of the package, nor can we certify the
3377 :     validity of any of the file. Click continue or install only if you want
3378 :     to install the feature, or click cancel if you want to abort the installation.<br>
3379 : celek 1.2
3380 :    
3381 :    
3382 : celek 1.4 </blockquote>
3383 : celek 1.2
3384 :    
3385 :    
3386 :    
3387 :    
3388 :    
3389 :    
3390 :    
3391 :    
3392 :    
3393 :    
3394 :    
3395 : celek 1.4
3396 :     <h5>
3397 :     Corrupted </h5>
3398 : celek 1.2
3399 :    
3400 :    
3401 :    
3402 :    
3403 :    
3404 :    
3405 :    
3406 :    
3407 :    
3408 :    
3409 :    
3410 : celek 1.4
3411 :     <blockquote>
3412 : celek 1.2
3413 :    
3414 :    
3415 :    
3416 :    
3417 :    
3418 :    
3419 :    
3420 :    
3421 :    
3422 :    
3423 :    
3424 : celek 1.4
3425 :     <p class="MsoNormal">
3426 :      If the content of a feature has changed since it has been signed, you
3427 :     will see such a dialog &lt;PICTURE&gt;. This means the content has been
3428 :     tempered with. Install/Update will prevent you from installing such a feature.
3429 :     Click cancel if you want to abort the installation and contact the provider
3430 :     of the feature and/or the site. </p>
3431 : celek 1.2
3432 :    
3433 :    
3434 : celek 1.4 </blockquote>
3435 : celek 1.2
3436 :    
3437 :    
3438 :    
3439 :    
3440 :    
3441 :    
3442 :    
3443 :    
3444 :    
3445 :    
3446 :    
3447 : celek 1.4
3448 :     <h5>
3449 :     Feature verification dialog</h5>
3450 : celek 1.2
3451 :    
3452 :    
3453 :    
3454 :    
3455 :    
3456 :    
3457 :    
3458 :    
3459 :    
3460 :    
3461 :    
3462 : celek 1.4
3463 :     <blockquote>
3464 : celek 1.2
3465 :    
3466 :    
3467 :    
3468 :    
3469 :    
3470 :    
3471 :    
3472 :    
3473 :    
3474 :    
3475 :    
3476 : celek 1.4
3477 :     <p class="MsoNormal">
3478 :     &lt;TODO explain the dialog with feature/ install/ cancel&gt;</p>
3479 : celek 1.2
3480 :    
3481 :    
3482 : celek 1.4 </blockquote>
3483 : celek 1.2
3484 :    
3485 :    
3486 :    
3487 :    
3488 :    
3489 :    
3490 :    
3491 :    
3492 :    
3493 :    
3494 :    
3495 : celek 1.4
3496 :     <h5>
3497 :     Feature file verification dialog</h5>
3498 : celek 1.2
3499 :    
3500 :    
3501 :    
3502 :    
3503 :    
3504 :    
3505 :    
3506 :    
3507 :    
3508 :    
3509 :    
3510 : celek 1.4
3511 :     <blockquote>
3512 : celek 1.2
3513 :    
3514 :    
3515 :    
3516 :    
3517 :    
3518 :    
3519 :    
3520 :    
3521 :    
3522 :    
3523 :    
3524 : celek 1.4
3525 :     <p class="MsoNormal">
3526 :     &lt;TODO explain the dialog with feature file/ continue/ cancel&gt;</p>
3527 : celek 1.2
3528 :    
3529 :    
3530 : celek 1.4 </blockquote>
3531 : celek 1.2
3532 :    
3533 :    
3534 :    
3535 :    
3536 :    
3537 :    
3538 :    
3539 :    
3540 :    
3541 :    
3542 :    
3543 : celek 1.4
3544 :     <h5>
3545 :     Persistence of the answer</h5>
3546 : celek 1.2
3547 :    
3548 :    
3549 :    
3550 :    
3551 :    
3552 :    
3553 :    
3554 :    
3555 :    
3556 :    
3557 :    
3558 : celek 1.4
3559 :     <blockquote>
3560 : celek 1.2
3561 :    
3562 :    
3563 :    
3564 :    
3565 :    
3566 :    
3567 :    
3568 :    
3569 :    
3570 :    
3571 :    
3572 : celek 1.4
3573 :     <p class="MsoNormal">
3574 :     If click continue or install on a verification dialog, the Install/Update
3575 :     component will remember your action and will not prompt you again if one
3576 :     of the file of the feature is about to show the exact same verification dialog.
3577 : celek 1.2
3578 :    
3579 :    
3580 : celek 1.4 <br>
3581 :     </p>
3582 : celek 1.2
3583 :    
3584 :    
3585 : celek 1.4 </blockquote>
3586 : celek 1.2
3587 :    
3588 :    
3589 :    
3590 :    
3591 :    
3592 :    
3593 :    
3594 :    
3595 :    
3596 :    
3597 :    
3598 : celek 1.4
3599 :     <h2>
3600 :     Configuring/Unconfiguring a Feature</h2>
3601 : celek 1.2
3602 :    
3603 :    
3604 :    
3605 :    
3606 :    
3607 :    
3608 :    
3609 :    
3610 :    
3611 :    
3612 :    
3613 : celek 1.4
3614 :     <blockquote>
3615 :     This section will focus on configuring and unconfiguring the feature
3616 :     you can manage in your current configuration. A configuration is a list
3617 :     of configured and unconfigured features that determine what tool are available
3618 :     for you to use in your workspace.  To know more about configuration see:
3619 :     <a href="http://www.eclipse.org"> Configuration</a>
3620 :     . <br>
3621 : celek 1.2
3622 :    
3623 :    
3624 : celek 1.4 </blockquote>
3625 : celek 1.2
3626 :    
3627 :    
3628 :    
3629 :    
3630 :    
3631 :    
3632 :    
3633 :    
3634 :    
3635 :    
3636 :    
3637 : celek 1.4
3638 :     <h3>
3639 :     Checking if a feature is configured or unconfigured.<br>
3640 : celek 1.2
3641 :    
3642 :    
3643 : celek 1.4 </h3>
3644 : celek 1.2
3645 :    
3646 :    
3647 :    
3648 :    
3649 :    
3650 :    
3651 :    
3652 :    
3653 :    
3654 :    
3655 :    
3656 : celek 1.4
3657 :     <blockquote>
3658 :     Feature you installed appear in the Configuration View. Expand the Current
3659 :     Configuration to see the configured sites. Expand the site to see the Features.
3660 :     Use the local view toolbar button to switch between configured features
3661 :     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">
3662 : celek 1.2
3663 :    
3664 :    
3665 : celek 1.4 <br>
3666 : celek 1.2
3667 :    
3668 :    
3669 : celek 1.4 </blockquote>
3670 : celek 1.2
3671 :    
3672 :    
3673 :    
3674 :    
3675 :    
3676 :    
3677 :    
3678 :    
3679 :    
3680 :    
3681 :    
3682 :    
3683 : celek 1.4 <h3>
3684 :     Configure/Unconfigure Wizard</h3>
3685 : celek 1.2
3686 :    
3687 :    
3688 :    
3689 :    
3690 :    
3691 :    
3692 :    
3693 :    
3694 :    
3695 :    
3696 :    
3697 :    
3698 : celek 1.4 <blockquote>
3699 : celek 1.2
3700 :    
3701 :    
3702 :    
3703 :    
3704 :    
3705 :    
3706 :    
3707 :    
3708 :    
3709 :    
3710 :    
3711 :    
3712 : celek 1.4
3713 :     <p class="MsoNormal">
3714 :     The Wizard will help you configure or unconfigure a feature. <br>
3715 : celek 1.2
3716 :    
3717 :    
3718 : celek 1.4 </p>
3719 : celek 1.2
3720 :    
3721 :    
3722 : celek 1.4 </blockquote>
3723 : celek 1.2
3724 :    
3725 :    
3726 :    
3727 :    
3728 :    
3729 :    
3730 :    
3731 :    
3732 :    
3733 :    
3734 :    
3735 :    
3736 : celek 1.4
3737 :     <h4>
3738 :     Preview Tab</h4>
3739 : celek 1.2