docs: remove invalid example about mixing files and directory #4566
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
The mix of file and package/directory (as documented inside the quick start) doesn't work as expected.
Same thing for the usage of multiple files from different packages.
Examples
This limitation is related to the package loader of
x/tools
.There is a hack: the usage of the prefix
file=
allows to mix files and packages but this has a major side effect.The usage of
file=
, despite what the name of the query suggests, will not limit the loading to the file but to the package that contains the file.In other words, instead of analyzing one file, all the sibling files will be analyzed.
So this is not an acceptable solution.
In this context, I edited the documentation to remove this invalid example.
To reproduce
Fixes #3200
Fixes #1081
Fixes #942