These options change some aspect of how abuild starts or runs.
Terminate argument parsing and pass all remaining arguments
(up to --make) to ant.
Change directories to the given directory before building.
Tell ant to run in emacs mode by passing the
-e flag to it and also setting the property
abuild.private.emacs-mode. Ant targets can
use this information to pass to programs whose output may need
to be dependent upon whether or not emacs mode is in effect.
Locates the first directory at or above the current directory
that contains an Abuild.conf file, and
changes directories to that location before building.
Performs abuild's integrity checks for all items in the
local tree, externals, and backing areas. Ordinarily,
abuild performs its integrity check only for items that are
being built in the current build. The
--full-integrity flag would generally be
useful only for people who are maintaining backing areas that
are used by other people. For detailed information about
abuild's integrity checks, please see Section 10.4, “Integrity Checks”.
Build up to n build items in parallel by
invoking up to n simultaneous instances
of the backend. Does not cause the backend to run multiple
jobs in parallel. See also --make-jobs.
Don't stop the build after the first failed build item, but
instead continue building additional build items that don't
depend on any failed items. Also tells backend to continue
after its first failure. Even with -k,
abuild will never try to build an item if any of its
dependencies failed. This behavior may be changed by
also specifying --no-dep-failures.
Terminate argument parsing and pass all remaining arguments
(up to --ant) to make.
Allow make to run up to n jobs in parallel.
Omit n to allow make to run as many jobs as
it wants. Be aware that if this option is used in combination
with --jobs, the total number of threads
could potentially be the product of the two numerical
arguments.
Run in monitored mode. For details, see Chapter 28, Monitored Mode.
For make-based builds only: have make print what it would do without actually doing it.
Do not tell ant to use the custom
AbuildLogger as its logger.
AbuildLogger is aware of the
possibility of nested ant targets and also properly suppresses
output of empty ant targets. As of ant version 1.7, the
DefaultLogger and
NoBannerLogger loggers produce
misleading output when there are nested ant targets.
Must be combined with -k. By default,
abuild does not attempt to build any items whose
dependencies have failed even if -k is
specified. When the --no-dep-failures option
is specified along with -k, abuild will
attempt to build items even if one or more of their
dependencies have failed. Using -k and
--no-dep-failures together enables abuild
to attempt to build everything that the backends will allow.
Note that cascading errors (i.e., errors
resulting from earlier errors) are likely when this option is
used.
Specify a platform selector for object code platforms. This
argument may be repeated any number of times. Later instances
supersede earlier ones when they specify selection criteria for
the same platform type. When two selectors refer to different
platform types, both selectors are used. Platform selectors
may also be given in the
ABUILD_PLATFORM_SELECTION environment variable.
For details on platform selectors, see Section 21.1, “Platform Selection”.
Suppress most non-error output. Also tells make and ant to generate less output.
Generate more verbose output. Also tells make and ant to generate more output.