Subject: | MooseX-Getopt does not support "man" option as recommend in Getopt::Long |
Date: | Mon, 27 Jan 2014 11:56:30 +0800 |
To: | bug-MooseX-Getopt [...] rt.cpan.org |
From: | demerphq <demerphq [...] gmail.com> |
Getopt::Long includes a "standard" template for using Getopt::Long
with Pod::Usage, in particular it recommends that users support the
following:
my $man = 0;
my $help = 0;
GetOptions('help|?' => \$help, man => \$man) or pod2usage(2);
pod2usage(1) if $help;
pod2usage(-exitval => 0, -verbose => 2) if $man;
MooseX-Getopt does not follow the recommendation to support "--man".
This means there is no easy way other than "perldoc" to view full
manuals for MooseX-Getopt based scripts. I consider this a bug as
perldoc does not show the pod file correctly as compared to supporting
the --man option.
Obviously one can manually add such support to a script, but it seems
an unnecessary requirement to force everyone to do this.
Please add support for the --man option so that MooseX-Getopt scripts
have an easy way to show the full manual and are "interface"
compatible with the long recommended template in Getopt::Long (10
years or more)
Note this parameter is especially useful on *non* *nix systems where
man does not exist.
Yves
--
perl -Mre=debug -e "/just|another|perl|hacker/"