bad "handles" example in doc/Language/subscripts.pod6

[coke]

This sample code:

    class HTTP::Header does Associative is Iterable {
        subset StrOrArrayOfStr where Str | ( Array & {.all ~~ Str} );

        has %!fields of StrOrArrayOfStr
                     handles <AT-KEY EXISTS-KEY DELETE-KEY push
                              iterator list kv keys values>;

        method Str { #`[not shown, for brevity] }
    }

Is presented as an example of handles, but if you run it, you get:

===SORRY!=== Error while compiling -
Class HTTP::Header can't pun role Iterable because it has required methods: iterator. Did you mean to use "does" instead?
at -:1

and if you fix that, you get:

Method 'iterator' must be implemented by HTTP::Header because it is required by roles: Iterable.

So this sample code isn't doing what it claims to.

[zoffixznet]

The first one is a proper error, it sould be does instead of is (fixed in 492896f)

Method 'iterator' must be implemented by HTTP::Header because it is required by roles: Iterable.

I'd call that a rakudo bug; it fails to see the handles is providing iterator method. This is already reported as a more direct bug when actual method is present, but I mentioned this case with handles as well.

So... this ticket looks to be fixed to me, now.

[coke]

Ideally, we'd reference the RT in the user-visible code, and remove the skip once the bug is fixed.

[JJ]

Checking that the RT bug is still open.

[JJ]

There's a patch submitted: rakudo/rakudo#1170, but it has not been accepted yet.

[JJ]

Of course, we could/should rewrite the example...