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 f95468b7c52..7b242a352ef 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 @@ -1,133 +1,149 @@ - - - - Building C/C++ projects - + + + Building C/C++ projects +

Building C/C++ projects

- -

The CDT relies on an external make utility, such as GNU make, to build a project. -The CDT can generate makefiles automatically when you create a Managed Make C project or a Managed Make C++ project. -You have the option of creating a Standard Make C project or a Standard Make C++ project and providing the makefile yourself.

+

The CDT relies on an external make utility, such as GNU make, to +build a project. The CDT can generate makefiles automatically when you +create a Managed Make C project or a Managed Make C++ project. You have +the option of creating a Standard Make C project or a Standard Make C++ +project and providing the makefile yourself.

Required utilities

You must install and configure the following utilities: +

-Note: while make, gcc and gdb are the examples used in the documentation, virtually any similar set of tools or utilities could be used.

- -

Tip: Cygwin contains these utilities (make, gcc and gdb) for a Windows environment, while running the cygwin installation ensure gcc and make are selected, they are not installed by default. -For more information, see http://www.cygwin.com. Red Hat users, all you need to build your project is included in the Red Hat Linux installation. -For other operating systems please refer to your installation documentation.

-

- +Note: while make, gcc and gdb are the examples used in the +documentation, virtually any similar set of tools or utilities could be +used. +

+

Tip: Cygwin contains these utilities (make, gcc and gdb) for +a Windows environment.  While running the cygwin installation, +ensure gcc and make are selected since they are not +installed by default. For more information, see http://www.cygwin.com. If you are a +Red Hat user, all that you need to do to build your project is included +in the Red Hat Linux installation. +For other operating systems, please refer to your installation +documentation.

+

Build terminology

-

The CDT uses a number of terms to describe the scope of the build.

-

Build Project

- -

This is an incremental build (make all, assuming all is defined in your makefile). Only the components affected by modified files in that particular project are built.

- +

This is an incremental build (make all, assuming all is defined in +your makefile). Only the components affected by modified files in that +particular project are built.

Rebuild Project

- -

Builds every file in the project whether or not a file has been modified since the last build. A rebuild is a clean followed by a build.

- +

Builds every file in the project whether or not a file has been +modified since the last build. A rebuild is a clean followed by a build.

For more information on builds, see:

-

Build-related information is displayed as follows:

- - -

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

- +

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

Getting a makefile

- -

You can either create a C/C++ project for which you supply the makefile or create a C/C++ project for which the CDT generates makefiles automatically.

- -

To create a new project, from the menu bar choose File > New > Project. In the dialog that appears:

- +

You can either create a C/C++ project for which you supply the makefile +or create a C/C++ project for which the CDT generates makefiles +automatically.

+

To create a new project, from the menu bar choose File > New +> Project. In the dialog that appears:

-

Setting build preferences

-

You can set build preferences in Eclipse:

-
-
Build order
-
If certain projects must be built before others, you can set the build order. - If your project refers to another project, the CDT must build the other project first. - To set the build order, from the menu bar select Window > Preferences > Build Order. -

When you set the build order, the CDT does not rebuild projects that depend on a project; - you must rebuild all projects to ensure all changes are propagated.

-
Automatic save
-
You can set the CDT to perform an automatic save of all modified resources when you perform a manual build; - from the menu bar, select Windows > Preferences > Workbench.By default, this feature is enabled.
+
Build order
+
If certain projects must be built before others, you can set the build +order. If your project refers to another project, the CDT must +build the other project first. To set the build order, from the menu +bar select Window > Preferences > Build Order. +

When you set the build order, the CDT does not rebuild projects +that depend on a project; you must rebuild all projects to ensure all +changes are propagated.

+
+
Automatic save
+
You can set the CDT to perform an automatic save of all +modified resources when you perform a manual build; from the menu bar, +select Windows > Preferences > Workbench. By default, +this feature is enabled.
-

Controlling the building of your project

- -

For a Standard Make 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:

+In the dialog that appears, the C/C++ Standard Make Project +page enables you to control a variety of settings, including:

-
Build Setting
-
Controls whether the compiler will Stop On Erroror Keep Going On Error. - Choosing Keep Going On Error will force the compiler to attempt to build all referenced projects even if the current project has errors.
-
Build Command
-
Controls which make is used.
-
Workbench Build Behavior
-
Controls which makefile target will be built depending on the scope of the build.
+
Build Setting
+
Controls whether the compiler will Stop On Error or Keep +Going On Error. Choosing Keep Going On Error will force the +compiler to attempt to build all referenced projects even if the +current project has errors.
+
Build Command
+
Controls which make is used.
+
Workbench Build Behavior
+
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:

+

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 +

Related concepts
CDT Projects
Project file views

-

Related tasks +

Related tasks
Building

-

Related reference +

Related reference
Project Properties

  - -

-Red Hat Copyright Statement
-IBM Copyright Statement +

Red Hat Copyright Statement
+IBM Copyright Statement

- - \ No newline at end of file + 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 782caf80125..f980516f08a 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 @@ -1,15 +1,16 @@ - - - Tutorial - + + + Tutorial +

Additional Project Settings

-

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 the C/C++ Indexer tab and 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.

- - \ No newline at end of file + diff --git a/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_basic14.htm b/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_basic14.htm index 0d97a16b3dc..eb75aba960d 100644 --- a/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_basic14.htm +++ b/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_basic14.htm @@ -1,25 +1,26 @@ - - - Tutorial - - - - + +

Enter code

- -

Enter the code in the main.cpp file that was just created. -You can double click the main.cpp tab in the Editor view to expand the view.
-Note: Leave a blank line at the end of the code, some compilers require one.

- - -

You will notice an asterisk in front of the file name on the tab in the Editor view, this tells you the file changed but has not been saved.

- +

Enter the code in the main.cpp +file that was just created. +You can double click the main.cpp tab in the Editor +view to expand the view.
+Note: Leave a blank line at the end of the code, some compilers +require one.

+

You will notice an asterisk in front of the file name on the tab in +the Editor view. The asterisk indicates that the file has +changed but has not been saved.

- \ No newline at end of file + diff --git a/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_basic15.htm b/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_basic15.htm index 7cb80a8d75c..b75e3d07426 100644 --- a/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_basic15.htm +++ b/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_basic15.htm @@ -1,17 +1,16 @@ - - - Tutorial - + + + Tutorial +

Step through the code

- -

You will also see the Outline view has also been populated with objects created from your code.

-

If you select an item from the Outline view the corresponding text in the editor is highlighted.

- - +

You will also see the Outline view has also been populated +with objects created from your code.

+

If you select an item from the Outline view, the +corresponding text in the editor is highlighted.

- \ No newline at end of file + diff --git a/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_basic16.htm b/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_basic16.htm index 855b1f6500a..f03049a2223 100644 --- a/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_basic16.htm +++ b/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_basic16.htm @@ -1,17 +1,18 @@ - - - Tutorial - + + + Tutorial +

Save the file

- -

Now save the main.cpp file, and build your project by typing CTRL+B.

-

You can read through the build messages in the Console view, the project should build successfully showing the following message:
-Build complete for project HelloWorld

- +

Now save the main.cpp file by clicking FILE > SAVE, and build your +project by typing CTRL+B.

+

You can read through the build messages in the Console view. +The project should build successfully, showing the following message:

+

Build complete for project HelloWorld

- \ No newline at end of file + diff --git a/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_basic17.htm b/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_basic17.htm index 0d435b6ac91..f46fda96701 100644 --- a/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_basic17.htm +++ b/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_basic17.htm @@ -1,16 +1,15 @@ - - - Tutorial - + + + Tutorial +

View Executable

- -

Navigate to the C/C++ Projects view and expand the Binary object, you will now see the executables listed.

- - +

Navigate to the C/C++ Projects view and expand the Binary +object. You will now see the executables listed.

+

- \ No newline at end of file + diff --git a/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_basic18.htm b/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_basic18.htm index 13cb7a02a18..da0fa113ffa 100644 --- a/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_basic18.htm +++ b/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_basic18.htm @@ -1,16 +1,15 @@ - - - Tutorial - + + + Tutorial +

Run the application

- -

You can run your application within the C/C++ Perspective, to do so click Run > Run...

