doc/html/user-guide/config-tool-using-templates.html

   1 <!-- Copyright (C) 2003 Red Hat, Inc.                                -->
   2 <!-- This material may be distributed only subject to the terms      -->
   3 <!-- and conditions set forth in the Open Publication License, v1.0  -->
   4 <!-- or later (the latest version is presently available at          -->
   5 <!-- http://www.opencontent.org/openpub/).                           -->
   6 <!-- Distribution of the work or derivative of the work in any       -->
   7 <!-- standard (paper) book form is prohibited unless prior           -->
   8 <!-- permission is obtained from the copyright holder.               -->
   9 <HTML
  10 ><HEAD
  11 ><TITLE
  12 >Using Templates</TITLE
  13 ><meta name="MSSmartTagsPreventParsing" content="TRUE">
  14 <META
  15 NAME="GENERATOR"
  16 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
  17 "><LINK
  18 REL="HOME"
  19 TITLE="eCos User Guide"
  20 HREF="ecos-user-guide.html"><LINK
  21 REL="UP"
  22 TITLE="Updating the Configuration"
  23 HREF="config-tool-updating-configuration.html"><LINK
  24 REL="PREVIOUS"
  25 TITLE="Platform Selection"
  26 HREF="config-tool-platform-selection.html"><LINK
  27 REL="NEXT"
  28 TITLE="Searching"
  29 HREF="config-tool-searching.html"></HEAD
  30 ><BODY
  31 CLASS="SECT1"
  32 BGCOLOR="#FFFFFF"
  33 TEXT="#000000"
  34 LINK="#0000FF"
  35 VLINK="#840084"
  36 ALINK="#0000FF"
  37 ><DIV
  38 CLASS="NAVHEADER"
  39 ><TABLE
  40 SUMMARY="Header navigation table"
  41 WIDTH="100%"
  42 BORDER="0"
  43 CELLPADDING="0"
  44 CELLSPACING="0"
  45 ><TR
  46 ><TH
  47 COLSPAN="3"
  48 ALIGN="center"
  49 >eCos User Guide</TH
  50 ></TR
  51 ><TR
  52 ><TD
  53 WIDTH="10%"
  54 ALIGN="left"
  55 VALIGN="bottom"
  56 ><A
  57 HREF="config-tool-platform-selection.html"
  58 ACCESSKEY="P"
  59 >Prev</A
  60 ></TD
  61 ><TD
  62 WIDTH="80%"
  63 ALIGN="center"
  64 VALIGN="bottom"
  65 >Chapter 19. Updating the Configuration</TD
  66 ><TD
  67 WIDTH="10%"
  68 ALIGN="right"
  69 VALIGN="bottom"
  70 ><A
  71 HREF="config-tool-searching.html"
  72 ACCESSKEY="N"
  73 >Next</A
  74 ></TD
  75 ></TR
  76 ></TABLE
  77 ><HR
  78 ALIGN="LEFT"
  79 WIDTH="100%"></DIV
  80 ><DIV
  81 CLASS="SECT1"
  82 ><H1
  83 CLASS="SECT1"
  84 ><A
  85 NAME="CONFIG-TOOL-USING-TEMPLATES">Using Templates</H1
  86 ><P
  87 >To load a configuration based on a template, select
  88           <SPAN
  89 CLASS="emphasis"
  90 ><I
  91 CLASS="EMPHASIS"
  92 >Build</I
  93 ></SPAN
  94 >-&gt;<SPAN
  95 CLASS="emphasis"
  96 ><I
  97 CLASS="EMPHASIS"
  98 >Templates</I
  99 ></SPAN
 100 >.</P
 101 ><P
 102 >The following dialog box will be displayed:</P
 103 ><DIV
 104 CLASS="FIGURE"
 105 ><A
 106 NAME="AEN1417"><P
 107 ><B
 108 >Figure 19-4. Templates dialog box</B
 109 ></P
 110 ><P
 111 ><IMG
 112 SRC="pix/templates.png"></P
 113 ></DIV
 114 ><P
 115 >Change the hardware template, the packages template, or
 116           both. To select a hardware template, choose from the first
 117           drop-list. To choose a packages template, choose from the
 118           second. Brief descriptions of each kind of template are
 119           provided in the corresponding edit boxes.</P
 120 ><DIV
 121 CLASS="SECT2"
 122 ><H2
 123 CLASS="SECT2"
 124 ><A
 125 NAME="RESOLVING-CONFLICTS">Resolving conflicts</H2
 126 ><P
 127 >During the process of configuring <SPAN
 128 CLASS="PRODUCTNAME"
 129 >eCos</SPAN
 130 > it is possible
 131             that conflicts will be created. For more details of the
 132             meaning of conflicts, see <A
 133 HREF="cdl-concepts.html"
 134 >Chapter 24</A
 135 >.</P
 136 ><P
 137 >The Conflicts Window displays all conflicts in the
 138             current configuration. Additionally, a window in the
 139             status bar displays a count of the conflicts. Because the
 140             resolution of conflicts can be time-consuming, a mechanism
 141             exists whereby conflicts can be resolved
 142             automatically.</P
 143 ><P
 144 >You can choose to have a conflicts resolution dialog
 145             box displayed by means of the <SPAN
 146 CLASS="emphasis"
 147 ><I
 148 CLASS="EMPHASIS"
 149 >View-&gt;Settings...
 150               </I
 151 ></SPAN
 152 >menu item, on the <SPAN
 153 CLASS="emphasis"
 154 ><I
 155 CLASS="EMPHASIS"
 156 >Conflict Resolution</I
 157 ></SPAN
 158 >
 159 tab of the dialog.</P
 160 ><DIV
 161 CLASS="FIGURE"
 162 ><A
 163 NAME="AEN1430"><P
 164 ><B
 165 >Figure 19-5. Options</B
 166 ></P
 167 ><P
 168 ><IMG
 169 SRC="pix/ToolsOptions.png"></P
 170 ></DIV
 171 ><P
 172 >You can choose to have conflicts checked under the
 173             following circumstances:</P
 174 ><P
 175 ></P
 176 ><UL
 177 ><LI
 178 ><P
 179 >After any item is changed (in other words,
 180                 as soon as the conflict is created)</P
 181 ></LI
 182 ><LI
 183 ><P
 184 >Before saving the configuration (including
 185                 building)</P
 186 ></LI
 187 ><LI
 188 ><P
 189 >Never</P
 190 ></LI
 191 ></UL
 192 ><P
 193 >The method you chose depends on how much you need
 194                 your configuration to be free of conflicts. You may
 195                 want to avoid having to clean up all the conflicts at
 196                 once, or you may want to keep the configuration
 197                 consistent at all times. If you have major changes to
 198                 implement, which may resolve the conflicts, then you
 199                 might want to wait until after you have completed
 200                 these changes before you check for conflicts.</P
 201 ><DIV
 202 CLASS="NOTE"
 203 ><BLOCKQUOTE
 204 CLASS="NOTE"
 205 ><P
 206 ><B
 207 >Note: </B
 208 >If you choose to check conflicts after any item
 209               is changed, only newly arising conflicts are displayed.
 210               If you choose to check for conflicts before saving the
 211               configuration, the complete set is
 212               displayed.</P
 213 ></BLOCKQUOTE
 214 ></DIV
 215 ></DIV
 216 ><DIV
 217 CLASS="SECT2"
 218 ><H2
 219 CLASS="SECT2"
 220 ><A
 221 NAME="AEN1444">Automatic resolution</H2
 222 ><P
 223 >If you check the &#8220;Automatically suggest
 224             fixes&#8221; check box, a conflicts resolution dialog box
 225             will be displayed whenever new conflicts are created. The
 226             same dialog box may be displayed at any stage by means of
 227             the <SPAN
 228 CLASS="emphasis"
 229 ><I
 230 CLASS="EMPHASIS"
 231 >Tools-&gt;Resolve Conflicts</I
 232 ></SPAN
 233 >
 234             <SPAN
 235 CLASS="emphasis"
 236 ><I
 237 CLASS="EMPHASIS"
 238 ></I
 239 ></SPAN
 240 >menu item.
 241             </P
 242 ><P
 243 >The conflicts resolution dialog box contains two major windows. </P
 244 ><DIV
 245 CLASS="FIGURE"
 246 ><A
 247 NAME="AEN1450"><P
 248 ><B
 249 >Figure 19-6. Resolve conflicts window</B
 250 ></P
 251 ><P
 252 ><IMG
 253 SRC="pix/Conflicts.png"></P
 254 ></DIV
 255 ><P
 256 >The upper contains the set of conflicts to be addressed; the
 257 format of the data being as that of the Conflicts Window. The lower
 258 window contains a set of proposed resolutions &#8211; each entry
 259 is a suggested configuration item value change that as a whole may
 260 be expected to lead to the currently selected conflict being resolved. </P
 261 ><P
 262 >Note that there is no guarantee:</P
 263 ><P
 264 ></P
 265 ><UL
 266 ><LI
 267 ><P
 268 >that automatic resolutions will be determinable for every
 269 conflict.</P
 270 ></LI
 271 ><LI
 272 ><P
 273 >       that the resolutions for separate conflicts will be independent.
 274 In other words, the resolution of one conflict may serve to prevent
 275 the resolution of another.</P
 276 ></LI
 277 ><LI
 278 ><P
 279 >       that the resolution conflicts will not create further
 280 conflicts.</P
 281 ></LI
 282 ></UL
 283 ><P
 284 >The above warnings are, however, conservative. In practice
 285 (so long as the number and extent of conflicts are limited) automatic
 286 conflict resolution may be used to good effect to correct problems
 287 without undue amounts of programmer intervention.</P
 288 ><P
 289 >In order to select the conflicts to be applied, select or
 290 clear the check boxes against the resolutions for each proposed
 291 resolution. By default all resolutions are selected; you can return
 292 to the default state (in other words, cause all check boxes for
 293 each conflict to again become checked) by pressing the &#8220;Reset&#8221; button.
 294 Note that multiple selection may be used in the resolutions control
 295 to allow ranges of check boxes to be toggled in one gesture.</P
 296 ><P
 297 >When you are happy to apply the selected resolutions for each
 298 conflict displayed, click <SPAN
 299 CLASS="emphasis"
 300 ><I
 301 CLASS="EMPHASIS"
 302 >Apply</I
 303 ></SPAN
 304 >; this will
 305 apply the resolutions. Alternatively you may cancel from the dialog
 306 box without any resolutions being applied.</P
 307 ></DIV
 308 ></DIV
 309 ><DIV
 310 CLASS="NAVFOOTER"
 311 ><HR
 312 ALIGN="LEFT"
 313 WIDTH="100%"><TABLE
 314 SUMMARY="Footer navigation table"
 315 WIDTH="100%"
 316 BORDER="0"
 317 CELLPADDING="0"
 318 CELLSPACING="0"
 319 ><TR
 320 ><TD
 321 WIDTH="33%"
 322 ALIGN="left"
 323 VALIGN="top"
 324 ><A
 325 HREF="config-tool-platform-selection.html"
 326 ACCESSKEY="P"
 327 >Prev</A
 328 ></TD
 329 ><TD
 330 WIDTH="34%"
 331 ALIGN="center"
 332 VALIGN="top"
 333 ><A
 334 HREF="ecos-user-guide.html"
 335 ACCESSKEY="H"
 336 >Home</A
 337 ></TD
 338 ><TD
 339 WIDTH="33%"
 340 ALIGN="right"
 341 VALIGN="top"
 342 ><A
 343 HREF="config-tool-searching.html"
 344 ACCESSKEY="N"
 345 >Next</A
 346 ></TD
 347 ></TR
 348 ><TR
 349 ><TD
 350 WIDTH="33%"
 351 ALIGN="left"
 352 VALIGN="top"
 353 >Platform Selection</TD
 354 ><TD
 355 WIDTH="34%"
 356 ALIGN="center"
 357 VALIGN="top"
 358 ><A
 359 HREF="config-tool-updating-configuration.html"
 360 ACCESSKEY="U"
 361 >Up</A
 362 ></TD
 363 ><TD
 364 WIDTH="33%"
 365 ALIGN="right"
 366 VALIGN="top"
 367 >Searching</TD
 368 ></TR
 369 ></TABLE
 370 ></DIV
 371 ></BODY
 372 ></HTML
 373 >