The barrels doc says:
See How to Include Barrels for more information on how to include Barrels and specific annotations.
But the "how to include barrels" section says this:
In order to use a Barrel, developers will need to add it to the current project
...
The Barrels and their specified annotations will be added to the default Barrel Jungle file automatically.
1) a barrel's annotations do not seem to be added to the default barrel jungle automatically, at least with the barrel I tested: https://github.com/douglasr/msgpack-monkeyc
2) the docs don't say how you would manually add annotations. i.e. there's no example of this:
base.BarrelName.annotations = barrelAnnotationA; barrelAnnotationB
Also, I think the following part of the docs is interesting:
Developers can use annotations to denote sub-modules within their Barrels. Sub-modules with annotations (i.e. the
(:Bars)
annotation above) allow developers to import certain sections of code without importing the entire Barrel
This almost seems to imply that dev could easily import the entire barrel and/or that this is something which happens by default. But it seems that once a barrel has annotations, the way to import the entire barrel (or at least all of the parts of the barrel that are annotated) is to manually specify all the annotations. In other words, "allow" in the above statement seems a bit misleading. Once a barrel uses annotations, it's more like the consumer of the barrel is *obligated* to import certain sections of the code by manually adding annotations to the barrel jungle.