[skip ci] Update wording

Author: TysonAndre

ext/spl/spl_deque.stub.php

@@ -21,15 +21,14 @@ final class Deque implements IteratorAggregate, Countable, JsonSerializable, Arr
     /** Construct the Deque from the values of the Traversable/array, ignoring keys */
     public function __construct(iterable $iterator = []) {}
     /**
-     * The final version of getIterator will iterate over a copy of the Deque's values taken at the time getIterator was called.
-     * The iteration keys will be the offsets of the copy(0, 1, ...), and the values will be the values from front to back.
-     *
-     * i.e. `foreach($deque as $k => $v)` and `foreach($deque->toArray() as $k => $v)` will iterate over the same elements.
-     *
-     * This will be done to avoid surprises in case pushFront/popFront/clear are called.
-     *
-     * To access the current version of the Deque without making a copy,
-     * use `for ($i = 0; $i < count($deque); $i++) { process($deque[$i]); }`.
+     * Returns an iterator that accounts for calls to shift/unshift tracking the position of the front of the Deque.
+     * Calls to shift/unshift will do the following:
+     * - Increase/Decrease the value returned by the iterator's key()
+     *   by the number of elements added/removed to/from the front of the Deque.
+     *   (`$deque[$iteratorKey] === $iteratorValue` at the time the key and value are returned).
+     * - Repeated calls to shift will cause valid() to return false if the iterator's
+     *   position ends up before the start of the Deque at the time iteration resumes.
+     * - They will not cause the remaining values to be iterated over more than once or skipped.
      */
     public function getIterator(): InternalIterator {}
     /** Returns the number of elements in the Deque. */

ext/spl/spl_deque_arginfo.h

@@ -1,5 +1,5 @@
 /* This is a generated file, edit the .stub.php file instead.
- * Stub hash: 49a35ccd63900ec4e1bcb992357d1d3a211f999e */
+ * Stub hash: 1e1fc67dd37c51352430e9ea9f4385a3e10b971e */
 
 ZEND_BEGIN_ARG_INFO_EX(arginfo_class_Deque___construct, 0, 0, 0)
 	ZEND_ARG_TYPE_INFO_WITH_DEFAULT_VALUE(0, iterator, IS_ITERABLE, 0, "[]")