Re: [perl #117649] [PATCH] Refer to documentation on find2perlswitch error

On Sun, 14 Jul 2013 22:08:29 -0700, "Tony Cook via RT"
<perlbug-followup@perl.org> wrote:

> On Thu May 09 02:25:27 2013, ppisar wrote:
> > On 2013-05-09, James E Keenan via RT <perlbug-followup@perl.org> wrote:
> > > I agree that the two current error messages are rather ... skimpy.
> > >
> > > But I'm not sure that you're suggestion of adding on "See manual or
> > > perldoc page for usage help" adds much.
> > 
> > After user realizes the switch is wrong, he wants to know correct usage.
> > Unfortunately `find2perl -h' or `find2perl --help' do not help
> > either. Pointing to the manual directly saves headaches. That's my
> > motivation.
> 
> I'm inclined to agree with Jim here.
> 
> If a user tries something with a command-line tool they expect to work
> and it doesn't, reaching for the documentation should be their first
> impulse, not something we need to prompt them to do.
> 
> Also:
> 
> tony@mars:.../git/bse$ find -h
> find: unknown predicate `-h'

There will always be conflicts

$ git checkout --help
… lots of help
$ git co --help
`git co' is aliased to `checkout'

Yeah, really helpful! (not)
They discussed this on the devel list and declined to change that

-- 
H.Merijn Brand  http://tux.nl   Perl Monger  http://amsterdam.pm.org/
using perl5.00307 .. 5.19   porting perl5 on HP-UX, AIX, and openSUSE
http://mirrors.develooper.com/hpux/        http://www.test-smoke.org/
http://qa.perl.org   http://www.goldmark.org/jeff/stupid-disclaimers/

• [perl #117649] [PATCH] Refer to documentation on find2perl switch error by Tony Cook via RT
• [perl #117649] [PATCH] Refer to documentation on find2perl switch error by Tony Cook via RT
• Re: [perl #117649] [PATCH] Refer to documentation on find2perlswitch error by H.Merijn Brand