doc/html/user-guide/config-tool-screen-layout.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 >Screen Layout</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="The eCos Configuration Tool"
  23 HREF="the-ecos-configuration-tool.html"><LINK
  24 REL="PREVIOUS"
  25 TITLE="Settings"
  26 HREF="config-tool-settings.html"><LINK
  27 REL="NEXT"
  28 TITLE="Updating the Configuration"
  29 HREF="config-tool-updating-configuration.html"></HEAD
  30 ><BODY
  31 CLASS="CHAPTER"
  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-settings.html"
  58 ACCESSKEY="P"
  59 >Prev</A
  60 ></TD
  61 ><TD
  62 WIDTH="80%"
  63 ALIGN="center"
  64 VALIGN="bottom"
  65 ></TD
  66 ><TD
  67 WIDTH="10%"
  68 ALIGN="right"
  69 VALIGN="bottom"
  70 ><A
  71 HREF="config-tool-updating-configuration.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="CHAPTER"
  82 ><H1
  83 ><A
  84 NAME="CONFIG-TOOL-SCREEN-LAYOUT">Chapter 18. Screen Layout</H1
  85 ><P
  86 >The following windows are available within the
  87       <SPAN
  88 CLASS="PRODUCTNAME"
  89 >eCos</SPAN
  90 > <SPAN
  91 CLASS="APPLICATION"
  92 > Configuration
  93         Tool</SPAN
  94 >:
  95     </P
  96 ><P
  97 ></P
  98 ><UL
  99 ><LI
 100 ><P
 101 >               Configuration Window</P
 102 ></LI
 103 ><LI
 104 ><P
 105 >               Properties Window</P
 106 ></LI
 107 ><LI
 108 ><P
 109 >               Short Description</P
 110 ></LI
 111 ><LI
 112 ><P
 113 >               Conflicts</P
 114 ></LI
 115 ><LI
 116 ><P
 117 >               Output</P
 118 ></LI
 119 ></UL
 120 ><P
 121 >The layout of the windows may be adjusted to suit your
 122         preferences: see <A
 123 HREF="config-tool-settings.html"
 124 >the Section called <I
 125 >Settings</I
 126 > in Chapter 17</A
 127 >.</P
 128 ><DIV
 129 CLASS="SECT1"
 130 ><H1
 131 CLASS="SECT1"
 132 ><A
 133 NAME="CONFIG-TOOL-CONFIGURATION-WINDOW">Configuration Window</H1
 134 ><P
 135 >This is the principal window used to configure <SPAN
 136 CLASS="PRODUCTNAME"
 137 >eCos</SPAN
 138 >. It
 139           takes the form of a tree-based representation of the
 140           configuration items within the currently loaded <SPAN
 141 CLASS="PRODUCTNAME"
 142 >eCos</SPAN
 143 >
 144           packages.</P
 145 ><P
 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
 152 ><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
 156 press <SPAN
 157 CLASS="emphasis"
 158 ><I
 159 CLASS="EMPHASIS"
 160 >ENTER</I
 161 ></SPAN
 162 >. To discard the partial results
 163 of in-cell editing and revert to the previous value, press <SPAN
 164 CLASS="emphasis"
 165 ><I
 166 CLASS="EMPHASIS"
 167 >ESCAPE</I
 168 ></SPAN
 169 >.</P
 170 ><P
 171 ><P
 172 ><IMG
 173 SRC="pix/configwin.png"></P
 174 ></P
 175 ><P
 176 >Cells come in three varieties, according to the type of
 177           data they accept:</P
 178 ><DIV
 179 CLASS="TABLE"
 180 ><A
 181 NAME="AEN1273"><P
 182 ><B
 183 >Table 18-1. Cell types</B
 184 ></P
 185 ><TABLE
 186 BORDER="1"
 187 CLASS="CALSTABLE"
 188 ><THEAD
 189 ><TR
 190 ><TH
 191 ALIGN="LEFT"
 192 VALIGN="TOP"
 193 >Cell Type</TH
 194 ><TH
 195 ALIGN="LEFT"
 196 VALIGN="TOP"
 197 ><P
 198 >Data Accepted</P
 199 ></TH
 200 ></TR
 201 ></THEAD
 202 ><TBODY
 203 ><TR
 204 ><TD
 205 ALIGN="LEFT"
 206 VALIGN="TOP"
 207 >Integer</TD
 208 ><TD
 209 ALIGN="LEFT"
 210 VALIGN="TOP"
 211 >Decimal or hexadecimal values</TD
 212 ></TR
 213 ><TR
 214 ><TD
 215 ALIGN="LEFT"
 216 VALIGN="TOP"
 217 >Floating Point</TD
 218 ><TD
 219 ALIGN="LEFT"
 220 VALIGN="TOP"
 221 >Floating point values</TD
 222 ></TR
 223 ><TR
 224 ><TD
 225 ALIGN="LEFT"
 226 VALIGN="TOP"
 227 >String</TD
 228 ><TD
 229 ALIGN="LEFT"
 230 VALIGN="TOP"
 231 >Any</TD
 232 ></TR
 233 ></TBODY
 234 ></TABLE
 235 ></DIV
 236 ><P
 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
 241 ><DIV
 242 CLASS="SECT2"
 243 ><H2
 244 CLASS="SECT2"
 245 ><A
 246 NAME="AEN1292">Disabled items</H2
 247 ><P
 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
 251             disabled items.</P
 252 ><DIV
 253 CLASS="SECT3"
 254 ><H3
 255 CLASS="SECT3"
 256 ><A
 257 NAME="AEN1295">Right-Clicking</H3
 258 ><P
 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
 262 ><P
 263 ></P
 264 ><UL
 265 ><LI
 266 ><P
 267 > <SPAN
 268 CLASS="emphasis"
 269 ><I
 270 CLASS="EMPHASIS"
 271 >Properties</I
 272 ></SPAN
 273 > &#8211;
 274                   information relating to the currently selected item
 275                   is displayed. The information is equivalent to that
 276                   displayed in the Properties
 277                   Window.</P
 278 ></LI
 279 ><LI
 280 ><P
 281 > <SPAN
 282 CLASS="emphasis"
 283 ><I
 284 CLASS="EMPHASIS"
 285 >Restore Defaults</I
 286 ></SPAN
 287 > -
 288                   the default value of the currently selected item is
 289                   restored.</P
 290 ></LI
 291 ><LI
 292 ><P
 293 ><SPAN
 294 CLASS="emphasis"
 295 ><I
 296 CLASS="EMPHASIS"
 297 >Visit Documentation</I
 298 ></SPAN
 299 >
 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
 304 ></LI
 305 ><LI
 306 ><P
 307 > <SPAN
 308 CLASS="emphasis"
 309 ><I
 310 CLASS="EMPHASIS"
 311 >View Header File</I
 312 ></SPAN
 313 >
 314                   &#8211; 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
 318                   the <SPAN
 319 CLASS="emphasis"
 320 ><I
 321 CLASS="EMPHASIS"
 322 >View-&gt;Settings</I
 323 ></SPAN
 324 > menu item
 325                   (see <A
 326 HREF="config-tool-settings.html"
 327 >the Section called <I
 328 >Settings</I
 329 > in Chapter 17</A
 330 >).
 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
 334                   repository.</P
 335 ></LI
 336 ><LI
 337 ><P
 338 ><SPAN
 339 CLASS="emphasis"
 340 ><I
 341 CLASS="EMPHASIS"
 342 >Unload Package</I
 343 ></SPAN
 344 > -
 345                   this is equivalent to using the
 346                   <SPAN
 347 CLASS="emphasis"
 348 ><I
 349 CLASS="EMPHASIS"
 350 >Build-&gt;Packages</I
 351 ></SPAN
 352 > menu item to
 353                   select and unload the package in
 354                   question.</P
 355 ></LI
 356 ></UL
 357 ></DIV
 358 ></DIV
 359 ><DIV
 360 CLASS="SECT2"
 361 ><H2
 362 CLASS="SECT2"
 363 ><A
 364 NAME="AEN1317">Conflicts Window</H2
 365 ><P
 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
 369             the CDL. See <A
 370 HREF="cdl-conflicts.html"
 371 >the Section called <I
 372 >Conflicts</I
 373 > in Chapter 24</A
 374 > .<P
 375 ><IMG
 376 SRC="pix/conflictwin.png"></P
 377 ></P
 378 ><P
 379 >The window comprises three columns:</P
 380 ><P
 381 ></P
 382 ><UL
 383 ><LI
 384 ><P
 385 >               <SPAN
 386 CLASS="emphasis"
 387 ><I
 388 CLASS="EMPHASIS"
 389 >Item</I
 390 ></SPAN
 391 ></P
 392 ><P
 393 >This is the macro name of the first item involved
 394                 in the conflict.</P
 395 ></LI
 396 ><LI
 397 ><P
 398 >
 399                 <SPAN
 400 CLASS="emphasis"
 401 ><I
 402 CLASS="EMPHASIS"
 403 >Conflict</I
 404 ></SPAN
 405 ></P
 406 ><P
 407 >This is a description of the conflict type. The currently
 408                 supported types are &#8220;unresolved&#8221;, &#8220;illegal
 409                 value&#8221;, &#8220;evaluation exception&#8221;, &#8220;goal
 410                 unsatisfied&#8221; and &#8220;bad data&#8221;.</P
 411 ></LI
 412 ><LI
 413 ><P
 414 >
 415                 <SPAN
 416 CLASS="emphasis"
 417 ><I
 418 CLASS="EMPHASIS"
 419 >Property</I
 420 ></SPAN
 421 ></P
 422 ><P
 423 >This contains a description of the configuration
 424                 item&#8217;s property that caused the conflict.</P
 425 ><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
 429 ></LI
 430 ></UL
 431 ><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
 435 CLASS="emphasis"
 436 ><I
 437 CLASS="EMPHASIS"
 438 >Locate</I
 439 ></SPAN
 440 >
 441 from the popup menu.</P
 442 ><P
 443 >You can use the <SPAN
 444 CLASS="emphasis"
 445 ><I
 446 CLASS="EMPHASIS"
 447 >Tools-&gt;Resolve Conflicts</I
 448 ></SPAN
 449 > menu
 450 item, or right-click over the item and select <SPAN
 451 CLASS="emphasis"
 452 ><I
 453 CLASS="EMPHASIS"
 454 >Resolve</I
 455 ></SPAN
 456 > from the popup menu,
 457 to resolve conflicts &#8212; <A
 458 HREF="config-tool-using-templates.html#RESOLVING-CONFLICTS"
 459 >the Section called <I
 460 >Resolving conflicts</I
 461 > in Chapter 19</A
 462 >.</P
 463 ><DIV
 464 CLASS="SECT3"
 465 ><H3
 466 CLASS="SECT3"
 467 ><A
 468 NAME="AEN1343">Output Window</H3
 469 ><P
 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
 474 ><P
 475 >Within the output window you can right-click to display a
 476 context menu which allows you to:</P
 477 ><P
 478 ></P
 479 ><UL
 480 ><LI
 481 ><P
 482 >Save the contents of the window to a
 483                   file</P
 484 ></LI
 485 ><LI
 486 ><P
 487 >Clear the contents of the
 488                   window</P
 489 ></LI
 490 ></UL
 491 ></DIV
 492 ><DIV
 493 CLASS="SECT3"
 494 ><H3
 495 CLASS="SECT3"
 496 ><A
 497 NAME="AEN1352">Properties Window</H3
 498 ><P
 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 &#8220;properties&#8221;.</P
 503 ><P
 504 >             <P
 505 ><IMG
 506 SRC="pix/propwin.png"></P
 507 ></P
 508 ><P
 509 >Two properties may be double-clicked as
 510             follows:</P
 511 ><P
 512 ></P
 513 ><UL
 514 ><LI
 515 ><P
 516 ><SPAN
 517 CLASS="emphasis"
 518 ><I
 519 CLASS="EMPHASIS"
 520 >URL</I
 521 ></SPAN
 522 > &#8211;
 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 &#8220;Visit
 527                   Documentation&#8221;.</P
 528 ></LI
 529 ><LI
 530 ><P
 531 ><SPAN
 532 CLASS="emphasis"
 533 ><I
 534 CLASS="EMPHASIS"
 535 >File</I
 536 ></SPAN
 537 > &#8211;
 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
 541                   the <SPAN
 542 CLASS="emphasis"
 543 ><I
 544 CLASS="EMPHASIS"
 545 >View-&gt;Settings</I
 546 ></SPAN
 547 > menu
 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
 551                   repository.</P
 552 ></LI
 553 ></UL
 554 ></DIV
 555 ><DIV
 556 CLASS="SECT3"
 557 ><H3
 558 CLASS="SECT3"
 559 ><A
 560 NAME="AEN1366">Short Description Window</H3
 561 ><P
 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 &#8220;Visit
 566               Documentation&#8221;.</P
 567 ></DIV
 568 ></DIV
 569 ></DIV
 570 ></DIV
 571 ><DIV
 572 CLASS="NAVFOOTER"
 573 ><HR
 574 ALIGN="LEFT"
 575 WIDTH="100%"><TABLE
 576 SUMMARY="Footer navigation table"
 577 WIDTH="100%"
 578 BORDER="0"
 579 CELLPADDING="0"
 580 CELLSPACING="0"
 581 ><TR
 582 ><TD
 583 WIDTH="33%"
 584 ALIGN="left"
 585 VALIGN="top"
 586 ><A
 587 HREF="config-tool-settings.html"
 588 ACCESSKEY="P"
 589 >Prev</A
 590 ></TD
 591 ><TD
 592 WIDTH="34%"
 593 ALIGN="center"
 594 VALIGN="top"
 595 ><A
 596 HREF="ecos-user-guide.html"
 597 ACCESSKEY="H"
 598 >Home</A
 599 ></TD
 600 ><TD
 601 WIDTH="33%"
 602 ALIGN="right"
 603 VALIGN="top"
 604 ><A
 605 HREF="config-tool-updating-configuration.html"
 606 ACCESSKEY="N"
 607 >Next</A
 608 ></TD
 609 ></TR
 610 ><TR
 611 ><TD
 612 WIDTH="33%"
 613 ALIGN="left"
 614 VALIGN="top"
 615 >Settings</TD
 616 ><TD
 617 WIDTH="34%"
 618 ALIGN="center"
 619 VALIGN="top"
 620 ><A
 621 HREF="the-ecos-configuration-tool.html"
 622 ACCESSKEY="U"
 623 >Up</A
 624 ></TD
 625 ><TD
 626 WIDTH="33%"
 627 ALIGN="right"
 628 VALIGN="top"
 629 >Updating the Configuration</TD
 630 ></TR
 631 ></TABLE
 632 ></DIV
 633 ></BODY
 634 ></HTML
 635 >