Document use of method invocant to distinguish between class and object methods

[ronaldxs]

See also perl6/roast #217 and IRC.

The technique is sometimes used by examples in the docs but not really described in either of Classes and Objects or Object Orientation. It would seem helpful to have it discussed directly someplace where someone might look for it.

class C {
    multi method f(::?CLASS:U:){say "class method"}
    multi method f(::?CLASS:D:){say "object method"}
}
C.f;       # says class method
C.new.f;   # says object method

[zakame]

Hi, I think I can help out on this. I suppose this would be elaborated more on Object Orientation, to keep the class tutorial simple?

[zoffixznet]

I suppose this would be elaborated more on Object Orientation, to keep the class tutorial simple?

Sounds good. Perhaps in the Methods section?

[zakame]

Yep, that section sounds good. And since multi is shown here, I suppose linking to declarator multi might be needed (since there's no example of multi-methods prior to this yet...)

[ronaldxs]

Move to "Class and Instance Methods" section after Classes/self.

PR discussion: #1495 (comment)

[zakame]

@ronaldxs I have the change to add header (after Methods and before self,) is that fine? If so, I can commit it directly.

EDIT: mixup 😹

[ronaldxs]

planning to close soon if no objection ...