View | Details | Raw Unified | Return to bug 193376 | Differences between
and this patch

Collapse All | Expand All

(-)getting_started/cdt_w_existing_code.htm (-9 / +6 lines)
Lines 106-112 Link Here
106
    <li>Click <b>Finish</b> to exit the <b>Check Out As</b> dialog.
106
    <li>Click <b>Finish</b> to exit the <b>Check Out As</b> dialog.
107
    </p>
107
    </p>
108
108
109
    <li>Click <ui>Next</ui> to continue.
109
    <li>Click <b>Next</b> to continue.
110
</ol>
110
</ol>
111
111
112
<h3>Importing C/C++ code into an existing project</h3>
112
<h3>Importing C/C++ code into an existing project</h3>
Lines 118-142 Link Here
118
<ol>
118
<ol>
119
    <li>
119
    <li>
120
    Right-click the module or directory in the CVS
120
    Right-click the module or directory in the CVS
121
    Repositories view and choose <ui>Check Out As&hellip;</ui>
121
    Repositories view and choose <b>Check Out As</b>
122
    from the menu.
122
    from the menu.
123
123
124
    <p>
124
    <p>
125
    The IDE displays the Check Out As dialog.
125
    The IDE displays the Check Out As dialog.
126
    </p>
126
    </p>
127
127
128
<li>Choose <ui>Check out into an existing project</ui>, and then click
128
<li>Choose <b>Check out into an existing project</b>, and then click
129
  <ui>Next</ui>.
129
  <b>Next</b>.
130
  The IDE displays the Check Out Into dialog:
130
  The IDE displays the Check Out Into dialog:
131
131
132
    <p>
133
    <img src="images/cvs-checkout-into.gif" alt="Check Out Into">
134
    </p>
135
    </li>
132
    </li>
136
133
137
    <li>
134
    <li>
138
    Select an existing project from the list, and then
135
    Select an existing project from the list, and then
139
    click <ui>Finish</ui> to add the code from CVS to the selected
136
    click <b>Finish</b> to add the code from CVS to the selected
140
    project.
137
    project.
141
    </li>
138
    </li>
142
</ol>
139
</ol>
Lines 149-155 Link Here
149
	<li>Identify a "root folder" of your source code tree.</li>
146
	<li>Identify a "root folder" of your source code tree.</li>
150
	<li>Create a new C/C++ project using the New Project Wizard, and specify the "root folder" as a non-default location of the new project.</li>
147
	<li>Create a new C/C++ project using the New Project Wizard, and specify the "root folder" as a non-default location of the new project.</li>
151
</ol>
148
</ol>
152
<p>Typically existing projects will have their own makefiles, so you should create a new Standard Make C/C++ project.  For more information see 
149
<p>Typically, existing projects will have their own makefiles, so you should create a new Make C/C++ project.  For more information see 
153
<a href="../tasks/cdt_t_proj_new.htm">Creating a project</a> and
150
<a href="../tasks/cdt_t_proj_new.htm">Creating a project</a> and
154
<a href="../tasks/cdt_o_proj_files.htm">Working with C/C++ project files</a>.</p>
151
<a href="../tasks/cdt_o_proj_files.htm">Working with C/C++ project files</a>.</p>
155
152
(-)getting_started/cdt_w_build.htm (-2 / +4 lines)
Lines 9-22 Link Here
9
<body>
9
<body>
10
<h1>Building a project</h1>
10
<h1>Building a project</h1>
11
<p>The make output and build progress information displays in the
11
<p>The make output and build progress information displays in the
12
Console view. The Make Targets view displays makefile actions. The
12
Console view. The Make Targets view displays makefile actions, and the
13
Tasks view displays compile warnings or errors.</p>
13
Tasks view displays compile warnings or errors.</p>
14
<p>To build a project:</p>
14
<p>To build a project:</p>
15
<ol>
15
<ol>
16
  <li>In the <b>C/C++ Projects</b> view, select your project. For the tutorial, you want to select the <b>HelloWorld</b> project.</li>
16
  <li>In the <b>C/C++ Projects</b> view, select your project. For the tutorial, you can to select the <b>Hello World</b> project you created earlier. <p><br></p></li>
17
  <li>Click <b>Project &gt; Build Project</b>.</li>
17
  <li>Click <b>Project &gt; Build Project</b>.</li>
18
  <p>If you see the error message:</p>
18
  <p>If you see the error message:</p>
19
  <br>
19
  <p><samp>Exec error:Launching failed</samp></p>
20
  <p><samp>Exec error:Launching failed</samp></p>
21
  <br>
20
  <p>then CDT cannot locate the build command, usually <samp>make</samp>.
22
  <p>then CDT cannot locate the build command, usually <samp>make</samp>.
