carbidecpp22devenv/configuration/org.eclipse.osgi/bundles/309/1/.cp/tasks/cdt_t_search.htm
changeset 5 684bf18fdedf
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/carbidecpp22devenv/configuration/org.eclipse.osgi/bundles/309/1/.cp/tasks/cdt_t_search.htm	Fri Dec 04 10:01:33 2009 -0600
@@ -0,0 +1,148 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
+<html lang="en">
+
+<head>
+<meta http-equiv="Content-Language" content="en-us">
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>Searching for C/C++ elements</title>
+<link rel="stylesheet" type="text/css" href="../help.css">
+</head>
+
+<body>
+
+<h1>Searching for C/C++ elements</h1>
+
+<p>It is recommended that you perform searches on successfully compiled 
+programs to ensure the accuracy of search results. It is important to familiarize yourself with the correct search syntax 
+to use to complete an effective search. It is also important to ensure that 
+include paths and symbols are correctly defined. For more information, see
+<a href="cdt_t_proj_paths.htm">Including paths and symbols</a>.</p>
+
+<p>See <a href="../concepts/cdt_c_search.htm">C/C++ search</a>, for more information on:</p>
+
+<ul>
+  <li>What you can search for</li>
+  <li>How to limit your search</li>
+  <li>How to use wildcard characters in your search</li>
+  <li>Syntax examples</li>
+</ul>
+
+
+
+<p>Performing a C/C++ Search can be done in a number of different ways but regardless of the manner chosen the same information must be provided to C/C++ Search.</p> 
+
+The info required to do a search is:
+
+<table border="1"  cellpadding="2" valign="top">
+	<tr>
+		<td valign="top"><b>Search string</b></td>
+		<td valign="top">this is the name of the element you are looking for. See <a href="../concepts/cdt_c_search.htm">C/C++ search</a> for more information on how to specify wildcard searches and how to further refine your searches by using fully qualified names</td>
+	</tr>
+	<tr>
+		<td valign="top"><b>Search For </b></td>
+		<td valign="top">this is the element type that you wish to search for. You can also select to search on ‘Any Element’ which will perform the search on a combination of all elements</td>
+	</tr>
+	<tr>
+		<td valign="top"><b>Limit To</b></td>
+		<td valign="top">this allows you to limit your search to declarations, definitions or references. You can also select ‘All Occurrences’ which will search for declarations, definitions and references that match the element</td>
+	</tr>
+	<tr>
+		<td valign="top"><b>Scope</b></td>
+		<td valign="top">this allows the user to limit the scope of the search. The three available scopes are:
+		<table border="0" cellpadding="2">
+			<tr>
+				<td valign="top"><b>Workspace</b></td>
+				<td valign="top">this searches all of the open projects in the workspace</td>
+			</tr>
+			<tr>
+				<td valign="top"><b>Selected Resources</b></td>
+				<td valign="top">this option becomes enabled whenever something is selected in one of the following views in the C/C++ perspective:
+				<ul>
+					<li>C/C++ Projects</li>
+					<li>Project Explorer</li>
+					<li>Search</li>
+					<li>Outline</li>
+				</ul>
+				<p>The scope will be limited to whatever element is selected in the view.</p>
+				</td>
+			</tr>
+			<tr>
+				<td valign="top"><b>Working Set</b></td>
+				<td valign="top">working sets can be selected and created </td>
+				</tr>		
+			</table>
+		</td>
+	</tr>
+</table>
+
+<p>There are 3 main ways for initiating a C/C++ search:
+<ul>
+	<li>Using the <b>C/C++ Search</b> dialog</li>
+	<li>Selecting an element in the <b>Editor</b> view</li>
+	<li>Selecting an element in the <b>C/C++ Projects</b> view or Selecting an element from the <b>Outline</b> view</li>
+</ul>
+</p>
+
+
+
+<h3>Using the C/C++ Search dialog</h3>
+<p> <img src="../images/search.png"  alt="Search dialog box"></p>
+
+<ol>
+	<li>Enter the search string in the <b>Search String</b> field (optional mark it case sensitive). <br>
+	<b>Note: </b>that previous search queries (from the same work session) are remembered and can be accessed via the drop down list.</li>
+	<li>Select the <b>Search For</b> element.</li>
+	<li>Select the <b>Limit To</b>.</li>
+	<li>Select the <b>Scope</b>.</li>
+	<li>Press <b>Search</b>.</li>
+</ol>
+<p>Results are displayed in the <b>Search</b> view.</p>
+
+
+<h3>Selecting an element in the Editor view</h3>
+<ol>
+	<li>Select the desired element in the editor.</li>
+	<li>Right click and select <b>All Declarations</b> or <b>All References</b> and the scope you wish to search.</li>
+</ol>
+<p>Results are displayed in the <b>Search</b> view.</p>
+
+
+
+<h3>Selecting an element in C/C++ Projects or Outline View</h3>
+
+<ol>
+	<li>Select the desired element in the tree.</li>
+	<li>Right click and select <b>All Declarations</b> or <b>All References</b> and the scope you wish to search.</li>
+</ol>
+<p>Results are displayed in the <b>Search</b> view.</p>
+
+
+<p>For more information, see:
+<li><b>Workbench User Guide &gt; Concepts &gt; Views &gt; Search view</b></li>
+<li><b>Workbench User Guide &gt; Concepts &gt; Workbench &gt; Working Set</b></li>
+<li><b>Workbench User Guide &gt; Tasks &gt; Navigating and finding resources</b></li>
+
+</ul>
+
+<p><img border="0" src="../images/ngconcepts.gif" ALT="Related concepts" width="143" height="21">
+<br>
+<a href="../concepts/cdt_c_search.htm">C/C++ search</a><br>
+<a href="../concepts/cdt_c_indexer.htm">C/C++ Indexer</a><br>
+<a href="../concepts/cdt_c_projects.htm">CDT Projects</a><br>
+<a href="../concepts/cdt_c_open_declarations.htm">Open Declaration</a><br>
+</p>
+
+<p><img border="0" src="../images/ngtasks.gif" ALT="Related tasks" width="143" height="21"><br>
+<a href="cdt_t_sel_search.htm">Selection Searching for C/C++ elements</a><br>
+<a href="cdt_t_open_declarations.htm">Navigate to C/C++ declarations</a><br>
+</p>
+
+<p><img border="0" src="../images/ngref.gif" ALT="Related reference" width="143" height="21">
+<br>
+<a href="../reference/cdt_u_search.htm">C/C++ search page, Search dialog box</a></p>
+<p>&nbsp;</p>
+<img src="../images/ng00_07.gif" ALT="IBM Copyright Statement" >
+
+</body>
+
+</html>
\ No newline at end of file