Merge pull request #307 from TeraTermProject/274-unicode__doc

274 unicode doc
TeraTermProject · Sep 5, 2024 · f9e55b4 · f9e55b4
2 parents 1937754 + 1295e62
commit f9e55b4
Show file tree

Hide file tree

Showing 4 changed files with 79 additions and 33 deletions.
diff --git a/doc/en/html/usage/unicode.html b/doc/en/html/usage/unicode.html
@@ -9,28 +9,53 @@
 </HEAD>
 <BODY>
 
-<h1>Unicode</h1>
+<h1>Unicode Settings</h1>
 
-<p>
-To use UTF-8, changed from English to "UTF-8" or "Japanese" or "Korean" under Setup-&gt;General menu.<br>
+<a href="../menu/setup-additional-coding.html">Additional settings / "coding" tab</a> for setting character encoding.
+To use UTF-8, select the following character encoding.
+
+<dl>
+  <dt>Chinese/UTF-8<br>
+    Japanese/UTF-8<br>
+    Korean/UTF-8</dt>
+  <dd>
+    Select UTF-8.<br>
+    By default, Ambiguous Characters width is 2 and Emoji Characters width is 2 for <a href="../about/glossary.html#CJK">CJK</a>.
+  </dd>
+
+  <dt>UTF-8</dt>
+  <dd>
+    Select UTF-8.<br>
+    By default, Ambiguous Characters width is 1 and Emoji Characters width is 1.
+  <dd>
+</dl>
+
+<h2>TTXKanjiMenu plug-in</h2>
+
+TTXKanjiMenu plug-in is available only for the following character encodings.
+It is not displayed for other character codes.
 
-<p>
-When the Language "UTF-8" is selected, below function can not be used beside Japanese setting.
-</p>
 <ul>
-  <li>The JIS, EUC and SJIS character code except for UTF-8</li>
-  <li>Specifying Japanese character set of ISO/IEC 2022</li>
-  <li>TTXKanjiMenu plug-in</li>
+  <li>"Japanese/UTF-8"</li>
+  <li>"Japanese/SJIS (CP932)"</li>
+  <li>"Japanese/JIS"</li>
+  <li>"Japanese/EUC"</li>
+  <li>"Korean/KS5601 (CP949)"</li>
+  <li>"Korean/UTF-8"</li>
 </ul>
 
+<h2>Language</h2>
+
+String from the beginning of the character code to "/" (eg. "Japanese") corresponds to "Language"
+that was existed in "Setup" menu - "General" dialog In Tera Term 5.2 or earlier.
+
 <p>
-If you set the Language "Japanese" or "Korean", select "Terminal" from the Tera Term "Setup" menu. Inside the dialog-box,
-select "UTF-8" from "Kanji(receive)" or "Kanji(transmit)".
-There is no need to restart Tera Term to activate these configuration changes.<br>
+  Tera Term has a restriction that sending and receiving character codes must be selected same language.
+
+<h2>command line</h2>
 
 When "UTF8" is specified with '/KT' or '/KR' option in the command line,
 UTF-8 encoding/decoding can be used during transmitting and receiving of data.
-</p>
 
 </BODY>
 </HTML>
diff --git a/doc/ja/html/usage/unicode.html b/doc/ja/html/usage/unicode.html
@@ -11,30 +11,51 @@
 
 <h1>Unicode設定</h1>
 
-<p>
-UTF-8化を行うには、Tera Termの「Setup[設定]」メニューから「General[全般]」
-を選び、「Language[言語]」を "UTF-8", "Japanese" および "Korean"
-のいずれかへ変更します。
-</p>
+<a href="../menu/setup-additional-coding.html">Additional settings / "coding" タブ</a>で文字コードの設定を行います。<br>
+UTF-8 を使用する場合は次の文字コードを選んでください。
+
+<dl>
+  <dt>Chinese/UTF-8<br>
+    Japanese/UTF-8<br>
+    Korean/UTF-8</dt>
+  <dd>
+    UTF-8を使用します。<br>
+    <a href="../about/glossary.html#CJK">CJK</a>環境に合わせて、
+    デフォルトで Ambiguous Characters width は 2、Emoji Characters width は 2 となります。
+  </dd>
+
+  <dt>UTF-8</dt>
+  <dd>
+    UTF-8を使用します。<br>
+    デフォルトで Ambiguous Characters width は 1、Emoji Characters width は 1 となります。
+  <dd>
+</dl>
+
+<h2>TTXKanjiMenuプラグイン</h2>
+
+次の文字コードの時のみ使用できます。他の文字コードの時は表示されません。
 
