1
0
Fork 0
mirror of https://github.com/eclipse-cdt/cdt synced 2025-04-22 06:02:11 +02:00

bug 409392: Removed docs for non-existing scanner discovery property pages on file and folder level

This commit is contained in:
Andrew Gvozdev 2013-05-28 18:08:19 -04:00
parent 6359fdac14
commit 9a53b3573e
10 changed files with 1 additions and 267 deletions

View file

@ -16,7 +16,6 @@
<li><a href=cdt_u_fprop_resource.htm>Resource</a></li>
<li>C/C++ Build
<ul>
<li><a href=cdt_u_fileprop_discovery.htm>Discovery options</a></li>
<li>Settings
<ul>
<li><a href=cdt_u_fileprop_toolsettings.htm>Tool chains setting tab</a></li>

View file

@ -16,7 +16,6 @@
<li><a href=cdt_u_fprop_resource.htm>Resource</a></li>
<li>C/C++ Build
<ul>
<li><a href=cdt_u_fprop_discovery.htm>Discovery options</a></li>
<li>Settings
<ul>
<li><a href=cdt_u_fprop_toolsettings.htm>Tool chains setting tab</a></li>

View file

@ -1,129 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html lang="en">
<head>
<meta http-equiv="Content-Language" content="en-us">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>C/C++ File Properties, Discovery Options</title>
<link rel="stylesheet" type="text/css" href="../help.css">
</head>
<body>
<div role="main"><h1>C/C++ File Properties, Discovery Options</h1>
<p>Use the <strong>Discovery Options</strong> property panel to define the discovery option properties of a C/C++ file's.<br>
</p>
<p><img src="../images/cdt_file_discovery.png" alt="C/C++ File Properties, Discovery Options"></p>
<table cellpadding="5" cellspacing="0" border="1" bordercolor="#DDDDDD" width="700" >
<caption><strong>Discovery options</strong></caption>
<colgroup>
<col width="30%" valign="top" >
<col width="70%" valign="top" >
</colgroup>
<tbody>
<tr valign="top" >
<th id="option"><strong>Option</strong></th>
<th id="description"><strong>Description.</strong></th>
</tr>
<tr valign="top" >
<td headers="option"><strong>Configuration</strong></td>
<td headers="description"><a href="cdt_u_prop_all.htm">Click here for a description.</a></td>
</tr>
<tr valign="top" >
<td headers="option"><strong>Manage Configurations...</strong></td>
<td headers="description"><a href="cdt_u_prop_all.htm">Click here for a description.</a></td>
</tr>
<tr valign="top" >
<td headers="option"><strong>Exclude resource from build</strong></td>
<td headers="description">Excludes the selected file from the build process.</td>
</tr>
<tr valign="top" >
<td headers="description">Left pane list (language specific)</td>
<td headers="description">Shows a list of language specific compilers. Select a language from the list.</td>
</tr>
<tr valign="top" >
<td headers="option"><strong>Automate discovery of paths and symbols</strong></td>
<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>
</tr>
<tr valign="top" >
<td headers="option"><strong>Report path detection problems</strong></td>
<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>
</tr>
<tr valign="top" >
<td headers="option"><strong>Discovery profile options</strong></td>
<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>
</tr>
<tr valign="top" >
<td headers="option"><strong>Enable generate scanner info command</strong></td>
<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.
<p>When selected, you can specify any required compiler specific commands in the <strong>Compiler invocation command</strong> field.</p>
</td>
</tr>
<tr valign="top" >
<td headers="option"><strong>Compiler invocation command</strong></td>
<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.
<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>
<ul>
<li><samp>-D <span style="font-style: italic;">name</span></samp></li>
<li><samp>-I</samp></li>
<li><samp>-U <span style="font-style: italic;">name</span></samp></li>
<li><samp>-I-</samp></li>
<li><samp>-nostdinc</samp></li>
<li><samp>-nostdinc++</samp></li>
<li><samp>-include <span style="font-style: italic;">file</span></samp></li>
<li><samp>-imacros <span style="font-style: italic;">file</span></samp></li>
<li><samp>-idirafter <span style="font-style: italic;">dir</span></samp></li>
<li><samp>-isystem <span style="font-style: italic;">dir</span></samp></li>
<li><samp>-iprefix <span style="font-style: italic;">prefix</span></samp></li>
<li><samp>-iwithprefix <span style="font-style: italic;">dir</span></samp></li>
<li><samp>-iwithprefixbefore <span style="font-style: italic;">dir</span></samp></li>
</ul>
</td>
</tr>
<tr valign="top" >
<td headers="option"><strong>Browse</strong></td>
<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>
</tr>
<tr>
<td valign="top" headers="option"><strong>Compiler invocation arguments </strong></td>
<td valign="top" headers="description">Enter additional argument options to pass on to the compiler. </td>
</tr>
</tbody>
</table>
<p><img src="../images/ngref.gif" alt="Related reference"
height="21" width="143"><br>
<ul>
<li><a href=cdt_u_fprop_resource.htm>Resource</a></li>
<li>C/C++ Build
<ul>
<li><a href=cdt_u_fileprop_discovery.htm>Discovery options</a></li>
<li>Settings
<ul>
<li><a href=cdt_u_fileprop_toolsettings.htm>Tool chains setting tab</a></li>
<li><a href=cdt_u_fileprop_steps.htm>Build Steps tab</a></li>
</ul>
</li>
<li><a href="cdt_u_prop_build_toolchain.htm">Tool chain editor page</a>
</ul>
</li>
<li>C/C++ General
<ul>
<li><a href="cdt_u_fileprop_lang_mapp.htm">Language Mappings</a>
<li>Paths and Symbols
<ul>
<li><a href="cdt_u_fileprop_inc.htm">Includes tab</a>
<li><a href="cdt_u_fileprop_sym.htm">Symbols tab</a>
</ul>
</li>
</ul>
</li>
<li><a href="cdt_u_prop_rundebug.htm">Run/Debug Settings page</a>
</ul>
<p></p>
<hr >
<p><img src="../images/intl_07.gif" ALT="Intel Copyright Statement" ></p>
</div></body>
</html>

