carbidecpp22devenv/configuration/org.eclipse.osgi/bundles/309/1/.cp/reference/cdt_u_pref_multi_cfg.htm
changeset 5 684bf18fdedf
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/carbidecpp22devenv/configuration/org.eclipse.osgi/bundles/309/1/.cp/reference/cdt_u_pref_multi_cfg.htm	Fri Dec 04 10:01:33 2009 -0600
@@ -0,0 +1,61 @@
+<!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>