Setting Standard Make build preferences

[David Inglis <dinglis@xxxxxxx>]

Here are a few changes for the user docs.

1) Please remove the following step in the tutorial;

To	See
Disable the feature that builds your project whenever a file is created, saved or deleted.	Setting build preferences

* This is no longer need as by default the make builder will not build on auto-build and
now gives the user control of this on a per project basis.

2) In cdt_c_build_over.htm please remove the following;

Clean

Delete all the built components (i.e. .o, .so, .exe, and so on) without building anything (i.e. make clean).

* The build target it no longer added by default for standard make projects.

Automatic build

By default, the CDT automatically rebuilds every time you save a resource (e.g. file). Autobuild is useful if you have a few, small projects open. You may choose to disable this feature for larger projects.

* same reason as #1.

3) see attached page for auto build page changes.

4) see attached page for add make target changes.

Title: Setting build preferences

Setting Standard Make build preferences

The global prefernece for Make project can be found in Window > Preferences > C/C++ 
> New Make Projects Within these preferences you can change the default builders settings
for new project, the binary parser for new project and error parsers, and include paths and preprocessor symbols.
For the purpose of this tutorial, you 
the automatic build feature for this tutorial so that your project does not 
build each time you create or modify a file.

To turn off automatic build

1. Click Window > Preferences.
2. On the left, click Workbench.
3. Clear the Perform build automatically on resource modification check box.
   This check box is selected by default.

Next, Creating your project

Back, Tutorial contents

CDT Overview
CDT Projects

Building
Customizing the C++ editor
 

 

Title: Automatically building when resources are modified

Automatically building when resources are modified

By default, Standard Make projects will not automaticlly rebuild every time you change a resource (Which is the default for other project types, ie. Java). This is due to the nature of the make builder, which is using an external utility to preform the actual build, and is unable to pass the modified files to the builder. Therefore complete project builds are performed, this may perform well if you are working with a few, small open projects. But as projects get larger they quickly become a problem.
 

To automatically build open projects

1. Click Window > Preferences.
2. Click Workbench on the left.
3. Select the Perform build automatically on resource modification check box.
4. Click OK.
5. Select Properties on context menu of make project.
6. Select Make C/C++ Project in property dialog.
7. In the Make Builder under Workbench build type: enable Build on resource save (Auto Build) and provide the make target you would like to invoke for this build.
   

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 set up correctly or you do not have make installed on your system.

Build overview
 

Building
 

 

Title: Adding a make target

Adding a make target

A make target is an action called by the make utility to perform a customized build-related task. For example, many makefiles support a target named clean, which gets called as make clean. You can call your own target such as myMakeAction to be called as make myMakeAction. You can also use a make target to pass options such as CPULIST=x86, which causes the make utility to build only for x86. These options work only if they are already defined in the makefile.

If you have added your own make targets, you can configure the CDT to call them specifically.

To add a customized make target to the C/C++ Projects view context menu

1. In the C/C++ Projects view, right-click a project and click Create Make Target....
2. In the Target Name: field, type a name that you would like to associate to the target
3. In Build Target: field, type in the name of the make build target.
   
4. Click OK. The target is added to the Make Targets view.

Build overview

Building