View file

@ -78,7 +78,6 @@
<li><a href=cdt_u_fprop_resource.htm>Resource</a></li>
<li>C/C++ Build
<ul>
<li><a href=cdt_u_fileprop_discovery.htm>Discovery options</a></li>
<li>Settings
<ul>
<li><a href=cdt_u_fileprop_toolsettings.htm>Tool chains setting tab</a></li>

View file

@ -54,7 +54,6 @@ build output, immediately prior to and immediately after normal build processing
<li><a href=cdt_u_fprop_resource.htm>Resource</a></li>
<li>C/C++ Build
<ul>
<li><a href=cdt_u_fileprop_discovery.htm>Discovery options</a></li>
<li>Settings
<ul>
<li><a href=cdt_u_fileprop_toolsettings.htm>Tool chains setting tab</a></li>

View file

@ -73,7 +73,6 @@
<li><a href=cdt_u_fprop_resource.htm>Resource</a></li>
<li>C/C++ Build
<ul>
<li><a href=cdt_u_fileprop_discovery.htm>Discovery options</a></li>
<li>Settings
<ul>
<li><a href=cdt_u_fileprop_toolsettings.htm>Tool chains setting tab</a></li>

View file

@ -1,130 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html lang="en">
<head>
<meta http-equiv="Content-Language" content="en-us">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>C/C++ Folder Properties, Discovery Options</title>
<link rel="stylesheet" type="text/css" href="../help.css">
</head>
<body>
<div role="main"><h1>C/C++ Folder Properties, Discovery Options</h1>
<p>You can define the discovery options on the Discovery Options page
of a C/C++ project's properties window.<br>
</p>
<p style="margin-left: 40px;"><img img=""
src="../images/cdt_fold_discovery.png"
alt="C/C++ Folder Properties, Discovery Options"
><br>
</p>
<table cellpadding="5" cellspacing="0" border="1" >
<br>
<caption><strong>Discovery options</strong></caption>
<br>
<colgroup>
<col width="30%" valign="top" >
<col width="70%" valign="top" >
</colgroup>
<tbody>
<tr class="hidden">
<th id="option">Option</th>
<th id="description">Description</th>
</tr>
<tr>
<td headers="option"><strong>Configuration</strong></td>
<td headers="description"><a href="cdt_u_prop_all.htm">Click here for a description.</a></td>
</tr>
<tr>
<td headers="option"><strong>Manage configurations</strong></td>
<td headers="description"><a href="cdt_u_prop_all.htm">Click here for a description.</a></td>
</tr>
<tr>
<td headers="option"><strong>Exclude resource from build</strong></td>
<td headers="description">Excludes the selected folder from the build process.</td>
</tr>
<tr>
<td headers="option">Left pane list (language specific)</td>
<td headers="description">Shows a list of language specific compilers. Select a language from the list.</td>
</tr>
<tr>
<td headers="option"><strong>Automate discovery of paths and symbols</strong></td>
<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>
</tr>
<tr>
<td headers="option"><strong>Report path detection problems</strong></td>
<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>
</tr>
<tr>
<td headers="option"><strong>Discovery profile options</strong></td>
<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>
</tr>
<tr>
<td headers="option"><strong>Enable generate scanner info command</strong></td>
<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.
<p>When selected, you can specify any required compiler specific commands in the <strong>Compiler invocation command</strong> field.</p>
</td>
</tr>
<tr>
<td headers="option"><strong>Compiler invocation command</strong></td>
<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.
<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>
<ul>
<li><samp>-D <span style="font-style: italic;">name</span></samp></li>
<li><samp>-I</samp></li>
<li><samp>-U <span style="font-style: italic;">name</span></samp></li>
<li><samp>-I-</samp></li>
<li><samp>-nostdinc</samp></li>
<li><samp>-nostdinc++</samp></li>
<li><samp>-include <span style="font-style: italic;">file</span></samp></li>
<li><samp>-imacros <span style="font-style: italic;">file</span></samp></li>
<li><samp>-idirafter <span style="font-style: italic;">dir</span></samp></li>
<li><samp>-isystem <span style="font-style: italic;">dir</span></samp></li>
<li><samp>-iprefix <span style="font-style: italic;">prefix</span></samp></li>
<li><samp>-iwithprefix <span style="font-style: italic;">dir</span></samp></li>
<li><samp>-iwithprefixbefore <span style="font-style: italic;">dir</span></samp></li>
</ul>
</td>
</tr>
<tr>
<td headers="option"><strong>Browse</strong></td>
<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>
</tr>
</tbody>
</table>
<p><img src="../images/ngref.gif" alt="Related reference"
height="21" width="143"><br>
<ul>
<li><a href=cdt_u_fprop_resource.htm>Resource</a></li>
<li>C/C++ Build
<ul>
<li><a href=cdt_u_fileprop_discovery.htm>Discovery options</a></li>
<li>Settings
<ul>
<li><a href=cdt_u_fileprop_toolsettings.htm>Tool chains setting tab</a></li>
<li><a href=cdt_u_fileprop_steps.htm>Build Steps tab</a></li>
</ul>
</li>
<li><a href="cdt_u_prop_build_toolchain.htm">Tool chain editor page</a>
</ul>
</li>
<li>C/C++ General
<ul>
<li>Paths and Symbols
<ul>
<li><a href="cdt_u_fileprop_inc.htm">Includes tab</a>
<li><a href="cdt_u_fileprop_sym.htm">Symbols tab</a>
</ul>
</li>
</ul>
</li>
<li><a href="cdt_u_prop_rundebug.htm">Run/Debug Settings page</a>
</ul>
<p></p>
<p><img src="../images/intl_07.gif" ALT="Intel Copyright Statement" ></p>
</div></body>
</html>

