From d8474102aa07f2dd6b853ac062e78a0cfa9d496e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=97=B2=20=E8=80=98?= <hotoo.cn@gmail.com>
Date: Fri, 25 Feb 2022 22:45:34 +0800
Subject: [PATCH] Release 2.11.0

---
 CHANGELOG.md    |  4 ++++
 README.en-US.md | 12 ++++++++++++
 package.json    |  2 +-
 3 files changed, 17 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 88e2c93..6eac203 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,10 @@
 
 ----
 
+## 2.11.0 (2022-02-25)
+
+- feat(surname): 支持姓氏拼音模式，优先处理姓氏读音。 fixed #288
+
 ## 2.10.2 (2021-04-11)
 
 - feat(cli): pinyin cli support group by phrases.
diff --git a/README.en-US.md b/README.en-US.md
index e5b2919..fef1f92 100644
--- a/README.en-US.md
+++ b/README.en-US.md
@@ -122,6 +122,11 @@ wǒ xǐhuān nǐ
 Specify pinyin style. please use static properties like `STYLE_*`.
 default is `.STYLE_TONE`. see Static Property for more.
 
+### `options.mode`
+
+pinyin mode, default is `pinyin.MODE_NORMAL`. If you cleared in surname scene,
+use `pinyin.MODE_SURNAME` maybe better.
+
 ## Static Property
 
 ### `.STYLE_NORMAL`
@@ -162,6 +167,13 @@ First letter style.
 
 Example: `p y`
 
+### `pinyin.MODE_NORMAL`
+
+Normal mode. This is the default mode.
+
+### `pinyin.MODE_SURNAME`
+
+Surname mode. If chinese word is surname, The pinyin of surname is prioritized.
 
 ## Test
 
diff --git a/package.json b/package.json
index d05d436..1abc862 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "pinyin",
-  "version": "2.10.2",
+  "version": "2.11.0",
   "description": "汉语拼音转换工具。",
   "files": [
     "bin",