← Back to branch summary

~ubuntu-branches/debian/sid/eclipse-cdt/sid

« back to all changes in this revision

Viewing changes to doc/org.eclipse.cdt.doc.user/reference/cdt_u_fprop_discovery.htm

  • Committer: Package Import Robot
  • Author(s): Jakub Adam
  • Date: 2011-10-06 21:15:04 UTC
  • mfrom: (1.1.4)
  • Revision ID: package-import@ubuntu.com-20111006211504-8dutmljjih0zikfv
Tags: 8.0.1-1
* New upstream release.
* Split the JNI packages into a separate architecture dependent
  package and made eclipse-cdt architecture independent.
* Install JNI libraries into multiarch aware location
* Bumped Standards-Version to 3.9.2.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/org.eclipse.cdt.doc.user/reference/cdt_u_fprop_discovery.htm
 
1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> 
 
2
<html lang="en">
 
3
<head>
 
4
  <meta http-equiv="Content-Language" content="en-us">
 
5
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
 
6
  <title>C/C++ Folder Properties, Discovery Options</title>
 
7
  <link rel="stylesheet" type="text/css" href="../help.css">
 
8
</head>
 
9
<body>
 
10
<h1 role="main">C/C++ Folder Properties, Discovery Options</h1>
 
11
<p>You can define the discovery options on the Discovery Options page
 
12
of a C/C++ project's properties window.<br>
 
13
</p>
 
14
 
 
15
<p style="margin-left: 40px;"><img img=""
 
16
 src="../images/cdt_fold_discovery.png"
 
17
 alt="C/C++ Folder Properties, Discovery Options"
 
18
 ><br>
 
19
</p>
 
20
 
 
21
<table cellpadding="5" cellspacing="0" border="1" >
 
22
        <br>
 
23
                <caption><strong>Discovery options</strong></caption>
 
24
        <br>    
 
25
        <colgroup>
 
26
                <col width="30%" valign="top" >
 
27
                <col width="70%" valign="top" >
 
28
        </colgroup>
 
29
        <tbody>
 
30
                <tr class="hidden">
 
31
                        <th id="option">Option</th>
 
32
                        <th id="description">Description</th>
 
33
                </tr> 
 
34
                <tr>
 
35
                        <td headers="option"><strong>Configuration</strong></td>
 
36
                        <td headers="description"><a href="cdt_u_prop_all.htm">Click here for a description.</a></td>
 
37
                </tr>
 
38
                <tr>
 
39
                        <td headers="option"><strong>Manage configurations</strong></td>
 
40
                        <td headers="description"><a href="cdt_u_prop_all.htm">Click here for a description.</a></td>
 
41
                </tr>
 
42
                <tr>
 
43
                        <td headers="option"><strong>Exclude resource from build</strong></td>
 
44
                        <td headers="description">Excludes the selected folder from the build process.</td>
 
45
                </tr>
 
46
                <tr>
 
47
                        <td headers="option">Left pane list (language specific)</td>
 
48
                        <td headers="description">Shows a list of language specific compilers. Select a language from the list.</td>
 
49
                </tr>
 
50
                <tr>
 
51
                        <td headers="option"><strong>Automate discovery of paths and symbols</strong></td>
 
52
                        <td headers="description">Scans the build output to populate the path and symbol tables, such as symbol definitions, system include directories, local include directories, macros files, and include files. If this option is not selected, the <strong>Discovery profile options</strong> below do not appear.</td>
 
53
                </tr>
 
54
                                <tr>
 
55
                        <td headers="option"><strong>Report path detection problems</strong></td>
 
56
                        <td headers="description">Sets the notification of diagnostic errors for include paths that the Eclipse CDT is unable to resolve as it parses the build output.</td>
 
57
                </tr>
 
58
                <tr>
 
59
                        <td headers="option"><strong>Discovery profile options</strong></td>
 
60
                        <td headers="description">Indicates the discovery profile to use for paths and symbol detection. The type of <strong>Configuration</strong> and <strong>Discovery Profile Scope</strong> you specify determine what which <strong>Discovery Profile</strong> options display on this tab. This set of controls is profile-specific. It may vary from one profile to another.</td>
 
61
                </tr>           
 
62
                <tr>
 
63
                        <td headers="option"><strong>Enable generate scanner info command</strong></td>
 
64
                        <td headers="description">Enables the retrieval of information from the scanner. If it is not selected, the includes will be populated with default gcc system includes; Eclipse gathers the compiler settings based on the specified toolchain. This means that the Eclipse CDT can obtain the default gcc system includes to associate with the project. 
 
