We really are not communicating at all, are we? It says "--> Positional". Positional is a role specifying what to do with []. Positional is what knows what to do with [], so words() and lines() and everything else that produces a Positional doesn't have to know that. This is more or less the *definition* of Positional. It's not up to the documentation of words() to also tell you the documentation of Positional; it told you to look there.
And there is more to Positional than just knowing what to do with [], and that also is not something words() or its documentation should tell you. Or does every documentation page have to incorporate the whole Perl 6 documentation? ("You might decide to pass this a Str, so I guess I have to explain in detail what a Str is now just in case"?) On Wed, Sep 26, 2018 at 6:05 PM ToddAndMargo <toddandma...@zoho.com> wrote: > On 9/26/18 2:40 PM, Brandon Allbery wrote: > > Do you really think every function that produces a "list" has built into > > it secret knowledge of how you would index a list? They just produce a > > "Positional" or "Seq" or "List", etc. and *those* know what to do with > > []. The function doesn't even need to say it's doing that; that's to > > produce better error messages, not "wire what a list is into me". > > Hi Brandon, > > I know how to use the function and use it all the time. My > frustration is with the documentation. > > How did this > > multi method words(Str:D $input: $limit = Inf --> Positional) > > get to what you describe above? > > Yours in confusion, > -T > -- brandon s allbery kf8nh allber...@gmail.com