NAME ^

Parrot::Configure::Options - Process command-line options to Configure.pl

SYNOPSIS ^

    use Parrot::Configure::Options qw( process_options );

    $args = process_options( {
        mode => q{configure},
        argv => [@ARGV],
    } );

DESCRIPTION ^

Parrot::Configure::Options exports on demand the subroutine process_options(), which processes the command-line options provided to Configure.pl or to tools/dev/reconfigure.pl.

If you provide Configure.pl with either --help or --version, process_options() will print out the appropriate message and perform a bare return, i.e., the return value will be undef. The calling script -- whether Configure.pl or a test file -- can then check for the definedness of process_options()'s return value and proceed appropriately.

An array of valid command-line option names stored internally is consulted; the program will die if an invalid option is called.

SUBROUTINES ^

process_options() ^

NOTES ^

The functionality in this package originally appeared in Configure.pl. It was transferred here and refactored by James E Keenan.

SEE ALSO ^

Configure.pl. Parrot::Configure::Options::Conf. Parrot::Configure::Options::Reconf. Parrot::Configure::Options::Conf::CLI. Parrot::Configure::Options::Conf::File.


parrot