[MODULES-452] Document the meaning of ''*', '**' and '?' in pathSpecType

[dmlloyd]

@bstansberry opened MODULES-452 and commented

The xsd documentation for pathSpecType says:

The path name, which can be a literal path name or it may include the special wildcards "*", "**", and "?".

But this isn't enough information to really understand the rules around paths. For example, someone intuitively might create a path "foo/*" thinking it would match all resources under foo, but actually it matches subdirectories under foo, but not individual resources.

Ideally the semantics of ModuleXmlParser.parsePath would be documented in the pathSpecType documentation.

---

No further details from MODULES-452

[dmlloyd]

@bstansberry commented

Perhaps part of what's confusing and needs documenting is that these path patterns seem to only apply to directories, not individual resources. So the rules/examples in https://ant.apache.org/manual/dirtasks.html#patterns, which include many cases of matching individual files, are not applicable in the JBoss Modules 'filterType' context. The effect of these paths is only to identify directories.