|
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> |
|
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++ File Properties, Discovery Options</title> |
|
7 <link rel="stylesheet" type="text/css" href="../help.css"> |
|
8 </head> |
|
9 <body> |
|
10 <h1>C/C++ File 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_file_discovery.png" |
|
17 alt="C/C++ File Properties, Discovery Options" |
|
18 ><br> |
|
19 </p> |
|
20 |
|
21 <table cellpadding="5" cellspacing="0" border="1" > |
|
22 <br> |
|
23 <caption><b>Discovery options</b></caption> |
|
24 <br> |
|
25 <colgroup> |
|
26 <col width="30%" valign="top" > |
|
27 <col width="70%" valign="top" > |
|
28 </colgroup> |
|
29 <tbody> |
|
30 <tr> |
|
31 <td><b>Configuration</b></td> |
|
32 <td><a href="cdt_u_prop_all.htm">Click here for a description.</a></td> |
|
33 </tr> |
|
34 <tr> |
|
35 <td><b>Manage configurations</b></td> |
|
36 <td><a href="cdt_u_prop_all.htm">Click here for a description.</a></td> |
|
37 </tr> |
|
38 <tr> |
|
39 <td><b>Exclude resource from build</b></td> |
|
40 <td>Excludes the selected file from the build process.</td> |
|
41 </tr> |
|
42 <tr> |
|
43 <td>Left pane list (language specific)</td> |
|
44 <td>Shows a list of language specific compilers. Select a language from the list.</td> |
|
45 </tr> |
|
46 <tr> |
|
47 <td><b>Automate discovery of paths and symbols</b></td> |
|
48 <td>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 <b>Discovery profile options</b> below do not appear.</td> |
|
49 </tr> |
|
50 <tr> |
|
51 <td><b>Report path detection problems</b></td> |
|
52 <td>Sets the notification of diagnostic errors for include paths that the Eclipse CDT is unable to resolve as it parses the build output.</td> |
|
53 </tr> |
|
54 <tr> |
|
55 <td><b>Discovery profile options</b></td> |
|
56 <td>Indicates the discovery profile to use for paths and symbol detection. The type of <b>Configuration</b> and <b>Discovery Profile Scope</b> you specify determine what which <b>Discovery Profile</b> options display on this tab. This set of controls is profile-specific. It may vary from one profile to another.</td> |
|
57 </tr> |
|
58 <tr> |
|
59 <td><b>Enable generate scanner info command</b></td> |
|
60 <td>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. |
|
61 <p>When selected, you can specify any required compiler specific commands in the <b>Compiler invocation command</b> field.</p> |
|
62 </td> |
|
63 </tr> |
|
64 <tr> |
|
65 <td><b>Compiler invocation command</b></td> |
|
66 <td>Indicates the compiler specific command used to invoke the compiler (such as <tt>gcc</tt>, 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 <b>gcc -E -P -v hello.c | hello.cpp</b> 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 <b>Enable build output scanner info discovery</b> option), and is added to the project's scanner configuration. You can click <b>Browse</b> to locate this command, if required. |
|
67 |
|
68 <p><b>Note:</b> 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> |
|
69 <ul> |
|
70 <li><samp>-D <span style="font-style: italic;">name</span></samp></li> |
|
71 <li><samp>-I</samp></li> |
|
72 <li><samp>-U <span style="font-style: italic;">name</span></samp></li> |
|
73 <li><samp>-I-</samp></li> |
|
74 <li><samp>-nostdinc</samp></li> |
|
75 <li><samp>-nostdinc++</samp></li> |
|
76 <li><samp>-include <span style="font-style: italic;">file</span></samp></li> |
|
77 <li><samp>-imacros <span style="font-style: italic;">file</span></samp></li> |
|
78 <li><samp>-idirafter <span style="font-style: italic;">dir</span></samp></li> |
|
79 <li><samp>-isystem <span style="font-style: italic;">dir</span></samp></li> |
|
80 <li><samp>-iprefix <span style="font-style: italic;">prefix</span></samp></li> |
|
81 <li><samp>-iwithprefix <span style="font-style: italic;">dir</span></samp></li> |
|
82 <li><samp>-iwithprefixbefore <span style="font-style: italic;">dir</span></samp></li> |
|
83 </ul> |
|
84 </td> |
|
85 </tr> |
|
86 <tr> |
|
87 <td><b>Browse</b></td> |
|
88 <td>Click to browse for a file to include in the compiler invocation command. This button is only visible when <b>Configuration</b> is set to Release and the <b>Discovery Profiles Scope</b> is set to <b>Configuration-wide</b>.</td> |
|
89 </tr> |
|
90 </tbody> |
|
91 </table> |
|
92 |
|
93 <p><img src="../images/ngref.gif" alt="Related reference" border="0" |
|
94 height="21" width="143"><br> |
|
95 |
|
96 <ul> |
|
97 <li><a href=cdt_u_fprop_resource.htm>Resource</a></li> |
|
98 <li>C/C++ Build</li> |
|
99 <ul> |
|
100 <li><a href=cdt_u_fileprop_discovery.htm>Discovery options</a></li> |
|
101 <li>Settings</li> |
|
102 <ul> |
|
103 <li><a href=cdt_u_fileprop_toolsettings.htm>Tool chains setting tab</a></li> |
|
104 <li><a href=cdt_u_fileprop_steps.htm>Build Steps tab</a></li> |
|
105 </ul> |
|
106 <li><a href="cdt_u_prop_build_toolchain.htm">Tool chain editor page</a> |
|
107 </ul> |
|
108 <li>C/C++ General</li> |
|
109 <ul> |
|
110 <li><a href="cdt_u_fileprop_lang_mapp.htm">Language Mappings</a> |
|
111 <li>Paths and Symbols</li> |
|
112 <ul> |
|
113 <li><a href="cdt_u_fileprop_inc.htm">Includes tab</a> |
|
114 <li><a href="cdt_u_fileprop_sym.htm">Symbols tab</a> |
|
115 </ul> |
|
116 </ul> |
|
117 <li><a href="cdt_u_prop_rundebug.htm">Run/Debug Settings page</a> |
|
118 </ul> |
|
119 </p> |
|
120 <p><img src="../images/intl_07.gif" ALT="Intel Copyright Statement" ></p> |
|
121 |
|
122 </body> |
|
123 </html> |