diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/README b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/README new file mode 100644 index 00000000000..aa130093de8 --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/README @@ -0,0 +1 @@ +The contents of this folder originated in the book "Setting up Eclipse CDT" by Max Berger that was graciously donated to the Eclipse CDT project in January 2020. Please see Bug 559272. \ No newline at end of file diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/Mingw5_1.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/Mingw5_1.png new file mode 100644 index 00000000000..f40874f9ff6 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/Mingw5_1.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/Mingw5_2.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/Mingw5_2.png new file mode 100644 index 00000000000..5c003919b7b Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/Mingw5_2.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/Mingw5_3.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/Mingw5_3.png new file mode 100644 index 00000000000..34a82db75f4 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/Mingw5_3.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/autobuild.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/autobuild.png new file mode 100644 index 00000000000..11e6b048439 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/autobuild.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/build.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/build.png new file mode 100644 index 00000000000..b4efffe5a39 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/build.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/compiler.xml b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/compiler.xml new file mode 100644 index 00000000000..abb34608ee4 --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/compiler.xml @@ -0,0 +1,48 @@ + +
+ Setting up a compiler + Unfortunately Eclipse only provides the Integrated Development + Environment (IDE) but it is missing the actual compiler. To install a + compiler, please follow the instructions for your operating system. +
+ Windows compiler + Windows doesn't come with a build-in compiler. You could try to + install Visual Studio, but it is tricky to get that working with + Eclipse. Therefore we will install MSYS. MSYS is part of + the MinGW suite, which + provides free development tools for Windows. + You will have to follow these 4 steps: + + + Download and install MinGW + + + Download and install MSYS + + + Set your path environment variable + + + Restart Eclipse if it was started. + + + + +
+
+ Linux / Unix Compiler + In most Linux and Unix distributions the compiler is already + installed. Check if you can run + g++ --version + and either + make --version + or + gmake --version + If both of them (g++ and either + make or gmake) work then you are + already done. If not, please install those. This may be very different + depending on which Linux or Unix distribution you have. Install the + tools and continue with . +
+ +
diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/eclipse.xml b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/eclipse.xml new file mode 100644 index 00000000000..281d7bf6a56 --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/eclipse.xml @@ -0,0 +1,361 @@ + +
+ Setting up Eclipse + On Windows XP and later, this may be a good point in time to create a + system restore point. This may safe you trouble in the long run if the + installation fails. +
+ Java + Eclipse was originally written for the Java platform. It still + requires a Java Runtime Environment (JRE) or a Java Development Kit (JDK), + version 1.5 or greater. You will most probably already have Java installed + (it comes included in Mac OS X until 10.6 and will be auto-installed in + Mac OS X 10.7 / Lion). However, if you don't have Java installed, and you + are on Windows or Linux, you can download a JRE from Sun's Java website or from + java.com. At the time of + this writing the latest version was Java Runtime + Environment (JRE) 7. Look for the section called "Java SE Runtime + Environment (JRE)" and select "JRE 7" (or similar). You will not need + NetBeans, JDK, or EE, they are just larger downloads with more programs. + You may need the JDK if you want to do Java development. + Note: There may be an incompatibility + between Eclipse Helios and Java 1.6 update 21. + To find out if you have Java installed, and which version it is, you + can open a command prompt / shell and type in: + java -version +
+
+ Downloading Eclipse + Eclipse is a modular software, but ever summer there are bundled + released. The link is: + + + + + + + + I recommend the complete "Eclipse IDE for C/C++ Developers" bundle, + which already contains the CDT. If you download a different bundle, you + will probably have to install the CDT manually, as described in . + The file is about 86 MB in size, so it will take a while to + download. You will end up with a .ZIP file. Use either FilZip or your favorite ZIP + Program (Windows XP/Vista/7 and Mac OS X have .ZIP support build in) to + unpack the file. Move the unpacked folder to any location, for example + C:\Program Files\eclipse. You can now start Eclipse + by double-clicking it. +
+ Eclipse installed into C:\Program Files\eclipse + + + + + + + +
+
+
+ First Run of Eclipse + However you installed eclipse, you should now be able to run it. + Double-click the icon or start the appropriate script in UNIX and + Eclipse's splash-screen will appear: +
+ Eclipse splash screen + + + + + + + +
+ Immediately after that Eclipse will ask you for your workspace + location. It defaults to a place within your personal settings. It is a + good idea to use the default workspace, you may want to note where it is + located. +
+ Eclipse asking for workspace + + + + + + + +
+ If you always want to use the same workspace, you may select the + Use this as the default... and you'll + never have to worry about workspaces again. This is usually a good idea + once you've used Eclipse for a while. Finally Eclipse starts up with the + welcome screen: +
+ Eclipse welcome screen + + + + + + + +
+ And if you select the "Go to the workbench" (the backward arrow) on + the right, then you are inside Eclipse. + If you downloaded the "Eclipse IDE for C/C++ Developers" you can + skip the next section and go straight to . + If you have downloaded a different package, there are additional + tools needed to start programming. We want to develop in C++, so we will + continue with the next section. +
+
+ Installing the CDT + + This is only required if you did not download the CDT version as + described above. Please check if you are able to create a new C++ + project (as described in ) before going + through this section! + + + This section described the current (3.5, 3.6, and 3.7) version of + Eclipse. For the previous version (3.4) Please see ). + + In the "Help" menu select "Install New Software..." +
+ Select Install New Software... from the help menu + + + + + + + +
+ This will show you the list of available software update sites. CDT + is part of the standard release, so you can select an update site matching + your eclipse version. + Please note: It is important to install the right Version of CDT for + your version of eclipse: + + + For Eclipse 3.7 (Indigo): Use + http://download.eclipse.org/tools/cdt/releases/indigo + + + For Eclipse 3.6 (Helios): Use + http://download.eclipse.org/tools/cdt/releases/helios + + + For Eclipse 3.5 (Galileo): Use + http://download.eclipse.org/tools/cdt/releases/galileo + + +
+ Available Software Update page with Add... opened + + + + + + + +
+ When you have found the CDT site, it will give you two entries: CDT + Main Features and CDT Optional Features. Expand both, and find the latest + version of the CDT. Make sure you select at least the following: + + + C/C++ Development Tools + + + C/C++ GNU Toolchain Build Support + + + C/C++ GNU Toolchain Debug Support + + + C/C++ Development Platform + + + Do not select all items! Some of these require dependencies from + other projects, which may not be installed and thus fail to install. + Select only the features you need! +
+ Select CDT from the Update Site + + + + + + + +
+ The select "Next..." + You will have to confirm the selection with "Next". + And accept the license agreement with "Finish". + Downloading and installing will take a while. Once its done it will + ask you to restart Eclipse. This is a good idea, so select "Yes". +
+ Restarting the workbench + + + + + + + +
+ Once Eclipse has restarted you may need to configure it for your + computer. +
+
+ Configuring the CDT + Fortunately, this is very easy. If your path is set correctly, there + should be absolutely nothing you need to configure. This is true if you + followed these instructions for Windows or Mac OS X. + On some Unix systems you might have to change your "make" program to + "gmake". You will find the setting in Window / Preferences (Eclipse / + Preferences on Mac OS X). Then expand "C / C++", then "New CDT Project + Wizard", "Makefile Project" and select "Builder Settings". In the section + "builder", de-select "use default build command" and for "Build command" + enter "gmake". +
+
+ Hello, World! + Once you are in Eclipse, you are given an empty workspace. You now + have to start a new project. To do so, select "File" / "New" / + "Project...". Expand the section "C++" and select "C++ Project", then + click "Next >". +
+ New Project screen + + + + + + + +
+ On the next screen, you have to give your project a name. In this + case, it will be "HelloWorld", however, you may use any name you like. + Also, you have to select a toolchain. + + + For Windows, select "MinGW GCC" + + + For Linux, select "Linux GCC" + + + For Mac OS X, select "MacOSX GCC" + + + Do not use "Cross GCC"! Unfortunately this option may be + selected by default if you create an empty project! + + + Click "Next". +
+ New Project Name + + + + + + + +
+ The next screen contains some Basic settings. Fill in what you + like: +
+ Basic Settings + + + + + + + +
+ In the last setting you can chose output formats, it is always good + to have a release and a debug configuration. Click "Finish". +
+ New Project Platforms + + + + + + + +
+ Eclipse will now generate a few things, and then ask you if you want + to switch to the C/C++ Perspective. This is a good idea, so say + yes. +
+ Perspective Switch + + + + + + + +
+ Great. You have a project now, and it does contain some sample code! + You will immediately get an editor window for your project. Eclipse will + also auto-build your project every time you save. + If eclipse does not auto-build, you have to turn on "build + automatically" in the Project Menu, or click the "Build All" button after + every change. +
+ Make sure "Build Automatically" is enabled + + + + + + + +
+
+ If you turn off autobuild, you have to click the "build" button + on the toolbar + + + + + + + +
+
+ Example Hello World application + + + + + + + +
+ Now here comes the tricky part: On the left pane, select "C/C++ + Projects", expand "Binaries" and you should see and executable + (HelloWorld.exe on Windows). Now right-click that executable, and select + "Run" / "Run Local C/C++ Application". If everything goes well your output + will be in the bottom right window in the "Console" tab and it should say + "Hello, World". +
+ Running the example Hello World application + + + + + + + +
+ Congratulations! You have successfully installed a compiler, a build + system and an IDE. You have successfully created, edited, compiled and run + a project. You should now be able to start your own projects! +
+
diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/eclipseDir.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/eclipseDir.png new file mode 100644 index 00000000000..2ad68244634 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/eclipseDir.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/eclipsesu1.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/eclipsesu1.png new file mode 100644 index 00000000000..440fcde04e5 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/eclipsesu1.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/eclipsesu2.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/eclipsesu2.png new file mode 100644 index 00000000000..d0ddd71a5ee Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/eclipsesu2.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/eclipsesu3.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/eclipsesu3.png new file mode 100644 index 00000000000..c3b6113b118 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/eclipsesu3.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/eclipsesu4.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/eclipsesu4.png new file mode 100644 index 00000000000..a0ce245f2e4 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/eclipsesu4.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/eclipsesu5.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/eclipsesu5.png new file mode 100644 index 00000000000..e7ac8d46c72 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/eclipsesu5.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/eclipsesu6.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/eclipsesu6.png new file mode 100644 index 00000000000..e728cdd65bc Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/eclipsesu6.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/envwin.xml b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/envwin.xml new file mode 100644 index 00000000000..bf427ec265d --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/envwin.xml @@ -0,0 +1,114 @@ + +
+ Environment Variables + The next thing you need to do is set up your Path environment + variable. + On Windows 2000/XP, right-click on My + Computer and select + Properties. Then, select the + Advanced tab. There should be a button + called Environment Variables. +
+ Finding Environment Variables (Windows 2000) + + + + + + + +
+
+ Finding Environment Variables (Windows XP) + + + + + + + +
+ In Windows Vista / Windows 7, Click on the Windows Logo, right click + on Computer, select Properties +
+ Computer properties in Windows Vista / Windows 7 + + + + + + + + In the control panel, select "Advances system settings" +
+
+ Finding the System Properties in Winows Vista / Winows 7 + + + + + + + +
+ Finally, click on "Environment Variables" +
+ Environment Variables in Windows Vista / Windows 7 + + + + + + + +
+ In the environment variables, there are two sections, one for the + local user (you) and one for the system. Depending on whether you want the + paths to be set for everyone, or for you, do one of the following: + + Warning: I had reports of people deleting their existing + Path environment variable! Please be very careful when editing an existing + value! By default, Windows has the whole line selected, resulting in + overwriting what was in there! + + If you want to set it for everyone, look for the variable + Path in the section System + variables. Click Edit. + There should already be some text in there, append + ;C:\MinGW\bin;C:\MinGW\msys\1.0\bin; (or your appropriate + paths, e.g. ;C:\msys\1.0\bin;C:\mingw\bin if you + installed MinGW 5 / MSys 1.0.11) to it, and select + OK multiple times. Please make sure that + you do not overwrite what was in there! + If you just want to set it for you, look for + Path in the upper section. It is very + likely not there yet. So select New... and + enter C:\MinGW\bin;C:\MinGW\msys\1.0\bin (or your + appropriate paths, see paragraph above). Then select + OK multiple times. Again, if there was a + setting before, do not delete it, but rather append your path! +
+ Setting the Environment variables + + + + + + + +
+ There seems to be a problem with a very long PATH environment variable + on some systems. According to reports, Eclipse will fail to compile and + build, where as compiling and building from a command window may work fine. + In this case, try to prepend the path to MinGW and MSYS rather than + appending it. + Congratulations. Now you have a complier and make set up on your + computer. Continue with . + Checkpoint: Open up a command terminal (cmd) and type: + make --version +g++ --version +gcc --version + Each one of these should work now. If not, you have either not + installed MSYS correctly or not set your path environment variable. Also, + try logging out and back in. +
diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/feedback.xml b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/feedback.xml new file mode 100644 index 00000000000..efb0f55855d --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/feedback.xml @@ -0,0 +1,8 @@ + +
+ Feedback + Do you have any comments how this document could be improved? Email + the author. I'll be happy to make any changes that make the setup of the + Eclipse CDT easier, or include information that is missing in this + paper. +
diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/gdb.xml b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/gdb.xml new file mode 100644 index 00000000000..b1a29ae0ba7 --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/gdb.xml @@ -0,0 +1,20 @@ + +
+ GDB (optional!) + This section is completely optional. You may skip it and go + directly to . + If you want to use the debugger, you may have to install it + separately. This is the case with MinGW 5.0.2, it may be different in + other versions. Download it from the same page, look for a package + starting with gdb and ending with .exe. At the time of this writing + (Apr 29) the current version was "gdb-5.2.1-1.exe". Install + (double-click) that .exe, select all the default options (make sure + you select the same MinGW directory as you did during the MinGW + install). + I have received a report that gdb-6.3-2 does not work. So I + would advise using the older version or waiting for a newer + one. + Checkpoint: + gdb --version + should print the gdb version. This is optional. +
diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/helloout.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/helloout.png new file mode 100644 index 00000000000..a3746c7b275 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/helloout.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/helloworld.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/helloworld.png new file mode 100644 index 00000000000..6b68a97b011 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/helloworld.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/index.dbk.xml b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/index.dbk.xml new file mode 100644 index 00000000000..2b19a5edae3 --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/index.dbk.xml @@ -0,0 +1,11 @@ + +
+ + + + + + + + +
diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/info.xml b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/info.xml new file mode 100644 index 00000000000..16538b3619c --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/info.xml @@ -0,0 +1,39 @@ + + + Setting up Eclipse CDT + On Windows, Linux/Unix, OS X + + + Max + Berger + + max@berger.name + + + 2005 + 2006 + 2007 + 2008 + 2009 + 2010 + 2011 + 2012 + 2013 + 2014 + Max Berger + + + This howto has been avaiable under different versions at different times. + This document is licensed under the Eclipse Public License - v2.0 (EPL v2.0), or any later version. + Please see https://www.eclipse.org/legal/epl-2.0/ for details. + + Versions between August 2011 and December 2019 where proprietary. They are not be copied, distributed, published, or larger + parts being cited without the consent of the author. Small excerpts may be cited if proper attribution including a link to the authors website is given. All rights + reserved. + Previous versions of this document (prior to August 2011) where + published under the GNU Free Documentation License (GFDL), Version 1.2. + Please refer to the appropriate document version should you want to chose + that license. Please note that the GFDL does not apply to newer versions, + e.g. this version of the document! + + diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/introduction.xml b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/introduction.xml new file mode 100644 index 00000000000..cf709b729ea --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/introduction.xml @@ -0,0 +1,91 @@ + +
+ Introduction + There are several freely available C and C++ development environments. + Most of them have the disadvantage that they require one particular + operating system. The Eclipse IDE was written as a cross-platform + development environment. Initially just written for Java, it also has a very + good C/C++ development mode. + If you have already tried (and I assume failed, otherwise you wouldn't + be reading this document) to install Eclipse CDT, you may want to go + directly to . + This document describes how to install everything necessary to develop + with C or C++ using only free tools on the three major operating systems + Windows, Linux, and Mac OS X. It uses the Eclipse IDE, which is the same on + all operating systems, thus providing a consistent user experience once + installed. + There are two versions of this document: + + + The free online version + + The free + version of Setting up Eclipse CDT on Windows, Linux/Unix, Mac OS + X can be found on Max Bergers website. It + will always be the previous major revision of the document. + + + + A paid eBook version + + The eBook version of Setting up Eclipse CDT on Windows, + Linux/Unix, Mac OS X is distributed through Amazon.com, Amazon.co.uk, + and Amazon.de. It will always be the current major revision of the + document. + + + + Setting + up Eclipse CDT on Window, Linux/Unix, Mac OS X on + Amazon.com + + + + + Setting + up Eclipse CDT on Window, Linux/Unix, Mac OS X on + Amazon.co.uk + + + + + Setting + up Eclipse CDT on Window, Linux/Unix, Mac OS X on + Amazon.de + + + + + Setting + up Eclipse CDT on Window, Linux/Unix, Mac OS X on + Amazon.fr + + + + + Setting + up Eclipse CDT on Window, Linux/Unix, Mac OS X on + Amazon.it + + + + + Setting + up Eclipse CDT on Window, Linux/Unix, Mac OS X on + Amazon.es + + + + + + + At this time, the eBook version contains updates for the following + items which are not yet in the free version: + + + There are no updates in the ebook version at this time. + + + Screenshots may still reflect older versions of the used software, + they are only updated if there is a significant change. +
diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/macosx.xml b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/macosx.xml new file mode 100644 index 00000000000..113776fc937 --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/macosx.xml @@ -0,0 +1,119 @@ + +
+ Mac OS X Compiler + On Mac OS X you can also try the commands explained in to check if you have the necessary tools installed. If + not, you will need to install the developer tools +
+ Mac OS X up to Snow Leopard (10.6) + The developer tools are either on one of your Mac OS X CDs that came + with your computer, or you can download them at: Apple's developer + connection. +
+
+ Mac OS X Lion (10.7) and Newer + To get the compiler, you have to install developer tools (Xcode) + from the App Store. After downloading, you have to run the installer to + actually install the developer tools. + + If you have upgraded to Lion from an older version of OS X, you + have to redo both of these steps (download + install). Upgrading to Lion + breaks your existing developer tools. Again: You have to do this after + an upgrade to Lion, even if you have previously installed the developer + tools! + +
+ Find XCode in App Store + + + + + + + +
+ After you've downloaded developer tools (Xcode), you have to go to + your Applications folder and run the installer. +
+ Run the Xcode installer from Applications + + + + + + + +
+ During the install, you may encounter the following error + messages: + + + In order to continue installation, please close the following + application: iTunes + + You may need to do two things: + + + Close iTunes, see if that helped. + + + In a Terminal window, type: killall + iTunesHelper + + + + + + No matching processes belonging to you were found + + This can happen if your Unix username contains a space. The + workaround is to create an admin user to be used during the + installation. + + + Open system preferences, go to "Users and groups" + + + Unlock the user preferences, type in you password + + + Click on "+" to create a new user + + + For "New account" select "Administrator" + + + For fullname and account name enter something in all + lower cases without spaces, e.g. "admin". + + + In der Dropdownmenu for "new account" change + "Standard" to "Administrator". + + + Log out, and log back in as your new admin + user. + + + Try installing again. + + + Log out, log back in as your normal user + + + Delete the admin user (System preferences, Users and + Groups, unlock, select the admin user, click on "-") + + + + + + + + After Xcode has finished installing, you can open up a terminal + (Applications / Utilities / Terminal) and check if g++, gcc and make are + working: + gcc --version +g++ --version +make --version +
+
diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingw1.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingw1.png new file mode 100644 index 00000000000..391f25413a5 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingw1.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingw41_1.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingw41_1.png new file mode 100644 index 00000000000..bb9f5520bbc Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingw41_1.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingw41_1_1.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingw41_1_1.png new file mode 100644 index 00000000000..85e28d8c0ce Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingw41_1_1.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingw41_1_2.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingw41_1_2.png new file mode 100644 index 00000000000..a27afdcd682 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingw41_1_2.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingw41_2.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingw41_2.png new file mode 100644 index 00000000000..0693bab1400 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingw41_2.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingw41_3a.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingw41_3a.png new file mode 100644 index 00000000000..b5cbf5a2d06 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingw41_3a.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingw41_3b.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingw41_3b.png new file mode 100644 index 00000000000..94ee451dcab Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingw41_3b.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingw41_4.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingw41_4.png new file mode 100644 index 00000000000..565c5532d67 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingw41_4.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingw5.xml b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingw5.xml new file mode 100644 index 00000000000..086a6710cdf --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingw5.xml @@ -0,0 +1,80 @@ + +
+ MinGW 5.x + First, you need to download MinGW. You can either click through + the websites mentioned above or go directly to the MinGW + download area. Look for the Package "Automated MinGW + Installer". There, download the file ending in .exe. The file name + should be something like "MinGW-5.1.4.exe". You can also download + MinGW + Version 5.1.4 from the link given here. + You may also download an older version, and follow the + instructions given in : + + + You may download MinGW + 4 and follow the instructions in . + + + You may download MinGW + 3 and follow the instructions in . + + + Most of the options in the MinGW 5 installer are pretty + straightforward. I will point out some of the more tricky + options. + The first one of such options is which "MinGW" package to + install. Any of those should work just fine, but I would recommend + Current. +
+ MinGW 5 install + + + + + + + +
+ MinGW will ask which components to install. Either select + All or at least make sure that you + have the g++ compiler checked. This + is needed for C++ support. +
+ MinGW 5 install (2) + + + + + + + +
+ When asked for the install folder, please do not change it. You + will have a lot of trouble later on, especially if you chose a path + that contains spaces. +
+ MinGW 5 install (3) + + + + + + + +
+ That's already it for MinGW. There are two more steps: MSYS and + the Environment Variables. + Checkpoint: To test if everything worked, please reboot. Then + open up a terminal. (Start/Run, type CMD). Try these commands: + gcc --version + + should print the version of gcc. If you get a "File not found", + try logging out and logging back in, or even rebooting your computer. + If it still does not work, you have not installed MinGW correctly. You + may also need to set your environment variables manually (see + below). + g++ --version + should print the version for g++. You did select the "g++ + compiler" I hope. If not, install again! +
diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst.xml b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst.xml new file mode 100644 index 00000000000..1f3d0ac4e16 --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst.xml @@ -0,0 +1,155 @@ + +
+ MinGW + MSYS + First, you need to download MinGW. You can either click through the + websites mentioned above or go directly to the MinGW download + area. Look for the Section "Automated MinGW Installer", then + "mingw-get-inst". There, download the newest subdirectory. and in there + download the file ending in .exe. The file name should be something like + "mingw-get-inst-20110802.exe". You can also download mingw-get-inst-200110802.exe + from the link given here. + Make sure you install the program with Administrator Priviledges. + Right-click on the downloaded file, and select "Run as + Administrator". +
+ MinGW-Get-Inst Setup + + + + + + + +
+ Make sure the second screen tells you that this is an Administrator + install. If you don't get this screen, select "Cancel" and re-start as + administrator. +
+ Make sure you do an Administrator install + + + + + + + +
+ The next screen asks you if you want up-to-date versions of the files. + Tell the installer that you want do download the newest catalog data. +
+ Select the latest version + + + + + + + + Next, you have to accept the License. +
+ MinGW License + + + + + + + + The following screen allows you to select a directory to install + to. The default directory C:\MinGW is + fine. You can select almost anything you like. + + Do not select a path containing spaces! This will lead to + trouble later on! + +
+ Select a path for MinGW and MSYS + + + + + + + +
+
+ Next, you're asked if you want to create a start menu entry. This is + a good idea for checking the install, so do it. +
+ Create a start menu entry + + + + + + + + On the next screen, you again have to change things. You have to + select "C++Compiler" and "MSYS Basic System". These two are necessary to + run the compiler and the build-system on Windows. +
+ Select "C++ Compiler" and "MSYS Basic System" + + + + + + + +
+
+ The next screen lets you check the installation. Make sure it looks + like this screenshot. +
+ Please check if the right options are selected + + + + + + + +
+
+ After selecting "Install", you have to wait for the installation + process to complete. +
+ Installer updating its catalogue files + + + + + + + +
+
+ Downloading and installing + + + + + + + +
+
+ Installation complete + + + + + + + + Once the installation is complete, hit "Finish". +
+ Checkpoint: You should be able to start MSYS by going to Start / + Programs / MinGW / MinGW Shell. A console window should open. There, the + following commands should give you some output: + gcc --version +g++ --version +make --version + Close the MSYS shell again. We'll make sure that these tools are + available for all Windows programs in the next section. +
diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst1.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst1.png new file mode 100644 index 00000000000..70b2967df16 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst1.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst10.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst10.png new file mode 100644 index 00000000000..734d044dbd3 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst10.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst11.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst11.png new file mode 100644 index 00000000000..af2f8bb87aa Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst11.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst2.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst2.png new file mode 100644 index 00000000000..c31986b625b Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst2.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst3.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst3.png new file mode 100644 index 00000000000..9fe57f2efa4 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst3.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst4.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst4.png new file mode 100644 index 00000000000..0894555a1e2 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst4.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst5.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst5.png new file mode 100644 index 00000000000..787595a7b27 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst5.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst6.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst6.png new file mode 100644 index 00000000000..5b6e0ccde24 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst6.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst7.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst7.png new file mode 100644 index 00000000000..6c2ff7380ac Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst7.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst8.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst8.png new file mode 100644 index 00000000000..1f0f0732659 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst8.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst9.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst9.png new file mode 100644 index 00000000000..f364fca1c5a Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/mingwgetinst9.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/msys1011.xml b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/msys1011.xml new file mode 100644 index 00000000000..ee12b9d6d96 --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/msys1011.xml @@ -0,0 +1,97 @@ + +
+ MSYS 1.0.11 + Unfortunately MinGW is not enough. We also need the MSYS tools + from the same download page. Go there again, to the "Current" section + and look for "MSYS Base System". Again, look for the file ending in + .exe, as this time: "MSYS-1.0.11.exe". You may have to expand the + "Release Candidate" section. Or you may use the link here to MSYS-1.0.11.exe. + Download it and start it. You should get a window like this: +
+ MSYS install + + + + + + + +
+ If you accept all the default options, after a while there + should be a black and white window, similar to this: +
+ MSYS asking for post-install + + + + + + + +
+ To continue the install type in y and then Enter. The next + question reads like this: +
+ MSYS asking for MinGW + + + + + + + +
+ Which you can also answer with y Enter. The next question is a + little bit more tricky: +
+ MSYS asking for path to MinGW + + + + + + + +
+ What they want to know is where you installed MinGW to and that + you replace all backward slashes (\) by forward slashes (/). If you + followed the instructions, the answer here will be: + C:/MinGW + Caveat: If you have not used the default paths, but instead have + installed MinGW in a different location, such as + C:/Program Files/MinGW, where the + path contains spaces and / or is longer than 8 characters you may have + to replace that particular path component with its DOS short pathname, + such as C:/PROGRA~1/mingw. + Caveat2: The installer may be case sensitive. Please make sure + you have written MinGW in the same capitalization as during your first + install, in some cases you will have to enter + c:/mingw (note + capitalization!). + The very last question just asks you to press a key: +
+ MSYS installing correctly + + + + + + + +
+ Where you can press any key you like to continue. Setup will + come back and ask you if you want to read a welcome note and the + README file. You probably don't want either one, but it does not hurt + to look. Anyways, once you hit "Finish" you are done with the setup. + Now you have to set up your Path environment variable. +
+ MSYS is done + + + + + + + +
+
diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/navigator.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/navigator.png new file mode 100644 index 00000000000..1a93108040d Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/navigator.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/newcppproject.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/newcppproject.png new file mode 100644 index 00000000000..c5d9b64d89e Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/newcppproject.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/newcppproject2.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/newcppproject2.png new file mode 100644 index 00000000000..19597984c0b Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/newcppproject2.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/newcppproject3.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/newcppproject3.png new file mode 100644 index 00000000000..f7d01f55461 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/newcppproject3.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/newcppproject4.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/newcppproject4.png new file mode 100644 index 00000000000..9c8ace08de1 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/newcppproject4.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/newproject.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/newproject.png new file mode 100644 index 00000000000..414c0bf5573 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/newproject.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/newsource.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/newsource.png new file mode 100644 index 00000000000..2cc4000c9a8 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/newsource.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/older.xml b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/older.xml new file mode 100644 index 00000000000..71ab2ee5c90 --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/older.xml @@ -0,0 +1,497 @@ + +
+ Older Instructions + Sometimes you may not be happy with the current version of a certain + program. I have left instructions for the older versions here in case you + need them: +
+ MinGW 5, MSYS 1.0.11 + This is the old MSYS/MinGW installation used before the new mingw-get-inst was available. + + + +
+
+ Installing the CDT on Eclipse 3.4 + + This is only required if you did not download the CDT version as + described above. Please check if you are able to create a new C++ + project (as described in ) before going + through this section! + + In the "Help" menu select "Software Updates..." +
+ Select Software Updates... from the menu + + + + + + + +
+ This will show you the list of available software update sites. If + you are luck you already have the CDT update site configured. Search for + an entry which contains the String "cdt", for example + http://download.eclipse.org/tools/cdt/releases/ganymede. +
+ Main Software Update page + + + + + + + +
+ If there is no site for cdt available, go to "Manage Sites", and + you will get a list of sites. +
+ Manage Software Update sites + + + + + + + +
+ Again, search for a site containing "CDT". If there is no site + available, add it (using the "Add..." button), adding + http://download.eclipse.org/tools/cdt/releases/ganymede + (the address may be different in future versions of Eclipse, this is for + 3.4!) + Also, make sure the checkbox next to the Address is checked. + Otherwise the site is configured, but ignored by Eclipse. Leave this + page and go back to the main Software update page. + Expand the CDT site, and find the latest version of the CDT. Make + sure you select at least the following: + + + Eclipse C/C++ Development Tools + + + CDT GNU Toolchain Build Support + + + CDT GNU Toolchain Debug Support + + + Eclipse C/C++ Development Platform + + +
+ Select CDT from the Update Site + + + + + + + +
+ The select "Install..." + You will have to confirm the selection with "Finish" + Downloading and installing will take a while. Once its done it + will ask you to restart Eclipse. This is a good idea, so select + "Yes". +
+ Restarting the workbench + + + + + + + +
+ Once Eclipse has restarted you now need to configure it for your + computer. +
+
+ Hello, World! in older versions of CDT + Once you are in Eclipse, you are given an empty workspace. You now + have to start a new project. To do so, select "File" / "New" / + "Project...". Expand the section "C++" and select "Managed Make C++ + Project", then click "Next >". +
+ New Project screen + + + + + + + +
+ On the next screen, you have to give your project a name. In this + case, it will be "HelloWorld", however, you may use any name you like. + Leave the "Use default" in "Project Contents" checked. +
+ New Project Name + + + + + + + +
+ The next two settings about "Project Type" and additional settings + are usually OK, so we'll just leave them: +
+ New Project Platforms + + + + + + + +
+
+ New Project Settings + + + + + + + +
+ Eclipse will now generate a few things, and then ask you if you + want to switch to the C/C++ Perspective. This is a good idea, so say + yes. +
+ Perspective Switch + + + + + + + +
+ Great. You have a project now. However, it currently does not have + any files. So select "File" / "New" / "C Source File". It will then ask + you for the name of the file, type in something like "main.cpp". +
+ Create a new Source File + + + + + + + +
+ You will immediately get an editor window for your file. Eclipse + will also auto-build your project every time you save. So type in + something like this and hit save, and it should compile + automatically: +
+ Example Hello World application + + + + + + + +
+ Now here comes the tricky part: On the left pane, select "C/C++ + Projects", expand "Binaries" and you should see and executable + (HelloWorld.exe). Now right-click that executable, and select "Run" / + "Run Local C/C++ Application". If everything goes well your output will + be in the bottom right window in the "Console" tab and it should say + "Hello, World". +
+ Running the example Hello World application + + + + + + + +
+ Congratulations! You have successfully installed a compiler, a + build system and an IDE. You have successfully created, edited, compiled + and run a project. You should now be able to start your own + projects! +
+
+ Eclipse 3.1 with CDT 3.0 +
+ Downloading Eclipse 3.1 + Now we are finally ready to install Eclipse. Go to the Eclipse website + and look for "Downloads". It will automatically try to figure out your + OS and give you an option like "Download now: Eclipse Platform SDK + 3.1, Windows.". Do it. You will receive a .ZIP file. Use either FilZip or your favorite ZIP + Program (Windows XP and Mac OS X have .ZIP support build in) to unpack + the file. Move the unpacked folder to any location, for example + C:\Program Files\eclipse. You can now start + Eclipse by double-clicking it. +
+ Eclipse installed into C:\Program Files\eclipse + + + + + + + +
+
+
+ First Run of Eclipse + However you installed eclipse, you should now be able to run it. + Double-click the icon or start the appropriate script in UNIX and + Eclipse's splash-screen will appear: +
+ Eclipse splash screen + + + + + + + +
+ Immediately after that Eclipse will ask you for your workspace + location. It defaults to: C:\Program + Files\eclipse\workspace which is actually very bad. + Depending on where you want to use Eclipse, please set your workspace + to the appropriate folder. If you are in a computer lab, check their + policy on personal home folders. If you are on your own computer, a + place within your personal settings is usually best: +
+ Eclipse asking for workspace + + + + + + + +
+ If you always want to use the same workspace, you may select the + Use this as the default... and you'll + never have to worry about workspaces again. This is usually a good + idea once you've used Eclipse for a while. Finally Eclipse starts up + with the welcome screen: +
+ Eclipse welcome screen + + + + + + + +
+ And if you select the "Go to the workbench" in the top right + corner, then you are right in Eclipse and you can start developing in + Java. However, since we want to develop in C++ just continue with the + next section. +
+
+ Installing the CDT + Eclipse by default comes with support for programming Java, the + support for C/C++ (the C Development Toolkit) has to be installed as + an update. + In the "Help" menu select "Software Updates" and the "Find and + Install...". You should get something like: +
+ Find and Install software updates + + + + + + + +
+ Select "Search for new features to install", and then "Next + >". You should get: +
+ Select update sites + + + + + + + +
+ Leave "Ignore features not applicable to this environment" + checked and de-select all update sites (you will probably have less in + there than I do). Select "New Remote Site" and then enter the + following information: + Note: What name you enter does not matter. Here is the URL for + cut-n-paste: + http://download.eclipse.org/tools/cdt/releases/eclipse3.1 +
+ Add new update site + + + + + + + +
+ Hit "OK". Now select "Eclipse CDT" and then "Next >". It + should connect to the Eclipse CDT update site and look for the newest + version. Then it displays a window like this one: +
+ Select CDT to install + + + + + + + +
+ Select the latest version of the "Eclipse C/C++ Development + Tools". (3.0.1 at the time of this writing) Do not select any other + features. Hit "Next >". + In the next window, you will have to "accept" the license, and + then select "Next >". + It will again show you an overview, which you can just accept + and select "Finish". + It will warn you that the Eclipse CDT is an "unsigned feature". + But you can just ignore that and select "Install All". +
+ Unsigned JAR + + + + + + + +
+ Downloading and installing will take a while. Once its done it + will ask you to restart Eclipse. This is a good idea, so select + "Yes". +
+ Restarting the workbench + + + + + + + +
+ Once Eclipse has restarted you now need to configure it for your + computer. + Eclipse 3.1 with CDT 3.0.0 (and 3.0.1) has a bug on windows! If + you are on windows, please close eclipse, and delete the file + spawner.dll in + eclise\plugins\org.eclipse.cdt.core.win32_3.0.0\os\win32\x86. This bug + appears every time you try and run short programs (they will not show + any output). More information is available in Eclipse + Bug 102043. This bug is fixed in CDT 3.0.2. +
+
+
+ MinGW 4.x + MinGW 4.x comes with a new installer that asks much more questions + than the old one. The current (Aug 05) version is MinGW 4.1.1. + Please note: The MinGW 4.x installer downloads parts of the MinGW + suite during the install! You must have an internet connection during + the install. If this is not an option for you, download the last version + (3.1) +
+ MinGW 4.1 install + + + + + + + +
+ Most installation options are pretty straight forward. You will + have to accept the license agreement: +
+ MinGW license + + + + + +
+ It will ask you for a download mirror. Of course, you should pick + one close to your country. If you are installing from home in the us, + use a commercial mirror, if you are installing from a university + connection, chose a university mirror. +
+ Mirror Selection + + + + + +
+ When installing MinGW, it is advisable to use the default + directory C:\MinGW. Do not use a path + that contains spaces, this will give you problems later on. +
+ MinGW installation directory + + + + + + + +
+ If all you need MinGW for is compiling your programs from within + Eclipse, the Compact install should be enough: +
+ MinGW installation components + + + + + + + +
+ Next, it will ask you for additional tasks to perform. Select all + of them: +
+ Additional Tasks + + + + + +
+ MinGW will download and install your selected components. After a + little while your installation is done. You will now need to install + MSYS. +
+
+ MinGW 3.1 + At the time of this writing this was "Download MinGW-3.1.0-1.exe", + but the version number may be higher now. Once downloaded, start the + program. It should look similar to this: +
+ MinGW 3.1 install + + + + + + + +
+ If you accept all the default options MinGW should install just + fine. +
+
diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/other.xml b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/other.xml new file mode 100644 index 00000000000..6ba31631733 --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/other.xml @@ -0,0 +1,23 @@ + +
+ Other Resources + When looking for Instructions, I found the following + websites: + + + + + + + + + + + + + + + + + +
diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/perspective.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/perspective.png new file mode 100644 index 00000000000..d1e062ffbd1 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/perspective.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/problems.xml b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/problems.xml new file mode 100644 index 00000000000..abbcac03215 --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/problems.xml @@ -0,0 +1,297 @@ + +
+ Common Problems + If you have followed these instructions everything should work. + However, you may have ran into trouble, and then decided to look for the + manual (at least, that's the way I would have done it). So now you have a + problem and need an answer: + Please note if you are reading the online version: Some problems may + covered in a newer version of this document, please refer to . +
+ How to fix most of the common errors on Windows + Make sure you have done the following things: + + + + Installed the CDT + + + Installed (not just downloaded) MinGW and MSYS with + Administrator privileges + + + Set up your path environment variable + + + + Especially made sure you did the last step. You + will need to restart eclipse (full restart with + shutdown, File / Restart is not sufficient). This solves about 99% of all + support mails I've got so far. +
+
+ How to fix most of the common errors on Lion (Mac OS X 10.7) + Make sure you have done the following this: + + + Downloaded XCode from App Store + + + Installed XCode using the "Install XCode button" + + + Both of these steps are important, in particular when you upgraded + from an earlier version of Mac OS X. Upgrading to Lion breaks your + existing developer tools! Read also the full description in . It also covers problems during the XCode + install. +
+
+ Build error (Exec error:Launching failed), CreateProcess: make -k + all error=2, + You have just tried the build the hello world program, and you get + this error message instead of an executable. This means that + make is not in your path. Open up a command prompt (In + OS X: Terminal in Applications/Utilities, in Windows: Start/Run, type in + cmd) and type in make. If that doesn't work, try + gmake. + If gmake worked, see . + If neither worked, make sure you install make (See ) and set your path (See in + the case of Windows). + To check your path (on windows), open up cmd and + type in echo %path%. This should show the path to MSYS + and MinGW. Also, make sure that you restarted Eclipse (or cmd if you are + testing) after setting your path. + If you are on Windows, and you have installed MinGW, but not MSYS, + you may have an executable called mingw-make. In this + case you have to go to and configure + appropriately. It is possible to just use mingw-make and no MSYS at all, + however, mingw-make has some limitations. Eclipse CDT managed makefiles + may or may not work with it. Please see the MinGW + FAQ for more information. +
+
+ /bin/sh: line 1: g++: command not found, Error launching external + scanner info generator + This error message means that g++ is either not installed or not in + your path. Check your path settings as described in , but this time try the commands: gcc + --version and g++ --version. If gcc works, + but g++ doesn't, it means you have only installed the C and not the C++ + version of the gcc compiler, which happens quite frequently on Linux + distributions. Check if you have all needed packages installed, and check + . + If you are on windows, and neither of them worked, install MinGW and + set your path environment variable. If only gcc one worked, reinstall + MinGW and don't forget to select the C++ compiler! +
+
+ Undefined symbols for architecture x86_64 (OS X 10.7) + Make sure you have done the steps in . + If the problem still persist, and you are trying to compile C++ + code, make sure your source files actually have an extension of ".cc" or + ".cpp". +
+
+ No output or only sometimes output + If you are on windows and use Eclipse 3.1 with CDT 3.0.0 there is a + bug. See . + Please note that debug sessions in Windows have their own console + window (a black console window) and do not appear in the regular Eclipse + console. If you're running a debug session, please watch which windows + appear in your task bar. +
+
+ Error launching 'cygpath' command + If you followed these instructions you have installed MSYS instead + of cygwin. You may safely ignore this error message. +
+
+ I do not have the option to start a C++ project + You have not installed the CDT. See . +
+
+ Error 1, open output file blabla.exe: Permission denied + Every time I start Eclipse on my laptop, I can only compile and run + a program once. After that it asks if I want to run it with errors every + time. The compiler says this: + Building target: Project01Test.exe +Invoking: GCC C++ Linker +g++ -oProject01Test.exe ./test.o +C:\MinGW\bin\..\lib\gcc\mingw32\3.4.2\..\..\..\..\mingw32\bin\ld.exe: cannot +open output file Project01Test.exe: Permission denied +collect2: ld returned 1 exit status +make: *** [Project01Test.exe] Error 1 +make: Target `all' not remade because of errors. +Build complete for project Project01Test + + Answer: Your program may still be running. Try stopping it by using + the small red square on the console window (the one for your program). + Another way is switching to the "Debug" perspective, selecting your + running program, and stopping it there (also the small red square). +
+
+ The debugger doesn't work (on windows, with MinGW) + Unfortunately gdb is not included in the current (4.1.1 or 5.0.2) + version of MinGW. See . +
+
+ Incorrect command line argument: -k' + Make sure you are using the make programs provided by MinGW. If your + output in the console shows something like: + make -k clean all +MAKE Version 5.2 Copyright (c) 1987, 2000 Borland +Incorrect command line argument: -k + Then you have make installed from a previous installation of Borland + C++. You have several choices: + + + Adjust your PATH environment variable to have the MinGW / MSYS + installation come before Borlands tools. Please be warned that this + may break your Borland tools! + + + Remove the path to the Borland tools from your PATH. This will + definitely break your Borland tools. + + + Download "mingw32-make". This is an option when installing + MinGW. Make sure you set your make setting to be "mingw32-make". If + you still get an error, try setting it for the build settings in your + project. In this case you may even skip the installation of MSYS, but + you will get limited functionality. + + +
+
+ A Java Runtime Envrionment (JRE) or Java Development Kit (JDK) must + be available... + There are several possible reasons for that: + + + You have not installed Java. Please see . + + + Your "path" environment is messed up (Windows). Please see . Make sure C:\windows\system32 + is in your path (should be there by default). + + + java.com has a + button called verify + installation. + + +
+
+ I have no binaries + If you have no binaries folder, then one of several things may have + happened: + + + You are not looking at the C/C++ Project view. Make sure you are + in the C++ perspective and "C/C++ Projects" is active. An example of + this situation is shown in : Click on + "C/C++ Projects" to fix. + + + Your program didn't compile. Check the output of the "Console" + Window. It is either an error in your program or a configuration + error. For configuration errors, check the other problems. + + + AutoBuild is turned off. Turn it on as described in . + + + If you do have a binaries folder, then make sure you run you + program by right-clicking (on the mac: hold down ctrl and click) on + the binary, and then selecting Run / Run as C/C++ Application. Just + hitting the run button will only work after you have done that at + least once! + + +
+ The Navigator view instead of the C/C++ Projects view + + + + + + + +
+
+
+ Unable to access jarfile startup.jar + This problem happens on Windows when you moved Eclipse out of its + directory instead of creating a shortcut. Please move it back into the + Eclipse directory, then drag'n'drop it using the right mouse button, where + you can select "Create Shurtcut" +
+
+ Problems when CYGWIN is installed on Windows + I personally do not recommend the installation of cygwin, but rather + the installation of MinGW and MSYS as described in . However, the following problems have been + reported by users: +
+ Binaries require cygwin.dll + Eclipse prefers to use cygwin if it is installed, and will do + everything to manipulate the path to include cygwin if it is installed. + Binaries will therefore by default be linked against the cygwin + libraries. Possible workarounds: + + + add -mno-cygwin to your + compiler settings + + + Overwrite the path variable in eclipse: In the Project + Properties: C/C++ Build -> Environment -> User Variables -> + New. Select PATH, remove the cygwin directory and select Replace as + Operation. + + +
+
+
+ Launch failed Reason: Unable to set working directory + Your workspace or your eclipse installation may use a path with + includes spaces, such as C:\Documents and + Settings. Eclipse sometimes fails in this case. Try + creating your workspace in a different directory. +
+
+ Problems not covered here + If you read the online version of this document, check out . You problem may be covered in a newer version + of this document. + If you are still having trouble, you may try and send me an email. + Please be aware that I may not respond to every email, as I am doing this + support mainly as a hobby. Make sure your email includes the following. + Please send the complete output! + + + The contents of your PATH environment variable (in Windows: + echo %PATH%. In Linux / Mac OS X: echo + $PATH). + + + Version of GCC you're using (gcc + --version) + + + Version of Make you're using (make --version + or gmake --version) + + + Version of Eclipse you're using + + + Version of the CDT you're using + + + The complete output of your "Console" window (at the bottom of + eclipse) when your error occurs. + + + The steps you did so before the problem occurred. + + +
+
diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/projectadd.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/projectadd.png new file mode 100644 index 00000000000..f8d8d33ea89 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/projectadd.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/projectname.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/projectname.png new file mode 100644 index 00000000000..bea2a499a4b Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/projectname.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/projecttype.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/projecttype.png new file mode 100644 index 00000000000..d73542c4617 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/projecttype.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setup1.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setup1.png new file mode 100644 index 00000000000..35f5793d98e Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setup1.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setup2.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setup2.png new file mode 100644 index 00000000000..3d7e20b3852 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setup2.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setup3.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setup3.png new file mode 100644 index 00000000000..b3f36427c56 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setup3.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setup4.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setup4.png new file mode 100644 index 00000000000..c34e8de1904 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setup4.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setup5.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setup5.png new file mode 100644 index 00000000000..a1350abae61 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setup5.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setup6.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setup6.png new file mode 100644 index 00000000000..7a76b92d406 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setup6.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setup7.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setup7.png new file mode 100644 index 00000000000..75dc0c2d9e5 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setup7.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setup8.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setup8.png new file mode 100644 index 00000000000..d553ab738c1 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setup8.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setup9.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setup9.png new file mode 100644 index 00000000000..518c68c12b6 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setup9.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setupa.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setupa.png new file mode 100644 index 00000000000..d238f4ab0dd Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setupa.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setupb.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setupb.png new file mode 100644 index 00000000000..f1bd074bb95 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setupb.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setupc.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setupc.png new file mode 100644 index 00000000000..d257da9e6d0 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setupc.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setupd.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setupd.png new file mode 100644 index 00000000000..4209d888178 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/setupd.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/softwareupdateadd35.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/softwareupdateadd35.png new file mode 100644 index 00000000000..c70d04d800e Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/softwareupdateadd35.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/softwareupdatecdt.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/softwareupdatecdt.png new file mode 100644 index 00000000000..104380ffdd1 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/softwareupdatecdt.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/softwareupdatecdt35.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/softwareupdatecdt35.png new file mode 100644 index 00000000000..001d4cade75 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/softwareupdatecdt35.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/softwareupdatemain.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/softwareupdatemain.png new file mode 100644 index 00000000000..f3cabb9d9b7 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/softwareupdatemain.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/softwareupdatemenu.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/softwareupdatemenu.png new file mode 100644 index 00000000000..d55312db370 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/softwareupdatemenu.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/softwareupdatemenu35.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/softwareupdatemenu35.png new file mode 100644 index 00000000000..caa91e6925a Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/softwareupdatemenu35.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/softwareupdatesites.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/softwareupdatesites.png new file mode 100644 index 00000000000..f2425d3a27c Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/softwareupdatesites.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/splash.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/splash.png new file mode 100644 index 00000000000..0e9510c5a12 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/splash.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/splash35.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/splash35.png new file mode 100644 index 00000000000..9dae9f81636 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/splash35.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/splash36.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/splash36.png new file mode 100644 index 00000000000..74413573037 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/splash36.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/splash37.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/splash37.png new file mode 100644 index 00000000000..71bb392da2b Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/splash37.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/systemproperties.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/systemproperties.png new file mode 100644 index 00000000000..08cb4dd1c33 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/systemproperties.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/systempropertiesw71.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/systempropertiesw71.png new file mode 100644 index 00000000000..3f9875d3311 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/systempropertiesw71.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/systempropertiesw72.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/systempropertiesw72.png new file mode 100644 index 00000000000..8c4c654e2f8 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/systempropertiesw72.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/systempropertiesw73.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/systempropertiesw73.png new file mode 100644 index 00000000000..a1d881dfbcc Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/systempropertiesw73.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/systempropertiesw74.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/systempropertiesw74.png new file mode 100644 index 00000000000..ae9103d67fe Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/systempropertiesw74.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/systempropertiesxp.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/systempropertiesxp.png new file mode 100644 index 00000000000..2012dada195 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/systempropertiesxp.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/updatecallisto.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/updatecallisto.png new file mode 100644 index 00000000000..1d858b85676 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/updatecallisto.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/welcome.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/welcome.png new file mode 100644 index 00000000000..99fc3916db4 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/welcome.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/workspace.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/workspace.png new file mode 100644 index 00000000000..32c1ab07a27 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/workspace.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/xcode1.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/xcode1.png new file mode 100644 index 00000000000..5a92db44608 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/xcode1.png differ diff --git a/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/xcode2.png b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/xcode2.png new file mode 100644 index 00000000000..03ee8ce33ac Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/setting_up_eclipse_cdt/src/xcode2.png differ