21
Either your path is not configured correctly, or you do not have <samp>make</samp>
23
Either your path is not configured correctly, or you do not have <samp>make</samp>
22
installed on your system.</p>
24
installed on your system.</p>
(-)getting_started/cdt_w_import.htm (-5 / +5 lines)
Lines 8-33 Link Here
8
8
9
<script language="JavaScript">
9
<script language="JavaScript">
10
function newWin(url) {
10
function newWin(url) {
11
	window.open(url, 'install_cdt', 'width=750, height=700, menubar=no, toolbar=no, status=no, resizable=yes, location=no, scrollbars=yes');
11
	window.open(url, 'install_cdt', 'width=950, height=700, menubar=no, toolbar=no, status=no, resizable=yes, location=no, scrollbars=yes');
12
}
12
}
13
</script>
13
</script>
14
</head>
14
</head>
15
<body>
15
<body>
16
<h2>Turorial: Importing an existing project</h2>
16
<h2>Tutorial: Importing an existing project</h2>
17
17
18
<p>The following tutorial will walk you though the process of importing a simple application using the CDT.</p>
18
<p>The following tutorial takes you though the process of importing a simple application using the CDT.</p>
19
19
20
20
21
<p>Step 1: You want to create a single project that will reflect all of the components for the existing source tree.<br></p> 
21
<p>Step 1: You want to create a single project that will reflect all of the components for the existing source tree.<br></p> 
22
<ol>
22
<ol>
23
	<li>Select <b>File &gt; New &gt; Project</b>.
23
	<li>Select <b>File &gt; New &gt; Project</b>.
24
	<li>For this tutorial, expand <b>C++</b> and select <b>C++ project</b>.
24
	<li>For this tutorial, expand <b>C++</b> and select <b>C++ project</b>.
25
	<p><br>The <b>New Project</b> wizard dispalys. <a href="javascript:void(0)" onClick="newWin('../images/cdt_w_import02.png')">Click here to see an illustration (displayed in a separate window)</a>.</p> <br>
25
	<p><br>The <b>New Project</b> wizard displays. <a href="javascript:void(0)" onClick="newWin('../images/cdt_w_import02.png')">Click here to see an illustration (displayed in a separate window)</a>.</p> <br>
26
26
27
27
28
	<li>In the <b>Project name</b> field, type a name for the project.
28
	<li>In the <b>Project name</b> field, type a name for the project.
29
	<li>Ensure that the <b>Use default location</b> option is not selected because you will need to specify where the resources reside in the file system since they do not reside in your workspace.
29
	<li>Ensure that the <b>Use default location</b> option is not selected because you will need to specify where the resources reside in the file system since they do not reside in your workspace.
30
	<li>In the <b>Location</b> field, specify the path for your project. For this tutorial, the project to import is assumed to reside in the directory C:\MySrcDirectory.
30
	<li>In the <b>Location</b> field, specify a path for your project.
31
	<li>From the <b>Project types</b> list, expand <b>Makefile Project</b> and select <b>Hello World C++ Project</b>.
31
	<li>From the <b>Project types</b> list, expand <b>Makefile Project</b> and select <b>Hello World C++ Project</b>.
32
	<li>Click <b>Next</b>.
32
	<li>Click <b>Next</b>.
33
	<li>Select only the configurations you want created. Configurations display for each toolchain selected on the previous page of the wizard.
33
	<li>Select only the configurations you want created. Configurations display for each toolchain selected on the previous page of the wizard.
(-)getting_started/cdt_w_standard.htm (-146 lines)
Removed Link Here
1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
2
<html lang="en">
3
<head>
4
	<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
5
	<title>New CDT Project with your own makefile - Tutorial</title>
6
	<link rel="stylesheet" type="text/css" href="../help.css">
7
8
<script language="JavaScript">
9
var first = 0;
10
var last = 16;
11
var position = 0;
12
13
var cdt_w_standardText= new Array(17) 
14
cdt_w_standardText[0]='cdt_w_standard01.htm';
15
cdt_w_standardText[1]='cdt_w_standard02.htm';
16
cdt_w_standardText[2]='cdt_w_standard03.htm';
17
cdt_w_standardText[3]='cdt_w_standard04.htm';
18
cdt_w_standardText[4]='cdt_w_standard05.htm';
19
cdt_w_standardText[5]='cdt_w_standard06.htm';
20
cdt_w_standardText[6]='cdt_w_standard07.htm';
21
cdt_w_standardText[7]='cdt_w_standard08.htm';
22
cdt_w_standardText[8]='cdt_w_standard09.htm';
23
cdt_w_standardText[9]='cdt_w_standard10.htm';
24
cdt_w_standardText[10]='cdt_w_standard11.htm';
25
cdt_w_standardText[11]='cdt_w_standard12.htm';
26
cdt_w_standardText[12]='cdt_w_standard13.htm';
27
cdt_w_standardText[13]='cdt_w_standard14.htm';
28
cdt_w_standardText[14]='cdt_w_standard15.htm';
29
cdt_w_standardText[15]='cdt_w_standard16.htm';
30
cdt_w_standardText[16]='cdt_w_standard17.htm';
31
32
var cdt_w_standardPic= new Array(17) 
33
cdt_w_standardPic[0]='../images/cdt_w_standard01.png';
34
cdt_w_standardPic[1]='../images/cdt_w_standard02.png';
35
cdt_w_standardPic[2]='../images/cdt_w_standard03.png';
36
cdt_w_standardPic[3]='../images/cdt_w_standard04.png';
37
cdt_w_standardPic[4]='../images/cdt_w_standard05.png';
38
cdt_w_standardPic[5]='../images/cdt_w_standard06.png';
39
cdt_w_standardPic[6]='../images/cdt_w_standard07.png';
40
cdt_w_standardPic[7]='../images/cdt_w_standard08.png';
41
cdt_w_standardPic[8]='../images/cdt_w_standard09.png';
42
cdt_w_standardPic[9]='../images/cdt_w_standard10.png';
43
cdt_w_standardPic[10]='../images/cdt_w_standard11.png';
44
cdt_w_standardPic[11]='../images/cdt_w_standard12.png';
45
cdt_w_standardPic[12]='../images/cdt_w_standard13.png';
46
cdt_w_standardPic[13]='../images/cdt_w_standard14.png';
47
cdt_w_standardPic[14]='../images/cdt_w_standard15.png';
48
cdt_w_standardPic[15]='../images/cdt_w_standard16.png';
49
cdt_w_standardPic[16]='../images/cdt_w_standard17.png';
50
51
var screenText= new Array(17) 
52
screenText[0]='Eclipse Workbench';
53
screenText[1]='Opening the C/C++ Perspective';
54
screenText[2]='The C++ Perspective';
55
screenText[3]='Creating a New Project';
56
screenText[4]='New Project Wizard';
57
screenText[5]='New Managed Make C++ Project';
58
screenText[6]='Select a Target';
59
screenText[7]='Error Parser Configuration';
60
screenText[8]='New C++ Project in the Workbench';
61
screenText[9]='Create a New File';
62
screenText[10]='New File Wizard';
63
screenText[11]='New File in the Workbench';
64
screenText[12]='Entering Code in the New .cpp File';
65
screenText[13]='Stepping Through the Code in Outline View';
66
screenText[14]='Save the File';
67
screenText[15]='Displaying New Executables in the Projects View';
68
screenText[16]='Selecting Run from the Menu';
69
70
71
72
function nav_a() {	
73
					document.home.src='../images/icon_home.png';  
74
					document.home.title='Start Over'; 
75
					
76
					document.back.src='../images/icon_back.png';  
77
					document.back.title='Back';
78
					
79
					document.next.src='../images/icon_forward.png';  
80
					document.next.title='Next';  
81
				 };
82
				 
83
function nav_b() {
84
					document.home.src='../images/trans.gif'; 
85
					document.home.title=''; 
86
					
87
					document.back.src='../images/trans.gif'; 
88
					document.back.title='';
89
					
90
					document.next.src='../images/icon_forward.png';  
91
					document.next.title='Next';  
92
				 };
93
				 
94
function nav_e() {	
95
					document.home.src='../images/icon_home.png';  
96
					document.home.title='Start Over'; 
97
					
98
					document.back.src='../images/icon_back.png';  
99
					document.back.title='Back';
100
					
101
					document.next.src='../images/trans.gif';
102
					document.next.title='';  
103
				 };
104
105
function show() { 
106
	textFrame.location.href = cdt_w_standardText[position]; 
107
	document.screen.src  = cdt_w_standardPic[position];
108
	document.screen.alt  = screenText[position];
109
} 
110
111
function reset() { 
112
	position = first; 
113
	show(); 
114
	nav_b(); 
115
} 
116
117
function goNext() {
118
	if ( position == first ) { nav_a(); };
119
	if ( position  < last  ) { position++; show(); }
120
	if ( position == last  ) { nav_e(); }
121
}
122
123
function goBack() {
124
	if ( position == last  ) { nav_a(); };
125
	if ( position  > first ) { position--; show()};
126
	if ( position == first ) { nav_b(); };
127
}
128
129
</script> 
130
131
</head>
132
<body>
133
<h2>New CDT Project with your own makefile - Tutorial</h2>
134
<IFRAME name=textFrame SRC="cdt_w_standard01.htm" TITLE="cdt_w_standard Text" MARGINWIDTH=0 MARGINHEIGHT=0 width=800 height=200 frameborder=0 SCROLLING=auto></IFRAME>
135
<hr>
136
<table width="120px" border="0" cellspacing="0" summary="">
137
	<tr>
138
		<td align="center"><img src="../images/trans.gif" width="22" height="22" onClick="reset();" title="" name="home"></td>
139
		<td align="center"><img src="../images/trans.gif" align="left" width="22" height="22" onClick="goBack();" title="" name="back"></td>
140
		<td align="center"><img src="../images/icon_forward.png" align="right" width="22" height="22" onClick="goNext();" title="Next" name="next" ></td>
141
	</tr>
142
</table>
143
<p><img src="../images/cdt_w_standard01.png" align="center" alt="Eclipse Logo" name="screen" ></p>
144
<img src="../images/ng00_04a.gif" ALT="IBM Copyright Statement" >
145
</body>
146
</html>
(-)getting_started/cdt_w_install_cdt.htm (-22 / +16 lines)
Lines 29-80 Link Here
29
29
30
<p>To obtain the latest CDT features:</p>
30
<p>To obtain the latest CDT features:</p>
31
<ol>
31
<ol>
32
	<li>Select <b>Help &gt; Software Updates &gt; Find and Install</b>.<p><br></p>