-<p>
-Language 設定が UTF-8 の時は Japanese に比べて以下の機能を使わなく(使えなく)なります。
-</p>
 <ul>
-  <li>JIS, EUC, SJIS 等の UTF-8 以外の文字コード</li>
-  <li>ISO/IEC 2022での日本語文字セットの指示</li>
-  <li>TTXKanjiMenu プラグイン</li>
+  <li>"Japanese/UTF-8"</li>
+  <li>"Japanese/SJIS (CP932)"</li>
+  <li>"Japanese/JIS"</li>
+  <li>"Japanese/EUC"</li>
+  <li>"Korean/KS5601 (CP949)"</li>
+  <li>"Korean/UTF-8"</li>
 </ul>
 
+<h2>Language</h2>
+
+各文字コード文字列の先頭から"/"の文字(例 "Japanese")が、Tera Term 5.2 まで存在していた
+「Setup[設定]」メニュー「General[全般]」の「Language[言語]」相当になります。
+
 <p>
-Languageに "Japanese" と "Korean" のいずれかを選んだ場合、次に「Setup[全般]」
-メニューから「Terminal[端末]」を選択すると出る "Terminal setup[端末の設定]"
-ダイアログの「Kanji(receive)[漢字-受信]」および「Kanji(transmit)[漢字-送信]」
-にて、"UTF-8" を選んでください。Tera Termの再起動は必要ありません。<br>
+  Tera Term には、送信文字と受信文字コードは同一の言語から選択しなければならない制限があります。
+
+<h2>コマンドライン</h2>
 
 コマンドラインの「/KT」および「/KR」オプションにおいて、"UTF8" を指定すると、
 送信および受信コードに UTF-8 を設定することができます。
-</p>
 
 </BODY>
 </HTML>
diff --git a/teraterm/common/ttlib_charset.cpp b/teraterm/common/ttlib_charset.cpp
@@ -70,9 +70,9 @@ static const TKanjiList KanjiList[] = {
 	{ IdRussian,	IdISO,				"Russian/ISO 8859-5",		"ISO8859-5" },
 	{ IdKorean,		IdKoreanCP949,		"Korean/KS5601 (CP949)",	"KS5601" },
 	{ IdKorean,		IdUTF8,				"Korean/UTF-8",				"UTF-8" },
-	{ IdChinese,	IdCnGB2312,			"China/GB2312 (CP936)",		"GB2312" },
-	{ IdChinese,	IdCnBig5,			"China/Big5 (CP950)",		"BIG5" },
-	{ IdChinese,	IdUTF8,				"China/UTF-8",				"UTF-8" },
+	{ IdChinese,	IdCnGB2312,			"Chinese/GB2312 (CP936)",	"GB2312" },
+	{ IdChinese,	IdCnBig5,			"Chinese/Big5 (CP950)",		"BIG5" },
+	{ IdChinese,	IdUTF8,				"Chinese/UTF-8",			"UTF-8" },
 };
 
 const TLanguageList *GetLanguageList(int index)

diff --git a/teraterm/common/tttypes_charset.h b/teraterm/common/tttypes_charset.h
@@ -81,7 +81,7 @@ typedef enum {
 #define	IdKoreanCP949 1		// CP949, KS5601
 
 // ts.Language == IdChinese
-// China
+// Chinese
 #define	IdCnGB2312		1	// 1 CP936, GB2312
 #define	IdCnBig5		2	// 2 CP950, Big5