improved phpDoc

Author: dg

src/Database/ResultSet.php

@@ -204,7 +204,7 @@ public function fetchAssoc(?string $path = null): ?array
 
 
 	/**
-	 * Returns the next row as an object Row or null if there are no more rows.
+	 * Returns the next row as a Row object or null if there are no more rows.
 	 */
 	public function fetch(): ?Row
 	{
@@ -248,7 +248,9 @@ public function fetchFields(): ?array
 
 
 	/**
-	 * Returns all rows as associative array.
+	 * Returns all rows as associative array, where first argument specifies key column and second value column.
+	 * For duplicate keys, the last value is used. When using null as key, array is indexed from zero.
+	 * Alternatively accepts callback returning value or key-value pairs.
 	 */
 	public function fetchPairs(string|int|\Closure|null $keyOrCallback = null, string|int|null $value = null): array
 	{
@@ -257,7 +259,7 @@ public function fetchPairs(string|int|\Closure|null $keyOrCallback = null, strin
 
 
 	/**
-	 * Returns all rows.
+	 * Returns all remaining rows as array of Row objects.
 	 * @return Row[]
 	 */
 	public function fetchAll(): array

src/Database/Table/Selection.php

@@ -183,7 +183,7 @@ public function get(mixed $key): ?ActiveRow
 
 
 	/**
-	 * Fetches next row of result.
+	 * Returns the next row or null if there are no more rows.
 	 * @return T|null
 	 */
 	public function fetch(): ?ActiveRow
@@ -215,7 +215,9 @@ public function fetchField(?string $column = null): mixed
 
 
 	/**
-	 * Fetches all rows as associative array.
+	 * Returns all rows as associative array, where first argument specifies key column and second value column.
+	 * For duplicate keys, the last value is used. When using null as key, array is indexed from zero.
+	 * Alternatively accepts callback returning value or key-value pairs.
 	 */
 	public function fetchPairs(string|int|\Closure|null $keyOrCallback = null, string|int|null $value = null): array
 	{
@@ -224,7 +226,7 @@ public function fetchPairs(string|int|\Closure|null $keyOrCallback = null, strin
 
 
 	/**
-	 * Fetches all rows.
+	 * Returns all rows.
 	 * @return T[]
 	 */
 	public function fetchAll(): array
@@ -235,6 +237,7 @@ public function fetchAll(): array
 
 	/**
 	 * Returns all rows as associative tree.
+	 * @deprecated
 	 */
 	public function fetchAssoc(string $path): array
 	{