Update spec for RFC

bp1222 · David Walker · commit e6ffa80d976b · 2017-10-08T08:03:58.000-06:00
diff --git a/spec/10-expressions.md b/spec/10-expressions.md
@@ -2930,7 +2930,9 @@ At least one of the elements of the *list-expression-list* must be non-empty.
 **Semantics**
 
 This intrinsic assigns one or more elements of the source array to the
-target variables. On success, it returns a copy of the source array. If the
+target variables. On success, the target variable will be assigned to the
+corresponding value in the source array.  This can either be a reference
+or a copy of the value depening if `&` preceeds the variable. If the
 source array is not an array or object implementing `ArrayAccess` no
 assignments are performed and the return value is `NULL`.
 
@@ -2980,6 +2982,12 @@ list($arr[1], $arr[0]) = [0, 1];
 list($arr2[], $arr2[]) = [0, 1];
   // $arr2 is [0, 1]
 
+$a = [1, 2];
+list(&$one, $two) = $a;
+  // $a[0] is 1, $a[1] is 2
+$one++;
+  // $a[0] is 2, $a[1] is 2
+
 list("one" => $one, "two" => $two) = ["one" => 1, "two" => 2];
   // $one is 1, $two is 2
 list(
@@ -2990,6 +2998,13 @@ list(
     "two" => 2,
 ];
   // $one is 1, $two is 2
+
+$a = ['one' => 1, 'two' => 2];
+list('one' => &$one, 'two' => $two) = $a;
+  // $a['one'] is 1, $a['two'] is 2
+$one++;
+  // $a['one'] is 2, $a['two'] is 2
+
 list(list("x" => $x1, "y" => $y1), list("x" => $x2, "y" => $y2)) = [
     ["x" => 1, "y" => 2],
     ["x" => 3, "y" => 4]
