diff --git a/reference/array/functions/list.xml b/reference/array/functions/list.xml
index 1a7eb014bc..f3042c806e 100644
--- a/reference/array/functions/list.xml
+++ b/reference/array/functions/list.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.19 $ -->
+<!-- $Revision: 1.20 $ -->
 <refentry xml:id="function.list" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>list</refname>
@@ -98,6 +98,29 @@ while (list($id, $name, $salary) = mysql_fetch_row($result)) {
     </programlisting>
    </example>
   </para>
+  <para>
+   <example>
+    <title>Using nested <function>list</function></title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+
+list($a, list($b, $c)) = array(1, array(2, 3));
+
+var_dump($a, $b, $c);
+
+?>
+]]>
+    </programlisting>
+    <screen>
+<![CDATA[
+int(1)
+int(2)
+int(3)
+]]>
+    </screen>
+   </example>
+  </para>
   <para>
    <example>
     <title>Using <function>list</function> with array indices</title>