[skip ci] Update stub api documentation

Author: TysonAndre

ext/spl/spl_deque.stub.php

@@ -3,10 +3,14 @@
 /** @generate-class-entries */
 
 /**
- * A double-ended queue represented internally as a circular buffer.
+ * A double-ended queue (Typically abbreviated as Deque, pronounced "deck", like "cheque")
+ * represented internally as a circular buffer.
+ *
  * This has much lower memory usage than SplDoublyLinkedList or its subclasses (SplStack, SplStack),
  * and operations are significantly faster than SplDoublyLinkedList.
  *
+ * See https://en.wikipedia.org/wiki/Double-ended_queue
+ *
  * This supports amortized constant time pushing and popping onto the front or back of the array.
  *
  * Naming is based on https://www.php.net/spldoublylinkedlist
@@ -44,9 +48,15 @@ public static function __set_state(array $array): Deque {}
     public function push(mixed $value): void {}
     /** Prepends a value to the start of the Deque. */
     public function unshift(mixed $value): void {}
-    /** Pops a value from the end of the Deque. */
+    /**
+     * Pops a value from the end of the Deque.
+     * @throws UnderflowException if the Deque is empty
+     */
     public function pop(): mixed {}
-    /** Shifts a value from the front of the Deque. */
+    /**
+     * Shifts a value from the front of the Deque.
+     * @throws UnderflowException if the Deque is empty
+     */
     public function shift(): mixed {}
 
     /** Peeks at the value at the start of the Deque, throws if empty */
@@ -57,13 +67,35 @@ public function top(): mixed {}
     /** Returns a list of the elements from front to back. */
     public function toArray(): array {}
     /* Get and set are strictly typed, unlike offsetGet/offsetSet. */
+    /**
+     * Returns the value at offset $offset (relative to the start of the Deque)
+     * @throws OutOfBoundsException if the value of (int)$offset is not within the bounds of this vector
+     */
     public function get(int $offset): mixed {}
+    /**
+     * Sets the value at offset $offset (relative to the start of the Deque) to $value
+     * @throws OutOfBoundsException if the value of (int)$offset is not within the bounds of this vector
+     */
     public function set(int $offset, mixed $value): void {}
     // Must be mixed for compatibility with ArrayAccess
+    /**
+     * Returns the value at offset (int)$offset (relative to the start of the Deque)
+     * @throws OutOfBoundsException if the value of (int)$offset is not within the bounds of this vector
+     */
     public function offsetGet(mixed $offset): mixed {}
+    /**
+     * Returns true if `0 <= (int)$offset && (int)$offset < $this->count().
+     */
     public function offsetExists(mixed $offset): bool {}
+    /**
+     * Sets the value at offset $offset (relative to the start of the Deque) to $value
+     * @throws OutOfBoundsException if the value of (int)$offset is not within the bounds of this vector
+     */
     public function offsetSet(mixed $offset, mixed $value): void {}
     /** Throws unconditionally */
+    /**
+     * @throws RuntimeException unconditionally because unset and null are different things, unlike SplFixedArray
+     */
     public function offsetUnset(mixed $offset): void {}
 
     /** This is JSON serialized as a JSON array with elements from front to back */

ext/spl/spl_deque_arginfo.h

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