diff --git a/doc/org.eclipse.cdt.doc.user/images/cdt_pref-multi-cfg.png b/doc/org.eclipse.cdt.doc.user/images/cdt_pref-multi-cfg.png index bc593fe53a6..ad7a53afb5a 100644 Binary files a/doc/org.eclipse.cdt.doc.user/images/cdt_pref-multi-cfg.png and b/doc/org.eclipse.cdt.doc.user/images/cdt_pref-multi-cfg.png differ diff --git a/doc/org.eclipse.cdt.doc.user/images/cdt_pref-prop-pages.png b/doc/org.eclipse.cdt.doc.user/images/cdt_pref-prop-pages.png index 167a0ab303b..c10f770ffa0 100644 Binary files a/doc/org.eclipse.cdt.doc.user/images/cdt_pref-prop-pages.png and b/doc/org.eclipse.cdt.doc.user/images/cdt_pref-prop-pages.png differ diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_o_ref.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_o_ref.htm index 2f51dc4bc50..e7d59b57345 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_o_ref.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_o_ref.htm @@ -49,8 +49,8 @@ Appearance
Build preferences
Console
- Environment
- Make Targets
+ Environment
+ Make Targets
Makefile Editor
Settings
Debug preferences
@@ -65,7 +65,7 @@ Folding
Hovers
Mark Occurrences
- Save Actions
+ Save Actions
Scalability
Syntax Coloring
Templates
@@ -73,6 +73,10 @@ File Types
Indexer
Language Mappings
+ + Property Pages Settings
+ Multi-Configuration Edit
+
New Make Projects properties preferences
Make Builder preferences
diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_pref_multi_cfg.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_pref_multi_cfg.htm index 784686fc4de..e16e78fd92d 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_pref_multi_cfg.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_pref_multi_cfg.htm @@ -6,56 +6,63 @@ Multi-Configuration Edit preferences +

Multi-Configuration Edit preferences

- -

Since CDT 5.0, user is able to edit properties for -multiple project configurations simultaneously.

-

Either all configuations or some of them can be selected.

-

But, then we deal with string list property values, -it is not obvious how to concatenate them, if they differ.

- - +

Use the Multi-Configuration Edit preference panel to simultaneously edit properties for multiple project configurations. Its possible to select one or more configurations for editing.

+

But, then we deal with string list property values, it is not obvious how to concatenate them, if they differ.

Multi-Configuration Edit preferences tab

-
-
String list Display Mode
-
Specifies how values will be shown.
- There are 2 options: conjunction or disjunction. - - 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.
-
-
String list Write Mode
-
Specifies how values will be saved.
- There are 2 options: modify or replace. - - Note that Write mode can be changed directly on each tab which deals with string lists.
-
-
Restore Defaults
-
Sets all parameters to default values
-
Apply
-
Saves current settings.
-
+ + + + + + + + + + + + + + + + + + + + + + +
Property Pages Settings Preference Options
OptionDescription
String list Display ModeSpecifies how values are shown. The two options are: +
    +
  • Conjunction 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. +
  • Disjunction 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. +
+ 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.
String list Write ModeSpecifies how values are saved. The two options are: +
    +
  • Modify mode adds, changes or removes elements affected by user's actions. + Elements which were not touched by user are left unchanged.
    + Example: cfg1 has <A, B, C>; cfg2 has <B, C, D>.
    + User removed B and added F.
    + Result: cfg1 has <A, C, F>; cfg2 has <C, D, F>. +
  • Replace mode puts currently visible elements to all configurations. + Old contents will be lost.
    + Example: cfg1 has <A, B, C>; cfg2 has <B, C, D>.
    + Visible list depends of Display mode: <B, C> or <A, B, C, D>.
    + User removed B and added F.
    + Result: both cfgs will contain either <C, F> or <A, C, D, F> depending of Display mode. +
+ Note that Write mode can be changed directly on each tab which deals with string lists.
+ +

Related reference
+Property Pages Settings preferences

diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_pref_prop_pages.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_pref_prop_pages.htm index 350968b9e15..c06657f7742 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_pref_prop_pages.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_pref_prop_pages.htm @@ -6,46 +6,72 @@ Property Pages Settings preferences +

Property Pages Settings preferences

-

These settings affect behaviour of CDT property pages.

-

Property Pages Settings preferences tab

-
-
Show 'Manage Configurations...' button
-
Shows or hides corresponding button, normally placed on every property page.
- If this button is hidden, Manage operation can be accessed from Main Menu or Context Menu.
-
Display 'Data hierarchy' tab
-
Displays auxilliary tab which allows browsing data of project configurations. - This feature is useful for debug purposes mostly, so it's disabled by default.
-
Display 'Tool Chain Editor' tab
-
Shows or hides corresponding tab. Normally, users need not to edit tool chains manually.
-
Save property dialog bounds
-
Defines how property dialog parameters will be preserved: - -
-
Discovery profiles naming rule
-
Discovery profiles have unique IDs, but their names may be duplicate, - expecially if they are contributed by different developers. So there +

Use the Property Pages Settings preference panel to set the behaviors of CDT property pages.

+

Property Pages Settings Preference Panel

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Property Pages Settings Preference Options
OptionDescription
Show 'Manage Configurations...' buttonShows or hides corresponding button, normally placed on every property page.
+ If this button is hidden, Manage operation can be accessed from Main Menu or Context Menu.
Display 'Data hierarchy' tabDisplays auxiliary tab which allows browsing data of project configurations. + This feature is useful for debug purposes mostly, so it's disabled by default.
Display tool option tips of 'Tool Settings' tab at fixed location
Display 'Tool Chain Editor' tabShows or hides corresponding tab. Normally, users need not to edit tool chains manually.
Save Property Dialog BoundsDefines how property dialog parameters are preserved: +
    +
  • Save size only - position is set by system
    • +
  • Save size and position - next time, dialog is shown at the same place with the same size
    • +
  • Do not save at all - size and position is set by system each time dialog is shown
    • +
Discovery Profiles Naming RuleDiscovery 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:
    -
  • Show names if they are unique. Else show Name + ID. -
  • Show names if they are unique. Else show IDs only. -
  • Always show Name + ID. -
  • Always show IDs only. -
- -
Restore Defaults
-
Sets all parameters to default values
-
Apply
-
Saves current settings.
- +
  • Show disc. page names if they are unique. Else names + profile IDs.
    • +
  • Show disc. page names if they are unique. Else show profile IDs.
    • +
  • Always show names + profile IDs
    • +
  • Always show profile IDs only
    • +
    + +

    Related reference
    +Multi-Configuration Edit preferences