View file

@ -31,7 +31,6 @@
<li><a href=cdt_u_fprop_resource.htm>Resource</a></li>
<li>C/C++ Build
<ul>
<li><a href=cdt_u_fprop_discovery.htm>Discovery options</a></li>
<li>Settings
<ul>
<li><a href=cdt_u_fprop_toolsettings.htm>Tool chains setting tab</a></li>

View file

@ -9,6 +9,7 @@
<body>
<div role="main"><h1>Discovery Options properties </h1>
<p><img src="../images/icon_warning.gif" alt="Warning">Note that this functionality has been deprecated and not fully supported anymore</p>
<p>Use the <strong>Discovery Options</strong> properties panel to control how information required to build your project is discovered, enhance search and Content Assist functionality, and automatically enhance your makefile, such as include paths and symbol definitions.</p>
<p><img src="../images/mpref_discovopts.png" alt="Discovery options preference page"></p>

View file

@ -167,7 +167,6 @@
<topic label="C/C++ Folder properies" href="reference/cdt_o_prop_folder.htm">
<topic label="Resource page" href="reference/cdt_u_fprop_resource.htm"/>
<topic label="C/C++ Build">
<topic label="Discovery options page" href="reference/cdt_u_fprop_discovery.htm"/>
<topic label="Settings page">
<topic label="Tool Settings tab" href="reference/cdt_u_fprop_toolsettings.htm"/>
</topic>
@ -188,7 +187,6 @@
<topic label="C/C++ File Properties" href="reference/cdt_o_prop_file.htm">
<topic label="Resource page" href="reference/cdt_u_fprop_resource.htm"/>
<topic label="C/C++ Build">
<topic label="Discovery options page" href="reference/cdt_u_fileprop_discovery.htm"/>
<topic label="Settings page">
<topic label="Tool Settings tab" href="reference/cdt_u_fileprop_toolsettings.htm"/>
<topic label="Build Steps tab " href="reference/cdt_u_fileprop_steps.htm"/>