diff --git a/functions/array.xml b/functions/array.xml
index c3e7d110d5..8fc10be0de 100644
--- a/functions/array.xml
+++ b/functions/array.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.169 $ -->
+<!-- $Revision: 1.170 $ -->
  <reference id="ref.array">
   <title>Array Functions</title>
   <titleabbrev>Arrays</titleabbrev>
@@ -3127,8 +3127,36 @@ d = lemon
      Like <function>array</function>, this is not really a function,
      but a language construct.  <function>list</function> is used to
      assign a list of variables in one operation.
+    </para>
+    <para>
      <example>
-      <title><function>list</function> example</title>
+      <title><function>list</function> examples</title>
+      <programlisting role="php">
+<![CDATA[
+<?php
+
+$info = array('coffee', 'brown', 'caffeine');
+
+// Listing all the variables
+list($drink, $color, $power) = $info;
+print "$drink is $color and $power makes it special.\n";
+
+// Listing some of them
+list($drink, , $power) = $info;
+print "$drink has $power.\n";
+
+// Or let's skip to only the third one
+list( , , $power) = $info;
+print "I need $power!\n";
+
+?>
+]]>
+      </programlisting>
+     </example>
+    </para>
+    <para>
+     <example>
+      <title>An example use of <function>list</function></title>     
       <programlisting role="php">
 <![CDATA[
 <table>
@@ -3155,7 +3183,8 @@ while (list ($id, $name, $salary) = mysql_fetch_row ($result)) {
      </example>
     </para>
     <para>
-     See also <function>each</function> and <function>array</function>.
+     See also <function>each</function>, <function>array</function> 
+     and <function>extract</function>.
     </para>
    </refsect1>
   </refentry>