diff --git a/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_build_over.htm b/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_build_over.htm index ee1f5764f6b..f95468b7c52 100644 --- a/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_build_over.htm +++ b/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_build_over.htm @@ -50,7 +50,7 @@ For other operating systems please refer to your installation documentation.

For more information about the Tasks view, see Workbench User Guide > Reference > User interface information > Views and editors > Tasks view.

@@ -84,7 +84,7 @@ For other operating systems please refer to your installation documentation.

Controlling the building of your project

-

The C/C++ compiler that a project uses is controlled by the project's Properties setting. +

For a Standard Make project, the C/C++ compiler that a project uses is controlled by the project's Properties setting. To view a project's properties, right-click on the project and select Properties. In the dialog that appears, the C/C++ Standard Make Project page enables you to control a variety of settings, including:

@@ -97,13 +97,19 @@ In the dialog that appears, the C/C++ Standard Make Project page enables
Controls which makefile target will be built depending on the scope of the build.
+

For a Managed Make project, the project properties dialog enables you to manage the build configurations of your project. For additional information see:

+ +

Viewing build information

Build-related information is displayed as follows:

Related concepts @@ -113,6 +119,11 @@ In the dialog that appears, the C/C++ Standard Make Project page enables

Related tasks
Building

+

Related reference +
+Project Properties

+  +

Red Hat Copyright Statement
IBM Copyright Statement diff --git a/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_projects.htm b/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_projects.htm index 363759988c8..bf60f56953c 100644 --- a/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_projects.htm +++ b/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_projects.htm @@ -39,8 +39,7 @@ existing makefile.

Managed make C or C++ project

-

A managed make project generates the makefile for you automatically. In addition, the -files module.dep and module.mk are created for every project sub-directory. +

A managed make project generates the makefiles for you automatically. These files are required for your managed make projects to build successfully.

Project conversion

diff --git a/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_basic09.htm b/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_basic09.htm index 891fd1e5438..782caf80125 100644 --- a/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_basic09.htm +++ b/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_basic09.htm @@ -8,7 +8,7 @@

Additional Project Settings

-

Click the C/C++ Indexer tab, ensure Enable C/C++ Indexing is selected, otherwise search capabilities, and other tools that require search, will be disabled for your project. +

Click the C/C++ Indexer tab, ensure that the Full C/C++ Indexer is selected, otherwise search capabilities, and other tools that require search, will be disabled for your project.

Click Finish to close the dialog box.

diff --git a/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_import07.htm b/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_import07.htm index 5801fc10979..773bf47cc86 100644 --- a/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_import07.htm +++ b/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_import07.htm @@ -8,7 +8,7 @@

Additional Project Settings

-

Click the C/C++ Indexer tab, ensure Enable C/C++ Indexing is deselected for now. You will enable it later, otherwise search capabilities, and other tools that require search, will be disabled for your project. +

Click the C/C++ Indexer tab and select No Indexer for now. You will enable indexing later, otherwise search capabilities, and other tools that require search, will be disabled for your project.

Click Finish to close the dialog box.

diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_o_mmake_file.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_o_mmake_file.htm index 6e3287cf800..4da3f0544a3 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_o_mmake_file.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_o_mmake_file.htm @@ -15,7 +15,9 @@ Info
C/C++ Build
    -Tool Settings
+ Tool Settings
+     + Custom Build Steps

IBM Copyright Statement

diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_o_mmake_proj.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_o_mmake_proj.htm index 8e6816dae78..74055153907 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_o_mmake_proj.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_o_mmake_proj.htm @@ -20,11 +20,18 @@     Build Settings
    +Build Steps
+     Error Parsers
    Binary Parser
- File Types
- Indexer
+     +Environment
+     +Macros
+ C/C++ Documentation
+ C/C++ File Types
+ C/C++ Indexer
Project References

IBM Copyright Statement

diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_o_mproj_pref.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_o_mproj_pref.htm new file mode 100644 index 00000000000..d7c9474e36d --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_o_mproj_pref.htm @@ -0,0 +1,17 @@ + + + + + + +Project properties + + + + + +

Managed Make Project preferences

+ +

IBM Copyright Statement

+ + 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 568b09b1168..a2cccd1ed18 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 @@ -44,7 +44,7 @@ C/C++ Open Type
Create a Make Target
C/C++ Find/Replace
-C/C++ preferences
+C/C++ Preferences
Build Console preferences
Code Templates preferences
Debug preferences
@@ -63,6 +63,7 @@ Error Parser preferences
Binary Parser preferences
Discovery Options preferences
+ Managed Make Project preferences
Search preferences
C/C++ Project Properties
Managed Make Projects
@@ -71,11 +72,20 @@ C/C++ Build
Tool Settings
Build Settings
+ Build Steps
Error Parser
Binary Parser
- File Types
- Indexer
+ Environment
+ Macros
+ C/C++ Documentation
+ C/C++ File Types
+ C/C++ Indexer
Project References
+ Managed Make File Properties
+ Info
+ C/C++ Build
+ Tool Settings
+ Custom Build Steps
Standard Make Projects
Info
Builders
diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mfile_rcbs.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mfile_rcbs.htm new file mode 100644 index 00000000000..85174085d32 --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mfile_rcbs.htm @@ -0,0 +1,45 @@ + + + + + + + C/C++ Project Properties, Managed Make File, Build + + + + +

C/C++ Project Properties, Managed Make File, C/C++ Build, Custom Build Steps

+Customizes the selected build configuration allowing the specification of a user defined build command step +for the selected file. In addition to the build command, the user may specify any additional input file(s) +dependencies, the output file(s) generated by the build step, a descriptive message to be displayed in the +build output when the command is executed, and a rule for how the custom build step should be applied with +respect to other tools defined in the configuration, if any. Custom build steps may be specified for any +file type, regardless of the project nature. +

Resource Properties, Managed Make, C/C++ Build, Custom Build Steps

+ +

+
Exclude from build
Excludes the selected file from being built with the + selected build configuration.
+
Configuration:
Select the build configuration from the list provided.
+
Resource Configuration settings, Custom Build Steps
Define a custom build step for the selected file.
+
Custom Build Step Applicability
Disable the custom build step for the selected file, or apply the custom build step overriding any other tools defined for the configuration.
+
Additional Input File Name(s)
A semicolon separated list of additional input files required by this build command. The selected file is included by default. Paths are interpreted as relative to the project directory.
+
Output File Name(s)
A semicolon separated list of output files produced by this build command. Paths are interpreted as relative to the build directory.
+
Command
A semicolon separated list of commands that will be executed to perform this build step.
+
Description
An announcement string which will be echoed in the build output when this build step is executed.
+
Restore Defaults
Returns any changes back to the settings of the selected configuration.
+
Apply
Applies any changes.
+

