carbidecpp22devenv/configuration/org.eclipse.osgi/bundles/309/1/.cp/reference/cdt_u_pref_multi_cfg.htm
author cawthron
Fri, 04 Dec 2009 10:01:33 -0600
changeset 5 684bf18fdedf
permissions -rw-r--r--
add files for RCL_2_2

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html lang="en">

<head>
	<meta http-equiv="Content-Language" content="en-us">
	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
	<title>Multi-Configuration Edit preferences</title>
	<link rel="stylesheet" type="text/css" href="../help.css">
</head>
<body>

<h1>Multi-Configuration Edit preferences</h1>

<p>Since CDT 5.0, user is able to edit properties for 
multiple project configurations simultaneously.</p>
<p>Either all configuations or some of them can be selected.</p>
<p>But, then we deal with string list property values, 
it is not obvious how to concatenate them, if they differ.</p>


<p><img src="../images/cdt_pref-multi-cfg.png" alt="Multi-Configuration Edit preferences tab"></p>
<dl>
  <dt>String list Display Mode</dt>
  <dd>Specifies how values will be shown.<br>
  There are 2 options: conjunction or disjunction.
  <ul>
  <li><b>Conjunction</b> shows common elements only, so if 1st configuration has 
  value &lt;A, B, C&gt; and 2nd configuration has &lt;B, C, D&gt;, &lt;B, C&gt; will be shown. 
  <li><b>Disjunction</b> shows all existing elements except doubles, so if 1st configuration has 
  value &lt;A, B, C&gt; and 2nd configuration has &lt;B, C, D&gt;, &lt;A, B, C, D&gt; will be shown. 
  </ul>
  Note that Display mode can be changed directly on each tab which deals with string lists.
  Result is immediate: data on the tab refereshed according to selected mode.<br>
  </dd>
  <dt>String list Write Mode</dt>
  <dd>Specifies how values will be saved.<br>
  There are 2 options: modify or replace.
  <ul>
  <li><b>Modify mode</b> adds, changes or removes elements affected by user's actions.
  Elements which were not touched by user are left unchanged.<br>   
  Example: cfg1 has &lt;A, B, C&gt;; cfg2 has &lt;B, C, D&gt;.<br>
  User removed B and added F.<br>
  Result: cfg1 has &lt;A, C, F&gt;; cfg2 has &lt;C, D, F&gt;.
  <li><b>Replace mode</b> puts currently visible elements to all configurations.
  Old contents will be lost.<br>
  Example: cfg1 has &lt;A, B, C&gt;; cfg2 has &lt;B, C, D&gt;.<br>
  Visible list depends of Display mode: &lt;B, C&gt; or &lt;A, B, C, D&gt;.<br>
  User removed B and added F.<br>
  Result: both cfgs will contain either &lt;C, F&gt; or &lt;A, C, D, F&gt; depending of Display mode.
  </ul>
  Note that Write mode can be changed directly on each tab which deals with string lists.<br>
  </dd>
  <dt>Restore Defaults</dt>
  <dd>Sets all parameters to default values</dd>
  <dt>Apply</dt>
  <dd>Saves current settings.</dd>
</dl>

</body>

</html>