Abuild's make and property-driven
ant backends define several targets
that are available for use from the command line. When one of
those two build methods is used, you can rely on these targets
being defined. When the build.xml-driven
ant method is used (the build file is
Abuild-ant.xml), then it is up to the author
of the build file to provide these targets.
This is the default target. It is used to build all products that are intended for use by the end user or by other build items.
This target ensures that the local build item is built and then runs its automated test suite, if any. For this to do anything, the build item must have a test suite implemented with a test framework that is integrated with abuild or that is made available with a plugin. Abuild is integrated with QTest and, for Java-based build items, also with JUnit. The check target is not automatically run by the default target; it must be requested specifically.
This target removes any output directories that abuild thinks it created. (Output directories are discussed in Section 5.3, “Output Directories”.) Well-behaved abuild rules, including all the rules that are a standard part of abuild, won't create any files or directories outside of these locations.
This target is provided for building documentation that is
extracted from source code. The doc target
is not automatically run by the default target; it must be
requested explicitly. It depends on the
all target. There is no internal support
for document generation, so this capability must be provided
by a plugin. For ant builds,
plugins should define a doc hook. For
make builds, they should make the
document generation a dependency of the doc
target. Contributed plugins to support javadoc and doxygen
are available in abuild-contrib, which is
released separately from abuild.
This target prints help information for authors of the
Abuild.interface file for the current
build item. What is printed is based on which backend is
in use and, for make-based build
items, the value of the RULES variable
in Abuild.mk.
This target does nothing other than printing the name and
platform of each build item in the build set, but using it
still causes abuild to perform all the same validations it
would perform if it were going to build something. The
no-op target can be used to get a complete
list of all the items and platforms that would be built if
building a given build set and will also verify that there are
no errors in any Abuild.conf files. Note
that Abuild.interface files are not read
when invoking the no-op target.
For make-based build items, this
target prints help information for any rules defined in the
RULES variable in
Abuild.mk. For property-driven
ant-based build items, it prints
information about properties that can be set in
Abuild-ant.properties.
This target is a synonym for check.
This target runs any automated test suites but does not first try to build. In other words, the test-only target does not depend on the all target like the check and test targets do. This can be useful for running a test suite on a build item without first rebuilding it or for running all the test suites on a build tree that you know is up to date because you just built it.