- - +

You can run your application within the C/C++ Perspective. To do so +click Run > Run...

+

- \ No newline at end of file + diff --git a/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_basic19.htm b/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_basic19.htm index f5111b79548..d65f5256608 100644 --- a/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_basic19.htm +++ b/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_basic19.htm @@ -1,18 +1,18 @@ - - - Tutorial - + + + Tutorial +

Run Configuration

- -

You should now see the Run Configurations dialog box, navigate to the Configurations: view, and then double click C/C++ Local. -This will create your Run Configuration. Select the new Run Configuration in the Configurations: view.

+

You should now see the Run Configurations dialog box, +navigate to the Configurations: view, and then double click C/C++ +Local Application. This +will create your Run Configuration. Select the new Run Configuration, +named HelloWorld, in the Configurations view.

Now click the Main tab and then the Search button.

- - - \ No newline at end of file + diff --git a/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_basic20.htm b/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_basic20.htm index f14cabf20a7..e987f0a93a1 100644 --- a/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_basic20.htm +++ b/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_basic20.htm @@ -1,16 +1,15 @@ - - - Tutorial - + + + Tutorial +

Program Selection

- -

The Program Selection dialog box will appear, select the executable you would like to run and click OK.

- - +

The Program Selection dialog box will appear. Select the +executable you would like to run and click OK.

+

- \ No newline at end of file + diff --git a/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_build.htm b/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_build.htm index c461ffb0dab..4e25d759cff 100644 --- a/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_build.htm +++ b/doc/org.eclipse.cdt.doc.user/getting_started/cdt_w_build.htm @@ -1,53 +1,50 @@ - - - Building your project - + + + Building your project + - -

Building your project

- -

Make output and build progress information is displayed in the Console view. -The Make Targets view displays makefile actions. The Tasks view displays compile warnings or -errors.

- +

Make output and build progress information is displayed in the +Console view. The Make Targets view displays makefile actions. The +Tasks view displays compile warnings or errors.

To build your project:

  1. In the C/C++ Projects view, select the HelloWorld project.
  2. Click Project > Build Project.
    3. - -

    If you get the error message:

    - -

    Exec error:Launching failed

    - -

    This error message means -that the CDT cannot locate the build command, usually make. Either your path is -not configured correctly or you do not have make installed on your system.

    - +

    If you see the error message:

    +

    Exec error:Launching failed

    +

    then CDT cannot locate the build command, usually make. +Either your path is not configured correctly or you do not have make +installed on your system.

-

Related concepts +

Related concepts
CDT Projects
-Build overview

-

Related tasks +Build overview
+

+

Related tasks
-Building

-

Related reference +Building
+

+

Related reference
-Make Builder page, C/C++ Properties window

+Make Builder page, +C/C++ Properties window
+

- Next: Debugging your project

- + Next: Debugging your project

- Back: Creating your makefile

- - + Back: Creating your makefile

-IBM Copyright Statement +IBM Copyright Statement

- - \ No newline at end of file + diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mfile_build.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mfile_build.htm index ad7a65447a7..76b36bb341d 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mfile_build.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mfile_build.htm @@ -1,36 +1,42 @@ - - - - C/C++ Project Properties, Managed Make File, Build - + + + C/C++ Project Properties, Managed Make File, Build + -

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

-Customizes the options used for a specific file in your build configuration. Select a tab in the -Resource Configuration settings area to set a specific category of options.

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

- -

-
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
Edit individual file options.
-
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, C/C++ Build, Tool Settings
-C++ Project Properties, Managed Make File, Info
-C++ Project Properties, Managed, C/C++ Build

- +Customizes the options used for a specific file in your build +configuration. Select a tab in the Resource Configuration settings area +to set a specific category of options. +

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

+

+
+
Exclude from build
+
Excludes the selected file from being built with the selected +build configuration.
+
Configuration:
+
Specifies the selected build configuration from the list provided.
+
Resource Configuration settings
+
Sets file options which apply only to the selected file.
+
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, C/C++ Build, Tool Settings
+C++ Project Properties, Managed Make +File, Info
+C++ Project Properties, Managed, C/C++ +Build

-IBM Copyright Statement -

+IBM Copyright Statement

- diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mfile_info.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mfile_info.htm index 7014b3e0cda..9f4396d83bf 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mfile_info.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mfile_info.htm @@ -1,34 +1,35 @@ - - - - C/C++ Project Properties, Managed Make File, Info - + + + C/C++ Project Properties, Managed Make File, Info + -

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

- -

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

- +

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

-
Info
Shows file information.
-
Read only
You can set the file to be read only.
-
Derived
You can indicate that the file is derived from other resources.
-
Text file encoding
You can specify an alternate text encoding.
-
Restore Defaults
Returns any changes back to their default setting.
-
Apply
Applies any changes.
-

- -

Related reference
-C++ Project Properties, Managed Make File, C/C++ Build
+

Info
+
Shows file information.
+
Read only
+
Sets the file to be read only.
+
Derived
+
Specifies that the file is derived from other resources.
+
Text file encoding
+
Specifies an alternate text encoding.
+
Restore Defaults
+
Returns any changes back to their default setting.
+
Apply
+
Applies any changes.
+ +

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

-

-IBM Copyright Statement -

+IBM Copyright Statement

- 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 index 85174085d32..4167ecc5d92 100644 --- 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 @@ -1,45 +1,67 @@ - - - - C/C++ Project Properties, Managed Make File, Build - + + + 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 +

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

- +

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:
+
Specifies the selected build configuration from the list provided.
+
Resource Configuration settings, Custom Build Steps
+
Defines a custom build step for the selected file.
+
Custom Build Step Applicability
+
Disables the custom build step for the selected file, or applies +the custom build step, overriding any other tools defined for the +configuration.
+
Additional Input File Name(s)
+
Specifies 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)
+
Specifies a semicolon separated list of output files produced by +this build command. Paths are interpreted as relative to the build +directory.
+
Command
+
Specifies a semicolon separated list of commands that will be +executed to perform this build step.
+
Description
+
Specifies 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 -

+IBM Copyright Statement

- diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mfile_tool_settings.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mfile_tool_settings.htm index 32beb1fc3a6..bfd19f61041 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mfile_tool_settings.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_mfile_tool_settings.htm @@ -1,35 +1,40 @@ - - - - C/C++ Project Properties, Managed Make File, Build - + + + C/C++ Project Properties, Managed Make File, Build + - -

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

-Customizes the tools and tool options used by the selected file in your build configuration. -

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

- -

-
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, Tool Settings
Edit individual tool options for the selected file.
-
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

- +

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

+Customizes the tools and tool options used by the selected file in your +build configuration. +

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

+

+
+
Exclude from build
+
Excludes the selected file from being built with the selected +build configuration.
+
Configuration:
+
Specifies the selected build configuration from the list provided.
+
Resource Configuration settings, Tool Settings
+
Sets individual tool options for the selected file.
+
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 -

+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 423fc0be6be..9c53d32fa59 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 @@ -1,63 +1,93 @@ - - - - C/C++ Project Properties, Managed, Build - + + + C/C++ Project Properties, Managed, Build + -

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

-Customizes the options used in your build configuration. Select a tab in the -Configuration Settings area to set a specific category of options.

C/C++ Project Properties, Managed, Build

- -

-
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.
-
Configuration Settings
Edit individual options.
-
Restore Defaults
Returns any changes back to their default setting.
-
Apply
Applies any changes.
-

- - -

Related reference
+Customizes the options used in your build configuration. Select a tab +in the Configuration Settings area to set a specific category of +options. +

C/C++ Project Properties, Managed, Build

+

+
+
Project Type:
+
Displays the type of project that is built by the selected build +configuration.
+
Configuration:
+
Specifies the selected build configuration from the list +provided.
+
Manage...
+
Adds, removes, renames and manages configurations.
+
Configuration Settings
+
Sets build options for the configuration.
+
Restore Defaults
+
Resets 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, 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, 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++ 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

- -

-IBM Copyright Statement -

+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, 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 +

IBM Copyright Statement

- - \ No newline at end of file + 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 4f72d1b00a6..573d58cfcaa 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 @@ -1,63 +1,91 @@ - - - - C/C++ Project Properties, Managed, Build - + + + C/C++ Project Properties, Managed, Build + - -

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

