Bud Utility © 2006, Derek Parnell, Melbourne
(table of contents)
CMDLINE=-inline -wEnvironment Symbol Substitution
Example: Assuming you had set BUILDOPTS=-w -g
CMDLINE=%BUILDOPTS% # Allow switches to be passed via enviroment symbol.would mean that "-w -g" would be automatically placed on the utility's commandline whenever you ran it.
Example: a Group
[dbg] # To produce a debug edition of an application.
CMDLINE=-unittest
CMDLINE=--release
CMDLINE=--inline
CMDLINE=-g
CMDLINE=-w
CMDLINE=-full
CMDLINE=-T{Target}_{Group}
All the options lines before the first group are known as the default
options because these are always applied. To apply the options in a group
you need to specify which group(s) you want on the command line, or via
a . The group name is prepended with a plus sign on
the command line. To apply the 'debug' group in the above example, you
place on the command line +dbg
Example:
build myapp.d +finalwhere if a group called '[final]' is contained in any configuration file, the options in that group are used.
Example: contents of [final]
# This creates a production (release) edition of the app.
[final]
CMDLINE=-T{Target}_{Group} # Set the name of the executable.
CMDLINE=-release # Don't generate runtime checks.
CMDLINE=-full # Force compilation of all files.
CMDLINE=-cleanup # remove work files when completed
CMDLINE=-inline # Allow inlining to occur
CMDLINE=--debug* # Turn off any debug switches
CMDLINE=--unittest # Turn off any unittest switches
CMDLINE=--w # Turn off warnings
CMDLINE=--g # Turn off embedded debug symbolic info.
You can any number of configuration file group references on a command line. They
are processed in the order they appear.