From cc43f8e67600fc3ad73ea3ac095d67f166c5ca96 Mon Sep 17 00:00:00 2001
From: Ryan Cramer <ryan@processwire.com>
Date: Fri, 6 Jan 2023 13:22:30 -0500
Subject: [PATCH] Bump version to 3.0.210, plus some minor documentation
 updates

---
 wire/core/InputfieldWrapper.php                          | 2 +-
 wire/core/ProcessWire.php                                | 4 ++--
 wire/core/Sanitizer.php                                  | 2 +-
 wire/core/WireDatabasePDO.php                            | 6 +++---
 .../modules/Fieldtype/FieldtypeRepeater/RepeaterPage.php | 9 ++++++++-
 5 files changed, 15 insertions(+), 8 deletions(-)

diff --git a/wire/core/InputfieldWrapper.php b/wire/core/InputfieldWrapper.php
index 7bdf9675..bbd7cf1a 100644
--- a/wire/core/InputfieldWrapper.php
+++ b/wire/core/InputfieldWrapper.php
@@ -1361,7 +1361,7 @@ class InputfieldWrapper extends Inputfield implements \Countable, \IteratorAggre
 	 * 
 	 * #pw-group-errors
 	 * 
-	 * @return Inputfield[]
+	 * @return array|Inputfield[] Array of Inputfield objects indexed by Inputfield name attribute
 	 * @since 3.0.205
 	 * 
 	 */
diff --git a/wire/core/ProcessWire.php b/wire/core/ProcessWire.php
index 692a73b8..6b36fb14 100644
--- a/wire/core/ProcessWire.php
+++ b/wire/core/ProcessWire.php
@@ -79,13 +79,13 @@ class ProcessWire extends Wire {
 	 * Reversion revision number
 	 * 
 	 */
-	const versionRevision = 209;
+	const versionRevision = 210;
 
 	/**
 	 * Version suffix string (when applicable)
 	 * 
 	 */
-	const versionSuffix = 'dev';
+	const versionSuffix = '';
 
 	/**
 	 * Minimum required index.php version, represented by the PROCESSWIRE define
diff --git a/wire/core/Sanitizer.php b/wire/core/Sanitizer.php
index d8419f80..98c9faad 100644
--- a/wire/core/Sanitizer.php
+++ b/wire/core/Sanitizer.php
@@ -1293,7 +1293,7 @@ class Sanitizer extends Wire {
 	 * @param string $value Email address to sanitize and validate.
 	 * @param array $options All options require 3.0.208+
 	 *  - `allowIDN` (bool|int): Allow internationalized domain names? (default=false)
-	 *     Specify int 2 to also allow UTF-8 in local-part of email [SMTPUTF8] (i.e. "bøb" in "bøb@email.com")
+	 *     Specify int 2 to also allow UTF-8 in local-part of email [SMTPUTF8] (i.e. `bøb`).
 	 *  - `getASCII` (bool): Returns ASCII encoded version of email when host is IDN (default=false)
 	 *     Does not require the allowIDN option since returned email host will be only ASCII.
 	 *     Not meant to be combined with allowIDN=2 option since local-part of email does not ASCII encode.
diff --git a/wire/core/WireDatabasePDO.php b/wire/core/WireDatabasePDO.php
index afa158d6..0664debe 100644
--- a/wire/core/WireDatabasePDO.php
+++ b/wire/core/WireDatabasePDO.php
@@ -981,7 +981,7 @@ class WireDatabasePDO extends Wire implements WireDatabase {
 	 * 
 	 */
 	public function queryLog($sql = '', $note = '') {
-		if(empty($sql)) return $this->queryLog;
+		if($sql === '') return $this->queryLog;
 		if($sql === true) {
 			$this->debugMode = true; 
 			$this->queryLog = array();
@@ -1309,7 +1309,7 @@ class WireDatabasePDO extends Wire implements WireDatabase {
 	 * @param array $columns Associative array with one or more of `[ 'old_name' => 'new_name' ]`
 	 * @return int Number of columns renamed
 	 * @since 3.0.185
-	 * @throws \PDOException|WireException
+	 * @throws \PDOException
 	 * 
 	 */
 	public function renameColumns($table, array $columns) {
@@ -1352,7 +1352,7 @@ class WireDatabasePDO extends Wire implements WireDatabase {
 	 * @param string $oldName
 	 * @param string $newName
 	 * @return bool
-	 * @throws \PDOException|WireException
+	 * @throws \PDOException
 	 * @since 3.0.185
 	 * 
 	 */
diff --git a/wire/modules/Fieldtype/FieldtypeRepeater/RepeaterPage.php b/wire/modules/Fieldtype/FieldtypeRepeater/RepeaterPage.php
index 47245313..aacbb397 100644
--- a/wire/modules/Fieldtype/FieldtypeRepeater/RepeaterPage.php
+++ b/wire/modules/Fieldtype/FieldtypeRepeater/RepeaterPage.php
@@ -3,8 +3,10 @@
 /**
  * RepeaterPage represents an individual repeater page item
  *
- * ProcessWire 3.x, Copyright 2021 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2023 by Ryan Cramer
  * https://processwire.com
+ * 
+ * @property-read int $depth
  *
  */
 
@@ -226,6 +228,11 @@ class RepeaterPage extends Page {
 		$this->depth = $depth;
 	}
 
+	/* @todo
+	public function depthParent() { }
+	public function depthChildren() { }
+	 */ 
+
 	/**
 	 * Is this page public?
 	 *