+

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

Customizes your build configuration command and output settings. -

C/C++ Project Properties, Managed, Build

- -

-
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, Build Settings
You can change the build - 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.
-

- - -

Related reference
+

C/C++ Project Properties, Managed, Build

+

+
+
Project Type:
+
Displays the type of project that is built by the selected build +configuration.
+
Configuration:
+
Specifies the selected build configuration from the list provided.
+
Manage...
+
Adds, removes, renames and manages configurations.
+
Configuration Settings, Build Settings
+
Sets the build 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.
+
+

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, 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 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++ 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, +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, 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 -

+IBM Copyright Statement

- 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 cced5c50a10..e8ede9a2b7d 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 @@ -1,67 +1,91 @@ - - - - C/C++ Project Properties, Managed, Builders - + + + C/C++ Project Properties, Managed, Builders + -

C/C++ Project Properties, Managed, Builders

-

You can select which Builders to enable for this project and in which order they are used.

- -

C/C++ Project Properties, Managed, Builders

- -

-
Builders
Select which Builders to enable.
-
New..
Add a new builder.
-
Import..
Import a builder.
-
Edit..
Edit a builder.
-
Remove
Remove a builder.
-
Up
Move the currently selected builder higher in the list.
-
Down
Move the currently selected builder lower in the list.
-

- - - - -

Related reference
+

You can select which Builders to enable for this project and in +which order they are used.

+

C/C++ Project Properties, Managed, Builders

+

+
+
Builders
+
Selects which Builders to enable.
+
New...
+
Adds a new builder.
+
Import...
+
Imports a builder.
+
Edit...
+
Edits a builder.
+
Remove
+
Removes a builder.
+
Up
+
Moves the currently selected builder higher in the list.
+
Down
+
Moves the currently selected builder lower in the list.
+
+

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, 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, 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++ 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, 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++ 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 -

+IBM Copyright Statement

- - \ No newline at end of file + 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 index aace8cf0055..8075d8d2a7c 100644 --- 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 @@ -1,83 +1,100 @@ - - - - C/C++ Project Properties, Managed Make File, Build - + + + 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.
+

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:
+
Specifies the selected build configuration from the list provided.
+
Manage...
+
Adds, removes, rename and manages configurations.
+
Pre-build Step
+
    Command
+
Specifies a command, or a list of semicolon separated commands, +to be executed immediately prior to execution of the build.
+
    Description
+
Specifies 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
+
Specifies a command, or a list of semicolon separated commands, +to be executed immediately after the execution of the build.
+
    Description
+
Specifies 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.
+

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.
+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 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
+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

- +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 -

+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 index c9af1ab30df..de6e8fbf0ca 100644 --- 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 @@ -1,62 +1,82 @@ - - - - C/C++ Project Properties, Managed, C/C++ Documentation - + + + 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/C++ Project Properties, Managed, C/C++ Documentation

+

+
+
Help Books
+
Sets 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, 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

- - +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 -

+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 index a2e71dc682b..ce3a976491f 100644 --- 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 @@ -1,12 +1,11 @@ - - - - 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
You can add, remove and edit - environment variables for a - project or configuration.  Each tab contains two tables - one for user-defined - environment variables and one for non user-defined environment - variables.  Each - table contains two columns:

Name of the environment variable

-

Value of the environment variable. 

-

You can view all environment variables that are not user-defined in the System - Variables table.  You - can choose to also display all variables defined for lower-precedence contexts - in the System Variables table by checking the Show parent level - variables checkbox. System variables are read-only.

-

You can view all user-defined variables in the User - Variables table.   - A user-defined variable overrides a non user-defined variable of the same - name for the given level.  Overridden variables are displayed in bold in - the System Variables table.

-
Restore Defaults
Returns any changes back to their default setting.
-
Apply
Applies any changes.
+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:
+
Specifies the selected build configuration from the list provided.
+
Manage...
+
Adds, removes, renames and manages configurations.
+
Configuration Settings
+
Adds, removes and edits environment variables for a project or +configuration.  Each tab contains two tables - one for +user-defined environment variables and one for non user-defined +environment variables.  Each table contains two columns: +

Name of the environment variable

+

Value of the environment variable. 

+

You can view all environment variables that are not user-defined +in the System Variables table.  You +can choose to also display all variables defined for lower-precedence +contexts in the System Variables table by checking the Show +parent level variables checkbox. System variables are read-only.

+

You can view all user-defined variables in the + User Variables table.   + A user-defined variable overrides a non user-defined +variable of the same name for the given level.  Overridden +variables are displayed in bold in the System Variables table.

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

Detailed Specification

-

Users and tool-chain integrators -can define the set of environment variables to be used while the build process -is executing.

-

Since the -environment variable names are case sensitive on Unix-like systems and case -insensitive on Windows systems, the Managed Build System (MBS) will treat the variable names in the same manner as the host system.

+

Users and tool-chain +integrators can define the set of environment variables to be used +while the build process is executing.

+

Since +the environment variable names are case sensitive on Unix-like systems +and case insensitive on Windows systems, the Managed Build System (MBS) +will treat the variable names in the same manner as the host system.

-

Build Environment variables can be -specified at several levels:

+

Build Environment variables can +be specified at several levels:

-

- 1.      - Configuration level – variables specific to the selected configuration

-

- 2.      - Project level – variables specific to the selected project and common - for all project configurations

-

- 3.      - Workspace level – variables specific to the current workspace

-

- 4.      - System environment passed to eclipse

+

1.      + Configuration level – variables specific to the selected +configuration

+

+ 2.      + Project level – variables specific to the selected project and +common for all project configurations

+

+ 3.      + Workspace level – variables specific to the current workspace

+

+ 4.      + System environment passed to eclipse

-

When running the build utility for the -selected configuration, the process' total environment variables set will be -generated, including variables from all specified levels. Levels have -precedence over each other as specified in the above list, so for example if -configuration level and workspace level have a variable of the same name, the -configuration variable will take precedence, etc.

-

Users can create and delete environment variables -for any given project configuration, for the entire project or for the entire -workspace.

-

To create a new variable the "New" button should be -pressed. The dialog will appear representing the variable definition.

-

-

-

 

-

A variable definition contains the name, the value, the -delimiter and the "operation" to perform on the -variable of the same name defined at the lower-precedence level. The following -"operations" are defined: 

-

-·        -"append":  If the variable already exists, -add the user-specified value to the end of any existing value that the -environment variable has.  If the variable does not yet exist, create the -variable and set it to the user-specified value.

-

-·        -"prepend":  If the variable already -exists, add the user-specified value to beginning of any existing value that the -environment variable has.  If the variable does not yet exist, create the -variable and set it to the user-specified value.

-

-·        -"replace":  If the variable already -exists, set the value to the user-specified value.  If the variable does not yet -exist, create the variable and set it to the user-specified value.

-

-·        -"delete":  If the variable already exists, -remove the variable.

-

The resulting value of the variable used for the build process will be -calculated by querying all levels from bottom to top and performing the -operations for the variables defined at those levels.

-

The "Name" field contains the list of variables that are already defined. A user can -choose any variable from the list or enter a new variable name. When the -variable from the list is chosen or the name typed by the user matches already -defined variable name, the other fields of the dialog get filled with the -current value, delimiter and operation of that variable.

-

When the "replace" operation is selected, the "Value" field is used to -specify the variable value.

-

When either the "prepend" or "append" operation is selected, the "Value" -field becomes grayed and the "Prepended/Appended value" field becomes visible -that allows user to specify the value to be prepended/appended. The resulting -variable value will be automatically calculated and displayed in the "Value" -field. The delimiter to be used with append/prepend operations may be -specified in the "Delimiter" field.

-

-

-

When the "delete" operation is selected, the "Value", "Delimiter" and "Prepended/Appended -value" field becomes inaccessible.

-

When performing the variable value calculation the variable name case -sensitivity will be taken in account. That is on Windows systems the variables of -the different levels or provided by different suppliers whose names differ only -in case will be treated as the same variable, while on Unix-like systems where -case sensitive variable names are supported variables whose names will differ -only in case will be treated as different variables.

- - -

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

-

Managed Build Project preferences

-

Managed Build Project preferences, Environment

