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. -->
13 ><meta name="MSSmartTagsPreventParsing" content="TRUE">
16 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
19 TITLE="eCos User Guide"
20 HREF="ecos-user-guide.html"><LINK
22 TITLE="The eCos Configuration Tool"
23 HREF="the-ecos-configuration-tool.html"><LINK
26 HREF="config-tool-settings.html"><LINK
28 TITLE="Updating the Configuration"
29 HREF="config-tool-updating-configuration.html"></HEAD
40 SUMMARY="Header navigation table"
57 HREF="config-tool-settings.html"
71 HREF="config-tool-updating-configuration.html"
84 NAME="CONFIG-TOOL-SCREEN-LAYOUT">Chapter 18. Screen Layout</H1
86 >The following windows are available within the
101 > Configuration Window</P
105 > Properties Window</P
109 > Short Description</P
121 >The layout of the windows may be adjusted to suit your
123 HREF="config-tool-settings.html"
124 >the Section called <I
133 NAME="CONFIG-TOOL-CONFIGURATION-WINDOW">Configuration Window</H1
135 >This is the principal window used to configure <SPAN
139 takes the form of a tree-based representation of the
140 configuration items within the currently loaded <SPAN
146 >In the case of items whose values may be changed,
147 controls are available to set the item values. These either
148 take the form of check boxes or radio buttons within the
149 tree itself or cells to the right of the thin vertical
150 splitter bar. Controls in the tree may be used in the usual
151 way; cells, however, must first be activated.</P
153 >To activate a cell, simply click on it: it will assume a sunken
154 appearance and data can then be edited in the cell. To terminate
155 in-cell editing, click elsewhere in the configuration window or
162 >. To discard the partial results
163 of in-cell editing and revert to the previous value, press <SPAN
173 SRC="pix/configwin.png"></P
176 >Cells come in three varieties, according to the type of
183 >Table 18-1. Cell types</B
211 >Decimal or hexadecimal values</TD
221 >Floating point values</TD
237 >In the case of string cells, you can double-click the cell
238 to display a dialog box containing a larger region in which to edit
239 the string value. This is useful in the case of long strings, or
240 those spanning multiple lines.</P
246 NAME="AEN1292">Disabled items</H2
248 >Some items will appear disabled. In this case the item
249 label and any associated controls and cells will be
250 grayed. It is not be possible to change the values of
257 NAME="AEN1295">Right-Clicking</H3
259 >You can right-click on an item in the configuration
260 window item to display a pop-up menu which (depending on
261 the type of the item selected) allows you to:</P
274 information relating to the currently selected item
275 is displayed. The information is equivalent to that
276 displayed in the Properties
288 the default value of the currently selected item is
297 >Visit Documentation</I
300 - causes the HTML page most closely relating to the
301 currently selected item to be displayed. This has
302 the same effect as double-clicking the URL property
303 in the Properties Window.</P
314 – this causes the file containing the items to
315 be displayed. This is equivalent to double-clicking
316 on the File property in the Properties Window. The
317 viewer used for this purpose may be changed using
322 >View->Settings</I
326 HREF="config-tool-settings.html"
327 >the Section called <I
331 Note that this operation is only possible when the
332 current configuration is saved, in order to avoid
333 the possibility of changing the source
345 this is equivalent to using the
350 >Build->Packages</I
353 select and unload the package in
364 NAME="AEN1317">Conflicts Window</H2
366 >This window exists to display any configuration item
367 conflicts. Conflicts are the result of failures to meet
368 the requirements between configuration items expressed in
370 HREF="cdl-conflicts.html"
371 >the Section called <I
376 SRC="pix/conflictwin.png"></P
379 >The window comprises three columns:</P
393 >This is the macro name of the first item involved
407 >This is a description of the conflict type. The currently
408 supported types are “unresolved”, “illegal
409 value”, “evaluation exception”, “goal
410 unsatisfied” and “bad data”.</P
423 >This contains a description of the configuration
424 item’s property that caused the conflict.</P
426 >Within the conflicts window you can right-click on
427 any item to display a context menu which allows you to
428 choose from one of the following options:</P
432 >To locate the item involved in the
433 conflict, double-click in the first or third column, or
434 right-click over the item and choose <SPAN
441 from the popup menu.</P
443 >You can use the <SPAN
447 >Tools->Resolve Conflicts</I
450 item, or right-click over the item and select <SPAN
456 > from the popup menu,
457 to resolve conflicts — <A
458 HREF="config-tool-using-templates.html#RESOLVING-CONFLICTS"
459 >the Section called <I
460 >Resolving conflicts</I
468 NAME="AEN1343">Output Window</H3
470 >This window displays any output generated by
471 execution of external tools and any error messages that
472 are not suitable for display in other forms (for
473 example, as message boxes).</P
475 >Within the output window you can right-click to display a
476 context menu which allows you to:</P
482 >Save the contents of the window to a
487 >Clear the contents of the
497 NAME="AEN1352">Properties Window</H3
499 >This window displays the CDL properties of the item
500 currently selected in the configuration window. The same
501 information may be displayed by right-clicking the item
502 and selecting “properties”.</P
506 SRC="pix/propwin.png"></P
509 >Two properties may be double-clicked as
523 double-clicking on a URL property causes the
524 referenced HTML page to be displayed. This has the
525 same effect as right-clicking on the item and
526 choosing “Visit
527 Documentation”.</P
538 double-clicking on a File property in a saved
539 configuration causes the File to be displayed. The
540 viewer used for this purpose may be changed using
545 >View->Settings</I
548 item. Note that this operation is only possible when
549 the current configuration is saved, in order to
550 avoid the possibility of changing the source
560 NAME="AEN1366">Short Description Window</H3
562 >This window displays a short description of the item
563 currently selected in the configuration window. More
564 extensive documentation may be available by
565 right-clicking on the item and choosing “Visit
566 Documentation”.</P
576 SUMMARY="Footer navigation table"
587 HREF="config-tool-settings.html"
596 HREF="ecos-user-guide.html"
605 HREF="config-tool-updating-configuration.html"
621 HREF="the-ecos-configuration-tool.html"
629 >Updating the Configuration</TD