diff --git a/doc/org.eclipse.cdt.doc.user/about.html b/doc/org.eclipse.cdt.doc.user/about.html index d7c511887d6..a8759f20c6b 100644 --- a/doc/org.eclipse.cdt.doc.user/about.html +++ b/doc/org.eclipse.cdt.doc.user/about.html @@ -1,6 +1,9 @@ - -About + + + +About +

About This Content

@@ -21,4 +24,5 @@ provided with the Content. If no such license exists, contact the Redistributor indicated below, the terms and conditions of the EPL still apply to any source code in the Content and such source code may be obtained at http://www.eclipse.org.

- \ No newline at end of file + + \ No newline at end of file diff --git a/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_before_you_begin.htm b/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_before_you_begin.htm index 4e1954f2a6f..83b080e984c 100644 --- a/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_before_you_begin.htm +++ b/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_before_you_begin.htm @@ -9,28 +9,68 @@

Before you begin

-

Your CDT plugins are not complete until you've installed some additional C/C++ development tools.

+

Depending on how you received the CDT you may or may not have also received +a tool chain with a built-in CDT integration. +If you simply downloaded the CDT from an update site, then one will be required before +you can build and debug projects.

-

Utilities

-

You must install and configure the following utilities:

- +

The base CDT supports integration with the GNU tool chain. +This includes GNU's make, gcc compiler, and gdb debugger utilities. +If you require a tool chain to build software for your development host, this +is the best choice to get started. +Each platform that runs the CDT requires different steps to acquire this tool chain.

-

cygwin

-

cygwin contains all of these utilities for the Windows environment. To download or more information, see http://www.cygwin.com.

+

Linux

+

All Linux distributions include the GNU tool chain. They may not, however, be installed by default. +Please see the instructions for your particular distribution on how to install it

-

Once you've installed cygwin, you should test to ensure it was installed correctly. To do this, open a command prompt and type g++ or make. If the command complains of a missing file for input, everything has installed fine.

+

Windows

+

There are two main choices for acquiring the GNU tool chain for Windows: MinGW, and Cygwin.

-

If the following error message appears, it means that no make is installed, or your path is not configured correctly.

-
'g++' (or 'make') is not recognized as an internal or external command, operable program or batch file
-

To check the environment variable path for correctness, open a command prompt and type PATH. Make sure that the path to your build utility is defined (example PATH=c:\cygwin\bin).

+

Cygwin is a port of the Linux environment to Windows. +It provides a compatibility layer in a set of DLLs. These DLLs are +GPL licensed +making any code that links to them also subject to the GPL. +Cygwin, however, does provide the fullest implementation of the GNU tool chain +by supporting the GNU libc C library.

-

Build Automatically

-

For C/C++ projects the Build Automatically feature should be turned off, otherwise builds will be performed whenever a file is saved, including makefiles and header files.

-

Click Projects from the menubar and ensure there is no checkmark beside the Build Automatically menu item. If there is one, click Build Automatically to deselect it.

+

MinGW is a port of the GNU tool chain to the Windows platform. +The biggest difference over Cygwin is that MinGW uses the Windows C libraries (mscvrt) instead +of GNU's libc. As a result a compatibility layer is not required, thus avoiding the GPL issues +with Cygwin. However, there are differences between the Windows and GNU C libraries that will make +writing portable applications more difficult.

+ +

MinGW allows the best integration support with the CDT +due to it's direct support for the Windows environment. +The following are instructions and links on how to install the current version +of MinGW. Note that these links may become stale over time as new versions of +MinGW components are introduced. Please check the + +MinGW File Release section for the latest versions.

+ +
    +
  1. Download and run the MinGW setup program, + MinGW-5.1.3.exe. + Select download and install the MinGW base tools and the g++ compiler. + You may select the Current or Candidate version of these tools. + You may also install any of the other available compilers as well. + Do not install the MinGW Make feature as the MSYS version of make from step 3 + is a more complete implementation of make.
    2. +
  2. The MinGW setup program currently does not install the gdb debugger. + To do so, download the + gdb-6.6.tar.bz2 + file and extract it's contents to the same location where you installed MinGW.
    3. +
  3. If you plan on using Makefile projects, download and run the + MSYS-1.0.10.exe + setup program. MSYS provides an implementation of make and related command line tools. + This is not required for other types of projects with the MinGW tool chain, + which use CDT's internal build tools to perform the build.
    4. +
+ +

Other Platforms

+

The GNU tool chain is supported on all platforms that the CDT supports. +Please see you're platform vendor for instructions on how to install the GNU tool chain +on your platform.

Related reference
CDT Home