Bug#644701: libfile-which-perl: package description

[Martin Eberhard Schauer]

X-Debbugs-CC: jbr at edlug.org.uk

>> I believe rewording the description  (1) will make it better comprehensible.
>>
>> Description: Perl module for searching paths for executable programs
>>   File::Which searches directories of a user's PATH (as returned by File::Spec)
>>   and looks for executable files having the name specified as a parameter to
>>   which(), simulating the behaviour of the standard `which' program.
>>      
> Do you mean you were having trouble with the syntax, and the ambiguity
> about which of the previously mentioned goings-on was being referred
> to as "simulating the behaviour of the standard `which' program"?  Or
> is it the content that's a problem?
>    
My problem was "having the name specified as a parameter to
  which()".
>> Obiously we find upstream's (2) wording:
>>      
... should be a hint to the maintainers that the upstream wording
is problematic.
>>   File::Which simulates the behavior of the standard 'which' program: it
>>   searches directories of a user's PATH (as returned by File::Spec)
>>   and looks for executable files.
>>      
> It doesn't just return success if it finds any executables in PATH
> directories; it looks for particular command names.  You might
> abbreviate it to "looking for executable files matching a given name",
> though.
>    
If I understand right:

Description: Perl module for searching paths for executable programs
  File::Which simulates the behavior of the standard 'which' program: it
  searches directories of a user's PATH (as returned by File::Spec)
  looking for executable files matching a given name.