Description Susan McCourt 2007-11-13 13:41:37 EST

I figured that the NAMESPACE_IU namespace probably referred to an IU's id, but the documentation surrounding this namespace doesn't make this clear.  I realize there are places where the generic "name" parameter makes sense when providing a value for any random namespace, but when working specifically with NAMESPACE_IU, we should make it clearer that the id is the name used in this namespace.

Examples in the javadoc that are misleading:

* from NAMESPACE_IU
A capability namespace representing a particular InstallableUnit by name.

* public static RequiredCapability createRequiredCapabilityForName(String name, VersionRange versionRange, boolean optional) {...

Even if the constant name NAMESPACE_IU stays the same, we should make sure the arguments for anything that specifically assigns a value to this namespace should be called "id."  Even better, NAMESPACE_IU_ID would be a better name for this namespace.