32
	<li>Select <b>Help &gt; Software Updates &gt; Find and Install</b>.
33
<p><a href="javascript:void(0)" onClick="newWin('../images/cdt_update_find-install.png')">Click here to see an illustration (displayed in a separate window)</a>.</p>
33
<p><a href="javascript:void(0)" onClick="newWin('../images/cdt_update_find-install.png')">Click here to see an illustration (displayed in a separate window)</a>.</p>
34
	<br></li>
34
	<br></li>
35
	
35
	
36
	<li>In the <b>Feature Updates</b> window, select <b>Search for new features to install</b> and click <b>Next</b>. <p>Note: If you want to search for updates on features that you currently have installed, you can select the option <b>Search for updates of the currently installed features</b>.</p><br><p><br></p><p><a href="javascript:void(0)" onClick="newWin('../images/cdt_update_install_new.png')">Click here to see an illustration</a>.</p>
36
	<li>In the <b>Feature Updates</b> window, select <b>Search for new features to install</b> and click <b>Next</b>.<br><p>Note: If you want to search for updates on features that you currently have installed, you can select the option <b>Search for updates of the currently installed features</b>, and then follow the steps to update using that method.</p><p><a href="javascript:void(0)" onClick="newWin('../images/cdt_update_install_new.png')">Click here to see an illustration</a>.</p>
37
	<br></li>
37
	<br></li>
38
	
38
	
39
	
39
	
40
	<li>If you have not updated previously, you will have to enter the location of the Eclipse CDT Install site. Click <b>New Remote Site...</b>.<p><br></p>
40
	<li>If you have not updated previously, you will have to enter the location of the Eclipse CDT Install site. Click <b>New Remote Site...</b>.
41
<p><a href="javascript:void(0)" onClick="newWin('../images/cdt_update_install_sites.png')">Click here to see an illustration</a>.</p>
41
<p><a href="javascript:void(0)" onClick="newWin('../images/cdt_update_install_sites.png')">Click here to see an illustration</a>.</p>
42
	<br></li>
42
	<br></li>
43
	
43
	
44
	<li>In the New Update Site dialog box, type the name and URL for the Eclipe update site in the spaces provided.<p><br></p> 
44
	<li>In the New Update Site dialog box, type the name and URL for the Eclipse update site. 
45
<p><a href="javascript:void(0)" onClick="newWin('../images/cdt_update_install_new_sites.png')">Click here to see an illustration</a>.</p><br></li>
45
<p><a href="javascript:void(0)" onClick="newWin('../images/cdt_update_install_new_sites.png')">Click here to see an illustration</a>.</p><br></li>
46
	
46
	
47
 	<li>Click <b>OK</b>.
47
 	<li>Click <b>OK</b>.<p><br></p></li>
48
	<li>From the <b>Sites to include in search</b> list, select the update site you just created by clicking the appropriate check box, and click <b>Finish</b>.<p><br></p>
48
	<li>From the <b>Sites to include in search</b> list, select the update site you just created by clicking the appropriate check box, and click <b>Finish</b>.
49
<p><a href="javascript:void(0)" onClick="newWin('../images/cdt_update_install_cdt_site.png')">Click here to see an illustration</a>.</p>
49
<p><a href="javascript:void(0)" onClick="newWin('../images/cdt_update_install_cdt_site.png')">Click here to see an illustration</a>.</p>
50
	<br></li>
50
	<br></li>
51
	
51
	
52
	<li>The Search Results dialog shows the features available to install from the update site. Select each of the following features, 
52
	<li>The Search Results dialog shows the features available to install from the update site. Expand and select any additional features that you require. De-select any options that do not apply to you.<p><br></p></li>
53
		ensuring that you have precisely the same version for each one:
53
<li>Click <b>Next</b>.
54
		<ul>
55
			<li>Eclipse C/C+ Development Tooling SDK</li>
56
			<li>Eclipse C/C+ Development Tools</li>
57
		</ul>
58
<li>Expand and select any additional features that you require. De-select any options that do not apply to you.
59
<li>Click <b>Next</b>.<p><br></p>
60
<p><a href="javascript:void(0)" onClick="newWin('../images/cdt_update_search_results.png')">Click here to see an illustration</a>.</p><br>
54
<p><a href="javascript:void(0)" onClick="newWin('../images/cdt_update_search_results.png')">Click here to see an illustration</a>.</p><br>
61
	</li>
55
	</li>
62
	
56
	
63
	<li>You must accept the Eclipse.org Software User Agreement to continue installing the CDT update. If you accept the terms, select <b>I accept the terms in the license agreement</b> and then click <b>Next</b>.<p><br></p>
57
	<li>You must accept the Eclipse.org Software User Agreement to continue installing the CDT update. If you accept the terms, select <b>I accept the terms in the license agreement</b> and then click <b>Next</b>.
64
<p><a href="javascript:void(0)" onClick="newWin('../images/cdt_update_license_agreement.png')">Click here to see an illustration</a>.</p>
58
<p><a href="javascript:void(0)" onClick="newWin('../images/cdt_update_license_agreement.png')">Click here to see an illustration</a>.</p>
65
	<br></li>
59
	<br></li>
66
	<p>You can review the summary list of the features you selected to install.<p>
60
	<p>You can review the summary list of the features you selected to install.<br></p><br></li>
67
	<li>Optional: Click <b>Change Location</b> to select the location you would like the updates installed. Typically, this is the directory where you installed Eclipse.
61
	<li>Optional: Click <b>Change Location</b> to select the location you would like the updates installed. Typically, this is the directory where you installed Eclipse.<p><br></p></li>
68
<li>Click <b>Finish</b>.<p><br></p><p><a href="javascript:void(0)" onClick="newWin('../images/cdt_update_location.png')">Click here to see an illustration</a>.</p>
62
<li>Click <b>Finish</b>.<p><a href="javascript:void(0)" onClick="newWin('../images/cdt_update_location.png')">Click here to see an illustration</a>.</p>
69
	<br></li>
63
	<br></li>
70
	
64
	
71
	<li>You will now start downloading the CDT components. You will have to verify that you want the features installed by clicking
65
	<li>You will now start downloading the CDT components. You will have to verify that you want the features installed by clicking
72
		<b>Install</b> for each feature you selected.<p><br></p>
66
		<b>Install</b> for each feature you selected.
73
<p><a href="javascript:void(0)" onClick="newWin('../images/cdt_update_jar_verification.png')">Click here to see an illustration</a>.</p>
67
<p><a href="javascript:void(0)" onClick="newWin('../images/cdt_update_jar_verification.png')">Click here to see an illustration</a>.</p>
74
	<br></li>
68
	<br><p>Now, you have to restart Eclipse. </p><br></li>
69
	
75
	
70
	
76
	<p>Now, you have to restart Eclipse. 
71
	<li>Select <b>Yes</b> to complete the feature installation process.
77
	<li>Select <b>Yes</b> to complete the feature installation process.<p><br></p>
78
72
79
<p><a href="javascript:void(0)" onClick="newWin('../images/cdt_restart.png')">Click here to see an illustration</a>.</p>
73
<p><a href="javascript:void(0)" onClick="newWin('../images/cdt_restart.png')">Click here to see an illustration</a>.</p>
80
</ol>
74
</ol>
(-)getting_started/cdt_w_basic.htm (-47 / +30 lines)
Lines 35-41 Link Here
35
	<a href="javascript:void(0)" onClick="newWin('../images/cdt_w_basic04.png')">Click here to see an illustration.</a><br></p>
35
	<a href="javascript:void(0)" onClick="newWin('../images/cdt_w_basic04.png')">Click here to see an illustration.</a><br></p>
36
    <p><br>By default, the CDT filters the <b>Toolchain</b> and <b>Project types</b> that it displays in those lists based on the language support for the C++ Project wizard you selected for this tutorial.</p>
36
    <p><br>By default, the CDT filters the <b>Toolchain</b> and <b>Project types</b> that it displays in those lists based on the language support for the C++ Project wizard you selected for this tutorial.</p>
37
    </li><br>
37
    </li><br>
38
    <li><p>In the <b>Project name</b> field, type a name for the project.</p>
38
    <li><p>In the <b>Project name</b> field, type a name for the project, such as <b>Hello World</b>.</p>
39
    <br>
39
    <br>
40
    <li><p>From the <b>Project types</b> list, expand <b>Executable</b> and select <b>Hello World C++ Project</b>. This project type provides a simple Hello World application in C++, and the makefile is automatically created by the CDT.</p>
40
    <li><p>From the <b>Project types</b> list, expand <b>Executable</b> and select <b>Hello World C++ Project</b>. This project type provides a simple Hello World application in C++, and the makefile is automatically created by the CDT.</p>
41
	<br>
41
	<br>
Lines 67-129 Link Here
67
	<br>
67
	<br>
68
	<p>A project is created with the default settings and a full set of configurations based on the project type and toolchain you selected.
68
	<p>A project is created with the default settings and a full set of configurations based on the project type and toolchain you selected.
69
	You should now see the new project in C/C++ Projects view.</p>
69
	You should now see the new project in C/C++ Projects view.</p>
70
	<p><a href="javascript:void(0)" onClick="newWin('../images/cdt_w_basic12.png')">Click here to see an illustration.</a></p>
71
	<br>
70
</ol>
72
</ol>
71
73
72
<h3>Step 2: Creating a new file for the project</h3>
74
<h3>Step 2: Reviewing the code and building the project</h3>
73
<p>Now, you will create a new .cpp file (such as main.cpp) that will contain some code that you will copy from another file into an editor. </p>
74
75
<ol>
76
	<li>Right-click on your project in the Navigator.
77
	<li>Select <b>New &gt; Source File</b>.
78
	<p>You should now see the new project in the C/C++ Projects view under the project, and the new file opens in the <b>Editor</b> view.</p>
79
</ol>  
80
81
<h3>Step 3: Enter and step through the code</h3>
82
<ol>
75
<ol>
83
	<li>Copy the code from the file <a href="javascript:void(0)"
76
	<li>From the Project Explorer in the C++ Projects View, double-click the .cpp file that was created for your project, for example, <tt>Hello World.cpp</tt>. 