-

Managed Build Project preferences, Macros

- -

-IBM Copyright Statement +

When running the build utility +for the selected configuration, the process' total environment +variables set will be generated, including variables from all specified +levels. Levels have precedence over each other as specified in the +above list. So, for example, if configuration level and workspace level +have a variable of the same name, the configuration variable will take +precedence, etc.

+

Users can create and delete environment +variables for any given project configuration, for the entire project +or for the entire workspace.

+

To create a new variable the "New" +button should be pressed. A dialog box representing the variable +definition will appear.

+

+

+

 

+

A variable definition contains the name, +the value, the delimiter and the "operation" to +perform on the variable of the same name defined at the +lower-precedence level. The following "operations" are defined: 

+

+·        +"append":  If the variable +already exists, add the user-specified value to the end of any existing +value that the environment variable has.  If the variable does not +yet exist, create the variable and set it to the user-specified value.

+

+·        +"prepend":  If the variable +already exists, add the user-specified value to the beginning of any +existing value that the environment variable has.  If the variable +does not yet exist, create the variable and set it to the +user-specified value.

+

+·        +"replace":  If the variable +already exists, set the value to the user-specified value.  If the +variable does not yet exist, create the variable and set it to the +user-specified value.

+

+·        +"delete":  If the variable +already exists, remove the variable.

+

The resulting value of the variable used for the build process will +be calculated by querying all levels from bottom to top and performing +the operations for the variables defined at those levels.

+

The "Name" field contains the list of variables that are already +defined. A user can choose any variable from the list or enter a new +variable name. When the variable from the list is chosen or the name +typed by the user matches already defined variable name, the other +fields of the dialog get filled in with the current value, delimiter +and operation of that variable.

+

When the "replace" operation is selected, the "Value" field is used +to specify the variable value.

+

When either the "prepend" or "append" operation is selected, the +"Value" field becomes grayed and the "Prepended/Appended value" field +becomes visible that allows user to specify the value to be +prepended/appended. The resulting variable value will be automatically +calculated and displayed in the "Value" field. The delimiter to be used +with append/prepend operations may be specified in the "Delimiter" +field.

+

+

+

When the "delete" operation is selected, the "Value", "Delimiter" +and "Prepended/Appended value" field becomes inaccessible.

+

When performing the variable value calculation the variable name +case sensitivity will be taken in account. That is, on Windows systems, +the variables of the different levels or provided by different +suppliers with names that differ only in case will be treated as the +same variable. Conversely, on Unix-like systems, where case sensitive +variable names are supported, variables with names that differ only in +case will be treated as different variables.

+

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

+

Managed Build Project preferences

+

Managed Build Project preferences, +Environment

+

Managed Build Project preferences, +Macros

+

+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 0410d9cb67f..a58292b5d02 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 @@ -1,62 +1,86 @@ - - - - C/C++ Project Properties, Managed, File Types - + + + 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, 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.
-

- - -

Related reference
+

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, C/C++ File Types

+

+
+
Use workspace settings
+
Enables the use of the Managed workspace settings.
+
Use Project Settings
+
Enables the use of project settings, or the addition or removal +of specific file types.
+
New...
+
Adds a new file type.
+
Remove
+
Removes a listed file type.
+
+

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, 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++ Documentation
-C++ Project Properties, Managed, C/C++ Indexer
-C++ Project Properties, Managed, Project References

- - - +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++ Documentation
+C++ Project Properties, Managed, +C/C++ Indexer
+C++ Project Properties, Managed, Project +References

-IBM Copyright Statement -

+IBM Copyright Statement

- - \ No newline at end of file + 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 7f724a12d7f..448da81243d 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 @@ -1,62 +1,86 @@ - - - - C/C++ Project Properties, Managed, Indexer - + + + C/C++ Project Properties, Managed, Indexer + -

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, C/C++ Indexer

- -

-
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.
-

- - - -

Related reference
+

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, C/C++ Indexer

+

+
+
Available Indexers
+
Specifies the Indexer to use for this project; No Indexer +disables 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.
+
+

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, 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++ Documentation
-C++ Project Properties, Managed, C/C++ File Types
-C++ Project Properties, Managed, Project References

- - +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++ Documentation
+C++ Project Properties, Managed, +C/C++ File Types
+C++ Project Properties, Managed, Project +References

-IBM Copyright Statement -

+IBM Copyright Statement

- - \ No newline at end of file + 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 64f3c9e656d..7ff835ab5c1 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 @@ -1,62 +1,85 @@ - - - - C/C++ Project Properties, Managed, Info - + + + C/C++ Project Properties, Managed, Info + -

C/C++ Project Properties, Managed, Info

- -

C/C++ Project Properties, Managed, Info

- - +

C/C++ Project Properties, Managed, Info

-
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.
-

- -

Related reference
+

Info
+
Shows project information.
+
Default encoding for text files
+
Sets an alternate text encoding.
+
New text file line delimiter
+
Specifies the line delimiter.
+
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, 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++ 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, 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, +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++ 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 -

+IBM Copyright Statement

- - \ No newline at end of file + 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 index a088c4170ac..1409d7e9fb5 100644 --- 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 @@ -1,12 +1,11 @@ - - - - C/C++ Project Properties, Managed, Build - - + -

C/C++ Project Properties, Managed, C/C++ Build, 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, remove and edit 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. System macros are read-only.

-

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.

+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:
+
Specifies the selected build configuration from the list provided.
+
Manage...
+
Adds, removes, renames and manages configurations.
+
Configuration Settings
+
Adds, removes, edits and manages 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. 

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

- +
+

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. System macros are read-only.

+

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. +

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 a backslash in order to distinguish it from a build macro. The Managed -Build System (MBS) pre-defines many useful macros (see below) and allows tool -integrators and users to define additional macros.

+If the actual value of text property contains ${text}, +it must be pre-pended with a backslash in order to distinguish it from +a build macro. The Managed Build System (MBS) 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. -
  2. Text-List value: an array of Text values
    3. -
  3. Path-file value: can hold a file path
    4. -
  4. Path-dir value: can hold a directory path -
    5. -
  5. Path-any value: can hold both a file and directory path -
    6. -
  6. Path-file-List value: an array of Path-file values -
    7. -
  7. Path-dir-List value: an array of Path-dir values
    8. -
  8. Path-any-List value: an array of Path-any values
    9. +
  9. Text value: can be any text string
    10. +
  10. Text-List value: an array of Text values
    11. +
  11. Path-file value: can hold a file path
    12. +
  12. Path-dir value: can hold a directory path
    13. +
  13. Path-any value: can hold both a file and directory path
    14. +
  14. Path-file-List value: an array of Path-file values
    15. +
  15. Path-dir-List value: an array of Path-dir values
    16. +
  16. Path-any-List value: an array of Path-any values
-

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:

+

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. -
  2. -

    The - currently selected option

    3. -
  3. -

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

    4. -
  4. -

    The - currently selected project.

    5. -
  5. -

    The - current workspace.

    6. -
  6. -

    The CDT - and Eclipse installations.

    7. -
  7. -

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

    8. +
  8. +

    The currently selected file.

    +
    9. +
  9. +

    The currently +selected option

    +
    10. +
  10. +

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

    +
    11. +
  11. +

    The currently +selected project.

    +
    12. +
  12. +

    The current +workspace.

    +
    13. +
  13. +

    The CDT and Eclipse +installations.

    +
    14. +
  14. +

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

    +
-

Users can define and delete macros -for any given project configuration, for the entire project or for the entire +

Users can define and delete macros for any given +project configuration, for the entire project or for the entire workspace.

-

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.  -It is possible, but not recommended, for a user-defined macro to override the -definition of an MBS pre-defined macro. Overriding MBS pre-defined macros can -have unanticipated consequences.

-

To define a new macro the "New" button should be pressed. -A dialog will appear representing the macro definition.

+<<<<<<< cdt_u_mprop_macros.htm +

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. 

+

To define a new macro the "New" button should be +pressed. A dialog will appear representing the macro definition.

+======= +

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.  It is possible, but not recommended, for a +user-defined macro to override the definition of an MBS pre-defined +macro. Overriding MBS pre-defined macros can have unanticipated +consequences.

+

To define a new macro the "New" button should be +pressed. A dialog will appear representing the macro definition.

