diff -ur docsrc/src/Manual/VMethods.tt2 docsrc-sm/src/Manual/VMethods.tt2
--- docsrc/src/Manual/VMethods.tt2	Thu Jul 24 18:55:04 2003
+++ docsrc-sm/src/Manual/VMethods.tt2	Sun Feb 12 03:36:25 2006
@@ -286,6 +286,22 @@
 In the example, the 'books' list can contains hash references with 
 an 'author' key or objects with an 'author' method.
 
+=item shuffle
+
+Returns a list of elements of a list shuffled in a random order.
+
+    [% mylist = [ 1, 2, 3, 4, 5 ] %]
+    [% shuffled = mylist.shuffle %]
+
+An argument can be provided to specify desired number of items in
+returned random list.
+
+    [% one_random_item = mylist.shuffle(1).first %]
+    [% three_random_banners = all_banners.shuffle(3) %]
+
+If the argument specified is less than 1 or greater that number of
+items in a list, it is silently ignored.
+
 =item unshift(item), push(item)
 
 Adds an item to the start/end of a list.