84
 onclick="newWin('hw_example.htm')" title="here">main.cpp</a>
77
	<p>This file opens in a default editor. It contains C++ template code for the Hello World example project you selected earlier.</p>
85
file that was just created.
78
	<br>
86
<p>
79
	<p><b>Note:</b> You can specify a different editor, and add or modify existing code templates in <b>Window &gt; Preferences</b>.</p><p>In addition, the <b>Outline</b> view has also been populated
87
You can double click the <b>main.cpp</b> tab in the <b>Editor</b>
80
with objects created from your code.</p> <p><a href="javascript:void(0)" onClick="newWin('../images/cdt_w_basic13.png')">Click here to see an illustration.</a></p>
88
view to expand the view. <br>
81
</li>
89
<i>Note: Leave a blank line at the end of the code because it is required by some compilers.</i></p>
82
<li>Optional: You can type additional code in this file, and then save the changes by clicking <span
90
<p>On the tab in the <b>Editor</b> view, an asterisk character ("*") prefixes the file name. The asterisk indicates that the file has changed but has not been saved.</p>
83
 style="font-weight: bold;">File &gt; Save</span>, or pressing <b>CTRL+S</b>.
91
	<li>Notice that the <b>Outline</b> view has also been populated
84
 
92
with objects created from your code. </p>
85
 <p><br>Next, you will need to build your project before you can run it.</p><br></li>
93
<p>If you select an item from the <b>Outline</b> view, the
86
<li>Build your project by pressing <b>CTRL+B</b>, or select the project from the Project Explorer tab in the C++ Projects view and select <b>File &gt; Build Project</b>.</p>
94
corresponding text in the editor is highlighted.
87
<p><br><b>Note:</b> If a build generates any errors or warnings, you can see those in the Problems view. If you encounter difficulty, see the topics <a href="../concepts/cdt_c_build_over.htm">Building C/C++ projects</a> and <a href="../concepts/cdt_c_before_you_begin.htm">Before you begin</a><br>.</p></li>
95
<li>Save the main.cpp file by clicking <span
88
<li>Read through the build messages in the <b>Console</b> view.
96
 style="font-weight: bold;">File &gt; Save</span> or pressing <b>CTRL+S</b>.
89
The project should build successfully.</p>
97
<li>Build your project by pressing <b>CTRL+B</b>.</p>
98
<p>You can read through the build messages in the <b>Console</b> view.
99
The project should build successfully, showing the following message:</p>
100
<p><tt>Finished building target: HelloWorld.exe</tt></p>
101
<br>
90
<br>
102
<p>You will also see the <b>Outline</b> view has also been populated
91
<p>You will also see the <b>Outline</b> view has also been populated
103
with objects created from your code. </p>
92
with objects created from your code. If you select an item from the <b>Outline</b> view, the
104
<p>If you select an item from the <b>Outline</b> view, the
93
corresponding text in the editor is highlighted.</p><br>
105
corresponding text in the editor is highlighted.</p></li>
106
</ol>  
94
</ol>  
107
95
108
<h3>Step 4: Running the application</h3>
96
<h3>Step 3: Running the application</h3>
97
98
<p>To run your application:</p>
109
<ol>
99
<ol>
110
	<li>To run your application within the C/C++ Perspective, click <b>Run &gt; Run...</b>
100
	<li>Within the C/C++ Perspective, click <b>Run &gt; Run</b>.<p><br></p></li>
111
	<li>Select <b>C/C++ Local Application</b>.
101
	<li>Select <b>C/C++ Local Application</b>.<p><br></p></li>
112
	<li>Click <b>'New'</b>.
102
    <li>Click <b>New</b>.<p><br></p></li>
113
<li>Click <b>'New'</b>.</p>
114
103
115
<p>A new Run Configuration is created. Its name and path to executable are provided by the project ('HelloWorld' in our case). 
104
	<p>A new Run Configuration is created. Its name and path to the executable are provided by the project ('Hello World' in our case). 
116
105
117
<li>Click <b>'Run'</b>.
106
	<li>Click <b>Run</b>.<p><br></p>
118
</ol>  
119
107
120
<h3>Step 5: Reviewing and interpreting the results in the Console view</h3>
108
<p>Now, you should see the Hello World application running in the <b>Console</b> view.  
121
<p>Now, you should now see the Hello World application running in the <b>Console</b> view.  
109
The <b>Console</b> also shows which application is running in a title bar.</p><br></li>
122
The <b>Console</b> also shows which application is running in a title bar.  
123
You can configure this view to display different elements (such as user input elements) using different colors.</p>
124
<ol>
125
	<li>Type in your name and press Enter.
126
	<p>The title bar in the <b>Console</b> view shows you when the program has terminated.</p>
127
110
128
	<li>You can click the other views to see the information that they contain.
111
	<li>You can click the other views to see the information that they contain.
129
</ol> 
112
</ol> 
(-)concepts/cdt_c_before_you_begin.htm (-1 / +1 lines)
Lines 57-63 Link Here
57
  <li>Select download and install the MinGW base tools and the g++ compiler.
57
  <li>Select download and install the MinGW base tools and the g++ compiler.
58
  You may select the Current or Candidate version of these tools.
58
  You may select the Current or Candidate version of these tools.
59
  You may also install any of the other available compilers as well.
59
  You may also install any of the other available compilers as well.
60
  <p><b>Do not install the MinGW Make feature</b> as the MSYS version of make from step 3
60
  <p><b>Do not install the MinGW Make feature</b> as the MSYS version of make from step 5
61
  is a more complete implementation of make.</p></li>
61
  is a more complete implementation of make.</p></li>
62
  <li>The MinGW setup program currently does not install the gdb debugger.
62
  <li>The MinGW setup program currently does not install the gdb debugger.
63
  To install the debugger, download the file from the following location: 
63
  To install the debugger, download the file from the following location: 
(-)reference/cdt_u_appearance_pref.htm (-5 / +5 lines)
Lines 12-18 Link Here
12
12
13
<h1>Appearance preferences</h1>
13
<h1>Appearance preferences</h1>
14
14
15
<p>Customize the appearance of C elements in viewers using the <b>Appearance</b> preference panel.</p>
15
<p>Use the <b>Appearance</b> panel of the Preferences window to customize the appearance of C elements in the viewers.</p>
16
<p><img src="../images/view_appearance_prefs.png" width="627" height="524"></p>
16
<p><img src="../images/view_appearance_prefs.png" width="627" height="524"></p>
17
17
18
<table width="700px" cellpadding="5" cellspacing="0" border="1" >
18
<table width="700px" cellpadding="5" cellspacing="0" border="1" >
Lines 26-44 Link Here
26
	<tbody>
26
	<tbody>
27
		<tr>
27
		<tr>
28
			<td width="241" valign="top"><b>Show translation unit numbers </b></td>
28
			<td width="241" valign="top"><b>Show translation unit numbers </b></td>
29
			<td width="433" valign="top">Activate this checkbox to show translation unit numbers. </td>
29
			<td width="433" valign="top">Select this option to show translation unit numbers. </td>
30
		</tr>
30
		</tr>
31
		<tr>
31
		<tr>
32
			<td valign="top"><b>Group the includes in the C/C++ projects view </b></td>
32
			<td valign="top"><b>Group the includes in the C/C++ projects view </b></td>
33
			<td valign="top">Activate this checkbox to group include files in the C/C++ project view. </td>
33
			<td valign="top">Select this option to group include files in the C/C++ project view. </td>
34
		</tr>
34
		</tr>
35
		<tr>
35
		<tr>
36
			<td valign="top"><b>Group the includes in the outliner </b></td>
36
			<td valign="top"><b>Group the includes in the outliner </b></td>
37
			<td valign="top">Activate this checkbox to group include files in outline views. </td>
37
			<td valign="top">Select this option to group include files in outline views. </td>
38
		</tr>
38
		</tr>
39
		<tr>
39
		<tr>
40
			<td valign="top"><b>Group the namespaces in the outliner </b></td>
40
			<td valign="top"><b>Group the namespaces in the outliner </b></td>
41
			<td valign="top">Activate this checkbox to group files by namespaces in outline views. </td>
41
			<td valign="top">Select this option to group files by namespaces in outline views. </td>
42
		</tr>
42
		</tr>
43
	</tbody>
43
	</tbody>
44
</table>
44
</table>
(-)reference/cdt_u_new_proj_wiz_config.htm (-1 / +1 lines)
Lines 8-14 Link Here
8
</head>
8
</head>
9
<body>
9
<body>
10
<h1>New Project Wizard, Select configurations</h1>
10
<h1>New Project Wizard, Select configurations</h1>
11
<p>You can select toolchain(s) from this page of the wizard.</p>
11
<p>You can select configuration(s) from this page of the wizard. </p>
12
<p><img src="../images/new_proj_wz_config.png"
12
<p><img src="../images/new_proj_wz_config.png"
13
 alt="New Project Wizard, Select configurations"></p>
13
 alt="New Project Wizard, Select configurations"></p>
14
<p>
14
<p>
(-)reference/cdt_u_new_proj_wiz_type.htm (-2 / +2 lines)
Lines 8-14 Link Here
8
</head>
8
</head>
9
<body>
9
<body>
10
<h1>New Project Wizard, Select a Project Type</h1>
10
<h1>New Project Wizard, Select a Project Type</h1>
11
<p>You can select the type of project from this page of the wizard.</p>
11
<p>You can select a type of project from this page of the wizard. This project type will determine the toolchain and data, and tabs that the CDT uses. Once created, C/C++ projects display in the C/C++ Projects view.<p>
12
<p><img src="../images/new_proj_wz_type.png"
12
<p><img src="../images/new_proj_wz_type.png"
13
 alt="New Project Wizard, Select a Project Type"></p>
13
 alt="New Project Wizard, Select a Project Type"></p>
