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