config-tool.sgml

eCos操作系统源码

<ORDEREDLIST>

<LISTITEM>
<PARA>
Using the internal help system. This will show an internal viewer similar to Microsoft HTML Help, with a contents
hierarchy on the left and HTML pages on the right; see <xref linkend="figure-help-viewer">. The index is regenerated for each repository. If the documentation in
the repository has changed but the contents does not reflect this, please use the Tools Regenerate Help Index menu
item.
</PARA>
</LISTITEM>

<LISTITEM>
<PARA>
Using the default HTML browser. On Unix, you will need a .mailcap entry similar to this:
</PARA>

<PARA>
<PROGRAMLISTING>
text/html; netscape -no-about-splash %s
</PROGRAMLISTING>
</PARA>
</LISTITEM>

<LISTITEM>
<PARA>
Using the specified browser.
</PARA>
</LISTITEM>

</ORDEREDLIST>


<FIGURE id="figure-help-viewer">
<TITLE>HTML Help viewer</TITLE>
<GRAPHIC ENTITYREF="graphic5"></GRAPHIC>
</FIGURE>
<PARA>If you wish, you may choose to have <EMPHASIS>HTML Help</EMPHASIS> displayed
in a browser of your choice. To do this, select <EMPHASIS>View</EMPHASIS>-&gt;<EMPHASIS>Settings</EMPHASIS> and
use the controls in the View Documentation group to select the replacement browser.
Note that the Navigation facilities of the built-in <EMPHASIS>HTML
Help</EMPHASIS> system will be unavailable if you choose this method
of displaying help.</PARA>
</SECT1>
</CHAPTER>

