develooper Front page | perl.perl5.porters | Postings from August 2019

Re: [perl #134365] [PATCH] Typo in perlsub.pod

Thread Next
From:
Valeriy Kireev
Date:
August 16, 2019 16:28
Subject:
Re: [perl #134365] [PATCH] Typo in perlsub.pod
Message ID:
6e45840d-21da-6522-228d-aee000ad52b9@Tune-IT.Ru
I didn't know about "IFF" abbreviation. So, I suppose, this misunderstanding is 
my mistake, thus there is no need to clean up code base of IFFs.

On 8/15/19 10:45 PM, James E Keenan via RT wrote:
> On Thu, 15 Aug 2019 16:31:06 GMT, grinnz@gmail.com wrote:
>> On Thu, 15 Aug 2019 09:23:33 -0700, jkeenan wrote:
>>> On Thu, 15 Aug 2019 16:02:45 GMT, Valeriy.Kireev@Tune-IT.Ru wrote:
>>>> This is a bug report for perl from Valeriy.Kireev@Tune-IT.Ru,
>>>> generated with the help of perlbug 1.41 running under perl 5.31.3.
>>>>
>>>>
>>>> -----------------------------------------------------------------
>>>> [Please describe your issue here]
>>>> There is small typo in pod/perlsub.pod, "IIF" used instead of "if".
>>>> The patch
>>>> fixes it.
>>>>
>>>
>>> There are places in the Perl 5 core distribution (and elsewhere in the
>>> tech world) where the string "IFF" means "if and only if".
>>>
>>> Could this be one of those places?  If so, then we would not apply the
>>> patch.
>>>
>>> Thank you very much.
>>
>> Yes, I think this is correct.
> 
> Okay, given that at least one user found the documentation confusing, and given the fact that I had to ack the repository to locate other instances of 'IFF' to confirm my hunch, then I think we can conclude that the documentation is sub-optimal ... even though it's been there since perl-5.4 in 1997.
> 
> The longer I stare at it, the more I feel I don't know what the 'else "foo"' part means.
> 
> If I knew what 'else "foo"' meant, I'd work that into a rewording something like this:
> 
> #####
> foo;        # if and only if sub foo has been predeclared,
>              # then this is like foo() above
>              # otherwise, _______
> #####
> 

-- 
Kind regards,
Valeriy Kireev
Software developer -- TuneIT Company.

Thread Next


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About