14
<p>
14
<p>
Lines 35-41 Link Here
35
35
36
<p><img border="0" src="../images/ngconcepts.gif" 
36
<p><img border="0" src="../images/ngconcepts.gif" 
37
ALT="Related concepts" width="143" height="21"><br>
37
ALT="Related concepts" width="143" height="21"><br>
38
<a href="../concepts/cdt_c_projects.htm">CDT projects</a><br>
38
<a href="../concepts/cdt_c_projects.htm">CDT projects (detailed information about project types)</a><br>
39
</p>
39
</p>
40
40
41
<p><img border="0" src="../images/ngtasks.gif" ALT="Related tasks" width="143" height="21"><br>
41
<p><img border="0" src="../images/ngtasks.gif" ALT="Related tasks" width="143" height="21"><br>
(-)reference/cdt_u_new_proj_wiz_toolchain.htm (-3 / +6 lines)
Lines 8-14 Link Here
8
</head>
8
</head>
9
<body>
9
<body>
10
<h1>New Project Wizard, Select a toolchain</h1>
10
<h1>New Project Wizard, Select a toolchain</h1>
11
<p>You can select toolchain(s) from this page of the wizard.</p>
11
<p>You can select toolchain(s) from this page of the wizard. A toolchain is a set of tools (such as a compiler, linker, and assembler) intended to build your project.
12
    Additional tools, such as a debugger, can be associated with a toolchain.
13
    There can be several toolchains available, depending on the project type you specify, and the compilers installed on your system.</p>
14
    <br>
12
<p><img src="../images/new_proj_wz_toolchain.png"
15
<p><img src="../images/new_proj_wz_toolchain.png"
13
 alt="New Project Wizard, Select a toolchain"></p>
16
 alt="New Project Wizard, Select a toolchain"></p>
14
<p>
17
<p>
Lines 24-32 Link Here
24
    </tr>
27
    </tr>
25
    <tr>
28
    <tr>
26
      <td><b>Show Project Types and toolchains only if they are supported on the platform</b></td>
29
      <td><b>Show Project Types and toolchains only if they are supported on the platform</b></td>
27
      <td>If checked (default), list is filtered so that only toolchains
30
      <td>When selected (default), the list is filtered so that only toolchains
28
        that are buildable on the host system are shown.<br>
31
        that are buildable on the host system are shown.<br>
29
        If unchecked, lists all known toolchains.</td>
32
        If it is not selected, the list displays all known toolchains.</td>
30
    </tr>
33
    </tr>
31
  </tbody>
34
  </tbody>
32
</table>
35
</table>
(-)reference/cdt_u_build_pref.htm (-8 / +8 lines)
Lines 24-58 Link Here
24
	<tbody>
24
	<tbody>
25
		<tr>
25
		<tr>
26
			<td><dt>Always clear console before building</dt></td>
26
			<td><dt>Always clear console before building</dt></td>
27
			<td>Select this checkbox to clear the console whenever you perform a build.</td>
27
			<td>Select this option to clear the contents of the Console view every time you perform a build.</td>
28
		</tr>
28
		</tr>
29
		<tr>
29
		<tr>
30
			<td><dt>Open console when building</dt></td>
30
			<td><dt>Open console when building</dt></td>
31
			<td>Select this checkbox to open the console build when you perform a build.</td>
31
			<td>Select this option to open the Console view when you perform a build.</td>
32
		</tr>
32
		</tr>
33
		<tr>
33
		<tr>
34
			<td><dt>Bring console to top when building (if present)</dt></td>
34
			<td><dt>Bring console to top when building (if present)</dt></td>
35
			<td>Select this checkbox to bring the build console to the front when you perform a build.</td>
35
			<td>Select this option to make the Console view the active window when you perform a build.</td>
36
		</tr>
36
		</tr>
37
		<tr>
37
		<tr>
38
			<td><dt>Limit console output (#lines)</dt></td>
38
			<td><dt>Limit console output (#lines)</dt></td>
39
			<td>You specify the maximum number of lines that appear in the build console view.</td>
39
			<td>Specify the maximum number of lines that can display in the Console view.</td>
40
		</tr>
40
		</tr>
41
		<tr>
41
		<tr>
42
			<td><dt>Display tab width</dt></td>
42
			<td><dt>Display tab width</dt></td>
43
			<td>You can specify the number of spaces for a tab.</td>
43
			<td>Specify the number of spaces for a tab.</td>
44
		</tr>
44
		</tr>
45
		<tr>
45
		<tr>
46
			<td><dt>Output text color</dt></td>
46
			<td><dt>Output text color</dt></td>
47
			<td>You can customize the color of text in the build console.</td>
47
			<td>Customize the color of text in the Console view.</td>
48
		</tr>
48
		</tr>
49
		<tr>
49
		<tr>
50
			<td><dt>Information message text color</dt></td>
50
			<td><dt>Information message text color</dt></td>
51
			<td>You can customize the color of information text messages in the build console.</td>
51
			<td>Customize the color of information text messages in the Console view.</td>
52
		</tr>
52
		</tr>
53
		<tr>
53
		<tr>
54
			<td><dt>Error message text color</dt></td>
54
			<td><dt>Error message text color</dt></td>
55
			<td>You can customize the color of error text messages in the build console.</td>
55
			<td>Customize the color of error messages in the Console view.</td>
56
		</tr>
56
		</tr>
57
	</tbody>
57
	</tbody>
58
</table>
58
</table>

Return to bug 193376