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.