+ + +

Related reference
+C++ Project Properties, Managed Make File, Info
+C++ Project Properties, Managed, C/C++ Build, Tool Settings

+ +

+IBM Copyright Statement +

+ + + diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_build.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_build.htm index 09940bf077b..423fc0be6be 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_build.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_build.htm @@ -44,11 +44,15 @@ Configuration Settings area to set a specific category of options.

C++ Project Properties, Managed, Builders
C++ Project Properties, Managed, C/C++ Build, Tool Settings
C++ Project Properties, Managed, C/C++ Build, Build Settings
+C++ Project Properties, Managed, C/C++ Build, Build Steps
C++ Project Properties, Managed, C/C++ Build, Error Parsers
C++ Project Properties, Managed, C/C++ Build, Binary Parser
-C++ Project Properties, Managed, File Types
-C++ Project Properties, Managed, Indexer
-C++ Project Properties, Managed, Project References
+C++ Project Properties, Managed, C/C++ Build, Environment
+C++ Project Properties, Managed, C/C++ Build, Macros
+C++ Project Properties, Managed, C/C++ Documentation
+C++ Project Properties, Managed, C/C++ File Types
+C++ Project Properties, Managed, C/C++ Indexer
+C++ Project Properties, Managed, Project References

C++ Project Properties, Managed Make File, C/C++ Build

diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_build_settings.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_build_settings.htm index 5e0cb987a38..4f72d1b00a6 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_build_settings.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_build_settings.htm @@ -17,9 +17,9 @@ Customizes your build configuration command and output settings.

Project Type:
Displays the type of project that is built by the selected build configuration.
Configuration:
Select the build configuration from the list provided.
-
Manage...
You can add and remove configurations.
+
Manage...
You can add, remove and rename configurations.
Configuration Settings, Build Settings
You can change the build - command, build flags and the name of the build goal.
+ command, build flags, the name of the build goal, and whether to expand build environment macros in the generated make file.
Restore Defaults
Returns any changes back to their default setting.
Apply
Applies any changes.

@@ -45,10 +45,14 @@ Customizes your build configuration command and output settings. C++ Project Properties, Managed, Builders
C++ Project Properties, Managed, C/C++ Build
C++ Project Properties, Managed, C/C++ Build, Tool Settings
+C++ Project Properties, Managed, C/C++ Build, Build Steps
C++ Project Properties, Managed, C/C++ Build, Error Parsers
C++ Project Properties, Managed, C/C++ Build, Binary Parser
-C++ Project Properties, Managed, File Types
-C++ Project Properties, Managed, Indexer
+C++ Project Properties, Managed, C/C++ Build, Environment
+C++ Project Properties, Managed, C/C++ Build, Macros
+C++ Project Properties, Managed, C/C++ Documentation
+C++ Project Properties, Managed, C/C++ File Types
+C++ Project Properties, Managed, C/C++ Indexer
C++ Project Properties, Managed, Project References

diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_builders.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_builders.htm index 1f19794ed78..cced5c50a10 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_builders.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_builders.htm @@ -47,10 +47,14 @@ C++ Project Properties, Managed, C/C++ Build
C++ Project Properties, Managed, C/C++ Build, Tool Settings
C++ Project Properties, Managed, C/C++ Build, Build Settings
+C++ Project Properties, Managed, C/C++ Build, Build Steps
C++ Project Properties, Managed, C/C++ Build, Error Parsers
C++ Project Properties, Managed, C/C++ Build, Binary Parser
-C++ Project Properties, Managed, File Types
-C++ Project Properties, Managed, Indexer
+C++ Project Properties, Managed, C/C++ Build, Environment
+C++ Project Properties, Managed, C/C++ Build, Macros
+C++ Project Properties, Managed, C/C++ Documentation
+C++ Project Properties, Managed, C/C++ File Types
+C++ Project Properties, Managed, C/C++ Indexer
C++ Project Properties, Managed, Project References

diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_dcbs.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_dcbs.htm new file mode 100644 index 00000000000..aace8cf0055 --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_dcbs.htm @@ -0,0 +1,83 @@ + + + + + + + C/C++ Project Properties, Managed Make File, Build + + + + +

C/C++ Project Properties, Managed, C/C++ Build, Build Steps

+Customizes the selected build configuration allowing the specification of user defined build command steps, as +well as a descriptive message to be displayed in the +build output, immediately prior to and immediately after normal build processing +executes. +

Properties, Managed Make, C/C++ Build, Build Steps

+ +

+
Project Type:
Displays the type of project that is built by the + selected build configuration.
+
Configuration:
Allows the selection of the active build configuration from the list provided.
+
Manage...
+
You can add, remove and rename configurations.
+
Pre-build Step
+
    Command
A command, or a list of semicolon separated + commands, to be executed immediately prior to execution of the build.
+
    Description
Optional descriptive text that is + associated with the pre-build step to be displayed in the build output + immediately prior to execution of the pre-build step command or commands.
+
Post-build Step
+
    Command
A command, or a list of semicolon separated + commands, to be executed immediately after the execution of the build.
+
    Description
Optional descriptive text that is + associated with the post-build step to be displayed in the build output + immediately prior to execution of the post-build step command or commands.
+
Restore Defaults
Returns any changes back to their default + setting
+
Apply
Applies any changes.
+
+

+

Detailed Specification

+

To ensure reasonable custom build step behavior, sensible input must be +provided when specifying custom build step input. Custom build steps are not +verified for correctness in any regard and are passed exactly as entered into +the build stream.
+
+In the descriptive text, below, the term "main build" is defined as the sequence +of commands to be executed when a build is invoked, not including pre-build or +post-build steps.
+
+The pre-build step is not executed if the state of the main build is determined +to be up to date; otherwise it is executed. An attempt to execute the main build +will occur regardless of the success or failure of executing the pre-build step. +
+
+The post-build step is not executed if the state of the main build is determined +to be up to date. It will be executed only if the main-build has executed +successfully.

+ + +