+>>>>>>> 1.3 +

+

The "Name" field contains the list of macros that are already +defined. A user can choose any variable from the list or enter a new +variable name. When a macro from the list is chosen or the name typed +by the user matches an already existing macro name, the other fields of +the dialog get filled with the value, and value type of that macro.

+

When any of the "String," "File," "Directory" or "File or Directory" +value types is selected, the macro value may be specified with the +"Value" edit-box. For the "File" and "Directory" types, a "Browse" +button is also displayed that allows selecting file or directory using +the "Browse" dialog.

+

When either of the "List of Strings," "List of Files," "List of +Directories" or "List Files or Directories" value types is selected, +the macro value may be specified with the "Macro Value" multi-line text +box and button bar.

-

-

The "Name" field contains the list of macros that are already defined. A user can -choose any variable from the list or enter a new variable name. When a macro -from the list is chosen or the name typed by the user matches already existing -macro name, the other fields of the dialog get filled with the value, and value -type of that macro.

-

When either of the "String", "File", "Directory" or "File or Directory" value -types is selected, the macro value may be specified with the "Value" edit-box. -For the "File" and "Directory" types a "Browse" button is also displayed that -allows selecting file or directory using the "Browse" dialog.

-

When either of the "List of Strings", "List of Files", "List of Directories" -or "List Files or Directories" value types is selected, the macro value may be -specified with the "Macro Value" multi-line text box and button bar.

-

-

+

 

-

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" page. -

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

+

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" page. +

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

File-specific macros

-

The set of file-context macros is predefined by the Managed Build System (MBS). Neither a -tool-integrator nor a user can define new file-context macros.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +

The set of file-context macros is predefined by +the Managed Build System (MBS). Neither a tool-integrator nor a user +can define new file-context macros.

+
-

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.

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

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

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +

 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.

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

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

- - - - - - - - - - - +

Project-specific macros

+
-

${ProjName}

 -

Text

 -

Represents the name of a - given project.

-

${ProjDirPath}

 -

Path(Dir)

 -

Represents the absolute path of a given project. -

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

${ProjName}

+ 		+

Text

+ 		+

Represents the +name of a given project.

+
+

${ProjDirPath}

+ 		+

Path(Dir)

+ 		+

Represents the absolute path of a given +project.

+
-

Workspace-specific macros

- - - - - - - - - - - - - - - - +

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

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

