mirror of
https://github.com/eclipse-cdt/cdt
synced 2025-06-05 16:56:04 +02:00
Revised Property Pages and Multi-Config pref panels
This commit is contained in:
L. Frank Turovich
parent
75b18c16b3
commit
6ff5f0ac40
5 changed files with 117 additions and 80 deletions
Binary file not shown.
|
Before Width: | Height: | Size: 31 KiB After Width: | Height: | Size: 45 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 36 KiB After Width: | Height: | Size: 48 KiB |
|
|
@ -49,8 +49,8 @@
|
|||
<img src="../images/trans.gif" border="0" width="100" height="1" alt=""><a style="text-decoration:none" href="cdt_u_appearance_pref.htm">Appearance</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="100" height="1" alt=""><a style="text-decoration:none" href="cdt_u_pref_build.htm">Build preferences</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="150" height="1" alt=""><a style="text-decoration:none" href="cdt_u_console_pref.htm">Console</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="150" height="1" alt=""><a style="text-decoration:none" href="cdt_u_environment_pref.htm">Environment<br>
|
||||
</a><a style="text-decoration:none" href="cdt_u_make_pref.htm"><img src="../images/trans.gif" border="0" width="150" height="1" alt="">Make Targets</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="150" height="1" alt=""><a style="text-decoration:none" href="cdt_u_environment_pref.htm">Environment</a><br />
|
||||
<img src="../images/trans.gif" border="0" width="150" height="1" alt=""><a style="text-decoration:none" href="cdt_u_make_pref.htm">Make Targets</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="150" height="1" alt=""><a style="text-decoration:none" href="cdt_u_makefile_settings_pref.htm">Makefile Editor</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="200" height="1" alt=""><a style="text-decoration:none" href="cdt_u_make_settings_pref.htm">Settings</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="100" height="1" alt=""><a style="text-decoration:none" href="cdt_u_debug.htm">Debug preferences</a><br>
|
||||
|
|
@ -65,7 +65,7 @@
|
|||
<img src="../images/trans.gif" border="0" width="150" height="1" alt=""><a style="text-decoration:none" href="cdt_u_c_editor_folding.htm">Folding</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="150" height="1" alt=""><a style="text-decoration:none" href="cdt_u_c_editor_hov.htm">Hovers</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="150" height="1" alt=""><a style="text-decoration:none" href="cdt_u_c_editor_mark_occurrences.htm">Mark Occurrences<br>
|
||||
</a><img src="../images/trans.gif" border="0" width="150" height="1" alt=""><a style="text-decoration:none" href="cdt_u_c_editor_save_actions.htm">Save Actions</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="150" height="1" alt=""><a style="text-decoration:none" href="cdt_u_c_editor_save_actions.htm">Save Actions</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="150" height="1" alt=""><a style="text-decoration:none" href="cdt_u_c_editor_scalability.htm">Scalability</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="150" height="1" alt=""><a style="text-decoration:none" href="cdt_u_c_editor_color.htm">Syntax Coloring</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="150" height="1" alt=""><a style="text-decoration:none" href="cdt_u_code_temp.htm">Templates</a><br>
|
||||
|
|
@ -73,6 +73,10 @@
|
|||
<img src="../images/trans.gif" border="0" width="100" height="1" alt=""><a style="text-decoration:none" href="cdt_u_c_file_types.htm">File Types</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="100" height="1" alt=""><a style="text-decoration:none" href="cdt_u_indexer_preference.html">Indexer</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="100" height="1" alt=""><a style="text-decoration:none" href="cdt_u_language_mapping_pref.htm">Language Mappings</a><br>
|
||||
|
||||
<img src="../images/trans.gif" border="0" width="100" height="1" alt=""><a style="text-decoration:none" href="cdt_u_pref_prop_pages.htm">Property Pages Settings</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="150" height="1" alt=""><a style="text-decoration:none" href="cdt_u_pref_multi_cfg.htm">Multi-Configuration Edit</a><br>
|
||||
|
||||
<img src="../images/trans.gif" border="0" width="100" height="1" alt=""><a style="text-decoration:none" href="cdt_u_make_pref.htm"></a><br>
|
||||
<img src="../images/trans.gif" border="0" width="100" height="1" alt=""><a style="text-decoration:none" href="cdt_o_proj_prop_pages.htm">New Make Projects properties preferences</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="150" height="1" alt=""><a style="text-decoration:none" href="cdt_u_newproj_buildset.htm">Make Builder preferences</a><br>
|
||||
|
|
|
|||
|
|
@ -6,56 +6,63 @@
|
|||
<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">
|
||||
<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"></script>
|
||||
</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>Use the <img src="../images/command_link.png" border="0" alt="" /> <a class="command-link" href='javascript:executeCommand("org.eclipse.ui.window.preferences(preferencePageId=org.eclipse.cdt.managedbuilder.ui.preferences.PrefPage_MultiConfig)")'>Multi-Configuration Edit</a> preference panel to simultaneously edit properties for multiple project configurations. Its possible to select one or more configurations for editing.</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><strong>Conjunction</strong> shows common elements only, so if 1st configuration has
|
||||
value <A, B, C> and 2nd configuration has <B, C, D>, <B, C> will be shown.
|
||||
<li><strong>Disjunction</strong> shows all existing elements except doubles, so if 1st configuration has
|
||||
value <A, B, C> and 2nd configuration has <B, C, D>, <A, B, C, D> 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><strong>Modify mode</strong> adds, changes or removes elements affected by user's actions.
|
||||
Elements which were not touched by user are left unchanged.<br>
|
||||
Example: cfg1 has <A, B, C>; cfg2 has <B, C, D>.<br>
|
||||
User removed B and added F.<br>
|
||||
Result: cfg1 has <A, C, F>; cfg2 has <C, D, F>.
|
||||
<li><strong>Replace mode</strong> puts currently visible elements to all configurations.
|
||||
Old contents will be lost.<br>
|
||||
Example: cfg1 has <A, B, C>; cfg2 has <B, C, D>.<br>
|
||||
Visible list depends of Display mode: <B, C> or <A, B, C, D>.<br>
|
||||
User removed B and added F.<br>
|
||||
Result: both cfgs will contain either <C, F> or <A, C, D, F> 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>
|
||||
|
||||
<table width="600px" cellpadding="5" cellspacing="0" border="1" fgcolor="DDD" >
|
||||
<caption><strong>Property Pages Settings Preference Options</strong></caption>
|
||||
<colgroup>
|
||||
<col width="30%" valign="top" >
|
||||
<col width="70%" valign="top" >
|
||||
</colgroup>
|
||||
<thead>
|
||||
<tr>
|
||||
<th><b>Option</b></th>
|
||||
<th><b>Description</b></th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr valign="top" >
|
||||
<td><b>String list Display Mode</b></td>
|
||||
<td>Specifies how values are shown. The two options are:
|
||||
<ul>
|
||||
<li><b>Conjunction</b> shows common elements only, so if 1st configuration has
|
||||
value <A, B, C> and 2nd configuration has <B, C, D>, <B, C> will be shown.
|
||||
<li><b>Disjunction</b> shows all existing elements except doubles, so if 1st configuration has
|
||||
value <A, B, C> and 2nd configuration has <B, C, D>, <A, B, C, D> 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 is refreshed according to selected mode.</td>
|
||||
</tr>
|
||||
<tr valign="top" >
|
||||
<td><b>String list Write Mode</b></td>
|
||||
<td>Specifies how values are saved. The two options are:
|
||||
<ul>
|
||||
<li><strong>Modify mode</strong> adds, changes or removes elements affected by user's actions.
|
||||
Elements which were not touched by user are left unchanged.<br>
|
||||
Example: cfg1 has <A, B, C>; cfg2 has <B, C, D>.<br>
|
||||
User removed B and added F.<br>
|
||||
Result: cfg1 has <A, C, F>; cfg2 has <C, D, F>.
|
||||
<li><strong>Replace mode</strong> puts currently visible elements to all configurations.
|
||||
Old contents will be lost.<br>
|
||||
Example: cfg1 has <A, B, C>; cfg2 has <B, C, D>.<br>
|
||||
Visible list depends of Display mode: <B, C> or <A, B, C, D>.<br>
|
||||
User removed B and added F.<br>
|
||||
Result: both cfgs will contain either <C, F> or <A, C, D, F> depending of Display mode.
|
||||
</ul>
|
||||
Note that Write mode can be changed directly on each tab which deals with string lists.</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
<p><img border="0" src="../images/ngref.gif" ALT="Related reference" width="143" height="21"><br />
|
||||
<a href="cdt_u_pref_prop_pages.htm">Property Pages Settings preferences</a></p>
|
||||
</body>
|
||||
|
||||
</html>
|
||||
|
|
|
|||
|
|
@ -6,46 +6,72 @@
|
|||
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
||||
<title>Property Pages Settings preferences</title>
|
||||
<link rel="stylesheet" type="text/css" href="../help.css">
|
||||
<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<h1>Property Pages Settings preferences</h1>
|
||||
|
||||
<p>These settings affect behaviour of CDT property pages.</p>
|
||||
<p><img src="../images/cdt_pref-prop-pages.png" alt="Property Pages Settings preferences tab"></p>
|
||||
<dl>
|
||||
<dt>Show 'Manage Configurations...' button</dt>
|
||||
<dd>Shows or hides corresponding button, normally placed on every property page.<br>
|
||||
If this button is hidden, Manage operation can be accessed from Main Menu or Context Menu.</dd>
|
||||
<dt>Display 'Data hierarchy' tab</dt>
|
||||
<dd>Displays auxilliary tab which allows browsing data of project configurations.
|
||||
This feature is useful for debug purposes mostly, so it's disabled by default.</dd>
|
||||
<dt>Display 'Tool Chain Editor' tab</dt>
|
||||
<dd>Shows or hides corresponding tab. Normally, users need not to edit tool chains manually.</dd>
|
||||
<dt>Save property dialog bounds</dt>
|
||||
<dd>Defines how property dialog parameters will be preserved:
|
||||
<ul>
|
||||
<li>Save dialog size only (position is set by system).
|
||||
<li>Save dialog and position (next time, dialog will be shown on the same place with the same size).
|
||||
<li>Do not save at all (size and position is set by system each time when dialog is shown).
|
||||
</ul>
|
||||
</dd>
|
||||
<dt>Discovery profiles naming rule</dt>
|
||||
<dd>Discovery profiles have unique IDs, but their names may be duplicate,
|
||||
expecially if they are contributed by different developers. So there
|
||||
<p>Use the <img src="../images/command_link.png" border="0" alt="" /> <a class="command-link" href='javascript:executeCommand("org.eclipse.ui.window.preferences(preferencePageId=org.eclipse.cdt.managedbuilder.ui.preferences.PrefPage_PropertyPage)")'>Property Pages Settings</a> preference panel to set the behaviors of CDT property pages.</p>
|
||||
<p><img src="../images/cdt_pref-prop-pages.png" alt="Property Pages Settings Preference Panel"></p>
|
||||
|
||||
<table width="600px" cellpadding="5" cellspacing="0" border="1" fgcolor="DDD" >
|
||||
<caption><strong>Property Pages Settings Preference Options</strong></caption>
|
||||
<colgroup>
|
||||
<col width="30%" valign="top" >
|
||||
<col width="70%" valign="top" >
|
||||
</colgroup>
|
||||
<thead>
|
||||
<tr>
|
||||
<th><b>Option</b></th>
|
||||
<th><b>Description</b></th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr valign="top" >
|
||||
<td><b>Show 'Manage Configurations...' button</b></td>
|
||||
<td>Shows or hides corresponding button, normally placed on every property page.<br>
|
||||
If this button is hidden, Manage operation can be accessed from Main Menu or Context Menu.</td>
|
||||
</tr>
|
||||
<tr valign="top" >
|
||||
<td><b>Display 'Data hierarchy' tab</b></td>
|
||||
<td>Displays auxiliary tab which allows browsing data of project configurations.
|
||||
This feature is useful for debug purposes mostly, so it's disabled by default.</td>
|
||||
</tr>
|
||||
<tr valign="top" >
|
||||
<td><b>Display tool option tips of 'Tool Settings' tab at fixed location</b></td>
|
||||
<td></td>
|
||||
</tr>
|
||||
<tr valign="top" >
|
||||
<td><b>Display 'Tool Chain Editor' tab</b></td>
|
||||
<td>Shows or hides corresponding tab. Normally, users need not to edit tool chains manually.</td>
|
||||
</tr>
|
||||
<tr valign="top" >
|
||||
<td><b>Save Property Dialog Bounds</b></td>
|
||||
<td>Defines how property dialog parameters are preserved:
|
||||
<ul>
|
||||
<li><b>Save size only</b> - position is set by system</li>
|
||||
<li><b>Save size and position</b> - next time, dialog is shown at the same place with the same size</li>
|
||||
<li><b>Do not save at all</b> - size and position is set by system each time dialog is shown</li>
|
||||
</ul></td>
|
||||
</tr>
|
||||
<tr valign="top" >
|
||||
<td><b>Discovery Profiles Naming Rule</b></td>
|
||||
<td>Discovery profiles have unique IDs, but their names may be duplicate,
|
||||
especially if they are contributed by different developers. So there
|
||||
are 4 way to distinguish them in the list on Discovery tab:
|
||||
<ul>
|
||||
<li>Show names if they are unique. Else show Name + ID.
|
||||
<li>Show names if they are unique. Else show IDs only.
|
||||
<li>Always show Name + ID.
|
||||
<li>Always show IDs only.
|
||||
</ul>
|
||||
</dd>
|
||||
<dt>Restore Defaults</dt>
|
||||
<dd>Sets all parameters to default values</dd>
|
||||
<dt>Apply</dt>
|
||||
<dd>Saves current settings.</dd>
|
||||
</dl>
|
||||
<li>Show disc. page names if they are unique. Else names + profile IDs.</li>
|
||||
<li>Show disc. page names if they are unique. Else show profile IDs.</li>
|
||||
<li>Always show names + profile IDs</li>
|
||||
<li>Always show profile IDs only</li>
|
||||
</ul></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
<p><img border="0" src="../images/ngref.gif" ALT="Related reference" width="143" height="21"><br />
|
||||
<a href="cdt_u_pref_multi_cfg.htm">Multi-Configuration Edit preferences</a></p>
|
||||
|
||||
</body>
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue