carbidecpp22devenv/configuration/org.eclipse.osgi/bundles/309/1/.cp/reference/cdt_u_prop_builders.htm
author cawthron
Fri, 04 Dec 2009 10:01:33 -0600
changeset 5 684bf18fdedf
permissions -rw-r--r--
add files for RCL_2_2
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
5
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     2
<html lang="en">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     3
<head>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     4
  <meta http-equiv="Content-Language" content="en-us">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     5
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     6
  <title>C/C++ Project Properties, Builders</title>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     7
  <link rel="stylesheet" type="text/css" href="../help.css">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     8
</head>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     9
<body>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    10
<h1>C/C++ Project Properties, Builders</h1>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    11
<p>You can select which Builders to enable for this project and in
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    12
which order they are used.</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    13
<p><img img="" src="../images/prop_builders.png"
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    14
 alt="C/C++ Project Properties, Builders"></p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    15
<p></p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    16
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    17
<table cellpadding="5" cellspacing="0" border="1" >
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    18
	<br>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    19
		<caption><b>Builder properties</b></caption>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    20
	<br>	
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    21
	<colgroup>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    22
		<col width="30%" valign="top" >
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    23
		<col width="70%" valign="top" >
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    24
	</colgroup>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    25
	<tbody> 
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    26
		<tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    27
			<td><b>Configure the builders for the project</b></td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    28
			<td>Selects which builders to enable from the list. You can disable the CDT Builder and you can control when the CDT Builder runs with respect to the project builders that you define.
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    29
			</td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    30
		</tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    31
		<tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    32
			<td><b>New...</b></td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    33
			<td>Opens the Choose configuration type dialog so that you can add a new builder to the list. <p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    34
		</p><p><img img="" src="../images/prop_builders_newbldr.png"
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    35
 alt="C/C++ Project Properties, Builders, Choose configuration type"></p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    36
		<p>The <b>Ant Builder</b> option lets you configure and deploy projects; however, if you want to use some other tool or prefer to do it yourself, you can set up a <b>Program</b> external tool project builder. This type allows you to customize the deployment of your project as you require, while maintaining the convenience of automatically running your script every time your project is built.</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    37
		<p>The <b>Program</b> option lets you to define an external tool for any executable file that is accessible on your local or network file system. For example, if instead of Ant you prefer to use your own shell scripts or Windows .bat files to package and deploy your Eclipse projects, you can then create a <b>Program</b> external tool that would specify where and how to execute that script.</p></tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    38
	    <tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    39
			<td><b>Import...</b></td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    40
			<td>Opens the Import launch configuration dialog so that you can import a builder to include it in the list.<p></p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    41
			</p><p><img img="" src="../images/prop_builders_imprtlnchcnfg.png" alt="Import launch configuration">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    42
			<p></p></tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    43
	    <tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    44
			<td><b>Edit...</b></td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    45
			<td>Opens the Configure Builder dialog that lets you specify when to run the selected builder.<p></p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    46
			</p><p><img img="" src="../images/prop_builders_editbldr.png" alt="Configure Builder">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    47
			<p></p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    48
			<p>When you configure a builder, you have the following options:
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    49
			<ul>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    50
				<li><b>After a "Clean"</b> - When enabled, the selected builder is scheduled to run after a <b>clean</b> operation occurs.
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    51
				<li><b>During manual builds</b> - When enabled, the selected build is initiated when you explicitly select a menu item or press its corresponding shortcut key combination.
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    52
				<li><b>During auto builds</b> - When enabled, automatic builds are performed as resources are saved (they are incremental and operate over an entire workspace). <b>Note:</b> running your project builder during auto builds is possible, although it is not recommended because of performance concerns.
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    53
				<li><b>During a "Clean"</b> - When enabled, the selected builder is scheduled to run during a <b>clean</b> operation.
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    54
			</ul>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    55
			</p></tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    56
	    <tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    57
			<td><b>Remove</b></td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    58
			<td>Removes the selected builder from the list.</tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    59
	    <tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    60
			<td><b>Up</b></td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    61
			<td>Moves the currently selected builder higher in the list to change the builder order.</tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    62
 	    <tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    63
			<td><b>Down</b></td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    64
			<td>Moves the currently selected builder lower in the list to change the builder order.</tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    65
   </tbody>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    66
</table>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    67
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    68
<br>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    69
  <p><b>Available for:</b> Any projects, folders and files regardless of project kind.</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    70
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    71
<p><img border="0" src="../images/ngref.gif" alt="Related reference"
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    72
 width="143" height="21"><br>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    73
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    74
<ul>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    75
<li><a href="cdt_u_prop_resource.htm">Project Properties, Resource page</a>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    76
<li><a href="cdt_u_prop_builders.htm">Project Properties, Builders page</a>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    77
<li><a href="cdt_u_prop_build.htm">Project Properties, C/C++ Build category</a>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    78
   <ul type="disc">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    79
   <li><a href="cdt_u_prop_build_discovery.htm">Discovery options page</a>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    80
   <li><a href="cdt_u_prop_build_environment.htm">Environment page</a>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    81
   <li>Settings page
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    82
       <ul> 
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    83
       <li><a href="cdt_u_prop_build_settings_tool.htm">     Tool Settings tab</a>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    84
       <li><a href="cdt_u_prop_build_settings_steps.htm">    Build Steps tab</a>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    85
       <li><a href="cdt_u_prop_build_settings_artifact.htm"> Build Artifact tab</a>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    86
       <li><a href="cdt_u_prop_build_settings_binparser.htm">Binary Parsers tab</a>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    87
       <li><a href="cdt_u_prop_build_settings_errparser.htm">Error Parsers tab</a>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    88
       </ul> 
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    89
   <li><a href="cdt_u_prop_build_toolchain.htm">Tool chain editor page</a>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    90
   <li><a href="cdt_u_prop_build_variables.htm">Variables page</a>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    91
   </ul>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    92
<li>Project Properties, <a href="cdt_u_prop_general.htm">C/C++ General category</a>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    93
   <ul type="disc"> 
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    94
   <li><a href="cdt_u_prop_general_doc.htm">Documentation page</a>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    95
   <li><a href="cdt_u_prop_general_typ.htm">File Types page</a>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    96
   <li><a href="cdt_u_prop_general_idx.htm">Indexer page</a>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    97
   <li><a href="cdt_u_prop_general_lng.htm">Language Mapping page</a>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    98
   <li>Paths and Symbols page
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    99
       <ul>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   100
       <li><a href="cdt_u_prop_general_pns_inc.htm">Includes tab</a>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   101
       <li><a href="cdt_u_prop_general_pns_sym.htm">Symbols tab</a>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   102
       <li><a href="cdt_u_prop_general_pns_libpath.htm">Libraries path tab</a>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   103
       <li><a href="cdt_u_prop_general_pns_src.htm">Source Location tab</a>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   104
       <li><a href="cdt_u_prop_general_pns_ref.htm">References tab</a>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   105
       </ul>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   106
   </ul>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   107
<li><a href="cdt_u_prop_ref.htm">C/C++ Project Properties, Project References page</a>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   108
<li><a href="cdt_u_prop_refactoring_history.htm">C/C++ Project Properties, Refactoring History page</a>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   109
<li><a href="cdt_u_prop_rundebug.htm">C/C++ Project Properties, Run/Debug Settings page</a>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   110
</ul>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   111
</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   112
<p><img src="../images/intl_07.gif" ALT="Intel Copyright Statement" ></p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   113
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   114
</body>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   115
</html>