Related reference
+C++ Project Properties, Managed Make File, Info
+C++ Project Properties, Managed, Info
+C++ Project Properties, Managed, Builders
+C++ Project Properties, Managed, C/C++ Build
+C++ Project Properties, Managed, C/C++ Build, Tool Settings
+C++ Project Properties, Managed, C/C++ Build, Build Settings
+C++ Project Properties, Managed, C/C++ Build, Error Parsers
+C++ Project Properties, Managed, C/C++ Build, Binary Parser
+C++ Project Properties, Managed, C/C++ Build, Environment
+C++ Project Properties, Managed, C/C++ Build, Macros
+C++ Project Properties, Managed, C/C++ Documentation
+C++ Project Properties, Managed, C/C++ File Types
+C++ Project Properties, Managed, C/C++ Indexer
+C++ Project Properties, Managed, Project References

+ +

+IBM Copyright Statement +

+ + + diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_documentation.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_documentation.htm new file mode 100644 index 00000000000..c9af1ab30df --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_documentation.htm @@ -0,0 +1,62 @@ + + + + + + + C/C++ Project Properties, Managed, C/C++ Documentation + + + + +

C/C++ Project Properties, Managed, C/C++ Documentation

+

You can select which installed documentation to use for your project.

+ + +

C/C++ Project Properties, Managed, C/C++ Documentation

+ +

+
Help Books
Select the help books to use for this project.
+
Restore Defaults
Returns any changes back to their default setting.
+
Apply
Applies any changes.
+

+ + + +

Related reference
+C++ Project Properties, Standard, Info
+C++ Project Properties, Standard, Builders
+C++ Project Properties, Standard, File Types
+C++ Project Properties, Standard, Include Paths and Symbols
+C++ Project Properties, Standard, Indexer
+C++ Project Properties, Standard, Make Builder
+C++ Project Properties, Standard, Error Parser
+C++ Project Properties, Standard, Binary Parser
+C++ Project Properties, Standard, Discovery Options
+C++ Project Properties, Standard, Source
+C++ Project Properties, Standard, Output
+C++ Project Properties, Standard, Projects
+C++ Project Properties, Standard, Libraries
+C++ Project Properties, Standard, Path Containers
+C++ Project Properties, Standard, Project References
+C++ Project Properties, Managed, Info
+C++ Project Properties, Managed, Builders
+C++ Project Properties, Managed, C/C++ Build
+C++ Project Properties, Managed, C/C++ Build, Tool Settings
+C++ Project Properties, Managed, C/C++ Build, Build Settings
+C++ Project Properties, Managed, C/C++ Build, Build Steps
+C++ Project Properties, Managed, C/C++ Build, Error Parsers
+C++ Project Properties, Managed, C/C++ Build, Binary Parser
+C++ Project Properties, Managed, C/C++ Build, Environment
+C++ Project Properties, Managed, C/C++ Build, Macros
+C++ Project Properties, Managed, C/C++ File Types
+C++ Project Properties, Managed, C/C++ Indexer
+C++ Project Properties, Managed, Project References

+ + +

+IBM Copyright Statement +

+ + + diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_env.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_env.htm new file mode 100644 index 00000000000..a73d417e7a5 --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_env.htm @@ -0,0 +1,62 @@ + + + + + + + C/C++ Project Properties, Managed, Build + + + + +

C/C++ Project Properties, Managed, C/C++ Build, Environment

+Customizes the environment variables to be used in building your build configuration.

+C/C++ Project Properties, Managed, C/C++ Build, Environment

+ +

+
Project Type:
Displays the type of project that is built by the + selected build configuration.
+
Configuration:
Select the build configuration from the list provided.
+
Manage...
You can add, remove and rename configurations.
+
Configuration Settings
To Be Added.
+
Restore Defaults
Returns any changes back to their default setting.
+
Apply
Applies any changes.
+

+ + +

Related reference
+C++ Project Properties, Standard, Info
+C++ Project Properties, Standard, Builders
+C++ Project Properties, Standard, File Types
+C++ Project Properties, Standard, Include Paths and Symbols
+C++ Project Properties, Standard, Indexer
+C++ Project Properties, Standard, Make Builder
+C++ Project Properties, Standard, Error Parser
+C++ Project Properties, Standard, Binary Parser
+C++ Project Properties, Standard, Discovery Options
+C++ Project Properties, Standard, Source
+C++ Project Properties, Standard, Output
+C++ Project Properties, Standard, Projects
+C++ Project Properties, Standard, Libraries
+C++ Project Properties, Standard, Path Containers
+C++ Project Properties, Standard, Project References
+C++ Project Properties, Managed, Info
+C++ Project Properties, Managed, Builders
+C++ Project Properties, Managed, C/C++ Build
+C++ Project Properties, Managed, C/C++ Build, Tool Settings
+C++ Project Properties, Managed, C/C++ Build, Build Settings
+C++ Project Properties, Managed, C/C++ Build, Build Steps
+C++ Project Properties, Managed, C/C++ Build, Error Parsers
+C++ Project Properties, Managed, C/C++ Build, Binary Parser
+C++ Project Properties, Managed, C/C++ Build, Macros
+C++ Project Properties, Managed, C/C++ Documentation
+C++ Project Properties, Managed, C/C++ File Types
+C++ Project Properties, Managed, C/C++ Indexer
+C++ Project Properties, Managed, Project References

+ +

+IBM Copyright Statement +

+ + + diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_file_types.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_file_types.htm index 1c618d5bfbf..0410d9cb67f 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_file_types.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_file_types.htm @@ -9,18 +9,16 @@ -

C/C++ Project Properties, Managed, File Types

+

C/C++ Project Properties, Managed, C/C++ File Types

You can view a list of file types on the File Types page of a C/C++ project's properties window.

-

C/C++ Project Properties, Managed, File Types

+

C/C++ Project Properties, Managed, C/C++ File Types

Use workspace settings
Select this to use the Managed workspace settings.
Use Project Settings
Select this option to use project settings, or add or remove specific file types.
New...
Add a new file type.
Remove
Remove a listed file type.
-
Restore Defaults
Returns any changes back to their default setting.
-
Apply
Applies any changes.

@@ -45,9 +43,13 @@ C++ Project Properties, Managed, C/C++ Build
C++ Project Properties, Managed, C/C++ Build, Tool Settings
C++ Project Properties, Managed, C/C++ Build, Build Settings
+C++ Project Properties, Managed, C/C++ Build, Build Steps
C++ Project Properties, Managed, C/C++ Build, Error Parsers
C++ Project Properties, Managed, C/C++ Build, Binary Parser
-C++ Project Properties, Managed, Indexer
+C++ Project Properties, Managed, C/C++ Build, Environment
+C++ Project Properties, Managed, C/C++ Build, Macros
+C++ Project Properties, Managed, C/C++ Documentation
+C++ Project Properties, Managed, C/C++ Indexer
C++ Project Properties, Managed, Project References

diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_indexer.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_indexer.htm index d7e90c25a85..7f724a12d7f 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_indexer.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_indexer.htm @@ -9,15 +9,14 @@ -

C/C++ Project Properties, Managed, Indexer

-

You can select which C/C++ Indexers to use for your project. The indexer is necessary for search and related features, like content assist.

+

C/C++ Project Properties, Managed, C/C++ Indexer

+

You can select which C/C++ Indexer to use for your project. The indexer is necessary for search and related features, like content assist.

-

C/C++ Project Properties, Managed, Indexer

+

C/C++ Project Properties, Managed, C/C++ Indexer

-
Enable C/C++ Indexing
When selected C++ Indexing is enabled for this project.
-
Enable C++ Index problem reporting
When selected, any index related errors detected will be reported.
+
Available Indexers
Select the Indexer to use for this project, or No Indexer to disable indexing. Some indexers will display additional options below the indexer selection box.
Restore Defaults
Returns any changes back to their default setting.
Apply
Applies any changes.

@@ -45,9 +44,13 @@ C++ Project Properties, Managed, C/C++ Build
C++ Project Properties, Managed, C/C++ Build, Tool Settings
C++ Project Properties, Managed, C/C++ Build, Build Settings
+C++ Project Properties, Managed, C/C++ Build, Build Steps
C++ Project Properties, Managed, C/C++ Build, Error Parsers
C++ Project Properties, Managed, C/C++ Build, Binary Parser
-C++ Project Properties, Managed, File Types
+C++ Project Properties, Managed, C/C++ Build, Environment
+C++ Project Properties, Managed, C/C++ Build, Macros
+C++ Project Properties, Managed, C/C++ Documentation
+C++ Project Properties, Managed, C/C++ File Types
C++ Project Properties, Managed, Project References

diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_info.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_info.htm index b4f1d9521b0..64f3c9e656d 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_info.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_info.htm @@ -17,6 +17,7 @@
Info
Shows project information.
Default encoding for text files
You can specify an alternate text encoding.
+
New text file line delimiter
You can specify the line delimiter.
Restore Defaults
Returns any changes back to their default setting.
Apply
Applies any changes.

@@ -41,10 +42,14 @@ C++ Project Properties, Managed, C/C++ Build
C++ Project Properties, Managed, C/C++ Build, Tool Settings
C++ Project Properties, Managed, C/C++ Build, Build Settings
+C++ Project Properties, Managed, C/C++ Build, Build Steps
C++ Project Properties, Managed, C/C++ Build, Error Parsers
C++ Project Properties, Managed, C/C++ Build, Binary Parser
-C++ Project Properties, Managed, File Types
-C++ Project Properties, Managed, Indexer
+C++ Project Properties, Managed, C/C++ Build, Environment
+C++ Project Properties, Managed, C/C++ Build, Macros
+C++ Project Properties, Managed, C/C++ Documentation
+C++ Project Properties, Managed, C/C++ File Types
+C++ Project Properties, Managed, C/C++ Indexer
C++ Project Properties, Managed, Project References

diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_macros.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_macros.htm new file mode 100644 index 00000000000..2c5fe68c986 --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_macros.htm @@ -0,0 +1,474 @@ + + + + + + + C/C++ Project Properties, Managed, Build + + + + + +

C/C++ Project Properties, Managed, C/C++ Build, Macros

+Customizes the build macros used in your build configuration.

+C/C++ Project Properties, Managed, C/C++ Build, Macros

+ +

+
Project Type:
Displays the type of project that is built by the + selected build configuration.
+
Configuration:
Select the build configuration from the list provided.
+
Manage...
You can add, remove and rename configurations.
+
Configuration Settings
You can add and remove build macros for a + project or configuration.  Each tab contains two tables - one for User + defined build macros and one for non user-defined build macros.  Each + table contains three columns:

Name of the build macro

+

Type of value contained in the build macro (see below)

+

Value of the build macro. 

+

You can view all build macros that are not user-defined in the System + Macros table.  You + can choose to also display all macros defined for lower-precedence contexts + in the System Macros table by checking the Show parent context + macros checkbox.

+

You can view all user-defined macros in the User + Macros table.   + A user-defined macro overrides a non user-defined macro of the same + name for the given context.  Overridden macros are displayed in bold in + the System Macros table.

+
+
+
Restore Defaults
Returns any changes back to their default setting.
+
Apply
Applies any changes.
+

+ +

Detailed Specification

+

Build Macros can be used in all C/C++ Build configuration properties that +accept text. Build Macros are referenced in strings by enclosing them in braces, preceded by a dollar sign. +There are no special restrictions on a macro name, though it is encouraged that a macro name begin with +a letter and contain only letters, digits and underscore signs. Build macro names are case sensitive. +
+If the actual value of text property contains ${text}, it must be pre-pended +with the backslash in order to distinguish it from a build macro. The Managed +Build System pre-defines many useful macros (see below) and allows tool +integrators and users to define additional macros.

+

Build Macros can hold several types of values: +

+
    +
  1. Text value: can be any text string
  2. +
  3. Text-List value: an array of Text values
  4. +
  5. Path-file value: can hold a file path
  6. +
  7. Path-dir value: can hold a directory path +
  8. +
  9. Path-any value: can hold both a file and directory path +
  10. +
  11. Path-file-List value: an array of Path-file values +
  12. +
  13. Path-dir-List value: an array of Path-dir values
  14. +
  15. Path-any-List value: an array of Path-any values
  16. +
+

Build Macros are context-sensitive, that is the macro of a +given name could have different values depending on where it is used.  +Several contexts are defined:

+
    +
  1. +

    The currently selected file.

  2. +
  3. +

    The + currently selected option

  4. +
  5. +

    The + currently selected configuration (which includes a tool-chain).

  6. +
  7. +

    The + currently selected project.

  8. +
  9. +

    The + current workspace.

  10. +
  11. +

    The CDT + and Eclipse installations.

  12. +
  13. +

    The + process environment variables defined in the environment passed to Eclipse.

  14. +
+

Users can define new macros for any project or +configuration of a project.  The value of a build macro will be searched +for in the order specified above. If macro is not found for the currently +selected file context, the currently selected option context will be used, if +not found, the currently selected configuration context will be used, etc. 

