Merge pull request #2807 from perl6/Enumeration-Int-method

Document Enumeration.Int
Refs #2632. Thanks!

Author: JJ

doc/Type/Enumeration.pod6

@@ -167,6 +167,23 @@ Defined as:
 =for code :preamble<enum Norse-gods <Þor Oðin Freija>;>
 say Oðin.succ;  # OUTPUT: «Freija␤»
 
+=head2 method Int
+
+Defined as:
+
+    multi method Int(::?CLASS:D:)
+
+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' )
+    say cool.Int;                 # OUTPUT: «42␤»
+    say almost-pi.Int;            # OUTPUT: «3␤»
+
+Note that if the value cannot be coerced to C<Int>, an exception will
+be thrown.
+
 =head2 method C<===>
 
 Defined as