Document .Capture method

Spec:        Raku/roast@ca273503b6
Rakudo impl: rakudo/rakudo@cd5864cfc1
             rakudo/rakudo@bad9fefdd7
             rakudo/rakudo@4ba12ff17c

Author: zoffixznet

doc/Type/Blob.pod6

@@ -34,6 +34,15 @@ Returns C<False> if and only if the buffer is empty.
     $blob = Blob.new([1, 2, 3]);
     say $blob.Bool; # OUTPUT: «True␤»
 
+=head2 method Capture
+
+Defined as:
+
+    method Capture(Blob:D --> Capture:D)
+
+Equivalent to calling L«C<.List.Capture>|/type/List#method_Capture»
+on the invocant.
+
 =head2 method elems
 
 Defined as:

doc/Type/Callable.pod6

@@ -40,6 +40,14 @@ container, is has to implement Callable.
     my &a = A;
     say a(); # OUTPUT: «called␤»
 
+=head2 method Capture
+
+Defined as:
+
+    method Capture()
+
+Throws C<X::Cannot::Capture>.
+
 =head2 method assuming
 
     method assuming(Callable:D $self: |primers)

doc/Type/Channel.pod6

@@ -157,6 +157,15 @@ been closed or C<.fail> has already been called on it.
     CATCH { default { put .^name, ': ', .Str } };
     # OUTPUT: «X::AdHoc: Bad error happens!␤»
 
+=head2 method Capture
+
+Defined as:
+
+    method Capture(Channel:D --> Capture:D)
+
+Equivalent to calling L«C<.List.Capture>|/type/List#method_Capture»
+on the invocant.
+
 =head2 method Supply
 
 Defined as:

doc/Type/ComplexStr.pod6

@@ -36,6 +36,14 @@ directly the values can be whatever is required:
     say +$f; # OUTPUT: «42+0i␤»
     say ~$f; # OUTPUT: «"forty two (but complicated)"␤»
 
+=head2 method Capture
+
+Defined as:
+
+    method Capture(ComplexStr:D --> Capture:D)
+
+Equivalent to L«C<Mu.Capture>|/type/Mu#method_Capture».
+
 =head2 method Numeric
 
     method Numeric

doc/Type/Failure.pod6

@@ -108,6 +108,15 @@ Returns C<False>, and marks the failure as handled.
     # OUTPUT: «False␤
     # True␤»
 
+=head2 method Capture
+
+Defined as:
+
+    method Capture()
+
+Throws C<X::Cannot::Capture> if the invocant is a type object or a L<handled>
+L<Failure>. Otherwise, throws the invocant's L<exception>.
+
 =head2 method defined
 
 Defined as:

doc/Type/Int.pod6

@@ -43,6 +43,14 @@ These notations allow you to use variables, too:
 
 =head1 Methods
 
+=head2 method Capture
+
+Defined as:
+
+    method Capture()
+
+Throws C<X::Cannot::Capture>.
+
 =head2 routine chr
 
 Defined as:

doc/Type/Num.pod6

@@ -73,6 +73,14 @@ Seeds the pseudo random number generator used by L<Num.rand|/type/Num#rand> with
 the provided value. Note that C<srand> is called with a platform dependent
 value when a Perl 6 program is started.
 
+=head2 method Capture
+
+Defined as:
+
+    method Capture()
+
+Throws C<X::Cannot::Capture>.
+
 =head2 Int
 
     method Int(Num:D:)

doc/Type/Range.pod6

@@ -228,4 +228,17 @@ results.
     say ('a'..'d').reverse;                           # OUTPUT: «(d c b a)␤»
     say (1..Inf).reverse;                             # OUTPUT: «(Inf Inf Inf ...)␤»
 
+=head2 method Capture
+
+Defined as:
+
+    method Capture(Range --> Capture:D)
+
+Returns a L<Capture> with values of L«C<.min>|/type/Range#method_min»
+L«C<.max>|/type/Range#method_max»,
+L«C<.excludes-min>|/type/Range#method_excludes-min»,
+L«C<.excludes-max>|/type/Range#method_excludes-max»,
+L«C<.infinite>|/type/Range#method_infinite», and
+L«C<.is-int>|/type/Range#method_is-int» as named arguments.
+
 =end pod

doc/Type/RatStr.pod6

@@ -35,6 +35,14 @@ directly the values can be whatever is required:
     say +$f; # OUTPUT: «42.1␤»
     say ~$f; # OUTPUT: «"forty two and a bit"␤»
 
+=head2 method Capture
+
+Defined as:
+
+    method Capture(RatStr:D --> Capture:D)
+
+Equivalent to L«C<Mu.Capture>|/type/Mu#method_Capture».
+
 =head2 method Numeric
 
     method Numeric

doc/Type/Signature.pod6

@@ -768,4 +768,12 @@ be accepted by the C<Signature>.
     :($a, $b) ~~ :($foo, $bar, $baz?);   # RESULT: «True»
     :(Int $n) ~~ :(Str);                 # RESULT: «False»
 
+=head2 method Capture
+
+Defined as:
+
+    method Capture()
+
+Throws C<X::Cannot::Capture>.
+
 =end pod