Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Clarify wildcard usage for API.consumers #16

Open
Marcono1234 opened this issue Jul 1, 2020 · 0 comments
Open

Clarify wildcard usage for API.consumers #16

Marcono1234 opened this issue Jul 1, 2020 · 0 comments

Comments

@Marcono1234
Copy link
Contributor

API.consumers allows according to the documentation the usage of wildcards:

The supplied packages can be fully qualified package names or patterns containing asterisks that will be used as wildcards.

However, it is not very specific regarding the following:

  1. What is a wildcard? Only *?
  2. Do wildcards apply only to one package nesting depth or to this depth and all "sub packages". E.g. does a.* match a.b and a.b.c?
    Note that Java does not have a concept of "sub packages" so for example a package-private type in a cannot be seen by a type in a.b.
  3. Do wildcards match if that nesting depth is not present (related to point 1 above)? E.g. a.b.* matching a.b
  4. Can wildcards only appear at the end, or may they also appear in the middle or the front of the package name (if so how does points 2 and 3 above apply)? E.g. *.a.*.b
  5. May wildcards only appear as replacement for a complete "sub package name" or may they also be used within "sub package" names (and if so, how would they match)? E.g. a.tes* matching a.test and a.testing

Note that I do not suggest that the behavior described above is the desired one, it only lists what one might expect from wildcards.

Could you please clarify this in the documentation and possibly include some examples?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant