Attachment #185321 for bug #332451




	 * The Java elements resulting from a search with this scope will
	 * be children of the given elements.
	 * <p>
	 * If an element is an {@link IJavaProject}, then the project's source folders,
	 * its jars (external and internal) and its referenced projects (with their source
	 * folders and jars, recursively) will be included.</p>
	 * <p>If an element is an {@link IPackageFragmentRoot}, then only the package fragments of
	 * this package fragment root will be included.</p>
	 * <p>If an element is an {@link IPackageFragment}, then only the compilation unit and class
	 * files of this package fragment will be included. Subpackages will NOT be
	 * included.</p>
	 *
	 * <p>In other words, this is equivalent to using SearchEngine.createJavaSearchScope(elements, true).</p>
	 *
	 * @param elements the Java elements the scope is limited to
	 * @return a new Java search scope

	 * The Java elements resulting from a search with this scope will
	 * be children of the given elements.
	 *
	 * <p>If an element is an {@link IJavaProject}, then the project's source folders,
	 * its jars (external and internal) and - if specified - its referenced projects
	 * (with their source folders and jars, recursively) will be included.</p>
	 * <p>If an element is an {@link IPackageFragmentRoot}, then only the package fragments of
	 * this package fragment root will be included.</p>
	 * <p>If an element is an {@link IPackageFragment}, then only the compilation unit and class
	 * files of this package fragment will be included. Subpackages will NOT be
	 * included.</p>
	 *
	 * @param elements the Java elements the scope is limited to
	 * @param includeReferencedProjects a flag indicating if referenced projects must be

	 * The Java elements resulting from a search with this scope will
	 * be children of the given elements.
	 *
	 * <p>If an element is an IJavaProject, then it includes:</p>
	 * <ul>
	 * <li>its source folders if {@link IJavaSearchScope#SOURCES} is specified,</li>
	 * <li>its application libraries (internal and external jars, class folders that are on the raw classpath,
	 *   or the ones that are coming from a classpath path variable,
	 *   or the ones that are coming from a classpath container with the K_APPLICATION kind)
	 *   if {@link IJavaSearchScope#APPLICATION_LIBRARIES} is specified</li>
	 * <li>its system libraries (internal and external jars, class folders that are coming from an
	 *   IClasspathContainer with the K_SYSTEM kind)
	 *   if {@link IJavaSearchScope#APPLICATION_LIBRARIES} is specified</li>
	 * <li>its referenced projects (with their source folders and jars, recursively)
	 *   if {@link IJavaSearchScope#REFERENCED_PROJECTS} is specified.</li>
	 * </ul>
	 * <p>If an element is an {@link IPackageFragmentRoot}, then only the package fragments of
	 * this package fragment root will be included.</p>
	 * <p>If an element is an {@link IPackageFragment}, then only the compilation unit and class
	 * files of this package fragment will be included. Subpackages will NOT be
	 * included.</p>
	 *
	 * @param elements the Java elements the scope is limited to
	 * @param includeMask the bit-wise OR of all include types of interest

Return to bug 332451

Lines 245-260 Link Here

(-)search/org/eclipse/jdt/core/search/SearchEngine.java (-25 / +27 lines)
245	* The Java elements resulting from a search with this scope will	245	* The Java elements resulting from a search with this scope will
246	* be children of the given elements.	246	* be children of the given elements.
247	* <p>	247	* <p>
248	* If an element is an IJavaProject, then the project's source folders,	248	* If an element is an {@link IJavaProject}, then the project's source folders,
249	* its jars (external and internal) and its referenced projects (with their source	249	* its jars (external and internal) and its referenced projects (with their source
250	* folders and jars, recursively) will be included.	250	* folders and jars, recursively) will be included.</p>
251	* If an element is an IPackageFragmentRoot, then only the package fragments of	251	* <p>If an element is an {@link IPackageFragmentRoot}, then only the package fragments of
252	* this package fragment root will be included.	252	* this package fragment root will be included.</p>
253	* If an element is an IPackageFragment, then only the compilation unit and class	253	* <p>If an element is an {@link IPackageFragment}, then only the compilation unit and class
254	* files of this package fragment will be included. Subpackages will NOT be	254	* files of this package fragment will be included. Subpackages will NOT be
255	* included.</p>	255	* included.</p>
256	* <p>	256	*
257	* In other words, this is equivalent to using SearchEngine.createJavaSearchScope(elements, true).</p>	257	* <p>In other words, this is equivalent to using SearchEngine.createJavaSearchScope(elements, true).</p>
258	*	258	*
259	* @param elements the Java elements the scope is limited to	259	* @param elements the Java elements the scope is limited to
260	* @return a new Java search scope	260	* @return a new Java search scope
Lines 269-282 Link Here
269	* The Java elements resulting from a search with this scope will	269	* The Java elements resulting from a search with this scope will
270	* be children of the given elements.	270	* be children of the given elements.
271	*	271	*
272	* If an element is an IJavaProject, then the project's source folders,	272	* <p>If an element is an {@link IJavaProject}, then the project's source folders,
273	* its jars (external and internal) and - if specified - its referenced projects	273	* its jars (external and internal) and - if specified - its referenced projects
274	* (with their source folders and jars, recursively) will be included.	274	* (with their source folders and jars, recursively) will be included.</p>
275	* If an element is an IPackageFragmentRoot, then only the package fragments of	275	* <p>If an element is an {@link IPackageFragmentRoot}, then only the package fragments of
276	* this package fragment root will be included.	276	* this package fragment root will be included.</p>
277	* If an element is an IPackageFragment, then only the compilation unit and class	277	* <p>If an element is an {@link IPackageFragment}, then only the compilation unit and class
278	* files of this package fragment will be included. Subpackages will NOT be	278	* files of this package fragment will be included. Subpackages will NOT be
279	* included.	279	* included.</p>
280	*	280	*
281	* @param elements the Java elements the scope is limited to	281	* @param elements the Java elements the scope is limited to
282	* @param includeReferencedProjects a flag indicating if referenced projects must be	282	* @param includeReferencedProjects a flag indicating if referenced projects must be
Lines 293-314 Link Here
293	* The Java elements resulting from a search with this scope will	293	* The Java elements resulting from a search with this scope will
294	* be children of the given elements.	294	* be children of the given elements.
295	*	295	*
296	* If an element is an IJavaProject, then it includes:	296	* <p>If an element is an IJavaProject, then it includes:</p>
297	* - its source folders if IJavaSearchScope.SOURCES is specified,	297	* <ul>
298	* - its application libraries (internal and external jars, class folders that are on the raw classpath,	298	* <li>its source folders if {@link IJavaSearchScope#SOURCES} is specified,</li>
		299	* <li>its application libraries (internal and external jars, class folders that are on the raw classpath,
299	* or the ones that are coming from a classpath path variable,	300	* or the ones that are coming from a classpath path variable,
300	* or the ones that are coming from a classpath container with the K_APPLICATION kind)	301	* or the ones that are coming from a classpath container with the K_APPLICATION kind)
301	* if IJavaSearchScope.APPLICATION_LIBRARIES is specified	302	* if {@link IJavaSearchScope#APPLICATION_LIBRARIES} is specified</li>
302	* - its system libraries (internal and external jars, class folders that are coming from an	303	* <li>its system libraries (internal and external jars, class folders that are coming from an
303	* IClasspathContainer with the K_SYSTEM kind)	304	* IClasspathContainer with the K_SYSTEM kind)
304	* if IJavaSearchScope.APPLICATION_LIBRARIES is specified	305	* if {@link IJavaSearchScope#APPLICATION_LIBRARIES} is specified</li>
305	* - its referenced projects (with their source folders and jars, recursively)	306	* <li>its referenced projects (with their source folders and jars, recursively)
306	* if IJavaSearchScope.REFERENCED_PROJECTS is specified.	307	* if {@link IJavaSearchScope#REFERENCED_PROJECTS} is specified.</li>
307	* If an element is an IPackageFragmentRoot, then only the package fragments of	308	* </ul>
308	* this package fragment root will be included.	309	* <p>If an element is an {@link IPackageFragmentRoot}, then only the package fragments of
309	* If an element is an IPackageFragment, then only the compilation unit and class	310	* this package fragment root will be included.</p>
		311	* <p>If an element is an {@link IPackageFragment}, then only the compilation unit and class
310	* files of this package fragment will be included. Subpackages will NOT be	312	* files of this package fragment will be included. Subpackages will NOT be
311	* included.	313	* included.</p>
312	*	314	*
313	* @param elements the Java elements the scope is limited to	315	* @param elements the Java elements the scope is limited to
314	* @param includeMask the bit-wise OR of all include types of interest	316	* @param includeMask the bit-wise OR of all include types of interest