From 9b7b38f3f9edd2e266e593f24efbe065f5009807 Mon Sep 17 00:00:00 2001
From: Him188 <Him188@mamoe.net>
Date: Sat, 16 Nov 2019 00:45:36 +0800
Subject: [PATCH] Clarify docs

---
 .../kotlin/net.mamoe.mirai/contact/Contact.kt | 28 +++++++++++++------
 1 file changed, 19 insertions(+), 9 deletions(-)

diff --git a/mirai-core/src/commonMain/kotlin/net.mamoe.mirai/contact/Contact.kt b/mirai-core/src/commonMain/kotlin/net.mamoe.mirai/contact/Contact.kt
index 1f4c9cbbd..28ad4c726 100644
--- a/mirai-core/src/commonMain/kotlin/net.mamoe.mirai/contact/Contact.kt
+++ b/mirai-core/src/commonMain/kotlin/net.mamoe.mirai/contact/Contact.kt
@@ -137,14 +137,7 @@ open class QQ internal constructor(bot: Bot, id: UInt) : Contact(bot, id) {
 
     /**
      * 更新个人资料.
-     *
-     * 这个方法会尽可能更新已有的 [Profile] 对象的值, 而不是用新的对象替换
-     * 若 [QQ.profile] 已经初始化, 则在获取到新的 profile 时通过 [Profile.copyFrom] 来更新已有的 [QQ.profile]. 仍然返回 [QQ.profile]
-     * 因此, 对于以下代码:
-     * ```kotlin
-     * val old = qq.profile
-     * qq.updateProfile() === old // true, 因为只是更新了 qq.profile 的值
-     * ```
+     * 将会同步更新 property [profile]
      */
     suspend fun updateProfile(): Profile = bot.withSession {
         _profile = RequestProfileDetailsPacket(bot.qqAccount, id, sessionKey)
@@ -205,7 +198,24 @@ data class Profile(
     val homepage: String?,
     val email: String?,
     val company: String?
-)
+) {
+
+    override fun toString(): String = "Profile(qq=$qq, " +
+            "nickname=$nickname, " +
+            "gender=$gender, " +
+            (englishName?.plus("englishName=$englishName, ") ?: "") +
+            (chineseName?.plus("chineseName=$chineseName, ") ?: "") +
+            (qAge?.toString()?.plus("qAge=$qAge, ") ?: "") +
+            (zipCode?.plus("zipCode=$zipCode, ") ?: "") +
+            (phone?.plus("phone=$phone, ") ?: "") +
+            (birthday?.toString()?.plus("birthday=$birthday, ") ?: "") +
+            (personalStatement?.plus("personalStatement=$personalStatement, ") ?: "") +
+            (school?.plus("school=$school, ") ?: "") +
+            (homepage?.plus("homepage=$homepage, ") ?: "") +
+            (email?.plus("email=$email, ") ?: "") +
+            (company?.plus("company=$company?,") ?: "") +
+            ")"// 最终会是 ", )", 但这并不影响什么.
+}
 
 /**
  * 性别