65
                                <p>When selected, you can specify any required compiler specific commands in the <strong>Compiler invocation command</strong> field.</p>
 
66
                        </td>
 
67
                </tr>
 
68
                <tr>
 
69
                        <td headers="option"><strong>Compiler invocation command</strong></td>
 
70
                        <td headers="description">Indicates the compiler specific command used to invoke the compiler (such as <span class="typewriter">gcc</span>, or more complicated commands used to perform all necessary steps for compiling C/C++ source files into .o files, and linking the object files and libraries into an executable program. For example, the command <strong>gcc -E -P -v hello.c | hello.cpp</strong> reads a compiler's configuration file and prints out information that includes the compiler's internally defined preprocessor symbols and include search paths. The information is complementary to the scanner configuration discovered when the output is parsed (if you've enabled the <strong>Enable build output scanner info discovery</strong> option), and is added to the project's scanner configuration. You can click <strong>Browse</strong> to locate this command, if required.
 
71
                        
 
72
                        <p><strong>Note:</strong> The parsing of build output for scanner information is compiler specific. For example, the GNU toolchain compilers (gcc and g++) use -I for include paths, and -D for symbol definitions. Consult your compiler specific documentation for more information about scanner information commands, such as the following gcc commands:</p>
 
73
     <ul>
 
74
        <li><samp>-D <span style="font-style: italic;">name</span></samp></li>
 
75
        <li><samp>-I</samp></li>     
 
76
        <li><samp>-U <span style="font-style: italic;">name</span></samp></li>
 
77
        <li><samp>-I-</samp></li>
 
78
        <li><samp>-nostdinc</samp></li>
 
79
        <li><samp>-nostdinc++</samp></li>
 
80
        <li><samp>-include <span style="font-style: italic;">file</span></samp></li>
 
81
        <li><samp>-imacros <span style="font-style: italic;">file</span></samp></li>
 
82
        <li><samp>-idirafter <span style="font-style: italic;">dir</span></samp></li>
 
83
        <li><samp>-isystem <span style="font-style: italic;">dir</span></samp></li>
 
84
        <li><samp>-iprefix <span style="font-style: italic;">prefix</span></samp></li>
 
85
        <li><samp>-iwithprefix <span style="font-style: italic;">dir</span></samp></li>
 
86
        <li><samp>-iwithprefixbefore <span style="font-style: italic;">dir</span></samp></li>
 
87
      </ul>
 
88
                        </td>
 
89
                </tr>
 
90
                        <tr>
 
91
                        <td headers="option"><strong>Browse</strong></td>
 
92
                        <td headers="description">Click to browse for a file to include in the compiler invocation command. This button is only visible when <strong>Configuration</strong> is set to Release and the <strong>Discovery Profiles Scope</strong> is set to <strong>Configuration-wide</strong>.</td>
 
93
                </tr>
 
94
                </tbody>
 
95
</table>
 
96
 
 
97
<p><img src="../images/ngref.gif" alt="Related reference" 
 
98
 height="21" width="143"><br>
 
99
 
 
100
<ul>
 
101
<li><a href=cdt_u_fprop_resource.htm>Resource</a></li>
 
102
<li>C/C++ Build
 
103
<ul>
 
104
   <li><a href=cdt_u_fileprop_discovery.htm>Discovery options</a></li>
 
105
   <li>Settings
 
106
   <ul> 
 
107
       <li><a href=cdt_u_fileprop_toolsettings.htm>Tool chains setting tab</a></li>
 
108
       <li><a href=cdt_u_fileprop_steps.htm>Build Steps tab</a></li>
 
109
    </ul>
 
110
    </li>
 
111
    <li><a href="cdt_u_prop_build_toolchain.htm">Tool chain editor page</a>
 
112
</ul>
 
113
</li>
 
114
<li>C/C++ General
 
115
<ul>
 
116
    <li>Paths and Symbols
 
117
    <ul>
 
118
       <li><a href="cdt_u_fileprop_inc.htm">Includes tab</a>
 
119
       <li><a href="cdt_u_fileprop_sym.htm">Symbols tab</a>
 
120
    </ul> 
 
121
    </li>
 
122
</ul>
 
123
</li>
 
124
<li><a href="cdt_u_prop_rundebug.htm">Run/Debug Settings page</a>
 
125
</ul>
 
126
<p></p>
 
127
<p><img src="../images/intl_07.gif" ALT="Intel Copyright Statement" ></p>
 
128
 
 
129
</body>
 
130
</html>