+

Macro resolution takes place when the build file is being +generated.

+All macros except +the build process environment macros always get resolved in the makefile.  +See the ??“expand build environment macrosâ€? checkbox in the “Build Settingsâ€? tab +of the “C/C++ Buildâ€?. +

The Managed Build System pre-defines many useful macros +described in the following tables:

+

File-specific macros

+

The set of file-context macros is MBS-predefined, neither a +tool-integrator nor a user can define new file-context macros, but a +tool-integrator can specify the values for the file-context macros using +attributes of a builder element. The macro values specified in those attributes +should not contain the explicit e.g. file name, but instead should provide the +filename definition in terms of the builder automatic variables and text +functions. This is needed to allow the makefile generator to generate pattern +rules, e.g. in the case of Gnu make, the macro that represents the output file +name will contain the “$(notdir $@)? value. The builder definition of the gnu +tool-chain will contain attribute specifying the value for that macro. If a +tool-integrator does not provide the values for the file-specific macros, MBS +will automatically expand them to their actual value when generating the +buildfile, e.g. for the foo.c file the macro that represents the input file name +will contain “foo.c? in this case. In this case the makefile generator will not +be able to use pattern rules for building files with options containing +file-specific macros. (see the “Supplying the file-context macros values? +section for more detail)

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+

Macro

+

Value + Type

+

+ Description

+

${InputFileName}

+

Text

+

Represents the input + file name. The input file has the following meaning:

+

+ 1.      If a + tool does not accept building multiple files of the primary input type + with one tool invocation, the input file is the file of the primary + input type being built.

+

+ 2.      If a + tool accepts building multiple files of the primary input type with one + tool invocation the input file is undefined and the macros representing + the input file contain information about one of the inputs of the + primary input type being built.

+

${InputFileExt}

+

Text

+

Represents the extension + of the input file.

+

${InputFileBaseName}

+

Text

+

Represents the base name + of the input file. That is the file name with an extension stripped.

+

${InputFileRelPath}

+

Path(File)

+

Represents the input + file path relative to the builder current directory.

+

${InputDirRelPath}

+

Path(Dir)

+

Represents the input + file directory path relative to the builder current directory.

+

${OutputFileName}

+

Text

+

Represents the output + file name. The output file has the following meaning:

+

+ 1.      If a + tool is not capable of producing multiple files of the primary output + type with one tool invocation the output file is the file of the primary + output type that is built with a given tool invocation.

+

+ 2.      If a + tool is capable of producing multiple files of the primary output type + with one tool invocation the output file is undefined and the macros + representing the output file contain information about one of the files + of the primary output type that are built with a given tool invocation.

+

${OutputFileExt}

+

Text

+

Represents the output + file extension.

+

${OutputFileBaseName}

+

Text

+

Represents the output + file base name. That is the output file name with an extension stripped.

+

${OutputFileRelPath}

+

Path(File)

+

Represents the output + file path relative to the current builder directory.

+

${OutputDirRelPath}

+

Path(Dir)

+

Represents the output + file directory path relative to the current builder directory.

+

 Configuration-specific macros

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+

Macro

+

Value + Type

+

+ Description

+

${ConfigName}

+

Text

+

Represents the name of a + given configuration.

+

${ConfigDescription}

+

Text

+

Represents the description of a given + configuration.

+

${BuildArtifactFileName}

+

Text

+

Represents the name of the build artifact.

+

${BuildArtifactFileExt}

+

Text

+

Represents the extension of the build artifact.

+

${BuildArtifactFileBaseName}

+

Text

+

Represents the base name of the build artifact.

+

${BuildArtifactFilePrefix}

+

Text

+

Represents the prefix of the build artifact.

+

${TargetOsList}

+

Text-List

+

Represents the list of the target OS names.

+

${TargetArchList}

+

Text-List

+

Represents the list of the target Arch names.

+

Project-specific macros

+ + + + + + + + + + + +
+

${ProjName}

+

Text

+

Represents the name of a + given project.

+

${ProjDirPath}

+

Path(Dir)

+

Represents the absolute path of a given project. +

+

Workspace-specific macros

+ + + + + + + + + + + + + + + + +
+

${WorkspaceDirPath}

+

Path(Dir)

+

Represents the workspace absolute path.

+

${DirectoryDelimiter}

+

Text

+

Represents the directory delimiter used on the + system. That is the “\? for Win32 systems and the “/? for Unix-like + systems

+

This could be useful, e.g. in the case a user needs + the absolute path of an input file. The absolute path would be + represented in the following way: ${CWD}${DirectoryDelimiter}${InputFileRelPath}

+

${PathDelimiter}

+

Text

+

Represents the default path delimiter used on the + system to separate paths in the path environment variables. That is the + “;? for Win32 systems and the “:? for Unix-like systems

+

This might be used in the environment variable + definitions

+

CDT/Eclipse installation-specific macros

+ + + + + + + + + + + + + + + + + + + + + + + + + + +
+

${EclipseVersion}

+

Text

+

Represents the current eclipse version.

+

${CDTVersion}

+

Text

+

Represents the current CDT version.

+

${MBSVersion}

+

Text

+

Represents the current MBS version.

+

${HostOsName}

+

Text

+

Represents the operating system name on which + eclipse is running.

+

${HostArchName}

+

Text

+

Represents the architecture name on which eclipse + is running.

+ +

Related reference
+C++ Project Properties, Standard, Info
+C++ Project Properties, Standard, Builders
+C++ Project Properties, Standard, File Types
+C++ Project Properties, Standard, Include Paths and Symbols
+C++ Project Properties, Standard, Indexer
+C++ Project Properties, Standard, Make Builder
+C++ Project Properties, Standard, Error Parser
+C++ Project Properties, Standard, Binary Parser
+C++ Project Properties, Standard, Discovery Options
+C++ Project Properties, Standard, Source
+C++ Project Properties, Standard, Output
+C++ Project Properties, Standard, Projects
+C++ Project Properties, Standard, Libraries
+C++ Project Properties, Standard, Path Containers
+C++ Project Properties, Standard, Project References
+C++ Project Properties, Managed, Info
+C++ Project Properties, Managed, Builders
+C++ Project Properties, Managed, C/C++ Build
+C++ Project Properties, Managed, C/C++ Build, Tool Settings
+C++ Project Properties, Managed, C/C++ Build, Build Settings
+C++ Project Properties, Managed, C/C++ Build, Build Steps
+C++ Project Properties, Managed, C/C++ Build, Error Parsers
+C++ Project Properties, Managed, C/C++ Build, Binary Parser
+C++ Project Properties, Managed, C/C++ Build, Environment
+C++ Project Properties, Managed, C/C++ Documentation
+C++ Project Properties, Managed, C/C++ File Types
+C++ Project Properties, Managed, C/C++ Indexer
+C++ Project Properties, Managed, Project References

