The CDT uses the same make utility and makefile used on the command line.
+
The CDT relies on an external mae 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.
Required utilities
@@ -21,13 +21,10 @@ You have the option of creating a Standard Make C project or a Standard Make C++
Cygwin contains these utilities for a Windows environment, while running the cygwin installation ensure gcc and make are selected, they are not installed by default.
+
Tip: Cygwin contains these utilities 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.
-
To test if your compiler was installed correctly open a command prompt or terminal window and type g++ or make.
-An error message stating the command was not found or not recognized means that the utility is not installed or your path is not configured correctly.
-
To check your path at a command prompt and the appropriate path command (i.e. enter PATH for windows users or echo $PATH for linux users). Make sure that the path to your build utility is defined (example PATH=c:\cygwin\bin).
Build terminology
@@ -35,17 +32,13 @@ An error message stating the command was not found or not recognized means that
Build Project
-
This is an incremental build (make all). 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:
-
Workbench User Guide > Concepts > Workbench > Builds
Workbench User Guide > Tasks > Building resources
@@ -55,39 +48,21 @@ build.
The Console view displays the output of the make utility.
-
The Tasks view displays a list of compiler errors and warnings related to
- your projects.
-
Makefile actions are displayed in the Make Targets view.
+
The Tasks view displays a list of compiler errors and warnings related to your projects.
+
Makefile targets are displayed in the Make Targets view.
-
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 project for which you supply the
+
You can either create a C project for which you supply the makefile or create a C project for which the CDT generates makefiles automatically.
-makefile
-or create a 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:
-
+
To create a new project, from the menu bar choose File > New > Project. In the dialog that appears:
-
To create a project for which you supply the makefile,
-select either
-Standard Make C project or
-
-Standard Make C++ project.
-
-
To create a project for which the CDT supplies a basic
-makefile, select either
-Managed Make C project or
-Managed Make C++ project.
-
+
To create a project for which you supply the makefile, select either Standard Make C project or Standard Make C++ project.
+
To create a project for which the CDT supplies a basic makefile, select either Managed Make C project or Managed Make C++ project.
Setting build preferences
@@ -95,75 +70,41 @@ select either
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 disabled.
-
+
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
-
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++ Make Project page enables you
-to control a variety of settings, including:
-
+
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++ Make Project page enables you to control a variety of settings, including:
-
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 compiler is used.
-By default the compiler is C Builder
-(gcc).
-
-
Workbench Build Behavior
-
Controls the auto-build on save feature and what operations
-are performed during a build and rebuild.
+
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.
-
The External Tools Builders page
-enables you to add, reorder, or remove external build tools.
-
-
Viewing build information
-
Build-related information is displayed as follows:
-
-
+
Build-related information is displayed as follows:
-
The Console view displays the output of the make utility.
-
The Tasks view displays a list
-of compiler errors and warnings related to your projects.
-
-
Build actions display in the Make Targets view.
-
+
The Console view displays the output of the make utility.
+
The Tasks view displays a list of compiler errors and warnings related to your projects.
+
Build actions display in the Make Targets view.
+
CDT Projects
diff --git a/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_comments.htm b/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_comments.htm
index 153bb7384c9..8351875e0a4 100644
--- a/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_comments.htm
+++ b/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_comments.htm
@@ -19,7 +19,7 @@ Two styles of comments are supported by current C/C++ compilers:
Comment
-
You can quickly comment out one or more lies of code by inserting the leading
+
You can quickly comment out one or more lines of code by inserting the leading
characters // at the beginning of the line. To do so, select the line
(or lines) of code you want to comment out and press CTRL+/ (slash).
diff --git a/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_content_assist.htm b/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_content_assist.htm
index f258edee4a2..12e068ccc85 100644
--- a/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_content_assist.htm
+++ b/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_content_assist.htm
@@ -4,16 +4,8 @@
- Content assist
+ Content Assist
-
@@ -26,8 +18,7 @@ a developer will type, based on the current context, scope, and prefix.
Code completion
-
Content assist provides code completion in the body of a method
-or a function. For the current project (and any referenced projects) a list is
+
Content assist provides code completion anywhere in the document. For the current project a list is
displayed of the elements that begin with the letter combination you entered, and
the relevance of each proposal is determined in the following order:
@@ -43,20 +34,16 @@ the relevance of each proposal is determined in the following order:
Enumerations
-You trigger the Code completion feature when you call Content Assist (such as when you type Ctrl+Space), but you also invoke it when you type
+You trigger the Code completion feature when you call Content Assist (such as when you type Ctrl+Space), but it is autoacivated you type
".", "->" or "::".
-
You can view the signature of each item on the list in a pop-up by pointing
-to it. You can then select an
-item in the list to insert it directly into your code. Newly created
-elements in your current or referenced project(s) must be saved before they will
-appear in the Content Assist list.
+
You can view the signature of each item on the list in a pop-up by pointing to it. You can then select an item in the list to insert it directly into your code.
Code templates
-
You can create and save code templates for frequently used sections of code. The Content Assist feature also provides quick access to code
+
You can create and save code templates for frequently used sections of code, which will be inserted according to scope. The Content Assist feature also provides quick access to code
templates.
When you enter a letter combination in the C/C++ editor, and type CTRL+SPACE (or right-click and click Content Assist), a
diff --git a/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_editor.htm b/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_editor.htm
index 656ba919c13..bfd16a59b5c 100644
--- a/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_editor.htm
+++ b/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_editor.htm
@@ -10,40 +10,20 @@
C/C++ editor
-
The CDT provides an editor that gives you specific support for editing C code.
-This C editor is invoked automatically when you edit a
-.c or .cpp
-file.
-
+
The CDT provides an editor that gives you specific support for editing C/C++ code.
+This C/C++ editor is invoked automatically when you edit a C/C++ source file.
-
The C editor includes the following features:
+
The C/C++ editor includes the following features:
Syntax highlighting
Content/code assist
-
Code formatting
Integrated debugging features
-
A context-menu.
-
You can control some of the operation of the C editor from the Window > Preferences > C/C++ > C/C++ Editor preferences dialog.
+
You can customize some of the operation of the C editor from the Window > Preferences > C/C++ > Editor preferences dialog.
-
Content Assist
-
-You invoke the C editor's Content Assist function by typing the first characters of a C statement, then pressing Ctrl+Space.
-Eclipse proposes code templates based on the .c or .cpp file type.
-
-
The C/C++ editor context menu
-
-
To access the C/C++ Editor context menu, right-click in a C/C++ editor.
-
-
The C/C++ Editor context menu contains an Include feature.
-If you right-click on a function and choose Add Include,
-the editor attempts to determine the header in which the function is prototyped
-(this determination is done through a code-completion contributor extension).
-If this is successful, the editor adds the appropriate
-#include at the top of the file.
@@ -66,4 +46,4 @@ If this is successful, the editor adds the appropriate
-
+
\ No newline at end of file
diff --git a/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_open_declarations.htm b/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_open_declarations.htm
index 691bdb79f75..60df8c124b5 100644
--- a/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_open_declarations.htm
+++ b/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_open_declarations.htm
@@ -10,14 +10,15 @@
-
Open declarations
+
Open declaration
You can select an element name in your code and quickly navigate to its declaration.
-
+
-
If the search finds only one matching declaration, you will immediately jump to the declaration, even if it is in another file. If
-the search finds multiple declarations, a windowed list of prospects will appear.
+
Open declaraion will attempt to navigate to the exact declaraion of the selected element. Open declaration requires your file to have the proper include paths set up to the declaraion. If for any reason open declaraion cannot find the declarion, it will display the following message in the status line:
+
+
CDT Projects
diff --git a/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_outlineview.htm b/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_outlineview.htm
index 8c6bd7ccd24..383d3ac9659 100644
--- a/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_outlineview.htm
+++ b/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_outlineview.htm
@@ -21,23 +21,24 @@ open in the editor area, by listing the structural elements.
in which they occur:
-
C or C++ file
Class
Namespace
Include
Enum
Enumerator
-
Field
Field private
Field protected
Field public
Include
Method private
Method protected
-
Method public struct
+
Method public
+
Struct
Type definition
Union
Variable
+
Function
+
Macro Definition
You can also sort the list
@@ -67,6 +68,7 @@ items:
Complete a text-based search, of a workspace or a specified working set for the
selected element.
Open a selected .h file in the editor.
+
Rename Refactor
Icons
diff --git a/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_over_cdt.htm b/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_over_cdt.htm
index 890fb6ddf36..bce1ea0a330 100644
--- a/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_over_cdt.htm
+++ b/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_over_cdt.htm
@@ -28,26 +28,16 @@ utilities and interpret their responses, such as:
C/C++ perspective consists of an editor and the following
views:
-
C/C++ Projects view
-
Lists all of your C/C++ projects.
-
-
Navigator view
-
Lists all files in your Eclipse workspace.
-
-
Tasks view
-
Lists things such as tasks, compiler warnings, and errors.
-
-
Console view
-
Displays the output from make.
-
-
Properties view
-
Lists the properties of a file that has been selected in
-the C/C++ Projects view or the
-
-Navigator view.
-
-
Outline view
-
Lists file elements.
+
C/C++ Projects
Shows your C/C++ projects and files.It operates in much the same way as the Navigator.
+
Console
Displays your program's output, as well as the output from your build command.
+
Editor
The C/C++ editor view provides specialized features for editing C/C++ related files.
+
Make Targets
Enables you to select the make targets you want to build in your workspace.
+
Navigator
Shows all of the file system's files under your workspace directory.
+
Outline
Displays the structure of the file currently open in an editor.
+
Problems View
If you encounter any errors during a build they will be displayed in the Problems view.
+
Properties
Shows the attributes of the item currently selected in a view or an editor.
+
Search
Shows the results of searches for files or text.
+
Tasks
Lists tasks that want to keep track of, either as a schedule of things to do or a history of things that have been done.
For more information, see Workbench User Guide > Concepts > Perspectives.
The C/C++ Projects view displays, in a tree structure, only C and C++ project files. In this view you can do the following:
-
Browse the elements of .c, .cpp, and .h files
+
Browse the elements of C/C++ source files
+
Build Targets
+
Create new projects, classes, files, or folders
+
Import or Export files and projects
+
Manage existing files (cut, paste, delete, move or rename)
Open files in the editor view
Open projects in a new window
-
Create new projects, classes, files, or folders
-
Manage existing files (cut, paste, delete, move or rename)
+
Refactor
Restore deleted files from local history
-
Import or Export files and projects
+
Search
Files that you select in the C/C++ Projects view affect the information that is displayed in other views.
diff --git a/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_views.htm b/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_views.htm
index 5e33ccd8a25..2b3fb6bb481 100644
--- a/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_views.htm
+++ b/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_views.htm
@@ -25,9 +25,11 @@ The C/C++ perspective displays these panels in a single Eclipse window. <
C/C++ Projects
Shows your C/C++ projects and files.It operates in much the same way as the Navigator.
Console
Displays your program's output, as well as the output from your build command.
-
Make Targets
Enables you to select the make targets you want to build for a particular CPU.
+
Editor
The C/C++ editor view provides specialized features for editing C/C++ related files.
+
Make Targets
Enables you to select the make targets you want to build in your workspace.
Navigator
Shows all of the file system's files under your workspace directory.
Outline
Displays the structure of the file currently open in an editor.
+
Problems View
If you encounter any errors during a build they will be displayed in the Problems view.
Properties
Shows the attributes of the item currently selected in a view or an editor.
Search
Shows the results of searches for files or text.
Tasks
Lists tasks that want to keep track of, either as a schedule of things to do or a history of things that have been done.
@@ -40,7 +42,6 @@ The C/C++ perspective displays these panels in a single Eclipse window. <
Automatically generate project defines and include paths settings from the C/C++ > New Make Projects > Discovery Options project settings.
+
+
C/C++ File Types
+
Define specific files, especially C++ headers without extensions, using the C/C++ File Types global preferences or project property.
+
+
Multiple Architecture Project Support
+
Building from multiple binary formats? Choose the appropriate formats using the Binary Parser project option.
+
+
Editor Hyperlink Naviagation
+
Enable the editor hyperlink navigation and then you can use Ctrl+click to jump to the declaration of an item on the C/C++ editor.
+
+
Indexer Error Markers
+
Enable C/C++ indexing and indexer error reporting in the C/C++ Indexer properties. This helps identify projects missing path configuration information.
+
+
Rename Refactoring Support
+
Use the Outline or the C/C++ Editor Refactor > Rename context menu to refactor class & type names, methods, function & member names.
+
+
Open Type
+
Use Open Type to open up the declaration of C/C++ classes, structures, unions, typedefs, enumerations and namespaces.
+
+
Automatic Refresh
+
Configure the default behavior of the automatic retrieval of shared library and register information in the C/C++ debugger.
+
+
Improved Managed Make
You can now set the compiler command for managed projects.
@@ -54,26 +80,16 @@
Improved View and Browsing Features
You can now open Include files from the Outline View.
-
Rename Refactoring is now supported from Projects, Outline and Editor views.
You can now perform selection searches from the C/C++ Editor
Improved Search
Search now supports external files referenced using #include.
-
-
-
-
-
What's New Since 1.2
-
-
-
-
Makefile Outline View
You can now browse the structure of your Makefile in Outline View.
Content Assist Enhancements
-
Content Assist now produces proposals from class members.
+
Content Assist now produces proposals from classes and structure members, local & global variables, pre-processor defines, pre-processor commands.
Content Assist now supports C++.
@@ -140,7 +156,7 @@ to search, mapping, and the order of the search.
and auto-load-symbols. Stop-on-solib will force the debugger to stop on any
shared library events. Auto load will load the symbols for any shared library.
GDB/MI improvements in display of arrays
-
Arrays are now separated into ranges, to limit the possibility of a timeout
+
Arrays are now separated into ranges, to limit the possibility of a timeout
on large arrays.