Bug #114519 for Getopt-Long: Documentation/examples correction for option with hash value

I'm referring to the docs at http://perldoc.perl.org/Getopt/Long.html#Case-and-abbreviations 1) Section 'User-defined subroutines to handle options' "For a hash destination, the second argument is the key to the hash, and the third argument the value to be stored." It would help to explicitly mention that the option must have the '%' suffix to activate this behaviour with a user-defined subroutine. Perhaps you can also add a cross-reference to 'Summary of Option Specifications' where % is explained (and/or) to the example in 'Pushing multiple values in a hash option' 2) "... The value will be stored with the specified key in the hash. GetOptions ("define=s" => \%defines); Alternatively you can use: GetOptions ("define=s%" => \$defines); When used with command line options: --define os=linux --define vendor=redhat" the hash %defines (or %$defines ) will contain two keys, ..." This example needs a max value of 2 or more to work as described, e.g.: GetOptions ("define=s{1,}" => \%defines); GetOptions ("define=s%{1,}" => \$defines); Perhaps you can also add a cross-reference to 'Summary of Option Specifications' where min/max are explained. Thanks! Ben Golding