Bug #59509 for MooseX-Getopt: s/help/help_flag/ in 0.30 broke existing MooseX::Getopt programs

It doesn't look like the name of the attribute to hold the help information was previously documented as being public. To change it now, after it *has* been documented, would break other programs that conform to the published API. Adding an alias doesn't change the name of the attribute itself, only modify which methods can be used to interact with it, so adding a 'help' alias won't change the behaviour that you see. commit 81b19ed83c9e345f960ccefbcd639dd0e3c2de06 ... diff --git a/lib/MooseX/Getopt.pm b/lib/MooseX/Getopt.pm index 49b47b9..fdd4263 100644 --- a/lib/MooseX/Getopt.pm +++ b/lib/MooseX/Getopt.pm @@ -196,7 +196,8 @@ C<new_with_options> will throw an exception. If L<Getopt::Long::Descriptive> is installed and any of the following command line params are passed, the program will exit with usage -information. You can add descriptions for each option by including a +information (and the option's state will be stored in the help_flag +attribute). You can add descriptions for each option by including a B<documentation> option for each attribute to document. Your code should be written as: package Xailo; use Moose; use MooseX::Aliases; with 'MooseX::Getopt' => { -version => 0.30 }; has help_flag => ( traits => [ qw/ Getopt / ], isa => 'Bool', is => 'ro', alias => $ENV{help}, cmd_flag => $ENV{help}, cmd_aliases => [ qw(usage ?) ], documentation => "You're soaking it in", ); This should continue to work going forward, as the name of the attribute is documented. I was pondering the idea of adding an option to MooseX::Getopt::GLD to customize the name(s) of the help options, so you don't need to do any of this -- would this be of interest?