Signature.pod tweaks

Author: Mouq

lib/Type/Signature.pod

@@ -149,8 +149,9 @@ as the parameters were declared.
 In the case of named arguments and parameters, only the name is used for
 mapping arguments to parameters
 
+    =for code :allow<L>
     sub named(:$x, :$y) { "x=$x y=$y" }
-    named( y => 5, x => 4);             # x=4 y=5
+    named( y L«=>» 5, x => 4);             # x=4 y=5
 
 It is possible to have a different name for a named parameter than the
 variable name:
@@ -163,28 +164,38 @@ Aliases are also possible that way:
     sub paint( :color(:colour($c)) ) { }    # 'color' and 'colour' are both OK
     sub paint( :color(:$colour) ) { }      # same API for the caller
 
-
 =head2 Optional and Mandatory Parameters
 
-Named parameters are optional by default, and can be made mandatory with a
-trailing exclamation mark:
-
-    :(:$name!)          # mandatory 'name' named parameter
-
 Positional parameters are mandatory by default, and can be made optional
 with a default value or a trailing question mark:
 
+    :(Str $id)          # required parameter
     :($base = 10)       # optional parameter, default value 10
     :(Int $x?)          # optional parameter, default is the Int type object
 
-Named parameters can also have default values.
+Named parameters are optional by default, and can be made mandatory with a
+trailing exclamation mark:
+
+    :(:%config)         # optional parameter
+    :(:$debug = False)  # optional parameter, defaults to False
+    :(:$name!)          # mandatory 'name' named parameter
 
 Default values can depend on previous parameters, and are (at least
 notionally) computed anew for each call
 
     :($goal, $accuracy = $goal / 100);
     :(:$excludes = ['.', '..']);        # a new Array for every call
 
+=head2 Capture Parameters
+
+Prefixing a parameter with a vertical bar C<|> makes the parameter a
+L<C<Capture>>, using up all the remaining positional and named
+arguments.
+
+This is often used in L<C<proto> definitions|proto> (like C<proto foo (|) {*}>)
+to indicate that the routine's L<C<multi> definitions|multi> can have any
+L<type constraints|#Type_Constraints>.
+
 =head2 Parameter Traits and Modifiers
 
 By default, parameters are bound to their argument and marked as
@@ -206,14 +217,6 @@ value of the variable at the caller side
         ($x, $y) = ($y, $x);
     }
 
-To bind either to a value or a variable, one can prefix a parameter with
-a backslash C<\>.
-
-    sub f(\$raw) { ... }
-
-Prefixing a parameter with a vertical bar C<|> makes it use up all the
-remaining positional and named arguments.
-
 =head1 Methods
 
 =head2 method params