As mentioned, an Autotools project is an extended CDT Makefile project. Building the project is done the same as for any Makefile project. You can kick off a build manually by clicking on the Project -> Build Project menu item or if you choose, you can set up builds to occur automatically when resources are changed by checking off the Project -> Build Automatically menu item. The former build option is disabled when automatic builds are selected. By default, a make all is performed following the Autotools configure step. @@ -83,7 +83,7 @@
Note: changes to configurations are not performed unless the Ok or Apply buttons are pressed from a Property page with the Manage Configurations button on it. That is, pressing Ok from the Manage Configurations dialog does not make the changes permanent. You could add new configurations, delete others, and then hit the Cancel button from the corresponding property page and the changes would be reverted.
Note: changes to configurations are not performed unless the Ok or Apply buttons are pressed from a Property page with the Manage Configurations button on it. That is, pressing Ok from the Manage Configurations dialog does not make the changes permanent. You could add new configurations, delete others, and then hit the Cancel button from the corresponding property page and the changes would be reverted.
| diff --git a/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/Configuration.html b/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/Configuration.html index 188c262921a..c2110aba54d 100644 --- a/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/Configuration.html +++ b/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/Configuration.html @@ -28,7 +28,7 @@ | Invoking Autotools |
Prior to running a build, the Autotools plug-in runs the configure script. Parameters to be passed to configure may be entered via the Project -> Properties -> Autotools -> Configure Settings UI shown below:
@@ -96,7 +96,7 @@The Autotools console is an instance of a CDT Build console so the console preferences set in Window -> Preferences -> C/C++ -> Build Console apply as well.
-
| diff --git a/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/Creating-an-Autotools-Project.html b/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/Creating-an-Autotools-Project.html index c69673e0e78..4dc8e1401bd 100644 --- a/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/Creating-an-Autotools-Project.html +++ b/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/Creating-an-Autotools-Project.html @@ -28,20 +28,24 @@ | Configuration |
There a number of ways to create an Autotools project. The first method is through the CDT C and C++ Project wizards which can be activated from the File -> New -> C Project and File -> New -> C++ Project menu items, respectively, which are available while in the C/C++ Perspective. These two wizards can also be located by clicking on the File -> New -> Project... menu item and then opening the C/C++ folder found there.
+There a number of ways to create an Autotools project.
+The first method is through the CDT C and C++ Project wizards which can be activated from the File -> New -> C Project and File -> New -> C++ Project menu items, respectively, which are available while in the C/C++ Perspective. These two wizards can also be located by clicking on the File -> New -> Project... menu item and then opening the C/C++ folder found there.
Looking at the C Wizard, we see that there is a GNU Autotools category.
Opening the category, there are three choices: Empty Project, Autotools Shared Library Project, or Hello World Ansi C Autotools Project. The Empty Project template means that no files will be supplied to the new project while the Hello World project will supply a sample hello world program that uses Autotools for configuring the build. The Autotools Shared Library project is an example of how to use Autotools to create a shared library. The C++ Project Wizard also has the same GNU Autotools category and the three project templates: an Empty Project, Autotools Shared Library, and a Hello World C++ Autotools sample program. If you are creating a project from scratch, it is recommended that you use either the Hello World sample project or the Autotools Shared Library sample project and make modifications. Otherwise, you will need to create a configure script for the Autotools plug-in to invoke at build time or provide a Makefile so the configuration step does not fail.
+The C and C++ Wizards can also be used when importing an existing Autotools project. For example, when importing a project from CVS using File -> Import... -> CVS -> you are given the choice to "Check out as a project configured by the new project wizard".
From the New Project menu, open the C/C++ category and choose either a C Project or C++ Project, depending on the type of project being imported. If the code is both C and C++, choose C++ Project.
Let's say you have a C application using Autotools and select C Project. This will bring up the C Project Wizard as displayed earlier. In this case, choose the Empty Project from the GNU Autotools category as you already have all the configuration files in place.
+Another method to create an Autotools project is to convert an existing project. For example, if we import a project from SVN or CVS and do not configure using the new project wizard, the project will simply be downloaded into the workspace. At this point, it cannot be built or access various tools from the CDT.
To convert it, select the project in the Project Explorer and open the File -> New -> Convert to C/C++ Project menu item as found in the C/C++ Perspective. If in another perspective, this same wizard can be found by selecting File -> New -> Other... -> C/C++ -> Convert to a C/C++ Project. This brings up the C/C++ Conversion wizard.
@@ -49,6 +53,7 @@
Note how there is a set of projects that are candidates for conversion. This list contains any projects that are not already C or C++ projects. A C or C++ project includes regular CDT Managed Make and Makefile projects. Also note that the project you selected is automatically selected when the wizard opens.
There is a choice of C or C++ project and a set of project types to choose from. For Autotools, select the GNU Autotools category and this will convert to an Autotools project. Once converted, this project will not show up as a candidate project in the conversion wizard.
+The final way to create an Autotools project is to use the Autotools Conversion wizard. This wizard allows one to convert from any form of project to an Autotools project. Obviously, converting a project that isn't actually C or C++ and using Autotools will result in undefined behaviour. You need to first select the project you wish to convert. After selecting, go to File -> New -> Other... -> C/C++, open the category, select "Convert to a C/C++ Autotools Project" and hit the Next button.
@@ -58,7 +63,7 @@
Again, there are candidates for conversion. This list contains all projects that are not currently C or C++ Autotool projects. You are given the choice of C or C++ as with the standard C/C++ conversion wizard. Hitting the Finish button is all that is needed, but if you hit the Next button and continue on you can select referenced projects, if desired.
-Once converted to an Autotools project, there is no UI method to convert back to a regular C/C++ project. If this is desired, you need to manually remove the .project, .cproject, and .autotools files from the project directory. This will effectively remove the natures and CDT settings for the project, allowing you to convert it again however you want.
Once converted to an Autotools project, there is no UI method to convert back to a regular C/C++ project. If this is desired, you need to manually remove the .project, .cproject, and .autotools files from the project directory. This will effectively remove the natures and CDT settings for the project, allowing you to convert it again however you want.
| diff --git a/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/Invoking-Autotools.html b/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/Invoking-Autotools.html index 196c529d1e6..e0b67da4df9 100644 --- a/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/Invoking-Autotools.html +++ b/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/Invoking-Autotools.html @@ -28,7 +28,7 @@ | Special Editors |
To invoke the Autotools, a special sub-menu has been added to the project Context menu. Select any file in the project and then click on Invoke Autotools. There you will find a set of menu items to invoke the various Autotools for your project. The output of the tool invocation is presented in a special Autotools Console. Like the Configure and C-Build Consoles, the Autotools console is per-project and is not saved across Eclipse sessions. The console, if present, can be accessed via the "Display Selected Console" button in the Console View.
@@ -38,7 +38,7 @@
-
| diff --git a/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/Make-Targets.html b/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/Make-Targets.html index 76be5549b73..52e10fce758 100644 --- a/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/Make-Targets.html +++ b/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/Make-Targets.html @@ -28,7 +28,7 @@ | Updating This Document |
A Makefile has a set of targets that can be built. Typically, every Makefile has an all target which builds all targets, but there may be optional targets as well. A CDT Makefile project enables one to invoke the various make targets via the Make Targets dialog. Since an Autotools project is a form of Makefile project, it too supports the Make Targets dialog. @@ -73,7 +73,7 @@
The check-box that says "Run all project builders" should be left un-checked. By default, we only want the CDT Makefile builder to run and not the Autotools configure builder or any other builder.
The check-box that says "Run all project builders" should be left un-checked. By default, we only want the CDT Makefile builder to run and not the Autotools configure builder or any other builder.
| diff --git a/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/Special-Editors.html b/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/Special-Editors.html index 9a80c624bb2..c40f3881659 100644 --- a/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/Special-Editors.html +++ b/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/Special-Editors.html @@ -28,7 +28,7 @@ | Building |
The Autotools plug-in provides two special editors for editing Autotool input files. The first is the Autoconf Editor. This editor is invoked when opening configure.in, configure.ac files as well as the resultant configure scripts that autoconf creates. Support includes full colourization, outline view, rudimentary error parsing, and hover help/completion.
@@ -49,7 +49,7 @@
In the example shown, one can see the $ variable references are displayed when hovered over. This is particularly useful for $< and $@ in make targets to understand what is being referenced. In some instances, you will see reference to variables surrounded by the @ symbol (e.g. @srcdir@). This represents a variable that is to be substituted by the configure script.
-Rudimentary error parsing looks for syntax errors. As with the Autoconf editor, colourization can be controlled by preferences. Go to Window -> Preferences -> C/C++ -> Autotools -> Automake Editor and click on the Syntax tab.
Rudimentary error parsing looks for syntax errors. As with the Autoconf editor, colourization can be controlled by preferences. Go to Window -> Preferences -> C/C++ -> Autotools -> Automake Editor and click on the Syntax tab.
| diff --git a/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/Supported-Environments.html b/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/Supported-Environments.html index 17827b95805..d3350a06291 100644 --- a/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/Supported-Environments.html +++ b/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/Supported-Environments.html @@ -28,10 +28,10 @@ | Creating an Autotools Project |
While the Autotools should work on any Unix-based system, it has only been extensively tested on Linux as the plugins originally came from the Linux Tools project. OS-specific bugs or problems that are not reproducible on Linux may require a user work-around. For example, users of Cygwin or MinGW may require setting modifications to get the plug-in working for their project. The Autotools plug-in is not supported under a regular Windows environment (i.e. without Cygwin or MinGW).
-To use the Autotools plug-in, it is required that you have the base CDT (C/C++ Development Tools) installed in Eclipse, the GNU Autotools installed on your system, and a "sh" (shell) command must be available. The "sh" command is required to invoke the configure script.
To use the Autotools plug-in, it is required that you have the base CDT (C/C++ Development Tools) installed in Eclipse, the GNU Autotools installed on your system, and a "sh" (shell) command must be available. The "sh" command is required to invoke the configure script.
| diff --git a/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/Updating-This-Document.html b/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/Updating-This-Document.html index f3d632b3dea..8d9e2b496e2 100644 --- a/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/Updating-This-Document.html +++ b/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/Updating-This-Document.html @@ -24,12 +24,12 @@ |
This document is maintained in a collaborative wiki. If you wish to update or modify this document please visit http://wiki.eclipse.org/CDT/Autotools/User_Guide -
| diff --git a/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/User-Guide.html b/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/User-Guide.html index faad684e059..7a67fc3ec07 100644 --- a/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/User-Guide.html +++ b/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/User-Guide.html @@ -24,8 +24,7 @@ | Supported Environments |
The Autotools plug-in for Eclipse is an optional feature of the CDT (C/C++ Development Tools) that adds support for maintaining and building C/C++ projects that use GNU Autotools. The Autotools plug-ins were migrated from the Linux Tools project into the CDT as part of the Eclipse Juno release.
@@ -41,7 +40,7 @@ http://www.gnu.org/software/autoconf/ and http://www.gnu.org/software/automake/ -| diff --git a/build/org.eclipse.cdt.autotools.docs/build-helper.xml b/build/org.eclipse.cdt.autotools.docs/build-helper.xml index f21a10db3b4..0ff6c14923f 100644 --- a/build/org.eclipse.cdt.autotools.docs/build-helper.xml +++ b/build/org.eclipse.cdt.autotools.docs/build-helper.xml @@ -1,6 +1,6 @@ - |