Add an example for Hash.push

Author: ab5tract

lib/Type/Hash.pod

@@ -44,14 +44,14 @@ If an L<Enum> is encountered where a value is expected, it is used as a
 hash value:
 
     my %h = 'a', 'b' => 'c';
-    say %h<a>.WHAT;     # Pair();
-    say %h<a>.key;      # b
+    say %h<a>.WHAT;             # Pair();
+    say %h<a>.key;              # b
 
 If the same key appears more than once, the value associated with its last
 occurrence is stored in the hash:
 
     my %h = a => 1, a => 2;
-    say %h<a>;          # 2
+    say %h<a>;                  # 2
 
 =head1 Looping over hash keys and values
 
@@ -60,7 +60,7 @@ keys and values, for instance,
 
     my %vowels = 'a' => 1, 'e' => 2, 'i' => 3, 'o' => 4, 'u' => 5;
     for %vowels.kv -> $vowel, $index {
-	"$vowel: $index".say;
+	    "$vowel: $index".say;
     }
 
 gives output similar to this:
@@ -82,7 +82,7 @@ list of vowels in alphabetical order then one would write
 
     my %vowels = 'a' => 1, 'e' => 2, 'i' => 3, 'o' => 4, 'u' => 5;
     for %vowels.sort(*.key)>>.kv -> ($vowel, $index) {
-	"$vowel: $index".say;
+	    "$vowel: $index".say;
     }
 
 which prints
@@ -111,13 +111,20 @@ is a C<List>.
 Adds the C<@new> elements to the hash with the same semantics as hash
 assignment, but with three exceptions:
 
-=item the hash isn't emptied first, i.e. old pairs are not deleted.
+=item The hash isn't emptied first, i.e. old pairs are not deleted.
 
-=item if a key already exists in the hash, and the corresponding value is an
+=item If a key already exists in the hash, and the corresponding value is an
 L<Array>, the new value is pushed onto the array (instead of replacing it).
 
-=item if a key already exists in the hash, and the corresponding value is not
+=item If a key already exists in the hash, and the corresponding value is not
 an L<Array>, old and new value are both placed into an array in the place
 of the old value.
 
+Example:
+
+    my %h  = a => 1;
+    %h.push: a => 1;                    # a => [1,1]
+    %h.push: a => [ 1 xx 3 ];           # a => [1,1,1,1,1]
+    %h.push: b => 3;                    # a => [1,1,1,1,1], b => 3
+
 =end pod