<!-- }}} -->  
<!-- {{{ Customization                  -->

<CHAPTER id="config-tool-customization">
<TITLE>Customization</TITLE>
<PARA>The following visual aspects of the <productname>eCos</productname> <application>Configuration Tool</application> can be changed to suit
	individual preferences. These aspects are saved on a per-user
	basis, so that when the <productname>eCos</productname> <application>Configuration Tool</application> is next invoked by the same
	user, the appearance will be as set in the previous
	session.</PARA>
<SECT1 id="config-tool-window-placement">
<TITLE>Window Placement</TITLE>
<PARA>The relative sizes of all windows in the <productname>eCos</productname> <application>Configuration Tool</application> may be adjusted by dragging
	  the splitter bars that separate the windows. The chosen
	  sizes will be used the next time the <productname>eCos</productname> <application>Configuration Tool</application> is invoked by the current
	  user. </PARA>
<PARA>All windows except the <EMPHASIS>Configuration
	    Window</EMPHASIS> may be shown or hidden by using the
	  commands under the <EMPHASIS>View</EMPHASIS> menu (for
	  example, <EMPHASIS>View-&gt;Output</EMPHASIS>) or the
	  corresponding keyboard accelerators
	  (<EMPHASIS>Alt+1</EMPHASIS> to
	  <EMPHASIS>Alt+4</EMPHASIS>).
<!--
By default the
conflicts window is hidden.
-->
</PARA>
<PARA>Your chosen set of windows (and their relative sizes) will
be preserved between invocations of the <productname>eCos</productname> <application>Configuration
Tool</application>.</PARA>
</SECT1>
<!--
<SECT1 id="config-tool-toolbars">
<TITLE>Toolbars</TITLE>
<PARA>Select
	  <EMPHASIS>View</EMPHASIS>-&gt;<EMPHASIS>Toolbars</EMPHASIS>:
	  each of the standard and Memory Layout toolbars may be
	  hidden or shown.</PARA>
</SECT1>
-->
<SECT1 id="config-tool-settings">
<TITLE>Settings</TITLE>
<PARA>To change other visual aspects, select
	  <EMPHASIS>View</EMPHASIS>-&gt;<EMPHASIS>Settings</EMPHASIS>
	  and then select the <EMPHASIS>Display</EMPHASIS> and
          <EMPHASIS>View</EMPHASIS> tabs depending on the settings
          you wish to alter..
	  The options are as follows:
</PARA>


<SECT2>
<TITLE>Settings: Display tab</TITLE>

<FIGURE>
<TITLE>Settings dialog, Display tab</TITLE>
<GRAPHIC ENTITYREF="graphic32"></GRAPHIC>
</FIGURE>

<SECT3>
<TITLE>Labels</TITLE>

<PARA>In the configuration window, you can choose to have
	    either <EMPHASIS>descriptive names</EMPHASIS> (the
	    default) or <EMPHASIS>macro names</EMPHASIS> displayed as
	    tree item labels. Descriptive names are generally more
	    comprehensible, but macro names are used in some contexts
	    such as conflict resolution and may be directly related to
	    the source code of the configuration. Note that it is
	    possible to search for an item in the configuration view
	    by selecting
	    <EMPHASIS>Find</EMPHASIS>-&gt;<EMPHASIS>Edit</EMPHASIS>
	    (see <xref linkend="config-tool-searching">). Both
	    descriptive names and macro names can be searched.</PARA>
</SECT3>

<SECT3>
<TITLE>Integer Items</TITLE>
<PARA>You can choose to have integer items in the
	    Configuration Window displayed in decimal or hexadecimal
	    format.</PARA>
</SECT3>

<SECT3>
<TITLE>Font</TITLE>

<PARA>
Change the font for a particular window by selecting the window name using the drop-down list,
then clicking on <EMPHASIS>Change Font</EMPHASIS> to select a font for that
window. The changes will be applied when the press <EMPHASIS>OK</EMPHASIS> to dismiss the Settings dialog.
If you never make font changes, then the windows will take
the default setting determined by your current Windows or Unix environment. 
</PARA>
</SECT3>

<SECT3>
<TITLE>Miscellaneous</TITLE>

<PARA>
If the <EMPHASIS>Splash Screen</EMPHASIS> checkbox is checked, a <EMPHASIS>splash</EMPHASIS>
window will appear as the application is loading. Uncheck this to eliminate the splash screen.
</PARA>

</SECT3>
</SECT2>

<SECT2>
<TITLE>Settings: Viewers tab</TITLE>

<FIGURE>
<TITLE>Settings dialog, Viewers tab</TITLE>
<GRAPHIC ENTITYREF="graphic6"></GRAPHIC>
</FIGURE>

<SECT3>
<TITLE>View header files</TITLE>

<PARA>You can change the viewer used to display header files.</PARA>
</SECT3>

<SECT3>
<TITLE>View documentation</TITLE>

<PARA>You can change the viewer used to display HTML files.
See <xref linkend="methods-of-displaying-html-help">.
</PARA>



</SECT3>

</SECT2>

</SECT1>
</CHAPTER>

<!-- }}} -->  
<!-- {{{ Screen Layout                  -->

<CHAPTER id="config-tool-screen-layout">
<TITLE>Screen Layout</TITLE>
<PARA>The following windows are available within the
      <productname>eCos</productname> <application> Configuration
        Tool</application>:
    </PARA>
<ITEMIZEDLIST>
<LISTITEM>
<PARA>		Configuration Window</PARA>
</LISTITEM>
<LISTITEM>
<PARA>		Properties Window</PARA>
</LISTITEM>
<LISTITEM>
<PARA>		Short Description</PARA>
</LISTITEM>
<LISTITEM>
<PARA>		Conflicts</PARA>
</LISTITEM>
<LISTITEM>
<PARA>		Output</PARA>
</LISTITEM>
</ITEMIZEDLIST>

<PARA>The layout of the windows may be adjusted to suit your
	preferences: see <xref linkend="config-tool-settings">.</PARA>

<SECT1 id="config-tool-configuration-window">
<TITLE>Configuration Window</TITLE>
<PARA>This is the principal window used to configure <productname>eCos</productname>. It
	  takes the form of a tree-based representation of the
	  configuration items within the currently loaded <productname>eCos</productname>
	  packages.</PARA>
<PARA>In the case of items whose values may be changed,
	  controls are available to set the item values. These either
	  take the form of check boxes or radio buttons within the
	  tree itself or cells to the right of the thin vertical
	  splitter bar. Controls in the tree may be used in the usual
	  way; cells, however, must first be activated.</PARA>
<PARA>To activate a cell, simply click on it: it will assume a sunken
appearance and data can then be edited in the cell. To terminate
in-cell editing, click elsewhere in the configuration window or
press <EMPHASIS>ENTER</EMPHASIS>. To discard the partial results
of in-cell editing and revert to the previous value, press <EMPHASIS>ESCAPE</EMPHASIS>.
<!-- Not yet implemented
Note that an asterisk appears against configuration items which have changed since the configuration
was last saved.
-->
</PARA>
<PARA><GRAPHIC ENTITYREF="graphic7"></GRAPHIC></PARA>
<PARA>Cells come in three varieties, according to the type of
	  data they accept:</PARA>
<TABLE>
<TITLE>Cell types</TITLE>
<TGROUP COLS="2">
<THEAD>
<ROW>
<ENTRY>Cell Type</ENTRY>
<ENTRY><PARA>Data Accepted</PARA></ENTRY>
</ROW>
</THEAD>
<TBODY>
<ROW>
<ENTRY>Integer</ENTRY>
<ENTRY>Decimal or hexadecimal values</ENTRY>
</ROW>
<ROW>
<ENTRY>Floating Point</ENTRY>
<ENTRY>Floating point values</ENTRY>
</ROW>
<ROW>
<ENTRY>String</ENTRY>
<ENTRY>Any</ENTRY>
</ROW>
</TBODY>
</TGROUP>
</TABLE><!--
<row>
<cell><normal>Integer</normal></cell><cell><normal>Decimal or hexadecimal
values</normal></cell></row>
<row>
<cell><normal>Floating Point</normal></cell><cell><normal>Floating
point values</normal></cell></row>
<row>
<cell><normal>String</normal></cell><cell><normal>Any</normal></cell></row>
</body></formata>
-->
<PARA>In the case of string cells, you can double-click the cell
to display a dialog box containing a larger region in which to edit
the string value. This is useful in the case of long strings, or
those spanning multiple lines.</PARA>
<SECT2>
<TITLE>Disabled items</TITLE>
<PARA>Some items will appear disabled. In this case the item
	    label and any associated controls and cells will be
	    grayed. It is not be possible to change the values of
	    disabled items.</PARA>
<SECT3>
<TITLE>Right-Clicking</TITLE>
<PARA>You can right-click on an item in the configuration
	      window item to display a pop-up menu which (depending on
	      the type of the item selected) allows you to:</PARA>
<ITEMIZEDLIST>
<LISTITEM>
<PARA> <EMPHASIS>Properties</EMPHASIS> &ndash;
		  information relating to the currently selected item
		  is displayed. The information is equivalent to that
		  displayed in the Properties
		  Window.</PARA>
</LISTITEM>
<LISTITEM>
<PARA> <EMPHASIS>Restore Defaults</EMPHASIS> -
		  the default value of the currently selected item is
		  restored.</PARA>
</LISTITEM>
<LISTITEM>
<PARA><EMPHASIS>Visit Documentation</EMPHASIS>
		  - causes the HTML page most closely relating to the
		  currently selected item to be displayed. This has
		  the same effect as double-clicking the URL property
		  in the Properties Window.</PARA>
</LISTITEM>
<LISTITEM>
<PARA> <EMPHASIS>View Header File</EMPHASIS>
		  &ndash; this causes the file containing the items to
		  be displayed. This is equivalent to double-clicking
		  on the File property in the Properties Window. The
		  viewer used for this purpose may be changed using
		  the <EMPHASIS>View-&gt;Settings</EMPHASIS> menu item
		  (see <xref linkend="config-tool-settings">).
		  Note that this operation is only possible when the
		  current configuration is saved, in order to avoid
		  the possibility of changing the source
		  repository.</PARA>
</LISTITEM>
<LISTITEM>
<PARA><EMPHASIS>Unload Package</EMPHASIS> -
		  this is equivalent to using the
		  <EMPHASIS>Build-&gt;Packages</EMPHASIS> menu item to
		  select and unload the package in
		  question.</PARA>
</LISTITEM>
</ITEMIZEDLIST>
</SECT3>
</SECT2>
<SECT2>
<TITLE>Conflicts Window</TITLE>
<PARA>This window exists to display any configuration item
	    conflicts. Conflicts are the result of failures to meet
	    the requirements between configuration items expressed in
	    the CDL. See <xref linkend="cdl-conflicts"> <!--in &ldquo;CDL
	    Concepts&rdquo; on&nbsp;page&nbsp;45 -->.<GRAPHIC ENTITYREF="graphic8"></GRAPHIC></PARA>
<PARA>The window comprises three columns:</PARA>
<ITEMIZEDLIST>
<LISTITEM>
<PARA>		<EMPHASIS>Item</EMPHASIS></PARA>
<PARA>This is the macro name of the first item involved
		in the conflict.</PARA>
</LISTITEM>
<LISTITEM>
<PARA>			
		<EMPHASIS>Conflict</EMPHASIS></PARA>
<PARA>This is a description of the conflict type. The currently
		supported types are &ldquo;unresolved&rdquo;, &ldquo;illegal
		value&rdquo;, &ldquo;evaluation exception&rdquo;, &ldquo;goal
		unsatisfied&rdquo; and &ldquo;bad data&rdquo;.</PARA>
</LISTITEM>
<LISTITEM>
<PARA>			
		<EMPHASIS>Property</EMPHASIS></PARA>
<PARA>This contains a description of the configuration
		item&rsquo;s property that caused the conflict.</PARA>
<PARA>Within the conflicts window you can right-click on
		any item to display a context menu which allows you to
		choose from one of the following options:</PARA>
</LISTITEM>
</ITEMIZEDLIST>

<PARA>To locate the item involved in the
conflict, double-click in the first or third column, or
right-click over the item and choose <EMPHASIS>Locate</EMPHASIS>
from the popup menu.
</PARA>

<PARA>You can use the <EMPHASIS>Tools-&gt;Resolve Conflicts</EMPHASIS> menu
item, or right-click over the item and select <EMPHASIS>Resolve</EMPHASIS> from the popup menu,
to resolve conflicts &mdash; <xref linkend="resolving-conflicts">.</PARA>
<SECT3>
<TITLE>Output Window</TITLE>
<PARA>This window displays any output generated by
	      execution of external tools and any error messages that
	      are not suitable for display in other forms (for
	      example, as message boxes).</PARA>
<PARA>Within the output window you can right-click to display a
context menu which allows you to:</PARA>
<ITEMIZEDLIST>