Document item

Author: titsuki

doc/Type/Any.pod6

@@ -239,6 +239,27 @@ Exits the current process with return code C<$status>.
 
 =comment TODO maybe find a better place to document &exit
 
+=head2 sub item
+
+X<|$ (item contextualizer)>
+
+Defined as:
+
+    proto sub item(|) is pure
+    multi sub item(\x)
+    multi sub item(|c)
+    multi sub item(Mu $a)
+
+Forces given object to be evaluated in item context and returns the value of it.
+
+    dd item([1,2,3]);              # $[1, 2, 3]
+    dd item({ apple => 10 });      # ${:apple(10)}
+    dd item("abc");                # "abc"
+
+You can also use C<$> as item contextualizer.
+
+    say $[1,2,3] ~~ item([1,2,3]); # True
+
 =end pod
 
 # vim: expandtab shiftwidth=4 ft=perl6

doc/Type/Mu.pod6

@@ -122,6 +122,16 @@ be re-evaluated with L<EVAL|/routine/EVAL> to regenerate the object). The exact
 C<perl> is implementation specific, since there are generally many ways to
 write a Perl expression that produces a particular value
 
+=head2 method item
+
+    method item(Mu \item:) is raw
+
+Forces the invocant to be evaluated in item context and returns the value of it.
+
+    dd [1,2,3].item;         # $[1, 2, 3]
+    dd { apple => 10 }.item; # ${:apple(10)}
+    dd "abc".item;           # "abc"
+
 =head2 method clone
 
     method clone(*%twiddles)