Revert "Fix/Expand Array.append docs"

This reverts commit 00a904f.

It's a rogue commit. The disicion for change was abandoned.

Author: zoffixznet

doc/Type/Array.pod6

@@ -77,25 +77,22 @@ Defined as
 sub append(\array, elems)
 =end code
     multi method append(Array:D: \values)
-    multi method append(Array:D: *@values is raw)
+    multi method append(Array:D: **@values is raw)
 
-Appends the argument list to the invocant (or to the first argument, in sub
-form). This modifies the array in-place and returns it as well.
-Throws for lazy arrays.
-
-The difference from L<push> is that C<append> will L<flatten|/routine/flat>
-all the L<Iterables|/type/Iterable> in the argument list:
+Appends the argument list to the array passed as the first argument.  This
+modifies the array in-place.  Returns the modified array. Throws for lazy arrays.
 
-    my @array;
-    my @source1 = <a b c>;
-    my @source2 = <d e f>;
-    my %source3 = :42a, :72b;
+The difference from method C<push> is that with an array or list argument,
+C<append> appends several elements (one for each array or list element),
+whereas C<push> appends just one element.
 
-    say @array.append: @source1;           # OUTPUT: «[a b c]␤»
-    say @array;                            # OUTPUT: «[a b c]␤»
+Example:
 
-    say @array.append: @source2, %source3; # OUTPUT: «[a b c d e f a => 42 b => 72]␤»
-    say @array;                            # OUTPUT: «[a b c d e f a => 42 b => 72]␤»
+    my @a = <a b c>;
+    my @b = <d e f>;
+    @a.append: @b;
+    say @a.elems;               # OUTPUT: «6␤»
+    say @a;                     # OUTPUT: «[a b c d e f]␤»
 
 =head2 method elems