Merge pull request #3192 from uzluisf/master

Mention that the colon syntax on $.foo method is now supported

Author: JJ

doc/Language/objects.pod6

@@ -449,14 +449,27 @@ will itemize; C<$.a> will be equivalent to C<self.a.item> or C<$(self.a)>.
 
 =begin code
 class A {
+    has Int @.numbers;
     has $.x = (1, 2, 3);
-    method b() { .say for self.x; .say for $.x }
+
+    method show-diff() { .say for self.x; .say for $.x }
+
+    method twice  { self.times: 2 }
+    method thrice { $.times: 3    }
+
+    method times($val = 1) { @!numbers.map(* * $val).list }
 };
-A.new.b; # OUTPUT: «1␤2␤3␤(1 2 3)␤»
+
+my $obj = A.new(numbers => [1, 2, 3]);
+$obj.show-diff;   # OUTPUT: «1␤2␤3␤(1 2 3)␤»
+say $obj.twice;   # OUTPUT: «(2 4 6)␤»
+say $obj.thrice;  # OUTPUT: «(3 6 9)␤»
 =end code
 
-The colon-syntax for method arguments is only supported for method calls
-using C<self>, not the shortcut.
+
+The colon-syntax for method arguments is supported for method calls
+using either C<self> or the shortcut, as illustrated with the methods
+C<twice> and C<thrice> in the example above.
 
 Note that if the relevant methods C<bless>, C<CREATE> of L<Mu|/type/Mu>
 are not overloaded, C<self> will point to the type object in those methods.