Document missing Enumeration methods

Author: Kaiepi

doc/Type/Enumeration.pod6

@@ -122,6 +122,17 @@ Returns it as a C<Pair>.
 =for code :preamble<<enum Mass<g> >>
 say g.pair; # OUTPUT: «g => 1␤»
 
+=head2 method CALL-ME
+
+Defined as:
+
+    multi method CALL-ME(|)
+
+Returns an C<Enumeration> instance given an enum value.
+
+    enum Mass ( mg => 1/1000, g => 1/1, kg => 1000/1 );
+    say Mass(1/1000); # OUTPUT: mg
+
 =head2 method pick
 
 Defined as:
@@ -132,7 +143,7 @@ Defined as:
 
 It works on the defined class, selecting one element and eliminating it.
 
-=for code :preamble<enum Norse-gods <Þor Oðin Freija>;>
+=for code :preamble«enum Norse-gods <Þor Oðin Freija>;»
 say Norse-gods.pick() for ^3;  # OUTPUT: «Þor␤Freija␤Oðin␤»
 
 =head2 method roll
@@ -146,7 +157,7 @@ Defined as:
 They work on the defined class selecting one or C<n> elements without
 eliminating them.
 
-=for code :preamble<enum Norse-gods <Þor Oðin Freija>;>
+=for code :preamble«enum Norse-gods <Þor Oðin Freija>;»
 say Norse-gods.roll() for ^3;  # OUTPUT: «Freija␤Freija␤Oðin␤»
 
 =head2 method pred
@@ -155,7 +166,7 @@ Defined as:
 
     method pred(::?CLASS:D:)
 
-=for code :preamble<enum Norse-gods <Þor Oðin Freija>;>
+=for code :preamble«enum Norse-gods <Þor Oðin Freija>;»
 say Freija.pred;  # OUTPUT: «Oðin␤»
 
 =head2 method succ
@@ -164,9 +175,25 @@ Defined as:
 
     method succ(::?CLASS:D:)
 
-=for code :preamble<enum Norse-gods <Þor Oðin Freija>;>
+=for code :preamble«enum Norse-gods <Þor Oðin Freija>;»
 say Oðin.succ;  # OUTPUT: «Freija␤»
 
+=head2 method Numeric
+
+Defined as:
+
+    multi method Numeric(::?CLASS:D:)
+
+Takes a value of an enum and returns it after coercion to C<Numeric>:
+
+    enum Numbers ( cool => '42', almost-pi => '3.14', sqrt-n-one => 'i' );
+    say cool.Numeric;       # OUTPUT: «42␤»
+    say almost-pi.Numeric;  # OUTPUT: «3.14␤»
+    say sqrt-n-one.Numeric; # OUTPUT: «0+1i␤»
+
+Note that if the value cannot be coerced to C<Numeric>, an exception
+will be thrown.
+
 =head2 method Int
 
 Defined as:
@@ -175,16 +202,30 @@ Defined as:
 
 Takes a value of an enum and returns it after coercion to C<Int>:
 
-    enum Numbers <One Two Three>;
-    say Two.Int;                  # OUTPUT: «1␤»
+    enum Numbers ( cool => '42', almost-pi => '3.14', sqrt-n-one => 'i' );
+    say cool.Int;           # OUTPUT: «42␤»
+    say almost-pi.Int;      # OUTPUT: «3␤»
+    try say sqrt-n-one.Int;
+    say $!.message if $!;   # OUTPUT: «Cannot convert 0+1i to Int: imaginary part not zero␤»
 
-Or
+Note that if the value cannot be coerced to C<Int>, an exception will
+be thrown.
 
-    enum Numbers ( cool => '42', almost-pi => '3' );
-    say cool.Int;                 # OUTPUT: «42␤»
-    say almost-pi.Int;            # OUTPUT: «3␤»
+=head2 method Real
 
-Note that if the value cannot be coerced to C<Int>, an exception will
+Defined as:
+
+    multi method Real(::?CLASS:D:)
+
+Takes a value of an enum and returns it after coercion to C<Real>:
+
+    enum Numbers ( cool => '42', almost-pi => '3.14', sqrt-n-one => 'i' );
+    say cool.Real;           # OUTPUT: «42␤»
+    say almost-pi.Real;      # OUTPUT: «3.14␤»
+    try say sqrt-n-one.Real;
+    say $!.message if $!;    # OUTPUT: «Cannot convert 0+1i to Real: imaginary part not zero␤»
+
+Note that if the value cannot be coerced to C<Real>, an exception will
 be thrown.
 
 =head2 method C<===>
@@ -195,7 +236,7 @@ Defined as
 
 Equality of C<Enumeration> symbols:
 
-=for code :preamble< enum Norse-gods <Þor Oðin Freija>;>
+=for code :preamble«enum Norse-gods <Þor Oðin Freija>;»
 say Norse-gods.pick() === Freija for ^3; # OUTPUT: «False␤False␤True␤»