Options

The Options element specifies options to pass to Ounce/Make upon invocation.

This element provides an alternative to the use of certain Ounce/Make command line options, as described in Ounce/Make command syntax and make options.

Attributes use the syntax:

<option> = <true | false>

The Options element and its attributes are not required.

The Options element may include the following attributes:

Attribute Description
recursive Boolean value. True or false.

When true, implies -r command line option.
single_project Boolean value. True or false.

When true, implies -s command line option.
verbose Boolean value. True or false.

When true, implies -v command line option.
clean String value, enclosed in quotation marks ("), such as "make clean".

When set, implies -c command line option. The value should be the command to execute to perform the clean. For example, gmake clean.
build Boolean value. True or false.

Perform the build while gathering the make options.

Note: Incompatible with Cygwin.
application String value. When set, implies -a option. The value specified should be the application name that you want.
no_clean Boolean value. True or false.

Tell Ounce/Make not to run clean and do not display a prompt reminding that a clean is not going to be run.
Note: Ounce/Make uses the options set in the Properties file. However, if you run Ounce/Make with options included on the command line, these options take precedence over options set in the Properties file. If you run Ounce/Make without options on the command line, Ounce/Make applies the Properties file options.

Example

The following is an example line from the Properties file that makes use of all attributes:

<Options recursive="true" single_project="false" verbose="false"
clean="nmake.exe clean" no_clean="false"></Options>

Description

  • recursive="true"
  • single_project="false" directs Ounce/Make to operate in multiple-project mode. When operating in multiple-project mode, the recursive attribute should also be set to true.
  • verbose="false" turns off verbosity.
  • clean="nmake.exe clean" cleans the build environment.
  • no_clean= "false" tells Ounce/Make to run a clean command, suppressing the message stating that the clean will run.