Re: [Module::Build] ask() and you will receive

[David W. <da...@ki...>]

On Apr 14, 2006, at 02:44, Randy W. Sims wrote:

> +=item ask()
> +
> +[version 0.28]
> +
> +Asks the user a question and returns the answer as a string.
> +
> +The following is a list of arguments.  Only C<prompt> and C<default>
> +are required.
> +
> +=over
> +
> +=item allow_nonoption_default
>

I'd make this last. I tend to list options in the order of  
importance. So for this method, I would list them in this order:

=prompt
=default
=show_default
=options
=getopts_name
=show_options
=allow_nonoption_default

> +Normally, the value of the C<default> arguement must exist in the
> +C<options> array.

But only if there *is* an options array.

> Setting this to true allows the C<default> argument
> +to be set to an arbitrary value.
> +
> +=item default   [required]
> +
> +This is the default value that will be used if the user presses
> +E<lt>enterE<gt> or if running an unattended build.
> +
> +The value assigned to C<default> may be different from the options
> +listed in the C<options> argument.

But only if there *is* an options parameter and you've set  
allow_noniption_dfault to true.

> +=item show_default
> +
> +A boolean value that indicates whether the default value should be
> +displayed as part of the prompt.  If true and if the default is a
> +non-empty string,

And non-undef?

>  =item autosplit_file($from, $to)
>
>  [version 0.28]
> @@ -1437,6 +1514,8 @@
>
>  [version 0.12]
>
> +[Deprecated] See the C<ask()> method.
> +

What's deprecated, here?

Best,

David