NAME
Dpkg::BuildOptions - parse and update build options
DESCRIPTION
The Dpkg::BuildOptions object can be used to manipulate options stored
in the DEB_BUILD_OPTIONS environment variable.
FUNCTIONS
my $bo = Dpkg::BuildOptions->new()
Create a new Dpkg::BuildOptions object. It will be initialized
based on the value of the DEB_BUILD_OPTIONS environment variable.
$bo->reset()
Reset the object to not have any option (it's empty).
$bo->merge($content, $source)
Merge the options set in $content and record that they come from
the source $source. $source is mainly used in warning messages
currently to indicate where invalid options have been detected.
$content is a space separated list of options with optional
assigned values like "nocheck parallel=2".
$bo->set($option, $value, [$source])
Store the given option in the objet with the given value. It's
legitimate for a value to be undefined if the option is a simple
boolean (its presence means true, its absence means false). The
$source is optional and indicates where the option comes from.
The known options have their values checked for sanity. Options
without values have their value removed and options with invalid
values are discarded.
$bo->get($option)
Return the value associated to the option. It might be undef even
if the option exists. You might want to check with
$bo->has($option) to verify if the option is stored in the object.
$bo->has($option)
Returns a boolean indicating whether the option is stored in the
object.
$string = $bo->output($fh)
Return a string representation of the build options suitable to be
assigned to an environment variable. Can optionnaly output that
string to the given filehandle.
$bo->export([$var])
Export the build options to the given environment variable. If
omitted, DEB_BUILD_OPTIONS is assumed. The value set to the
variable is also returned.
AUTHOR
Raphal Hertzog <hertzog@debian.org>