platform-update-home/doc/working/documentation/user guide.html
Parent Directory
| 
Revision Log
Revision 1.5 - (view) (download) (as text)
| 1 : | celek | 1.1 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> |
| 2 : | <html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns="http://www.w3.org/TR/REC-html40"> | ||
| 3 : | <head> | ||
| 4 : | vlad | 1.5 | |
| 5 : | celek | 1.1 | <meta http-equiv="Content-Type" content="text/html; charset=windows-1252"> |
| 6 : | vlad | 1.5 | |
| 7 : | celek | 1.1 | <meta name="ProgId" content="Word.Document"> |
| 8 : | vlad | 1.5 | |
| 9 : | celek | 1.1 | <meta name="Generator" content="Microsoft Word 9"> |
| 10 : | vlad | 1.5 | |
| 11 : | celek | 1.1 | <meta name="Originator" content="Microsoft Word 9"> |
| 12 : | vlad | 1.5 | |
| 13 : | <link rel="File-List" href="./user%20guide_files/filelist.xml"> | ||
| 14 : | |||
| 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 : | celek | 1.1 | <o:DocumentProperties> |
| 25 : | <o:Author>Labuser</o:Author> | ||
| 26 : | <o:LastAuthor>Labuser</o:LastAuthor> | ||
| 27 : | vlad | 1.5 | <o:Revision>4</o:Revision> |
| 28 : | <o:TotalTime>40</o:TotalTime> | ||
| 29 : | celek | 1.1 | <o:Created>2002-04-12T13:24:00Z</o:Created> |
| 30 : | vlad | 1.5 | <o:LastSaved>2002-04-26T18:30:00Z</o:LastSaved> |
| 31 : | <o:Pages>37</o:Pages> | ||
| 32 : | <o:Words>7006</o:Words> | ||
| 33 : | <o:Characters>39939</o:Characters> | ||
| 34 : | celek | 1.1 | <o:Company>IBM Canada Ltd.</o:Company> |
| 35 : | vlad | 1.5 | <o:Lines>332</o:Lines> |
| 36 : | <o:Paragraphs>79</o:Paragraphs> | ||
| 37 : | <o:CharactersWithSpaces>49047</o:CharactersWithSpaces> | ||
| 38 : | <o:Version>9.4402</o:Version> | ||
| 39 : | celek | 1.1 | </o:DocumentProperties> |
| 40 : | </xml><![endif]--><!--[if gte mso 9]><xml> | ||
| 41 : | <w:WordDocument> | ||
| 42 : | <w:View>Normal</w:View> | ||
| 43 : | </w:WordDocument> | ||
| 44 : | </xml><![endif]--> | ||
| 45 : | vlad | 1.5 | |
| 46 : | celek | 1.1 | <style> |
| 47 : | <!-- | ||
| 48 : | vlad | 1.5 | /* 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 : | celek | 1.1 | /* Style Definitions */ |
| 57 : | p.MsoNormal, li.MsoNormal, div.MsoNormal | ||
| 58 : | {mso-style-parent:""; | ||
| 59 : | margin:0in; | ||
| 60 : | margin-bottom:.0001pt; | ||
| 61 : | mso-pagination:widow-orphan; | ||
| 62 : | font-size:12.0pt; | ||
| 63 : | font-family:"Times New Roman"; | ||
| 64 : | vlad | 1.5 | mso-fareast-font-family:"Times New Roman";} |
| 65 : | celek | 1.1 | a:link, span.MsoHyperlink |
| 66 : | {color:blue; | ||
| 67 : | text-decoration:underline; | ||
| 68 : | text-underline:single;} | ||
| 69 : | a:visited, span.MsoHyperlinkFollowed | ||
| 70 : | {color:blue; | ||
| 71 : | text-decoration:underline; | ||
| 72 : | text-underline:single;} | ||
| 73 : | vlad | 1.5 | p |
| 74 : | {font-size:12.0pt; | ||
| 75 : | font-family:"Times New Roman"; | ||
| 76 : | mso-fareast-font-family:"Times New Roman";} | ||
| 77 : | celek | 1.1 | @page Section1 |
| 78 : | {size:8.5in 11.0in; | ||
| 79 : | margin:1.0in 1.25in 1.0in 1.25in; | ||
| 80 : | mso-header-margin:.5in; | ||
| 81 : | mso-footer-margin:.5in; | ||
| 82 : | mso-paper-source:0;} | ||
| 83 : | div.Section1 | ||
| 84 : | {page:Section1;} | ||
| 85 : | vlad | 1.5 | /* 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 : | celek | 1.1 | --> |
| 271 : | </style> <!--[if gte mso 9]><xml> | ||
| 272 : | vlad | 1.5 | <o:shapedefaults v:ext="edit" spidmax="1027"/> |
| 273 : | celek | 1.1 | </xml><![endif]--><!--[if gte mso 9]><xml> |
| 274 : | <o:shapelayout v:ext="edit"> | ||
| 275 : | <o:idmap v:ext="edit" data="1"/> | ||
| 276 : | </o:shapelayout></xml><![endif]--> | ||
| 277 : | </head> | ||
| 278 : | vlad | 1.5 | <body lang="EN-US" link="blue" vlink="blue" style="tab-interval:.5in"> |
| 279 : | <div class="Section1"> | ||
| 280 : | <h1 align="Center" style="text-align: center; ">Install/Update User Guide</h1> | ||
| 281 : | <p class="MsoNormal"><!--[if !supportEmptyParas]--><!--[endif]--><o:p></o:p></p> | ||
| 282 : | celek | 1.1 | <h2>Getting Started: Install/Update in three steps</h2> |
| 283 : | vlad | 1.5 | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">This |
| 284 : | section will teach you how to install a new Feature and how to revert to a | ||
| 285 : | previous state in three easy steps. Before you start, make sure you installed | ||
| 286 : | the 'mockup' site following the <a href="http://www.eclipse.org">install mockup | ||
| 287 : | site</a> | ||
| 288 : | instructions.</p> | ||
| 289 : | <h3>Find new Feature</h3> | ||
| 290 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">This | ||
| 291 : | section will focus on finding a feature to install. There are different ways | ||
| 292 : | of finding a feature. The one we are going to focus in this section is <a href="http://www.eclipse.org"> | ||
| 293 : | browsing a site</a> | ||
| 294 : | . For more information about other ways of finding a feature, look at the | ||
| 295 : | <a href="http://www.eclipse.org">Find Features</a> | ||
| 296 : | section.</p> | ||
| 297 : | <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> | ||
| 299 : | <h4>Create a new site bookmark</h4> | ||
| 300 : | <ul type="Disc"> | ||
| 301 : | <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 : | Open the Install/Update perspective Help->Update Manager</li> | ||
| 304 : | <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; | ||
| 305 : | mso-list:l13 level1 lfo1;tab-stops:list .5in"> | ||
| 306 : | Select the Updates View.</li> | ||
| 307 : | <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; | ||
| 308 : | mso-list:l13 level1 lfo1;tab-stops:list .5in"> | ||
| 309 : | Open the context menu </li> | ||
| 310 : | <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; | ||
| 311 : | 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> | ||
| 324 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">The | ||
| 325 : | Site should appear on the view. The provider of a feature should give you | ||
| 326 : | the URL of their site so you can find their feature. We will now browse the | ||
| 327 : | site to discover the features.</p> | ||
| 328 : | <h4>Choose Feature</h4> | ||
| 329 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">You | ||
| 330 : | can expand the site and the categories to see the Features. In this site you | ||
| 331 : | should see one category: Red Dot Versions, and two features: Red Dot Feature | ||
| 332 : | 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 : | ·<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 : | Select Red Dot Feature 1.0.0</p> | ||
| 336 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">The | ||
| 337 : | Preview page should now look like the following picture:</p> | ||
| 338 : | <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 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">You | ||
| 341 : | may want to check the license and copyright or decide to have more information | ||
| 342 : | 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 : | the desired page.</p> | ||
| 345 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "><TIP | ||
| 346 : | 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> | ||
| 348 : | <h3>Install Feature</h3> | ||
| 349 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">When | ||
| 350 : | you are ready to install the feature click on the Install button in the Preview | ||
| 351 : | View. This will launch the Install Wizard.</p> | ||
| 352 : | <h4>Install Wizard</h4> | ||
| 353 : | <ul type="Disc"> | ||
| 354 : | <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; | ||
| 355 : | 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 : | <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; | ||
| 359 : | mso-list:l10 level1 lfo3;tab-stops:list .5in"> | ||
| 360 : | The second page shows the license you have to accept to install the | ||
| 361 : | feature. Click next of you accept the presented license otherwise click | ||
| 362 : | cancel.</li> | ||
| 363 : | <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; | ||
| 364 : | mso-list:l10 level1 lfo3;tab-stops:list .5in"> | ||
| 365 : | The last page of the Wizard presents the list of Site you can install | ||
| 366 : | your feature in. You can create a new site from this page. For more information | ||
| 367 : | 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 | ||
| 370 : | the workbench is installed. Click Finish.</li> | ||
| 371 : | </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 : | see the progress monitor showing you the evolution of theses tasks. During | ||
| 375 : | verification, you may be prompted to accept the verification. Click 'Ok' when | ||
| 376 : | prompted.</p> | ||
| 377 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">When | ||
| 378 : | 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> | ||
| 380 : | <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 : | To activate this specific feature customize your perspective and add the Red | ||
| 384 : | Dot Set Action Set:</p> | ||
| 385 : | <ul type="Disc"> | ||
| 386 : | <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 : | <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 : | <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; | ||
| 393 : | mso-list:l11 level1 lfo4;tab-stops:list .5in"> | ||
| 394 : | Expand Action Sets</li> | ||
| 395 : | <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; | ||
| 396 : | mso-list:l11 level1 lfo4;tab-stops:list .5in"> | ||
| 397 : | 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> | ||
| 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 : | dialog box should appear, meaning the feature and associated plug-ins have | ||
| 405 : | been successfully installed and configured.</p> | ||
| 406 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">We | ||
| 407 : | will now see how to manage your feature in your configuration.</p> | ||
| 408 : | <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 : | configured feature means that Install/Update will 'suggests' that the runtime | ||
| 412 : | configures the feature to be available. An unconfigured feature means that | ||
| 413 : | Install/Update will make the feature unavailable to the user.</p> | ||
| 414 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">When | ||
| 415 : | you installed Red Dot Feature 1.0.0, Install/Update installed and configured | ||
| 416 : | 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 : | .</p> | ||
| 420 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">A configuration | ||
| 421 : | is a list of configured and unconfigured features that determine what tool | ||
| 422 : | you can use.<br> | ||
| 423 : | The current configuration is the configuration currently active.</p> | ||
| 424 : | <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 : | .</p> | ||
| 428 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">In | ||
| 429 : | this section we will add the current history configuration to the list of | ||
| 430 : | 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> | ||
| 433 : | <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 : | current configuration is the configuration in the configuration history folder | ||
| 438 : | with an icon with a running person. It is the last configuration in the list.</p> | ||
| 439 : | <ul type="Disc"> | ||
| 440 : | <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; | ||
| 441 : | mso-list:l4 level1 lfo5;tab-stops:list .5in"> | ||
| 442 : | 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 : | <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 : | mso-list:l4 level1 lfo5;tab-stops:list .5in"> | ||
| 451 : | The configuration now appears under the Preserved Configurations folder.</li> | ||
| 452 : | </ul> | ||
| 453 : | <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 : | <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; | ||
| 458 : | mso-list:l2 level1 lfo6;tab-stops:list .5in"> | ||
| 459 : | 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 : | <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 : | mso-list:l2 level1 lfo6;tab-stops:list .5in"> | ||
| 468 : | Click Ok.</li> | ||
| 469 : | </ul> | ||
| 470 : | <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 : | <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; | ||
| 475 : | mso-list:l0 level1 lfo7;tab-stops:list .5in"> | ||
| 476 : | 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> | ||
| 480 : | </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 : | <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 : | Select Red Dot Feature 1.0.0</li> | ||
| 487 : | <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; | ||
| 488 : | mso-list:l3 level1 lfo8;tab-stops:list .5in"> | ||
| 489 : | 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 : | When the Dialog opens click Ok.</li> | ||
| 493 : | </ul> | ||
| 494 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">The | ||
| 495 : | workspace will shutdown and restart automatically.</p> | ||
| 496 : | <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 : | <h4>Verify the Feature is not available</h4> | ||
| 501 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">You | ||
| 502 : | should not see the red button icon in the toolbar, meaning the feature was | ||
| 503 : | 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 : | In the Configuration View, expand Current Configuration.</li> | ||
| 508 : | <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 : | mso-list:l14 level1 lfo9;tab-stops:list .5in"> | ||
| 513 : | Verify Red Dot Feature 1.0.0 does NOT appear as an icon.</li> | ||
| 514 : | <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; | ||
| 515 : | 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> | ||
| 518 : | </ul> | ||
| 519 : | <blockquote> | ||
| 520 : | <div> | ||
| 521 : | <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 : | </div> | ||
| 524 : | celek | 1.4 | </blockquote> |
| 525 : | vlad | 1.5 | <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 : | feature.</div> | ||
| 530 : | celek | 1.4 | </blockquote> |
| 531 : | vlad | 1.5 | <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 : | <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; | ||
| 536 : | mso-list:l12 level1 lfo10;tab-stops:list .5in"> | ||
| 537 : | 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 : | mso-list:l12 level1 lfo10;tab-stops:list .5in"> | ||
| 543 : | In the preview view click Restore</li> | ||
| 544 : | <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; | ||
| 545 : | mso-list:l12 level1 lfo10;tab-stops:list .5in"> | ||
| 546 : | When the Dialog opens click Ok.</li> | ||
| 547 : | </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 : | There are different ways of configuring a feature. To know more about configuring | ||
| 553 : | and unconfiguring features see: <a href="http://www.eclipse.org">Configuring/Unconfiguring | ||
| 554 : | features</a> | ||
| 555 : | .</p> | ||
| 556 : | <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" style="margin-right: 0.5in; margin-left: 0.5in; "> | ||
| 562 : | This section describes in details the User Interface of the Install/Update | ||
| 563 : | perspective. The perspective is composed of four different views: The Configuration | ||
| 564 : | View to manage the configurations, the Updates View to manage update sites | ||
| 565 : | and features as well as searches. The Preview View is used to show the details | ||
| 566 : | of the element selected in the previous two views and the Web View, which | ||
| 567 : | is used to browse HTML document from either sites or features.</p> | ||
| 568 : | <h3>The Configuration View</h3> | ||
| 569 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> | ||
| 570 : | The configuration view helps you manage your configurations. A configuration | ||
| 571 : | is a list of configured and unconfigured features that determine what tool | ||
| 572 : | are available fro you to use in your workspace. <br> | ||
| 573 : | </p> | ||
| 574 : | <blockquote><img border="0" width="251" height="251" id="_x0000_i1029" src="images%5Cpic006.gif" alt="Configuration View"> | ||
| 575 : | celek | 1.4 | </blockquote> |
| 576 : | vlad | 1.5 | <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 : | Expanding each site reveals the list of Features you have access to. Some | ||
| 581 : | 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 : | <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 | ||
| 589 : | 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</a> | ||
| 591 : | .</p> | ||
| 592 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> | ||
| 593 : | 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 : | are performed (i.e. install, configure, unconfigure etc...). When the Install/Update | ||
| 599 : | creates a new configuration, it will add it to the list. If you already have | ||
| 600 : | n configurations, the framework will automatically delete the oldest configuration | ||
| 601 : | from the list. To know when the Install/Update creates new configuration history | ||
| 602 : | 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 : | The Preserved Configurations folder contains history configurations you | ||
| 608 : | want to keep. The framework does not automatically delete the configurations | ||
| 609 : | in the Preserved Configurations folder; you have to explicitly delete them.</p> | ||
| 610 : | <h4>Configured/Unconfigured</h4> | ||
| 611 : | <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> | ||
| 612 : | You can decide to see only the configured features or both configured/unconfigured | ||
| 613 : | features by clicking the 'Show Unconfigured Features' toggle button in the | ||
| 614 : | view tool bar. To know more about configured/unconfigured features see: <a href="http://www.eclipse.org"> | ||
| 615 : | Configured/Unconfigured</a> | ||
| 616 : | .</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; "> | ||
| 620 : | This button allows you to see only the configured features or both configured | ||
| 621 : | and unconfigured features. Unconfigured features appear with a red circle | ||
| 622 : | around the icon. For more information about configuring/unconfiguring features | ||
| 623 : | see: <a href="http://www.eclipse.org">Configuring/Unconfiguring</a> | ||
| 624 : | .</p> | ||
| 625 : | <h4>Context Actions</h4> | ||
| 626 : | <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 : | 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 : | This action <TODO be consistent with navigator></p> | ||
| 635 : | <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 : | selected element.</p> | ||
| 642 : | <h5>Properties</h5> | ||
| 643 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> | ||
| 644 : | 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 have | ||
| 646 : | finished and you want to preserve your changes or click Cancel if you do not | ||
| 647 : | want to change the properties.</p> | ||
| 648 : | <h5>Add to Preserved</h5> | ||
| 649 : | <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; "> | ||
| 654 : | This action removes the selected configuration from the list of preserved | ||
| 655 : | configurations. This action will not delete any Site, Site Bookmark or Feature. | ||
| 656 : | This action will not delete the configuration it was created from or any other | ||
| 657 : | 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 : | celek | 1.4 | </blockquote> |
| 673 : | vlad | 1.5 | <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 : | celek | 1.4 | </blockquote> |
| 734 : | vlad | 1.5 | <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"> | ||
| 738 : | celek | 1.4 | </blockquote> |
| 739 : | vlad | 1.5 | <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 : | celek | 1.4 | </blockquote> |
| 746 : | vlad | 1.5 | <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 : | celek | 1.4 | </p> |
| 764 : | vlad | 1.5 | <blockquote> |
| 765 : | <div align="Left"><img border="0" width="438" height="481" id="_x0000_i1034" src="images%5Cpic011.gif" alt="New Folder Dialog"> | ||
| 766 : | <br> | ||
| 767 : | </div> | ||
| 768 : | celek | 1.4 | </blockquote> |
| 769 : | vlad | 1.5 | <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> | ||
| 774 : | </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 : | celek | 1.4 | </blockquote> |
| 778 : | vlad | 1.5 | <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 : | folders tree or by typing its name in the Create in entry field. Open the | ||
| 785 : | 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"> | ||
| 787 : | 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> | ||
| 928 : | Configure: this launches the Configure Wizard for this unconfigured | ||
| 929 : | feature. See <a href="http://www.eclipse.org">Configuring/Unconfiguring | ||
| 930 : | a Feature</a> | ||
| 931 : | .<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 : | This preview shows information about the select configuration.</p> | ||
| 939 : | <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 : | <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 : | celek | 1.4 | List of activities that led to the creation of the configuration. For more |
| 951 : | vlad | 1.5 | information about the different activities, see <a href="http://www.eclipse.org"> |
| 952 : | celek | 1.4 | Activities</a> |
| 953 : | vlad | 1.5 | .</p> |
| 954 : | <h5>Configuration Reversal</h5> | ||
| 955 : | <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 : | mso-list:l6 level1 lfo13;tab-stops:list .5in"> | ||
| 964 : | 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 : | .</li> | ||
| 973 : | </ul> | ||
| 974 : | <h4>The search Preview View</h4> | ||
| 975 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> | ||
| 976 : | 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 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> | ||
| 985 : | 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 : | celek | 1.4 | Features</a> |
| 988 : | vlad | 1.5 | .</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 : | and/or the bookmarked sites you created. When searching the local file system, | ||
| 994 : | click Settings to select which root folder will be searched.</p> | ||
| 995 : | <h5>Run the query</h5> | ||
| 996 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> | ||
| 997 : | Click Search Now to run the query.</p> | ||
| 998 : | <h5>See the results</h5> | ||
| 999 : | <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 : | celek | 1.4 | Click Ok when you have finished and you want to preserve your changes or |
| 1039 : | vlad | 1.5 | 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 : | celek | 1.4 | View</a> |
| 1046 : | vlad | 1.5 | .</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 : | celek | 1.4 | To know more about the scope of the search: see <a href="http://www.eclipse.org"> |
| 1176 : | vlad | 1.5 | 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 : | celek | 1.4 | must change the settings of the query before running it. Select the query |
| 1182 : | vlad | 1.5 | 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 : | celek | 1.4 | To know more about the scope of the search: see <a href="http://www.eclipse.org"> |
| 1191 : | vlad | 1.5 | 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> | ||
| 1275 : | To learn more about how to authorize an authenticator: see <a href="http://www.eclipse.org"> | ||
| 1276 : | Security and Keystore Management</a> | ||
| 1277 : | .</p> | ||
| 1278 : | <h5>Non Signed</h5> | ||
| 1279 : | <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 : | celek | 1.4 | </blockquote> |
| 1286 : | vlad | 1.5 | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> |
| 1287 : | When a feature has not been signed, we cannot authenticate the sender of | ||
| 1288 : | 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 : | <p class="MsoNormal"><img border="0" width="599" height="187" id="_x0000_i1048" src="images%5Cpic017.gif" alt="Corrupted Feature"> | ||
| 1297 : | </p> | ||
| 1298 : | </blockquote> | ||
| 1299 : | <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> | ||
| 1300 : | 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 : | 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 : | 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. | ||
| 1310 : | </p> | ||
| 1311 : | <h2>Configuring/Unconfiguring a Feature</h2> | ||
| 1312 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> | ||
| 1313 : | This section will focus on configuring and unconfiguring the feature you | ||
| 1314 : | can manage in your current configuration. A configuration is a list of configured | ||
| 1315 : | and unconfigured features that determine what tool are available for you to | ||
| 1316 : | use in your workspace. To know more about configuration see: <a href="http://www.eclipse.org"> | ||
| 1317 : | Configuration</a> | ||
| 1318 : | .</p> | ||
| 1319 : | <h3>Checking if a feature is configured or | ||
| 1320 : | unconfigured.</h3> | ||
| 1321 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> | ||
| 1322 : | Feature you installed appear in the Configuration View. Expand the Current | ||
| 1323 : | Configuration to see the configured sites. Expand the site to see the Features. | ||
| 1324 : | Use the local view toolbar button to switch between configured features and | ||
| 1325 : | all the features. Unconfigured features appear with such icon <img border="0" width="16" height="16" id="_x0000_i1049" src="images%5Cunconf_feature_obj.gif" alt="unconf_feature_obj.gif Unconfigured Feature"> | ||
| 1326 : | </p> | ||
| 1327 : | <h3>Configure/Unconfigure Wizard</h3> | ||
| 1328 : | <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> | ||
| 1329 : | The Wizard will help you configure or unconfigure a feature. </p> | ||
| 1330 : | <h4>Preview Tab</h4> | ||
| 1331 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> | ||
| 1332 : | This tab summarizes the action you are going to take. </p> | ||
| 1333 : | <div align="Center"> | ||
| 1334 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "><img border="0" width="500" height="500" id="_x0000_i1050" src="images%5Cpic003.gif" alt="PIC003.gif Configure Wizard Preview Tab"> | ||
| 1335 : | </p> | ||
| 1336 : | </div> | ||
| 1337 : | <h2>Configuration</h2> | ||
| 1338 : | <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> | ||
| 1339 : | A configuration is a list of configured and unconfigured features that determine | ||
| 1340 : | what tool are available for you to use in your workspace. A configuration | ||
| 1341 : | determines what task you can execute. There are three types of configurations: | ||
| 1342 : | the current configuration, the history configuration and the preserved configuration.</p> | ||
| 1343 : | <h3>Current Configuration</h3> | ||
| 1344 : | <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> | ||
| 1345 : | The current configuration is the configuration currently active.</p> | ||
| 1346 : | <h3>Configuration History or Preserved Configuration</h3> | ||
| 1347 : | <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> | ||
| 1348 : | Configuration History are automatically created by the Install/Update as | ||
| 1349 : | a snapshot of your current configuration at a certain time, before an activity | ||
| 1350 : | occurs. Preserved Configuration are configuration in the History Configuration | ||
| 1351 : | you want to persist.</p> | ||
| 1352 : | <h3>Configuration History</h3> | ||
| 1353 : | <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> | ||
| 1354 : | When you install a feature, the install/update component will copy your | ||
| 1355 : | current configuration in the history configuration, and then install and | ||
| 1356 : | configure the feature in you current configuration. You will end up with | ||
| 1357 : | two configurations, one without the feature installed and configured and | ||
| 1358 : | one with the feature installed and configured. The install/update will also | ||
| 1359 : | copy your current configuration when you install or remove a site, when you | ||
| 1360 : | configure or unconfigure a feature or when reconciliation is needed. Each | ||
| 1361 : | activity will be recorded in the configuration. For each configuration selected | ||
| 1362 : | in the history configuration folder, you can see in the preview view the | ||
| 1363 : | list of activities that were executed. See <a href="http://www.eclipse.org"> | ||
| 1364 : | Activities </a> | ||
| 1365 : | for more information about the different activities.</p> | ||
| 1366 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> | ||
| 1367 : | The install/update will keep a certain number of configurations in the configuration | ||
| 1368 : | history folder. After this number has been reached, if a new configuration | ||
| 1369 : | is created, the oldest configuration inside Configuration History folder will | ||
| 1370 : | be deleted. </p> | ||
| 1371 : | <h4>Renaming an history configuration</h4> | ||
| 1372 : | <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> | ||
| 1373 : | You can rename any configuration in the Configuration History folder. To | ||
| 1374 : | change the label of a Configuration, select the configuration, open the context | ||
| 1375 : | menu and click Properties. This will open a dialog where you can change the | ||
| 1376 : | label of the selected configuration. Click Ok if you want to save the label | ||
| 1377 : | or click cancel if you do not want to change the label of the configuration.</p> | ||
| 1378 : | <h4>Revert the current configuration to the | ||
| 1379 : | previous configuration</h4> | ||
| 1380 : | <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> | ||
| 1381 : | You can revert the current configuration to the previous configuration. | ||
| 1382 : | This action behaves like an 'Undo' where you want to go back to the previous | ||
| 1383 : | configuration.</p> | ||
| 1384 : | <h3> Preserved Configuration</h3> | ||
| 1385 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> | ||
| 1386 : | Preserved Configurations are configurations of the Configuration History | ||
| 1387 : | folder you want to Preserved because it represents a set of configured features | ||
| 1388 : | for a certain task. (I.e. you may want to enable some features for Enterprise | ||
| 1389 : | Java Bean Development, and have a configuration with some feature for front-end | ||
| 1390 : | development). If you do not preserved a configuration, it will be deleted | ||
| 1391 : | from the file system when the history maximum number is reached: see <a href="http://www.eclipse.org"> | ||
| 1392 : | Preference Page</a> | ||
| 1393 : | . You should add to preserved configuration the configuration you want to | ||
| 1394 : | quickly restore.</p> | ||
| 1395 : | <h4>Add a Configuration in the preserved folder</h4> | ||
| 1396 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> | ||
| 1397 : | To add a configuration to the list of preserved configurations, select the | ||
| 1398 : | configuration in the history configuration folder. Open the context menu; | ||
| 1399 : | click 'add to preserved configuration'. </p> | ||
| 1400 : | <h4>Remove a Configuration in the preserved | ||
| 1401 : | folder </h4> | ||
| 1402 : | <p style="margin-right: 0.5in; margin-left: 0.5in; "> | ||
| 1403 : | To remove a preserved configuration from the list, select the preserved configuration. | ||
| 1404 : | Open the context menu. Click Remove from preserved.</p> | ||
| 1405 : | <h4>Rename a Preserved Configuration</h4> | ||
| 1406 : | <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> | ||
| 1407 : | You can rename any configuration in the Preserved Configurations folder. | ||
| 1408 : | To change the label of a Configuration, select the configuration, open the | ||
| 1409 : | context menu and click Properties. This will open a dialog where you can change | ||
| 1410 : | the label of the selected configuration. Click Ok if you want to save the | ||
| 1411 : | label or click cancel if you do not want to change the label of the configuration.</p> | ||
| 1412 : | <p class="MsoNormal"><!--[if !supportEmptyParas]--><!--[endif]--><o:p></o:p></p> | ||
| 1413 : | <h3>Restore a Configuration/Revert to previous | ||
| 1414 : | configuration</h3> | ||
| 1415 : | <p class="MsoNormal"> <TODO></p> | ||
| 1416 : | <p class="MsoNormal"><!--[if !supportEmptyParas]--><!--[endif]--><o:p></o:p></p> | ||
| 1417 : | <h3>The Activities </h3> | ||
| 1418 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> | ||
| 1419 : | celek | 1.4 | Activities are tasks that are part of a configuration. Activities are the |
| 1420 : | vlad | 1.5 | actions that were taken to create the Configuration. You can see activities |
| 1421 : | celek | 1.4 | in the preview view when you select a configuration.<br> |
| 1422 : | vlad | 1.5 | </p> |
| 1423 : | <blockquote><img src="images%5Cpic014.gif" alt="activities" width="594" height="151"> | ||
| 1424 : | <br> | ||
| 1425 : | </blockquote> | ||
| 1426 : | <h5>Date</h5> | ||
| 1427 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> | ||
| 1428 : | The date using the locale format ate which the action took place.</p> | ||
| 1429 : | <h5>Target</h5> | ||
| 1430 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> | ||
| 1431 : | The identifier of the target of the action (see the different type of activities)</p> | ||
| 1432 : | <h5>Action</h5> | ||
| 1433 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> | ||
| 1434 : | The label of the action (see the different types of activities)</p> | ||
| 1435 : | <h5>Status</h5> | ||
| 1436 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> | ||
| 1437 : | The status of the action. Success if the action was successful.</p> | ||
| 1438 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> | ||
| 1439 : | There are nine different actions that create an activity in a configuration.</p> | ||
| 1440 : | <h4>Feature Installed </h4> | ||
| 1441 : | <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> | ||
| 1442 : | When a new feature is installed in a configured site.<br> | ||
| 1443 : | The target in the preview view is the identifier of the installed feature.</p> | ||
| 1444 : | <h4>Feature Removed</h4> | ||
| 1445 : | <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> | ||
| 1446 : | When a new feature is physically removed from a configured site.<br> | ||
| 1447 : | The target in the preview view is the identifier of the removed feature.</p> | ||
| 1448 : | <h4>Site Installed</h4> | ||
| 1449 : | <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> | ||
| 1450 : | When a Site is added to the current configuration.</p> | ||
| 1451 : | <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> | ||
| 1452 : | The target in the preview view is the Address of the site</p> | ||
| 1453 : | <h4>Site Removed</h4> | ||
| 1454 : | <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> | ||
| 1455 : | When a Site is removed from the current configuration.</p> | ||
| 1456 : | <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> | ||
| 1457 : | The target in the preview view is the Address of the site</p> | ||
| 1458 : | <h4>Feature Configured</h4> | ||
| 1459 : | <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> | ||
| 1460 : | When a new feature is configured in a configured site.<br> | ||
| 1461 : | The target in the preview view is the identifier of the configured feature.</p> | ||
| 1462 : | <h4>Feature Unconfigured</h4> | ||
| 1463 : | <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> | ||
| 1464 : | When a new feature is unconfigured in a configured site.<br> | ||
| 1465 : | The target in the preview view is the identifier of the unconfigured feature.</p> | ||
| 1466 : | <h4>Revert to Configuration</h4> | ||
| 1467 : | <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> | ||
| 1468 : | When the user reverted to a configuration from either the configuration | ||
| 1469 : | history or the preserved configuration</p> | ||
| 1470 : | <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> | ||
| 1471 : | The target in the preview view is the identifier of the configuration we | ||
| 1472 : | reverted to.</p> | ||
| 1473 : | <h4>Reconciliation</h4> | ||
| 1474 : | <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> | ||
| 1475 : | When the Install/Update detected a changed occurred between the last shutdown | ||
| 1476 : | and this startup.</p> | ||
| 1477 : | <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> | ||
| 1478 : | The URL of the file maintaining the overall configuration.</p> | ||
| 1479 : | <h4>Added to Preserved Configuration</h4> | ||
| 1480 : | <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> | ||
| 1481 : | When a configuration was added to the list of preserved configurations.</p> | ||
| 1482 : | <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> | ||
| 1483 : | The target in the preview view is the identifier of the configuration added | ||
| 1484 : | to the preserved configurations.</p> | ||
| 1485 : | <h2>Removing a Feature</h2> | ||
| 1486 : | <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> | ||
| 1487 : | This section explains how to physically remove an unconfigured feature from | ||
| 1488 : | the file system. You can only remove unconfigured features. You know how to | ||
| 1489 : | unconfigure a feature see: <a href="http://www.eclipse.org">Configure/Unconfigure | ||
| 1490 : | Features</a> | ||
| 1491 : | .</p> | ||
| 1492 : | <h3>Remove Wizard</h3> | ||
| 1493 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> | ||
| 1494 : | celek | 1.4 | This Wizard will help you uninstall an unconfigured feature.<br> |
| 1495 : | vlad | 1.5 | To launch the wizard, select an unconfigured feature in your current configuration. |
| 1496 : | See <a href="http://www.eclipse.org">Configure/Unconfigure</a> | ||
| 1497 : | celek | 1.4 | a feature to know how to unconfigure a configured feature, and if a feature |
| 1498 : | vlad | 1.5 | is configured or not.</p> |
| 1499 : | <h4>Preview Tab</h4> | ||
| 1500 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> | ||
| 1501 : | This tab summarizes the action you are going to take.<br> | ||
| 1502 : | </p> | ||
| 1503 : | <div align="Center"><img border="0" width="600" height="500" id="_x0000_i1052" src="images%5Cpic015.gif" alt="uninstall wizard"> | ||
| 1504 : | </div> | ||
| 1505 : | <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "></p> | ||
| 1506 : | <h2>Troubleshooting</h2> | ||
| 1507 : | <p class="MsoNormal"> If the workbench | ||
| 1508 : | does not start after you installed a new feature.<br> | ||
| 1509 : | The Install/Update views do not show anything.<br> | ||
| 1510 : | I created a Site but nothing shows (verify URL)</p> | ||
| 1511 : | <h2>Advanced User</h2> | ||
| 1512 : | <p class="MsoNormal"> Security and keystore | ||
| 1513 : | management.</p> | ||
| 1514 : | </div> | ||
| 1515 : | </body> | ||
| 1516 : | </html> |
| help@eclipse.org | ViewVC Help |
| Powered by ViewVC 1.0.3 |