From b0bfbd8ec3511bba96e8080f5931c8c7866e3488 Mon Sep 17 00:00:00 2001
From: Looly <loolly@gmail.com>
Date: Tue, 29 Nov 2022 19:37:19 +0800
Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E6=94=B9PhoneUtil=E5=AE=B9=E6=98=93?=
 =?UTF-8?q?=E6=AD=A7=E4=B9=89=E7=9A=84=E6=B3=A8=E9=87=8A?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 CHANGELOG.md                                  |  3 +-
 .../java/cn/hutool/core/util/PhoneUtil.java   | 28 +++++++++----------
 2 files changed, 16 insertions(+), 15 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 457e45951..95de5fe17 100755
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,13 +3,14 @@
 
 -------------------------------------------------------------------------------------------------------------
 
-# 5.8.11.M1 (2022-11-28)
+# 5.8.11.M1 (2022-11-29)
 
 ### 🐣新特性
 * 【core  】      CharUtil.isBlankChar增加\u180e（pr#2738@Github）
 * 【core  】      SyncFinisher线程同步结束器添加立即结束方法（pr#879@Gitee）
 * 【core  】      HtmlUtil中escape方法，增加不断开空格（nbsp）转译，防止xss攻击（pr#2755@Github）
 * 【extra 】      修正sftp.cd方法 方法注释和实际效果不符（issue#2758@Github）
+* 【core  】      修改PhoneUtil容易歧义的注释（issue#I63GWK@Gitee）
 * 
 ### 🐞Bug修复
 * 【json  】      修复普通byte数组转JSONArray时的异常（pr#875@Gitee）
diff --git a/hutool-core/src/main/java/cn/hutool/core/util/PhoneUtil.java b/hutool-core/src/main/java/cn/hutool/core/util/PhoneUtil.java
index f8494c748..5386dc8fe 100755
--- a/hutool-core/src/main/java/cn/hutool/core/util/PhoneUtil.java
+++ b/hutool-core/src/main/java/cn/hutool/core/util/PhoneUtil.java
@@ -18,10 +18,10 @@ import cn.hutool.core.lang.Validator;
 public class PhoneUtil {
 
 	/**
-	 * 验证是否为手机号码（中国）
+	 * 验证是否为手机号码（中国大陆）
 	 *
 	 * @param value 值
-	 * @return 是否为手机号码（中国）
+	 * @return 是否为手机号码（中国大陆）
 	 * @since 5.3.11
 	 */
 	public static boolean isMobile(CharSequence value) {
@@ -29,9 +29,9 @@ public class PhoneUtil {
 	}
 
 	/**
-	 * 验证是否为手机号码（香港）
+	 * 验证是否为手机号码（中国香港）
 	 * @param value 手机号码
-	 * @return 是否为香港手机号码
+	 * @return 是否为中国香港手机号码
 	 * @since 5.6.3
 	 * @author dazer, ourslook
 	 */
@@ -40,9 +40,9 @@ public class PhoneUtil {
 	}
 
 	/**
-	 * 验证是否为手机号码（台湾）
+	 * 验证是否为手机号码（中国台湾）
 	 * @param value 手机号码
-	 * @return 是否为台湾手机号码
+	 * @return 是否为中国台湾手机号码
 	 * @since 5.6.6
 	 * @author ihao
 	 */
@@ -51,9 +51,9 @@ public class PhoneUtil {
 	}
 
 	/**
-	 * 验证是否为手机号码（澳门）
+	 * 验证是否为手机号码（中国澳门）
 	 * @param value 手机号码
-	 * @return 是否为澳门手机号码
+	 * @return 是否为中国澳门手机号码
 	 * @since 5.6.6
 	 * @author ihao
 	 */
@@ -62,10 +62,10 @@ public class PhoneUtil {
 	}
 
 	/**
-	 * 验证是否为座机号码（中国）
+	 * 验证是否为座机号码（中国大陆）
 	 *
 	 * @param value 值
-	 * @return 是否为座机号码（中国）
+	 * @return 是否为座机号码（中国大陆）
 	 * @since 5.3.11
 	 */
 	public static boolean isTel(CharSequence value) {
@@ -73,10 +73,10 @@ public class PhoneUtil {
 	}
 
 	/**
-	 * 验证是否为座机号码（中国）+ 400 + 800
+	 * 验证是否为座机号码（中国大陆）+ 400 + 800
 	 *
 	 * @param value 值
-	 * @return 是否为座机号码（中国）
+	 * @return 是否为座机号码（中国大陆）
 	 * @since 5.6.3
 	 * @author dazer, ourslook
 	 */
@@ -85,10 +85,10 @@ public class PhoneUtil {
 	}
 
 	/**
-	 * 验证是否为座机号码+手机号码（CharUtil中国）+ 400 + 800电话 + 手机号号码（香港）
+	 * 验证是否为座机号码+手机号码（CharUtil中国）+ 400 + 800电话 + 手机号号码（中国香港）
 	 *
 	 * @param value 值
-	 * @return 是否为座机号码+手机号码（中国）+手机号码（香港）+手机号码（台湾）+手机号码（澳门）
+	 * @return 是否为座机号码+手机号码（中国大陆）+手机号码（中国香港）+手机号码（中国台湾）+手机号码（中国澳门）
 	 * @since 5.3.11
 	 */
 	public static boolean isPhone(CharSequence value) {