These options tell abuild what to build and what targets to apply to items being built.
Ordinarily, any explicitly specified targets are applied only to items that were directly selected for inclusion in the build set. With this flag, they are applied to all items being built, including recursively expanded dependencies. When used with a clean set, this option causes the clean set to expanded to include dependencies, which is otherwise not done. For detailed information about target selection, please see Chapter 8, Telling Abuild What to Build.
Specify which build items should be built. The default is to
have no build set specified. In that case, abuild just
builds in the local directory without attempting to build any
dependencies. For additional details including a list of
valid values for set, see Chapter 8, Telling Abuild What to Build.
Run abuild clean in all items in the build
set. The same build sets are defined as with the
--build option. Unlike build sets, clean
sets are not expanded to include dependencies, and build
items are not cleaned in dependency order. No targets may be
specified in conjunction with this option. For additional
details including a list of valid values for
set, see Chapter 8, Telling Abuild What to Build.
Exclude from the initial build set any items that do not
contain all of the named traits. As always, all dependencies
of any item in the reduced build set will remain in the build
set regardless of what traits they have. If not accompanied
by the --related-by-traits option, any
explicitly named targets will be applied only to items that
have all of the named traits. Other items (those they depend
on) will be built with the default all
target. If accompanied by the
--related-by-traits option, the
--related-by-traits option's behavior with
respect to explicit targets takes precedence. For more
information about traits, see Section 8.3, “Traits”.
Expand the build set with items that have all of the named traits relative to any item already in the build set. Specifying this option also causes any explicitly specified targets to be run only for those items. The default target all is run for all other build items in the build set. For more information about traits, see Section 8.3, “Traits”.
Alternative for --build=current