author | fturovic <frank.turovich@nokia.com> |
Fri, 16 Apr 2010 09:51:37 -0500 | |
branch | RCL_2_4 |
changeset 1225 | a546534a48de |
parent 939 | 47d3ca29d054 |
permissions | -rw-r--r-- |
939
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
1 |
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
2 |
<html> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
3 |
<head> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
4 |
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" /> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
5 |
<meta http-equiv="Content-Style-Type" content="text/css" /> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
6 |
<meta name="LASTUPDATED" content="06/17/05 11:09:43" /> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
7 |
<title>External Builds Support</title> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
8 |
<link rel="StyleSheet" href="../../book.css" type="text/css"/> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
9 |
</head> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
10 |
<body bgcolor="#FFFFFF"> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
11 |
<h2>External Builds Support</h2> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
12 |
<p> The IDE will perform the following tasks on external makefiles:</p> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
13 |
<ul> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
14 |
<li>Build</li> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
15 |
<li>Debug</li> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
16 |
<li>File Management in Project Manager window</li> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
17 |
<li>Source Browsing</li> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
18 |
<li>Error Lookup</li> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
19 |
</ul> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
20 |
<p>The IDE can build an external makefile and debug its output. A linker plugin enables the IDE to manage a command line and targets associated with a makefile. The command line is executed when a build step is initiated. The linker plugin will also supply the executable to use for debugging.</p> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
21 |
<p>The linker plugin provides a preference panel named External Build that is used to configure a target. The preference panel provides text fields for you to configure the command line for the target (which will enable building), specify the working directory and the output file used to launch a debugging session, and the debug platform.</p> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
22 |
<p>The linker plugin is generic so that it can be used regardless of the target CPU and OS. The list of available debugger preference panels will be updated by the IDE when you select the debug platform.</p> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
23 |
<p>The External Build Target preference panel collects the following information:</p> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
24 |
<ul> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
25 |
<li>Build command line to be executed in the build step</li> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
26 |
</ul> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
27 |
<blockquote> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
28 |
<p>The command line will be sent to the OS shell and will contain all parameters and/or switches that are necessary for proper building of the make file.</p> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
29 |
</blockquote> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
30 |
<ul> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
31 |
<li>Build directory in which command line will be executed.</li> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
32 |
<li>Output file name - Executable to be launched in the debug step. The file will be relative to the output directory specified in the Target Settings preference panel.</li> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
33 |
<li>Debug platform - The debugger platform represents the combination of OS and CPU that your build is targeting. “Unspecified/Remote debugging” is the default, which indicates you have not specified a debug platform. In most cases, not specifying a platform will result in not being able to debug. However, some platforms may allow debugging if no additional debugger preference panel is used. If only one platform entry exists with the “Unspecified” option, then it will become the default entry.</li> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
34 |
</ul> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
35 |
<blockquote> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
36 |
<p>After the IDE converts the makefile into a Carbide project, source files can be added in the project manager window. Files that appear in the project manager will be parsed by the language parser and will supply Source Browsing information, such as code completion.</p> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
37 |
<p>When a build step is initiated, the linker plugin will gather output after the command line begins executing. Output is directed to the IDE and displayed in a read-only Build Output Window. A build output window is displayed for each target. The build output window can be displayed manually by selecting the menu command View > Build Output (Windows) or Window > Build Output (Linux/Solaris/Mac). This command is enabled for targets that use the external build linker.</p> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
38 |
<p>If multiple build steps are performed on the same target, the output from each build step will be appended to the build output window. Each block of output will be separated by “----Build started----” and “----Done----” tags.</p> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
39 |
<p>The build output window allows users to navigate directly to the location of a compilation error. Double-click a line that contains an error message or press Enter when the cursor is in the line. If the IDE determines that a valid error message exists on the selected line, the source file is opened to the line on which the error occurred.</p> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
40 |
<p>Click the right mouse button in the build output window to display a context menu.</p> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
41 |
</blockquote> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
42 |
<ul> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
43 |
<li>The Copy command copies selected text to the clipboard. If no text is selected then the line that contains the cursor will be copied.</li> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
44 |
<li>The Clear All command clears the contents of output window.</li> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
45 |
<li>The Go To Error command navigates to the error location. This is identical to double-clicking.</li> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
46 |
</ul> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
47 |
<div id="footer">Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
48 |
|
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
49 |
</body> |
47d3ca29d054
revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
50 |
</html> |