Community
Participate
Working Groups
The help explanation for scopepattern and referencepattern is not very clear. Consider adding an example and impact of it on result.
Fixed in HEAD. Mike, does the following make sense to you? scopepattern This attribute specifies a regular expression pattern used to select what bundles will be searched for references. Only references found in a bundle that satisfies the regular expression will be included in the scan. For example, the following would only scan for references found in Eclipse bundles: org.eclipse.* This attribute does not affect where the referenced code can be found. See the referencepattern attribute. The pattern must be a well-formatted regular expression as defined here. ---- referencepattern This attribute specifies a regular expression pattern used to select what bundles will be searched for referenced code. Only references that refer to code from a bundle that satisfies the regular expression will be included in the scan. For example, the following would only scan for references that refer to code found in Eclipse bundles: org.eclipse.* This attribute does not affect where the reference can be found. See the scopepattern attribute. The pattern must be a well-formatted regular expression as defined here.
.
(In reply to comment #1) > scopepattern > Only references found in a bundle that satisfies the regular expression will > be included in the scan. This is a bit confusing since the bundle will not be searched at all if it does not match the scope pattern. I would omit that sentence. > > This attribute does not affect where the referenced code can be found. See the > referencepattern attribute. I am not sure what you are meaning here? What referenced code? Why would I want to see the following attribute? if you mean it does not filter references, then it needs re-wording, if thats not what you mean I would remove this sentence. > > referencepattern > > This attribute specifies a regular expression pattern used to select what > bundles will be searched for referenced code. "This attribute specifies a regular expression pattern used to select what bundles you want references from." sounds better to me. > > For example, the following would only report references that refer to code > found in Eclipse bundles: "For example, the following would only report references that refer to code found in Eclipse bundles:" sounds better to me > > This attribute does not affect where the reference can be found. See the > scopepattern attribute. > I would remove this sentence If you really wanted a blurb after the simple example, maybe something like: "Coupled with the referencepattern attribute, you can limit what bundles are searched and what bundles references come from in the scan results. For example if you have a scopepattern value of org.eclipse.jdt..* and a referencepattern of org.eclipse.jdt.debug..* you would only search the Eclipse JDT bundles for JDT debug references." Switch the wording of the above for the referencepattern section.
Reopening, we can improve the wording a little more.
Fixed in HEAD. Mike, feel free to review again. See apiuse-ant-task.htm
+1 look s fine now