${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.

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

${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
+

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, 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

-

Managed Build Project preferences

-

Managed Build Project preferences, Environment

-

Managed Build Project preferences, Macros

- +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

+

Managed Build Project preferences

+

Managed Build Project preferences, +Environment

+

Managed Build Project preferences, +Macros

-IBM Copyright Statement -

+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 b12f2c87348..360f819eeb4 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 @@ -1,81 +1,100 @@ - - - - C/C++ Project Properties, Managed, Binary Parser - + + + C/C++ Project Properties, Managed, Binary Parser + -

C/C++ Project Properties, Managed, C/C++ Build, Binary Parser

-

You can select the Binary Parsers you require for the project.

- -

To ensure the accuracy of the C/C++ Projects view and the ability to -successfully run and debug your programs. After you select the correct parser -for your development environment and build your project, you can view the +

You can select the Binary Parsers you require for a project to +ensure the accuracy of the C/C++ Projects view and to successfully run +and debug your programs. After you select the correct parser for your +development environment and build your project, you can view the symbols of the object file in the C/C++ Projects view.

- - - -

C/C++ Project Properties, Managed, Binary Parser

- - - +

C/C++ Project Properties, Managed, Binary Parser

-
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, Binary Parser
-
Select a binary parser from the list.
+
Project Type:
+
Displays the type of project that is built by the selected build +configuration.
+
Configuration:
+
Specifies the selected build configuration from the list provided.
+
Manage...
+
Adds, removes, renames and manages configurations.
+
Configuration Settings, Binary Parser
+
Specifies a binary parser from the list provided.
Binary Parser Options
-
If a binary parser has parser options you can define them in this section.
-
Restore Defaults
Returns any changes back to their default setting.
-
Apply
Applies any changes.
+
If a binary parser has parser options,  defines them.
+
Restore Defaults
+
Returns any changes back to their default setting.
+
Apply
+
Applies any changes.
- -

Related concepts +

Related concepts
Build overview

-

Related tasks +

Related tasks
Selecting a binary parser

-

Related reference
+

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, 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, 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, +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, 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, +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, 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 -

- +IBM Copyright Statement

- - \ No newline at end of file + 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 26c158843f1..71a717aeae2 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 @@ -1,26 +1,25 @@ - - - - C/C++ Project Properties, Managed, Error Parser - + + + C/C++ Project Properties, Managed, Error Parser + -

C/C++ Project Properties, Managed, C/C++ Build, Error Parsers

-

Customizes the list of the filters that detect error patterns in the build output log.

- -

C/C++ Project Properties, Managed, Error Parser

- - - +

Customizes the list of the filters that detect error patterns in the +build output log.

+

C/C++ Project Properties, Managed, Error Parser

-
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.
+
Project Type:
+
Displays the type of project that is built by the selected build +configuration.
+
Configuration:
+
Specifies the selected build configuration from the list provided.
+
Manage...
+
Adds, removes, renames and manages configurations.
Configuration Settings, Error Parsers
Lists the various error parsers which can be enabled or disabled.
Up
@@ -31,52 +30,75 @@
Selects all error parsers.
Unselect All
Clears all error parsers.
-
Restore Defaults
Returns any changes back to their default setting.
-
Apply
Applies any changes.
+
Restore Defaults
+
Returns any changes back to their default setting.
+
Apply
+
Applies any changes.
- -

Related concepts +

Related concepts
Build overview

-

Related tasks +

Related tasks
Filtering errors

-

Related reference
+

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, 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, 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 - - +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, 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 - - \ No newline at end of file + 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 ddd10e7ef0f..cb9d5287625 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 @@ -1,60 +1,77 @@ - - - - C/C++ Project, Managed, Project References - + + + C/C++ Project, Managed, Project References + -

C/C++ Project Properties, Managed, Project References

- -

C/C++ Project, Managed, Project References

- -

-
Project references for <project>:
Select the projects required to build this project.
-

- - - - -

Related reference
+

C/C++ Project, Managed, Project References

+

+
+
Project references for <project>:
+
Specifies the projects required to build this project.
+
+

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, 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++ Documentation
-C++ Project Properties, Managed, C/C++ File Types
-C++ Project Properties, Managed, C/C++ Indexer
- - - -

-IBM Copyright Statement +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++ Documentation
+C++ Project Properties, Managed, +C/C++ File Types
+C++ Project Properties, Managed, +C/C++ Indexer

+

IBM Copyright Statement

- - \ No newline at end of file + 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 a31d41cbab0..ef94d85c434 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 @@ -1,63 +1,90 @@ - - - - C/C++ Project Properties, Managed, Build - + + + C/C++ Project Properties, Managed, Build + - -

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

+

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

Customizes the tools and tool options used in your build configuration. -

C/C++ Project Properties, Managed, Build

- -

-
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, Tool Settings
Edit individual tool options.
-
Restore Defaults
Returns any changes back to their default setting.
-
Apply
Applies any changes.
-

- - -

Related reference
+

C/C++ Project Properties, Managed, Build

+

+
+
Project Type:
+
Displays the type of project that is built by the selected build +configuration.
+
Configuration:
+
Specifies the selected build configuration from the list provided.
+
Manage...
+
Adds, removes, renames and manages configurations.
+
Configuration Settings, Tool Settings
+
Sets individual tool options.
+
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, 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, 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++ 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

- -

-IBM Copyright Statement -

+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, 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 +

IBM Copyright Statement

- 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 fc39943c1c4..0d32dd78990 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 @@ -1,65 +1,69 @@ - - - - New Project Wizard - Managed Make, C/C++ Indexer - - + +

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

-

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

- - - -

- - - - - - - - - -
NameFunction
Available IndexersSelect the Indexer to use for this project, or No Indexer to disable indexing. Some indexers will display additional options below the indexer selection box.

- - -

Related concepts
+

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

+

+ + + + + + + + + + + +
NameFunction
Available IndexersSelects the Indexer to use for this project; No Indexer +disables indexing. Some indexers will display additional options below +the indexer selection box.
+

+

Related concepts
CDT projects

- -

Related tasks
+

Related tasks
CDT Managed Make Tutorial
-CDT Standard Make Tutorial
+CDT Standard Make +Tutorial

- -

Related reference
+

Related reference
New Project Wizard
-Managed Make, Select a Project Type
-Managed Make, Referenced Projects
+Managed Make, Select a +Project Type
+Managed Make, Referenced +Projects
Standard Make, Name
-Standard Make, Referenced Projects
+Standard Make, Referenced +Projects
Standard Make, Make Builder
Standard Make, Error Parsers
Standard Make, Binary Parser
-Standard Make, Discovery Options
+Standard Make, Discovery +Options
Standard Make, C/C++ Indexer

- -

-IBM Copyright Statement -

- +IBM Copyright Statement

- \ No newline at end of file + diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_new_proj_wiz_m_errorp.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_new_proj_wiz_m_errorp.htm index 2daebc42496..228523ab574 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_new_proj_wiz_m_errorp.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_new_proj_wiz_m_errorp.htm @@ -1,87 +1,85 @@ - - - - New Project Wizard - Managed Make, Error Parsers - - + +

New Project Wizard - Managed Make, Error Parsers

-

You can select which error parsers to use and in which order they are used for your project.

- -

New Project Wizard, Error Parser

- - - -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
NameFunction
Error ParsersYou can select which Error Parsers to enable from this window.
UpMoves the currently selected Error Parser higher in the ordered list.
DownMoves the currently selected Error Parser lower in the ordered list.
Select AllSelects all Error Parsers.
Unselect AllUnselects all Error Parsers.

- - -

Related concepts
+

You can select which error parsers to use and in which order they +are used for your project.

+

New Project Wizard, Error Parser

+

+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameFunction
Error ParsersSelects which Error Parsers to enable.
UpMoves the currently selected Error Parser higher in the +ordered list.
DownMoves the currently selected Error Parser lower in the +ordered list.
Select AllSelects all Error Parsers.
Unselect AllUnselects all Error Parsers.
+

+

Related concepts
CDT projects

- -

Related tasks
+

Related tasks
CDT Managed Make Tutorial
-CDT Standard Make Tutorial
+CDT Standard Make +Tutorial

- -

Related reference
+

Related reference
New Project Wizard
-Managed Make, Select a Project Type
-Managed Make, Referenced Projects
+Managed Make, Select a +Project Type
+Managed Make, Referenced +Projects
Managed Make, C/C++ Indexer
Standard Make, Name
-Standard Make, Referenced Projects
+Standard Make, Referenced +Projects
Standard Make, Make Builder
Standard Make, Error Parsers
Standard Make, Binary Parser
-Standard Make, Discovery Options
+Standard Make, Discovery +Options
Standard Make, C/C++ Indexer

- -

-IBM Copyright Statement -

- - +IBM Copyright Statement

- \ No newline at end of file + 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 b75e533252a..5eab317ad94 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 @@ -1,74 +1,78 @@ - - - - New Project Wizard - Managed Make, Name - - + +

New Project Wizard - Managed Make, Name

-

Select a name for the project. You can also enter a new path for your project by deselecting the Use Default Location checkbox and entering the new path in the Location text box.

- -

New Project Wizard, Managed Make, Name

- -

- - - - - - - - - - - - - - - - - - - -
NameFunction
NameSpecifies the name of the project.
Use Default LocationWhen selected the new project will be created in the default workspace location.
DirectoryIf Use Default Location is not selected, enter the location where the project is to be created.

-

Related concepts
+

Select a name for the project. You can also enter a new path for +your project by deselecting the Use Default Location checkbox +and entering the new path in the Location text box.

+

New Project Wizard, Managed Make, Name

+

+ + + + + + + + + + + + + + + + + + + +
NameFunction
NameSpecifies the name of the project.
Use Default LocationWhen selected, creates the new project in the default +workspace location.
DirectoryIf Use Default Location is not selected, specifies +the location where the project is to be created.
+

+

Related concepts
CDT projects

- -

Related tasks
+

Related tasks
CDT Managed Make Tutorial
-CDT Standard Make Tutorial
+CDT Standard Make +Tutorial

- -

Related reference
+

Related reference
New Project Wizard
-Managed Make, Select a Project Type
-Managed Make, Referenced Projects
+Managed Make, Select a +Project Type
+Managed Make, Referenced +Projects
Managed Make, C/C++ Indexer
Standard Make, Name
-Standard Make, Referenced Projects
+Standard Make, Referenced +Projects
Standard Make, Make Builder
Standard Make, Error Parsers
Standard Make, Binary Parser
-Standard Make, Discovery Options
+Standard Make, Discovery +Options
Standard Make, C/C++ Indexer

- -

-IBM Copyright Statement -

- - - +IBM Copyright Statement

- \ No newline at end of file + 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 2723cfb5201..a0eb68a9ba0 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 @@ -1,65 +1,65 @@ - - - - New Project Wizard - Managed Make, Projects - - + +

New Project Wizard - Managed Make, Referenced Projects

Select project references from your workspace.

- -

New Project Wizard, Managed Make, Referenced Projects

- - -

- - - - - - - - - -
NameFunction
Referenced C/C++ ProjectsIf you have any other projects in your workspace, you can select them as references for this new C or C++ project.

- - -

Related concepts
+

New Project Wizard, Managed Make, Referenced Projects

+

+ + + + + + + + + + + +
NameFunction
Referenced C/C++ ProjectsIf you have any other projects in your workspace, sets them +as references for this new C or C++ project.
+

+

Related concepts
CDT projects

- -

Related tasks
+

Related tasks
CDT Managed Make Tutorial
-CDT Standard Make Tutorial
+CDT Standard Make +Tutorial

- -

Related reference
+

Related reference
New Project Wizard
-Managed Make, Select a Project Type
+Managed Make, Select a +Project Type
Managed Make, C/C++ Indexer
Standard Make, Name
-Standard Make, Referenced Projects
+Standard Make, Referenced +Projects
Standard Make, Make Builder
Standard Make, Error Parsers
Standard Make, Binary Parser
-Standard Make, Discovery Options
+Standard Make, Discovery +Options
Standard Make, C/C++ Indexer

- -

-IBM Copyright Statement -

- - +IBM Copyright Statement

- \ No newline at end of file + 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 6c71fa13f10..ffced5e1a7a 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 @@ -1,69 +1,74 @@ - - - - New Project Wizard - Managed Make, Select a Target - + + + New Project Wizard - Managed Make, Select a Target + +

New Project Wizard - Managed Make, Select a Project Type

-

You can select the type of project and build configurations from this page of the wizard.

-

New Project Wizard, Managed Make, Select a Project Type

- -

- - - - - - - - - - - - - - - - - - - - - -
NameFunction
Project TypeYou can select a project type from the drop down list.
ConfigurationsSpecifies which build configurations will be supported for your project.
Show All Project TypesIf 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 ConfigurationsIf 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.

- - - -

Related concepts
+

You can select the type of project and build configurations from +this page of the wizard.

+

New Project Wizard, Managed Make, Select a Project Type

+

+ + + + + + + + + + + + + + + + + + + + + + + +
NameFunction
Project TypeSpecifies a project type from the list provided.
ConfigurationsSpecifies which build configurations will be supported for +your project.
Show All Project TypesIf selected, lists all known project types 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 ConfigurationsIf selected, lists all known default configurations in the Configurations +window. By default, the list is filtered so that only configurations +that are buildable on the host system are shown.
+

+

Related concepts
CDT projects

- -

Related tasks
+

Related tasks
CDT Managed Make Tutorial
-CDT Standard Make Tutorial
+CDT Standard Make +Tutorial

- -

Related reference
+

Related reference
New Project Wizard
-Managed Make, Referenced Projects
+Managed Make, Referenced +Projects
Managed Make, C/C++ Indexer
Standard Make, Name
-Standard Make, Referenced Projects
+Standard Make, Referenced +Projects
Standard Make, Make Builder
Standard Make, Error Parsers
Standard Make, Binary Parser
-Standard Make, Discovery Options
+Standard Make, Discovery +Options
Standard Make, C/C++ Indexer

- -

-IBM Copyright Statement -

- +IBM Copyright Statement

- \ No newline at end of file + diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_new_proj_wiz_s_binary.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_new_proj_wiz_s_binary.htm index 1abfff0e61b..89364b2dba6 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_new_proj_wiz_s_binary.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_new_proj_wiz_s_binary.htm @@ -1,70 +1,74 @@ - - - - New Project Wizard - Standard Make, Binary Parser - - + +

New Project Wizard - Standard Make, Binary Parser

-

You can select the Binary Parsers you require for the project.

- -

Select the appropriate binary parser to ensure the accuracy of the C/C++ Projects view and the ability to successfully run and debug your programs. -After you select the correct parser for your development environment and build your project, you can view the symbols of the .o file in the C/C++ Projects view.

- -

New Project Wizard, Standard Make, Binary Parser

- -

- - - - - - - - - - - - - -
NameFunction
Binary ParserSelect a binary parser from the list.
Binary Parser OptionsIf a binary parser has parser options you can define them in this section.

- - -

Related concepts
+

You can select the Binary Parsers you require for the project.

+

Select the appropriate binary parser to ensure the accuracy of the +C/C++ Projects view and the ability to successfully run and debug your +programs. After you select the correct parser for your development +environment and build your project, you can view the symbols of the .o +file in the C/C++ Projects view.

+

New Project Wizard, Standard Make, Binary Parser

+

+ + + + + + + + + + + + + + + +
NameFunction
Binary ParserSpecifies the binary parsers that are enabled.
Binary Parser OptionsSpecifies a binary parser's options, if any.
+

+

Related concepts
CDT projects

- -

Related tasks
+

Related tasks
CDT Managed Make Tutorial
-CDT Standard Make Tutorial
+CDT Standard Make +Tutorial

- -

Related reference
+

Related reference
New Project Wizard
-Managed Make, Select a Project Type
-Managed Make, Referenced Projects
+Managed Make, Select a +Project Type
+Managed Make, Referenced +Projects
Managed Make, C/C++ Indexer
Standard Make, Name
-Standard Make, Referenced Projects
+Standard Make, Referenced +Projects
Standard Make, Make Builder
Standard Make, Error Parsers
-Standard Make, Discovery Options
+Standard Make, Discovery +Options
Standard Make, C/C++ Indexer

- -

-IBM Copyright Statement -

- +IBM Copyright Statement

- \ No newline at end of file + diff --git a/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_autobuild.htm b/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_autobuild.htm index abdd9373ba4..ec3899543ec 100644 --- a/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_autobuild.htm +++ b/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_autobuild.htm @@ -1,37 +1,36 @@ - - - -Removing Build Automatically - + + + Removing Build Automatically + - -

Removing Build Automatically

- -

The Eclipse workbench is configured to build projects automatically. However for C/C++ development you should turn this feature off, -otherwise your entire project will be rebuilt whenever, for example, you save a change to your makefile or source files. -Click Project > Build Automatically and ensure there is no checkmark beside the Build Automatically menu item.

- -

Menubar showing Project selection

- -

Related concepts +

The Eclipse workbench is configured to build projects automatically. +However, for C/C++ development you should turn this feature off, +otherwise your entire project will be rebuilt whenever, for example, +you save a change to your makefile or source files. +Click Project > Build Automatically and ensure there is no +checkmark beside the Build Automatically menu item.

+

Menubar showing Project selection

+

Related concepts
Build overview

-

Related tasks +

Related tasks
Building Manually
Defining Build Settings
Building

-

Related reference +

Related reference
-Make Builder page, C/C++ Properties window

- -IBM Copyright Statement - +Make Builder page, +C/C++ Properties window

+IBM Copyright Statement - - \ No newline at end of file + diff --git a/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_cbuild_pref.htm b/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_cbuild_pref.htm index ac99cdb9552..4772a8e6352 100644 --- a/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_cbuild_pref.htm +++ b/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_cbuild_pref.htm @@ -1,43 +1,46 @@ - - - -Customizing the Console view - + + + Customizing the Console view + - -

Customizing the Console view

- -

The Console view displays the output of the utilities invoked when building a project or the programs output when running/debugging..

- +

The Console view displays the output of the utilities invoked when +building a project or the programs output when running/debugging.

To set Console view preferences

  1. Click Window > Preferences.
    2. -
  2. Expand C/C++, and click Build Console.
    - Build Console Properties
    3. -
  3. To display information on the latest build only, select the Always clear console before building check box.
    4. -
  4. To open the Console view when a project is built, select the Open console when building check box.
    5. -
  5. To display the console if it is already open when a project is built, select the Bring the console to top when building (if present) check box.
    6. -
  6. To change the number of lines the console stores in its history, enter a new value in the text field next to Limit console output (# lines).
    7. -
  7. To change the number of spaces displayed by a tab, enter the number in the txt field next to Display tab width.
    8. +
  8. Expand C/C++ and click Build Console.
    + Build Console Properties
    9. +
  9. To display information on the latest build only, select the Always +clear console before building check box.
    10. +
  10. To open the Console view when a project is built, select the Open +console when building check box.
    11. +
  11. To display the console if it is already open when a project is +built, select the Bring the console to top when building (if +present) check box.
    12. +
  12. To change the number of lines the console stores in its history, +enter a new value in the text field next to Limit console output (# +lines).
    13. +
  13. To change the number of spaces displayed by a tab, enter the +number in the txt field next to Display tab width.
  14. Click OK.
- -

Related concepts +

Related concepts
Build overview

-

Related tasks +

Related tasks
Defining Build Settings
Building

-

Related reference
+

Related reference
Views

-IBM Copyright Statement - +IBM Copyright Statement - - \ No newline at end of file + diff --git a/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_manualbuild.htm b/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_manualbuild.htm index 1293b63fe5c..6043c2c94e4 100644 --- a/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_manualbuild.htm +++ b/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_manualbuild.htm @@ -1,63 +1,60 @@ - - - -Building Manually - + + + Building Manually + - -

Building Manually

- -

Manual builds let you choose the scope of a build, as well as options for building, -or rebuilding projects. You can view the output of the make utility in the console.

- -

Sample build in console view

- - - +

Manual builds let you choose the scope of a build, as well as +options for building, or rebuilding projects. You can view the output +of the make utility in the console.

+

Sample build in console view

Incremental Builds
-
To incrementally build all open projects, you can select Project > Build All or type CTRL+B.
+
To incrementally build all open projects, you can select Project +> Build All or type CTRL+B.
Build Individual Projects
To build individual projects click Project > Build Project.
Rebuild Projects
-
To rebuild a project right click on the project and select Rebuild Project.
- Note: This will rebuild projects that this project references as well, but will not rebuild projects that references this one.
+
To rebuild a project right click on the project and select Rebuild +Project.
+ Note: This will rebuild projects that this project +references as well, but will not rebuild projects that references this +one.
Build Automatically
-
This performs a Build All whenever any project file is saved, such as your makefile.
- Tip: For C/C++ projects this feature should be turned off, if there is a checkmark beside Build Automatically it is on, to turn it off select Build Automatically.
-
- - +
This performs a Build All whenever any project file is saved, +such as your makefile.
+ Tip: For C/C++ projects, this feature should be turned off. +If there is a checkmark beside Build Automatically the feature +is on. To turn it off, select Build Automatically.
+

Tip: If you get the error message:

-

Exec error:Launching failed

- -

The error message means -that the CDT cannot locate the build command, (usually make). Either your path is -not configured correctly or you do not have make installed on your system.

- - -

Tip: The menubar item Project > Build Working Set submenu for C/C++ projects simply creates a link to the build all target as defined in your makefile, and is no different from an Incremental Build.

- - -

Related concepts +

then CDT cannot locate the build command, (usually make). +Either your path is not configured correctly or you do not have make +installed on your system.

+

Tip: The menubar item Project > Build Working Set +submenu for C/C++ projects simply creates a link to the build all +target as defined in your makefile, and is no different from an Incremental +Build.

+

Related concepts
Build overview

-

Related tasks +

Related tasks
Defining Build Settings
Building

-

Related reference +

Related reference
-Make Builder page, C/C++ Properties window

- -IBM Copyright Statement - +Make Builder page, +C/C++ Properties window

+IBM Copyright Statement - - \ No newline at end of file + diff --git a/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_new_cpp.htm b/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_new_cpp.htm index 46d0807eb06..17ac681418c 100644 --- a/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_new_cpp.htm +++ b/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_new_cpp.htm @@ -1,62 +1,64 @@ - - - -Creating a C/C++ file - - + - -

Creating a C/C++ file

- -

Files are edited in the C/C++ editor that is by default, located in the -editor area to the right of the C/C++ Projects view.

- -

The marker bar on the left margin of the C/C++ editor, displays icons for -errors, warnings, bookmarks, breakpoints and tasks.

- -

For more information on the marker bar, see Workbench User Guide > Reference > User interface -information > Views and editors > Editor area.

- +

Files are edited in the C/C++ editor that is, by default, located in +the editor area to the right of the C/C++ Projects view.

+

The marker bar on the left margin of the C/C++ editor, displays +icons for errors, warnings, bookmarks, breakpoints and tasks.

+

For more information on the marker bar, see Workbench User Guide +> Reference > User interface information > Views and editors +> Editor area.

To create a C++ file:

    -
  1. In the C++ Projects view, right-click a project, - and select New > File.
    - New > File in Projects View
    2. -
  2. In the list of projects, verify that the correct project is selected.
    3. -
  3. In the File name box, type a name followed by the appropriate extension.
    4. +
  4. In the C++ Projects view, right-click a project, and +select New > File.
    + New > File in Projects View
    5. +
  5. In the list of projects, verify that the correct project is +selected.
    6. +
  6. In the File name box, type a name followed by the +appropriate extension.
  7. Click Finish.
    - New File Wizard
    8. -

    The file will open in the C/C++ editor.

    -
  8. Enter your code in the editor view..
    - Editor view with a sample code
    9. -
  9. Type CTRL+S to save the file.
    10. + New File Wizard +

    The file will open in the C/C++ editor.

    +
  10. Enter your code in the editor view..
    + Editor view with a sample code
    11. +
  11. Type CTRL+S to save the file.
-

Related concepts +

Related concepts
CDT Projects
Project file views

-

Related tasks +

Related tasks
-Displaying C/C++ file components in the -C/C++ Projects view
-Hiding files by type in the C/C++ Projects -view

-

Related reference +Displaying C/C++ file components in +the C/C++ Projects view
+Hiding files by type in the C/C++ +Projects view

+

Related reference
Project properties

-

-IBM Copyright Statement \ No newline at end of file +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 1f4790f77f9..0da3cb4d910 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 @@ -1,96 +1,94 @@ - - - -Defining Standard Make build settings - + + + Defining Standard Make build settings + - -

Defining Standard Make build settings

-

The Make Builder page lets you:

- - -

You can define the properties on a per project basis in 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.

- +

You can define the properties on a per project basis in 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.

Before you begin

- -

In order to be able to turn on or to turn off the feature that automatically performs -an incremental build of your project every time a resource is saved for -individual projects, you need to enable the Workbench Build Automatically preference. You can then -disable this feature or change the associated make target for individual projects.

- +

In order to be able to turn on or to turn off the feature that +automatically performs an incremental build of your project every time +a resource is saved for individual projects, you need to enable the +Workbench Build Automatically preference. You can then disable +this feature or change the associated make target for individual +projects.

To enable build on resource save:

-
  1. Click Window > Preferences.
    2. -
  2. To automatically perform an incremental build of your project every time a - resource is saved, select Workbench from the list.
    3. -
  3. Select the Perform build automatically on resource modification check box.
    Note: this is the default setting.
    4. +
  4. To automatically perform an incremental build of your project +every time a resource is saved, select Workbench from the list.
    5. +
  5. Select the Perform build automatically on resource +modification check box.
    +Note: this is the default setting.

    6. You can now enable or disable this feature on a per project basis.

    -
- +

To define build settings:

-

Windows Preference Make Builder dialog

- +

Windows Preference Make Builder dialog

  1. Do one of the following:
    2. -
  2. Click the Make Builder tab.
    3. -
  3. Do one of the following:
    4. - +
  4. Click the Make Builder tab.
    5. +
+
    +
  1. To stop the build when an error is encountered, select Stop +on first build error.
    2. +
+
  1. Select one of the following build command settings:
  2. In the Workbench Build Behavior box, do the following:
    3. -
-

Related concepts +

  • Click OK.
    • + +

    Related concepts
    +CDT Projects
    +Project file views

    +

    Related tasks
    - CDT Projects
    - Project file views

    -

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

    -

    Related reference +

    Related reference
    -Make Builder page, C/C++ Properties window

    - - -IBM Copyright Statement - +Make Builder page, +C/C++ Properties window

    +IBM Copyright Statement - - \ No newline at end of file + 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 b2b9cfe6003..d5c16543e91 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 @@ -1,60 +1,58 @@ - - - -Selecting a binary parser - + + + Selecting a binary parser +

    Selecting a binary parser

    - -

    Selecting the correct binary parser is important to ensure the accuracy of the C/C++ -Projects view and the ability to successfully run and debug your programs. Windows users should select the -PE Windows Parser. UNIX and Linux users should select the Elf Parser. When -you select the correct parser for your development environment and build your -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.

    - -

    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.

    - +

    Selecting the correct binary parser is important to ensure the +accuracy of the C/C++ Projects view and to successfully run and debug +your programs. Windows users should select the PE Windows Parser. UNIX +and Linux users should select the Elf Parser. When you select the +correct parser for your development environment and build your 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.

    +

    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 set properties for future Standard Make projects:

    -
      -
    1. Click Window > - Preferences . Expand C/C++, click New Make Projects.
      2. +
    2. Click Window > Preferences . Expand C/C++, +click New Make Projects.
    3. Click the Binary Parser tab.
      - Select Binary Parser window
      4. + Select Binary Parser window
    4. In the Binary Parser list, click:
    5. Click OK.
    -

    For a Managed Make project:

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

    Related concepts
    +

    Related concepts
    CDT Projects
    Project file views

    -

    Related tasks
    +

    Related tasks
    Working with C/C++ project files

    -

    Related reference +

    Related reference
    -Binary Parser, C/C++ Properties window

    -IBM Copyright Statement - +Binary Parser, +C/C++ Properties window

    +IBM Copyright Statement - - \ No newline at end of file + diff --git a/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_proj_ref.htm b/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_proj_ref.htm index b6c0d638075..b1210dfeb45 100644 --- a/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_proj_ref.htm +++ b/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_proj_ref.htm @@ -1,51 +1,43 @@ - - - -Selecting referenced projects - + + + Selecting referenced projects + - -

    Selecting referenced projects

    - -

    The Referenced C/C++ Projects list on the Projects References page for a -given project, displays every project in your workspace -in the build order you specify. For more information, -see Setting build order.

    - -

    Projects selected in the list are built before the current project according to their dependencies. -The least used projects are built first.

    - +

    The Referenced C/C++ Projects list on the Projects References page +for a given project displays every project in your workspace in the +build order you specify. For more information, see Setting build order.

    +

    Projects selected in the list are built before the current project +according to their dependencies. The least used projects are built +first.

    To select referenced projects:

    -
    1. In the C/C++ Projects view, right-click a project, and select Properties.
      - Project Properties menu
      2. + Project Properties menu
    2. On the left, select Project References from the list.
    3. In the Project references... list, select referenced projects..
      - Project References dialog box
      4. - + Project References dialog box
    4. Click OK.
    -

    Related concepts +

    Related concepts
    +CDT Projects
    +Project file views

    +

    Related tasks
    - CDT Projects
    - Project file views

    -

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

    -

    Related reference +

    Related reference
    Project properties

    - - -IBM Copyright Statement - +IBM Copyright Statement - - \ No newline at end of file + diff --git a/doc/org.eclipse.cdt.doc.user/topics_Tasks.xml b/doc/org.eclipse.cdt.doc.user/topics_Tasks.xml index 936efedc253..bad46219d71 100644 --- a/doc/org.eclipse.cdt.doc.user/topics_Tasks.xml +++ b/doc/org.eclipse.cdt.doc.user/topics_Tasks.xml @@ -11,7 +11,7 @@ - +