develooper Front page | perl.perl6.users | Postings from September 2018

Just posted a documentation RFE

September 26, 2018 21:59
Just posted a documentation RFE
Message ID:
Hi All,

I just posted a documentation fix and RFE

     A booboo and an rfe in contains documentation

Thank you all for helping me understand to the point that I
can stop grumbling and start being part of the solution.



Over on
the return value is missing: --> Bool

Since it need to be updated anyway, for clarity, would you please 
consider the following enhancements:

Old: multi method contains(Str:D: Str:D $needle, Int:D $pos)
Proposed: multi method contains(Str:D $Haystack : Str:D $Needle, Int:D 
$Position --> Bool)

Giving the input string the name "Haystack" gives meaning to the 
parameter of "Needle". You are searching for the "needle in the 
haystack". Without this linkage, one is left wondering what the "needle" 
is "sticking".

The " :", rather than ":" makes it more clear that it is a delimiter to 
the untrained eye.

And spelling out "Position" just makes it clearer what it is. (Not "pos" 
for Positive or what ever else it can be mistaken for.) Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at | Group listing | About