+ +

+IBM Copyright Statement +

+ + + diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_mbinary.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_mbinary.htm index 47719ee73f2..b12f2c87348 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_mbinary.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_mbinary.htm @@ -27,7 +27,7 @@ symbols of the object file in the C/C++ Projects view.

Project Type:
Displays the type of project that is built by the selected build configuration.
Configuration:
Select the build configuration from the list provided.
-
Manage...
You can add and remove configurations.
+
Manage...
You can add, remove and rename configurations.
Configuration Settings, Binary Parser
Select a binary parser from the list.
Binary Parser Options
@@ -62,9 +62,13 @@ symbols of the object file in the C/C++ Projects view.

C++ Project Properties, Managed, C/C++ Build
C++ Project Properties, Managed, C/C++ Build, Tool Settings
C++ Project Properties, Managed, C/C++ Build, Build Settings
+C++ Project Properties, Managed, C/C++ Build, Build Steps
C++ Project Properties, Managed, C/C++ Build, Error Parsers
-C++ Project Properties, Managed, File Types
-C++ Project Properties, Managed, Indexer
+C++ Project Properties, Managed, C/C++ Build, Environment
+C++ Project Properties, Managed, C/C++ Build, Macros
+C++ Project Properties, Managed, C/C++ Documentation
+C++ Project Properties, Managed, C/C++ File Types
+C++ Project Properties, Managed, C/C++ Indexer
C++ Project Properties, Managed, Project References

diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_merror.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_merror.htm index 8a1f6798924..26c158843f1 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_merror.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_merror.htm @@ -20,7 +20,7 @@
Project Type:
Displays the type of project that is built by the selected build configuration.
Configuration:
Select the build configuration from the list provided.
-
Manage...
You can add and remove configurations.
+
Manage...
You can add, remove and rename configurations.
Configuration Settings, Error Parsers
Lists the various error parsers which can be enabled or disabled.
Up
@@ -62,9 +62,13 @@ C++ Project Properties, Managed, C/C++ Build
C++ Project Properties, Managed, C/C++ Build, Tool Settings
C++ Project Properties, Managed, C/C++ Build, Build Settings
+C++ Project Properties, Managed, C/C++ Build, Build Steps
C++ Project Properties, Managed, C/C++ Build, Binary Parser
-C++ Project Properties, Managed, File Types
-C++ Project Properties, Managed, Indexer
+C++ Project Properties, Managed, C/C++ Build, Environment
+C++ Project Properties, Managed, C/C++ Build, Macros
+C++ Project Properties, Managed, C/C++ Documentation
+C++ Project Properties, Managed, C/C++ File Types
+C++ Project Properties, Managed, C/C++ Indexer
C++ Project Properties, Managed, Project References

diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_ref.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_ref.htm index fcaddf3766c..ddd10e7ef0f 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_ref.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_ref.htm @@ -41,11 +41,14 @@ C++ Project Properties, Managed, C/C++ Build
C++ Project Properties, Managed, C/C++ Build, Tool Settings
C++ Project Properties, Managed, C/C++ Build, Build Settings
+C++ Project Properties, Managed, C/C++ Build, Build Steps
C++ Project Properties, Managed, C/C++ Build, Error Parsers
C++ Project Properties, Managed, C/C++ Build, Binary Parser
-C++ Project Properties, Managed, File Types
-C++ Project Properties, Managed, Indexer
-C++ Project Properties, Managed, Project References

+C++ Project Properties, Managed, C/C++ Build, Environment
+C++ Project Properties, Managed, C/C++ Build, Macros
+C++ Project Properties, Managed, C/C++ Documentation
+C++ Project Properties, Managed, C/C++ File Types
+C++ Project Properties, Managed, C/C++ Indexer
diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_tool_settings.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_tool_settings.htm index c707c9921a6..a31d41cbab0 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_tool_settings.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mprop_tool_settings.htm @@ -17,7 +17,7 @@ Customizes the tools and tool options used in your build configuration.
Project Type:
Displays the type of project that is built by the selected build configuration.
Configuration:
Select the build configuration from the list provided.
-
Manage...
You can add and remove configurations.
+
Manage...
You can add, remove and rename configurations.
Configuration Settings, Tool Settings
Edit individual tool options.
Restore Defaults
Returns any changes back to their default setting.
Apply
Applies any changes.
@@ -44,11 +44,15 @@ Customizes the tools and tool options used in your build configuration. C++ Project Properties, Managed, Builders
C++ Project Properties, Managed, C/C++ Build
C++ Project Properties, Managed, C/C++ Build, Build Settings
+C++ Project Properties, Managed, C/C++ Build, Build Steps
C++ Project Properties, Managed, C/C++ Build, Error Parsers
C++ Project Properties, Managed, C/C++ Build, Binary Parser
-C++ Project Properties, Managed, File Types
-C++ Project Properties, Managed, Indexer
-C++ Project Properties, Managed, Project References
+C++ Project Properties, Managed, C/C++ Build, Environment
+C++ Project Properties, Managed, C/C++ Build, Macros
+C++ Project Properties, Managed, C/C++ Documentation
+C++ Project Properties, Managed, C/C++ File Types
+C++ Project Properties, Managed, C/C++ Indexer
+C++ Project Properties, Managed, Project References

C++ Project Properties, Managed Make File, C/C++ Build, Tool Settings

diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_new_proj_wiz_m_cindexer.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_new_proj_wiz_m_cindexer.htm index 6f29059abe5..fc39943c1c4 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_new_proj_wiz_m_cindexer.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_new_proj_wiz_m_cindexer.htm @@ -16,7 +16,7 @@ function changeSize(theImage,wd,ht) {

New Project Wizard - Managed Make, C/C++ Indexer

-

You can select whether to enable the C/C++ Indexer for your project from this page of the wizard. The indexer is necessary for search and related features, like content assist.

+

You can select which C/C++ Indexer to use for your project from this page of the wizard. The indexer is necessary for search and related features, like content assist.

New Project Wizard

@@ -29,13 +29,9 @@ function changeSize(theImage,wd,ht) { - Enable C++ Indexing - When selected C++ Indexing is enabled for this project. + Available Indexers + Select the Indexer to use for this project, or No Indexer to disable indexing. Some indexers will display additional options below the indexer selection box. - - C++ Index problem reporting - Select the categories of index related errors that will be reported. -

diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_new_proj_wiz_m_name.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_new_proj_wiz_m_name.htm index 2825ffc0081..b75e533252a 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_new_proj_wiz_m_name.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_new_proj_wiz_m_name.htm @@ -36,7 +36,7 @@ function changeSize(theImage,wd,ht) { - Location + Directory If Use Default Location is not selected, enter the location where the project is to be created. diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_new_proj_wiz_m_proj.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_new_proj_wiz_m_proj.htm index 3812eb63098..2723cfb5201 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_new_proj_wiz_m_proj.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_new_proj_wiz_m_proj.htm @@ -28,7 +28,7 @@ function changeSize(theImage,wd,ht) { - Select Project References + Referenced C/C++ Projects If you have any other projects in your workspace, you can select them as references for this new C or C++ project.

diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_new_proj_wiz_m_target.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_new_proj_wiz_m_target.htm index ba5736e13b3..6c71fa13f10 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_new_proj_wiz_m_target.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_new_proj_wiz_m_target.htm @@ -16,7 +16,6 @@ Name Function - Project Type You can select a project type from the drop down list. @@ -25,11 +24,16 @@ Configurations Specifies which build configurations will be supported for your project. - - + + Show All Project Types - If selected, all known project types will appear in the Configurations window, by default, the list is filtered so that only project types for the host OS are shown. - + If selected, all known project types will appear in the Project Type list. + By default, the list is filtered so that only project types that are buildable on the host system are shown. + + + Show All Configurations + If selected, all known default configurations will appear in the Configurations window. + By default, the list is filtered so that only configurations that are buildable on the host system are shown.

diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_properties.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_properties.htm index 3e4332adb05..02f3c2ab4bb 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_properties.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_properties.htm @@ -40,10 +40,14 @@ C++ Project Properties, Managed, C/C++ Build
C++ Project Properties, Managed, C/C++ Build, Tool Settings
C++ Project Properties, Managed, C/C++ Build, Build Settings
+C++ Project Properties, Managed, C/C++ Build, Build Steps
C++ Project Properties, Managed, C/C++ Build, Error Parsers
C++ Project Properties, Managed, C/C++ Build, Binary Parser
-C++ Project Properties, Managed, File Types
-C++ Project Properties, Managed, Indexer
+C++ Project Properties, Managed, C/C++ Build, Environment
+C++ Project Properties, Managed, C/C++ Build, Macros
+C++ Project Properties, Managed, C/C++ Documentation
+C++ Project Properties, Managed, C/C++ File Types
+C++ Project Properties, Managed, C/C++ Indexer
C++ Project Properties, Managed, Project References

IBM Copyright Statement

diff --git a/doc/org.eclipse.cdt.doc.user/tasks/cdt_o_tasks.htm b/doc/org.eclipse.cdt.doc.user/tasks/cdt_o_tasks.htm index d09d96a938b..05d8b7e131c 100644 --- a/doc/org.eclipse.cdt.doc.user/tasks/cdt_o_tasks.htm +++ b/doc/org.eclipse.cdt.doc.user/tasks/cdt_o_tasks.htm @@ -36,7 +36,8 @@ Building projects
Renaming a project
Selecting referenced projects
- Defining build settings
+ Defining Standard Make build settings
+ Defining Managed Make build settings
Filtering errors
Selecting a binary parser
Adding Include paths and symbols
diff --git a/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_convert_cdt_proj.htm b/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_convert_cdt_proj.htm index 35748909110..5f792226ed5 100644 --- a/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_convert_cdt_proj.htm +++ b/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_convert_cdt_proj.htm @@ -12,7 +12,7 @@

Converting CDT 1.x Projects

-

How you update your CDT 1.x project to CDT 2.1 depends upon whether the +

How you update your CDT 1.x project to CDT 3.0 depends upon whether the project is a Standard Make project or a Managed Make project. For a Standard Make project, see Convert to C/C++ Make Project Wizard below.

Updating a Managed Make Project

@@ -22,7 +22,7 @@ convert your project when it attempts to read the Managed Build project information and discovers that the project needs to be updated.  You will be prompted to update the project.

Update Managed Builder dialog box

Click Yes and the project will be updated.  The updated Managed -Build information can no longer be loaded by CDT 1.x or CDT 2.0.  Select +Build information can no longer be loaded by CDT 1.x or CDT 2.x.  Select No and the project will not be updated.  You will be able to view the Managed Build settings, but no changes will be saved when you close the project or exit Eclipse.

@@ -42,7 +42,7 @@ See Set Discovery Options for details.

Related tasks
Adding Convert to a C/C++ Make Project to the New menu
Set Discovery Options
-Converting CDT 2.0 Managed Make Projects

+Converting CDT 2.x Managed Make Projects

IBM Copyright Statement

diff --git a/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_convert_mbs20_proj.htm b/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_convert_mbs20_proj.htm index c46979c7527..f2fb156405e 100644 --- a/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_convert_mbs20_proj.htm +++ b/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_convert_mbs20_proj.htm @@ -4,20 +4,20 @@ -Converting CDT 2.0 Managed Make Projects +Converting CDT 2.x Managed Make Projects -

Converting CDT 2.0 Managed Make Projects

+

Converting CDT 2.x Managed Make Projects

-

For a CDT 2.0 Managed Make project, the Managed Build system will prompt you to +

For a CDT 2.x Managed Make project, the Managed Build system will prompt you to convert your project when it attempts to read the Managed Build project information and discovers that the project needs to be updated.  You will be prompted to update the project.

-

Update CDT 2.0 Managed Builder dialog box

+

Update CDT 2.x Managed Builder dialog box

Click Yes and the project will be updated.  The updated Managed -Build information can no longer be loaded by CDT 2.0.  Select +Build information can no longer be loaded by CDT 2.x.  Select No and the project will not be updated.  You will be able to view the Managed Build settings, but no changes will be saved when you close the project or exit Eclipse.

diff --git a/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_mproj_build_set.htm b/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_mproj_build_set.htm new file mode 100644 index 00000000000..fecc5d08bd8 --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_mproj_build_set.htm @@ -0,0 +1,56 @@ + + + + + + +Defining Managed Make build settings + + + + + +

Defining Managed Make build settings

+ +

The C/C++ Build property page of a Managed Make project allows you to:

+ + + +See C/C++ Project Properties for further information. + +

Related concepts +
+ CDT Projects
+ Project file views

+

Related tasks +
+ +Working with C/C++ project files

+

Related reference +
+C/C++ Project Properties

+C++ Project Properties, Managed, C/C++ Build
+C++ Project Properties, Managed, C/C++ Build, Tool Settings
+C++ Project Properties, Managed, C/C++ Build, Build Settings
+C++ Project Properties, Managed, C/C++ Build, Build Steps
+C++ Project Properties, Managed, C/C++ Build, Error Parsers
+C++ Project Properties, Managed, C/C++ Build, Binary Parser
+C++ Project Properties, Managed, C/C++ Build, Environment
+C++ Project Properties, Managed, C/C++ Build, Macros
+

+ +IBM Copyright Statement + + + + diff --git a/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_proj_build_set.htm b/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_proj_build_set.htm index 2280a31b0ea..1f4790f77f9 100644 --- a/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_proj_build_set.htm +++ b/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_proj_build_set.htm @@ -4,13 +4,13 @@ -Defining build settings +Defining Standard Make build settings -

Defining build settings

+

Defining Standard Make build settings

The Make Builder page lets you:

diff --git a/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_proj_error_parser.htm b/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_proj_error_parser.htm index 9d9bb55f268..57f891a32f2 100644 --- a/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_proj_error_parser.htm +++ b/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_proj_error_parser.htm @@ -30,7 +30,8 @@ project properties in the Preferences window for future standard make projects.<
  • Do one of the following:
  • Click the Error Parsers tab.
  • In the Error parsers list, select error parsers.
  • diff --git a/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_proj_new.htm b/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_proj_new.htm index 82cdc0ea2ef..bf461a6d747 100644 --- a/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_proj_new.htm +++ b/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_proj_new.htm @@ -28,15 +28,15 @@
  • To specify a different directory in which to save your project, clear the Use Default Location check box, and enter the path in the Location box.
  • -
  • For managed make projects, click Next to select a deployment - platform. For more information, see Selecting a - deployment platform.
  • +
  • For Managed Make projects, click Next to select a project type and the + default configurations. For more information, see Selecting a + project type.
  • To create your project, click Finish.
    Managed New Project Wizard
  • If a message box prompts you to switch perspectives, click Yes.
  • Define your project - properties. For more information, see Defining + properties. For more information, see Defining project properties.

    Related concepts @@ -47,7 +47,7 @@
    Working with C/C++ project files

    Related reference -
    Project properties +
    Project properties
    Views

    diff --git a/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_proj_parser.htm b/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_proj_parser.htm index 1d613da2e6e..b2b9cfe6003 100644 --- a/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_proj_parser.htm +++ b/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_proj_parser.htm @@ -18,14 +18,14 @@ project, you can view the components of the .o file in the C/C++ Projects view and view the contents of the .o file in the C/C++ editor. You can also easily browse for the executable when defining run/debug configurations.

    -

    You can define the properties on a per project basis from the New Project +

    For a Standard Make project, you can define the properties on a per project basis from the New Project wizard, in the C/C++ Projects view or in the Navigator view. You can also define project properties in the Preferences window for future standard make projects.

    -

    To select a binary parser:

    +

    To set properties for future Standard Make projects:

      -
    1. To set properties for future Standard Make projects, click Window > +
    2. Click Window > Preferences . Expand C/C++, click New Make Projects.
    3. Click the Binary Parser tab.
      Select Binary Parser window
    4. @@ -38,6 +38,13 @@ project properties in the Preferences window for future standard make projects.<
    5. Click OK.
    +

    For a Managed Make project:

    +
      +
    1. In the C/C++ Projects view, right-click the project, and select Properties.
    2. +
    3. Select C/C++ Build from the list.
    4. +
    5. Click the Binary Parser tab.
    6. +
    +

    Related concepts
    CDT Projects
    Project file views

    diff --git a/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_proj_platf.htm b/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_proj_platf.htm index 44d787edab1..2f337e0d94d 100644 --- a/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_proj_platf.htm +++ b/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_proj_platf.htm @@ -12,20 +12,21 @@ -

    Selecting a deployment platform

    +

    Selecting a project type

    -

    For managed make projects, you need to select the platform on which you plan -to deploy your program. You also need to select a release or debug configuration for your project.

    +

    For Managed Make projects, you need to select the type of project that you plan to create, and the +default configurations for your project.

    -

    To select a deployment platform:

    +

    To select a project type:

      -
    1. In the C/C++ Projects view, right-click a project, and select Properties.
    2. Select C/C++ - Build from the list.
    3. -
    4. To create a configuration with optimization flags enabled and debug - symbols disabled, in the Configurations list, select Release.
    5. -
    6. To create a configuration with optimization flags disabled and debug - symbols enabled, in the Configurations list, select Debug.
    7. +
    8. Select a project type from the list. By default, this dialog dispays only the project types + that are buildable on the system on which Eclipse is running. + You can view all installed project types by selecting the Show All Project Types button.
    9. +
    10. Select the configurations that you want added to your project. + By default, this dialog dispays only the configurations + that are buildable on the system on which Eclipse is running. + You can view all default configurations by selecting the Show All Configurations button.

    Related concepts
    @@ -35,9 +36,6 @@ to deploy your program. You also need to select a release or debug configuration

    Related tasks
    Working with C/C++ project files

    -

    Related reference -
    -Target platform, C/C++ Properties window

    IBM Copyright Statement diff --git a/doc/org.eclipse.cdt.doc.user/topics_Reference.xml b/doc/org.eclipse.cdt.doc.user/topics_Reference.xml index 2e148fbef4e..db34d72246d 100644 --- a/doc/org.eclipse.cdt.doc.user/topics_Reference.xml +++ b/doc/org.eclipse.cdt.doc.user/topics_Reference.xml @@ -60,6 +60,7 @@ + @@ -69,17 +70,22 @@ + + + - - + + + + diff --git a/doc/org.eclipse.cdt.doc.user/topics_Tasks.xml b/doc/org.eclipse.cdt.doc.user/topics_Tasks.xml index b0899178f96..936efedc253 100644 --- a/doc/org.eclipse.cdt.doc.user/topics_Tasks.xml +++ b/doc/org.eclipse.cdt.doc.user/topics_Tasks.xml @@ -30,11 +30,12 @@ - + + - +