### Eclipse Workspace Patch 1.0 #P org.eclipse.jdt.core Index: search/org/eclipse/jdt/core/search/SearchPattern.java =================================================================== RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/search/org/eclipse/jdt/core/search/SearchPattern.java,v retrieving revision 1.75 diff -u -r1.75 SearchPattern.java --- search/org/eclipse/jdt/core/search/SearchPattern.java 25 Jan 2008 21:16:18 -0000 1.75 +++ search/org/eclipse/jdt/core/search/SearchPattern.java 27 Jan 2008 19:08:14 -0000 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -1264,16 +1264,16 @@ * Examples: *

search for case insensitive references to Object: - * createSearchPattern("Object", TYPE, REFERENCES, false);

createSearchPattern("Object", IJavaSearchConstants.TYPE, IJavaSearchConstants.REFERENCES, false);

search for case sensitive references to exact Object() constructor: - * createSearchPattern("java.lang.Object()", CONSTRUCTOR, REFERENCES, true);

createSearchPattern("java.lang.Object()", IJavaSearchConstants.CONSTRUCTOR, IJavaSearchConstants.REFERENCES, true);

search for implementers of java.lang.Runnable: - * createSearchPattern("java.lang.Runnable", TYPE, IMPLEMENTORS, true);

createSearchPattern("java.lang.Runnable", IJavaSearchConstants.TYPE, IJavaSearchConstants.IMPLEMENTORS, true);

* @param stringPattern the given pattern *

Type pattern can have the following syntax: - *
[qualification '.']type ['<' typeArguments '>']
+ *
Type patterns have the following syntax: + *
[qualification '.']typeName ['<' typeArguments '>']
*
Some samples:*
* *
- * Type arguments can be specified to search references to parameterized types + * Type arguments can be specified to search for references to parameterized types * using following syntax:
* '<' { [ '?' {'extends'|'super'} ] type ( ',' [ '?' {'extends'|'super'} ] type )* | '?' } '>' *
@@ -1293,10 +1293,10 @@ *

* - *

Method pattern can have the following syntax: - *

[declaringType '.'] ['<' typeArguments '>'] selector ['(' parameterTypes ')'] [returnType]

- *

Type arguments have the same pattern that for type patterns

- *

Some samples:+ *

Method patterns have the following syntax:
+ * 		[declaringType '.'] ['<' typeArguments '>'] methodName ['(' parameterTypes ')'] [returnType]
+ *			Type arguments have the same syntax as explained in the type patterns section
+ *			Some samples:
  *			

  *				java.lang.Runnable.run() void
  *				main(*)
@@ -1305,9 +1305,9 @@
  *			
  *			
  *		
- * 	Constructor pattern can have the following syntax:
- *			['<' typeArguments '>'] [declaringQualification '.'] type ['(' parameterTypes ')']
- *			Type arguments have the same pattern that for type patterns
+ * 	
Constructor patterns have the following syntax:
+ *			['<' typeArguments '>'] [declaringQualification '.'] typeName ['(' parameterTypes ')']
+ *			Type arguments have the same syntax as explained in the type patterns section
  *			Some samples:
  *			

  *				java.lang.Object()
@@ -1317,8 +1317,8 @@
  *			
  *			 
  * 	
- * 	Field pattern can have the following syntax:
- *			[declaringType.]name[ type]
+ * 	
Field patterns have the following syntax:
+ *			[declaringType '.'] fieldName [fieldType]
  *			Some samples:
  *			

  *				java.lang.String.serialVersionUID long
@@ -1327,6 +1327,16 @@
  *			
  *			
  * 	
+ * 	Package patterns have the following syntax:
+ *			packageNameSegment {'.' packageNameSegment}
+ *			Some samples:
+ *			

+ *				java.lang
+ *				org.e*.jdt.c*e
+ *			

+ *			
+ *			
+ * 	
  * 
  * @param searchFor determines the nature of the searched elements
  *	
@@ -1363,7 +1373,7 @@
  *		TODO (frederic) add specification for fine grain flags
  *		
  *	
- * @param matchRule one of the following match rule
+ * @param matchRule one of the following match rules
  * 	
  * 		{@link #R_EXACT_MATCH}
  * 		{@link #R_PREFIX_MATCH}
@@ -1372,7 +1382,7 @@
  * 		{@link #R_CAMELCASE_MATCH}
  * 		{@link #R_CAMELCASE_SAME_PART_COUNT_MATCH}
  * 	
- * 	which may be also combined with one of the following flag:
+ * 	, which may be also combined with one of the following flags:
  * 	
  * 		{@link #R_CASE_SENSITIVE}
  * 		{@link #R_ERASURE_MATCH}
@@ -1389,7 +1399,7 @@
  * 	Note that {@link #R_ERASURE_MATCH} or {@link #R_EQUIVALENT_MATCH} has no effect
  * 	on non-generic types/methods search.
  * 	
- * 	Note also that default behavior for generic types/methods search is to find exact matches.
+ * 	Note also that the default behavior for generic types/methods search is to find exact matches.
  * @return a search pattern on the given string pattern, or null if the string pattern is ill-formed
  */
 public static SearchPattern createPattern(String stringPattern, int searchFor, int limitTo, int matchRule) {
@@ -1530,7 +1540,7 @@
  *		
TODO (frederic) add specification for fine grain flags
  *		
  *	
- * @param matchRule one of the following match rule
+ * @param matchRule one of the following match rules:
  * 	
  * 		{@link #R_EXACT_MATCH}
  * 		{@link #R_PREFIX_MATCH}
@@ -1539,7 +1549,7 @@
  * 		{@link #R_CAMELCASE_MATCH}
  * 		{@link #R_CAMELCASE_SAME_PART_COUNT_MATCH}
  * 	
- * 	which may be also combined with one of the following flag:
+ * 	, which may be also combined with one of the following flags:
  * 	
  * 		{@link #R_CASE_SENSITIVE}
  * 		{@link #R_ERASURE_MATCH}