Mercurial Mercurial > oss > FCL > sftools > dev > ide > carbidecpp / annotate
summary | shortlog | changelog | graph | tags | bookmarks | branches | files | changeset | file | latest | revisions | annotate | diff | comparison | raw | help
Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
core/com.nokia.carbide.cpp.doc.user/html/concepts/ext_build_support.htm
author fturovic <frank.turovich@nokia.com>
Wed, 16 Jun 2010 11:39:35 -0500
changeset 1475 fb0e02cb252b
parent 1376 120480c02651
child 1791 727385d8e2b3
permissions -rw-r--r--
minor edits and updated images
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1376
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     1
 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     2
 
<html>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     3
 
<head>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     4
 
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     5
 
<meta http-equiv="Content-Style-Type" content="text/css" />
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     6
 
<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     7
 
<title>External Builds Support</title>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     8
 
<link rel="StyleSheet" href="../../book.css" type="text/css"/>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     9
 
</head>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    10
 
<body bgcolor="#FFFFFF">
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    11
 
<h2>External Builds Support</h2>
1475
fb0e02cb252b minor edits and updated images
fturovic <frank.turovich@nokia.com>
parents: 1376
diff changeset 
    12
 
<p>  The Carbide IDE  performs the following tasks on external makefiles:</p>
1376
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    13
 
<ul>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    14
 
  <li>Build</li>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    15
 
  <li>Debug</li>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    16
 
  <li>File Management in Project Manager window</li>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    17
 
  <li>Source Browsing</li>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    18
 
  <li>Error Lookup</li>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    19
 
</ul>
1475
fb0e02cb252b minor edits and updated images
fturovic <frank.turovich@nokia.com>
parents: 1376
diff changeset 
    20
 
<p>Carbide can build an external makefile and debug its output. A linker plugin  enables Carbide 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>
fb0e02cb252b minor edits and updated images
fturovic <frank.turovich@nokia.com>
parents: 1376
diff changeset 
    21
 
<p>The linker plugin  provides a preference panel named <strong>External Build</strong> 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>
1376
120480c02651 BUG 10758 - copyright revised date to 2010
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>
1475
fb0e02cb252b minor edits and updated images
fturovic <frank.turovich@nokia.com>
parents: 1376
diff changeset 
    23
 
<p>The <strong>External Build Target</strong> preference panel  collects the following information:</p>
1376
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    24
 
<ul>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    25
 
  <li>Build command line to be executed in the build step</li>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    26
 
</ul>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    27
 
<blockquote>
120480c02651 BUG 10758 - copyright revised date to 2010
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>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    29
 
</blockquote>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    30
 
<ul>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    31
 
  <li>Build directory in which command line will be executed.</li>
120480c02651 BUG 10758 - copyright revised date to 2010
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>
120480c02651 BUG 10758 - copyright revised date to 2010
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. &ldquo;Unspecified/Remote debugging&rdquo; 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 &ldquo;Unspecified&rdquo; option, then it will become the default entry.</li>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    34
 
</ul>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    35
 
<blockquote>
120480c02651 BUG 10758 - copyright revised date to 2010
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>
120480c02651 BUG 10758 - copyright revised date to 2010
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 &gt; Build Output (Windows) or Window &gt; Build Output (Linux/Solaris/Mac). This command is enabled for targets that use the external build linker.</p>
120480c02651 BUG 10758 - copyright revised date to 2010
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 &ldquo;----Build started----&rdquo; and &ldquo;----Done----&rdquo; tags.</p>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    39
 
  <p>The build output window will allow 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>
120480c02651 BUG 10758 - copyright revised date to 2010
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>
1475
fb0e02cb252b minor edits and updated images
fturovic <frank.turovich@nokia.com>
parents: 1376
diff changeset 
    41
 
  <ul>
fb0e02cb252b minor edits and updated images
fturovic <frank.turovich@nokia.com>
parents: 1376
diff changeset 
    42
 
      <li>The <strong>Copy</strong> command  copies selected text to the clipboard. If no text is selected then the line that contains the cursor is copied.</li>
fb0e02cb252b minor edits and updated images
fturovic <frank.turovich@nokia.com>
parents: 1376
diff changeset 
    43
 
      <li>The <strong>Clear All</strong> command  clears the contents of output window.</li>
fb0e02cb252b minor edits and updated images
fturovic <frank.turovich@nokia.com>
parents: 1376
diff changeset 
    44
 
      <li>The <strong>Go To Error</strong> command  navigates to the error location. This is identical to double-clicking.</li>
fb0e02cb252b minor edits and updated images
fturovic <frank.turovich@nokia.com>
parents: 1376
diff changeset 
    45
 
  </ul>
1376
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    46
 
</blockquote>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    47
 
<div id="footer">Copyright &copy; 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>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    48
 












120480c02651
BUG 10758 - copyright revised date to 2010



fturovic <frank.turovich@nokia.com>


parents: 
0

diff
changeset




    49


</body>













120480c02651
BUG 10758 - copyright revised date to 2010



fturovic <frank.turovich@nokia.com>


parents: 
0

diff
changeset




    50


</html>















FCL/sftools/dev/ide/carbidecpp