Tera TermRevision: 10479
https://osdn.net/projects/ttssh2/scm/svn/commits/10479
Author: zmatsuo
Date: 2023-01-14 00:54:48 +0900 (Sat, 14 Jan 2023)
Log Message:
-----------
Unicode iniファイルについてドキュメントを英訳
typo修正
ticket #46506
Ticket Links:
------------
https://osdn.net/projects/ttssh2/tracker/detail/46506
Modified Paths:
--------------
trunk/doc/en/html/about/qanda.html
trunk/doc/en/html/reference/dev/win32api.html
trunk/doc/ja/html/about/qanda.html
-------------- next part --------------
Modified: trunk/doc/en/html/about/qanda.html
===================================================================
--- trunk/doc/en/html/about/qanda.html 2023-01-12 03:31:19 UTC (rev 10478)
+++ trunk/doc/en/html/about/qanda.html 2023-01-13 15:54:48 UTC (rev 10479)
@@ -162,24 +162,25 @@
<li>A user turns off the "Accept Window Title Change Request" on the General tab of the <a href="../menu/setup-additional.html">[Setup]Additional Setting</a> dialog.</li>
</ul>
-<h2>[Tera Term 5 \x82ɂ\xA2\x82\xC4]</h2>
+<h2>[About Tera Term 5]</h2>
<p>
-<span class="qanda">Q.</span> \x90ݒ\xE8\x83t\x83@\x83C\x83\x8B\x82\xCDTera Term 4\x82Ƌ\xA4\x97L\x82ł\xAB\x82\xE9?<br>
+<span class="qanda">Q.</span> Can the configuration file(TERATERM.INI) be shared with Tera Term 4?<br>
<span class="qanda">A.</span>
-Tera Term 5 \x82\xC5 4 \x82\xCC TERATERM.INI \x82\xF0\x93ǂݍ\x9E\x82ނ\xB1\x82Ƃ͂ł\xAB\x82܂\xB7\x81B
+Tera Term 5 can read TERATERM.INI for Tera Term 4.
-Tera Term 5 \x82\xCD TERATERM.INI \x82\xF0 UTF-16 with LE BOM(\x82\xA2\x82\xED\x82\xE4\x82\xE9UTF-16LE
-BOM)\x82ɕϊ\xB7\x82\xB5\x82܂\xB7\x81B
+Tera Term 5 converts TERATERM.INI to UTF-16 with LE BOM(UTF-16LE BOM).
-ANSI(\x94\xF1Unicode)\x94\xC5API\x82\xF0\x8Eg\x97p\x82\xB5\x82Ă\xA2\x82\xE9 Tera Term 4 \x82ł\xE0 OS \x82\xAA\x95\xB6\x8E\x9A\x83R\x81[\x83h\x82\xF0
-\x95ϊ\xB7\x82\xB5\x82Ă\xAD\x82\xEA\x82邽\x82\xDFUnicode\x94\xC5ini\x83t\x83@\x83C\x83\x8B\x82\xF0\x93ǂݏ\x91\x82\xAB\x82\xB7\x82邱\x82Ƃ\xAA\x82ł\xAB\x82܂\xB7\x81B
-\x82\xBD\x82\xBE\x82\xB5\x81AANSI/Unicode\x82ŕ\xB6\x8E\x9A\x82\xF0\x95ϊ\xB7\x82ł\xAB\x82Ȃ\xA2\x8Fꍇ\x95\xB6\x8E\x9A\x89\xBB\x82\xAF\x82\xAA\x94\xAD\x90\xB6\x82\xB5\x82܂\xB7\x81B
+Tera Term 4 using the ANSI(not Unicode) API can also read/write
+Unicode ini files because the OS converts the character encoding.
-\x82܂\xBD\x81A9x\x8CnOS\x82ɂ͕\xB6\x8E\x9A\x8Eq\x83R\x81[\x83h\x82̕ϊ\xB7\x8B@\x94\\x82\xAA\x82Ȃ\xA2\x82\xBD\x82\xDFUnicode\x94\xC5ini\x83t\x83@\x83C\x83\x8B\x82\xCD
-\x8Eg\x97p\x82ł\xAB\x82܂\xB9\x82\xF1\x81B
+But, if the characters cannot be converted in ANSI/Unicode,
+characters will be breaked.
-<a href="../reference/dev/win32api.html">API \x82̓\xAE\x8D\xEC</a>\x82\xE0\x8EQ\x8Dl\x82ɂ\xB5\x82Ă\xAD\x82\xBE\x82\xB3\x82\xA2\x81B
+And, Windows 9x does not have a character code conversion function in API,
+Unicode version ini files cannot be used.
+
+Please also refer to the <a href="../reference/dev/win32api.html">API behavior</a>.
</p>
</BODY>
Modified: trunk/doc/en/html/reference/dev/win32api.html
===================================================================
--- trunk/doc/en/html/reference/dev/win32api.html 2023-01-12 03:31:19 UTC (rev 10478)
+++ trunk/doc/en/html/reference/dev/win32api.html 2023-01-13 15:54:48 UTC (rev 10479)
@@ -11,31 +11,31 @@
<h1>Win32API</h1>
-Win32API \x82Ɋւ\xB7\x82郁\x83\x82
+Notes on Win32API
-<h2 id="ini_file">ini\x83t\x83@\x83C\x83\x8B</h2>
+<h2 id="ini_file">ini file</h2>
<p>
- Windows 2000(NT3?) \x82\xB2\x82\xEB\x82\xC9 Unicode \x91Ή\x9E\x94\xC5WritePrivateProfileStringW()
- \x93\x99\x82\xAA\x8E\xC0\x91\x95\x82\xB3\x82ꂽ\x82Ǝv\x82\xED\x82\xEA\x82܂\xB7\x81B
+ in Windows 2000(NT3?) Unicode-aware version of
+ WritePrivateProfileStringW()... were implemented.
<p>
- ini\x83t\x83@\x83C\x83\x8B\x82̕\xB6\x8E\x9A\x83R\x81[\x83h\x82\xE2Unicode/ANSI\x82\xF0\x8D\xAC\x8D݂\xB5\x82Ďg\x97p\x82\xB5\x82Ă\xA2\x82\xBD\x8Fꍇ\x82̃h
- \x83L\x83\x85\x83\x81\x83\x93\x83g\x82͌\xA9\x93\x96\x82\xBD\x82\xE7\x82Ȃ\xA2\x82\xBD\x82ߓ\xAE\x8D\xEC\x82\xF0\x82܂Ƃ߂܂\xB5\x82\xBD\x81B\x8Dŋ߂\xCCWindows(\x8F\xAD\x82Ȃ\xAD
- \x82Ƃ\xE0Windows 10,11)\x82ł́AUnicode\x82ɑΉ\x9E\x82\xB7\x82邽\x82ߎ\x9F\x82̂悤\x82ȓ\xAE\x8D\xEC\x82ƂȂ\xC1\x82\xC4
- \x82\xA2\x82܂\xB7\x81B
+ We can't find any document about character encoding of ini files and
+ mixed use of Unicode/ANSI. We have documented the behavior.
+ In recent versions of Windows (at least Windows 10 and 11), the
+ following behavior is used to support Unicode.
<ul>
- <li>\x83t\x83@\x83C\x83\x8B\x82̐擪\x82\xC9UTF-16LE BOM(0xff 0xfe)\x82\xAA\x82\xA2\x82Ă\xA2\x82\xE9\x82Ƃ\xAB\x81Aini\x83t\x83@\x83C\x83\x8B\x82\xCDUnicode\x82̃t\x83@\x83C\x83\x8B\x82Ƃ\xB5\x82Ĉ\xB5\x82\xED\x82\xEA\x82܂\xB7\x81B</li>
- <li>ANSI/Unicode API\x82\xC5Unicode/\x94\xF1Unicode ini\x83t\x83@\x83C\x83\x8B\x82\xF0\x93ǂݏ\x91\x82\xAB\x82\xB5\x82\xBD\x82Ƃ\xAB\x8E\xA9\x93\xAE\x82\xC5ACP/Unicode\x95ϊ\xB7\x82\xAA\x8Ds\x82\xED\x82܂\xB7(9x\x8Cn\x82ł͍s\x82\xED\x82\xEA\x82܂\xB9\x82\xF1)\x81B</li>
+ <li>If the file has a UTF-16LE BOM (0xff 0xfe) at the beginning, the ini file is a Unicode file.</li>
+ <li>When reading/writing Unicode/non-Unicode ini files with the ANSI/Unicode API, ACP/Unicode conversion is automatically performed.(This is not done on Windows 9x).</li>
<ul>
- <li>Unicode ini\x83t\x83@\x83C\x83\x8B\x82̂Ƃ\xAB\x81AUnicode\x82Ƃ\xB5\x82ēǂݏ\x91\x82\xAB\x82\xB5\x82܂\xB7\x81B</li>
- <li>Unicode ini\x83t\x83@\x83C\x83\x8B\x82ł͂Ȃ\xA2\x82Ƃ\xAB\x81A\x93\xFA\x96{\x8C\xEA\x8A\xAB\x82ł\xCDShift_JIS(ACP)\x82Ƃ\xB5\x82ēǂݏ\x91\x82\xAB\x82\xB5\x82܂\xB7\x81B</li>
- <li>\x82\xB1\x82̂\xBD\x82\xDFini\x83t\x83@\x83C\x83\x8B\x82̕\xB6\x8E\x9A\x83R\x81[\x83h\x82ɂ\xE6\x82炸\x93\xA7\x89ߓI\x82\xC9API\x82𗘗p\x82ł\xAB\x82܂\xB7\x81B</li>
- <li>\x94\xF1Unicode ini\x83t\x83@\x83C\x83\x8B\x82\xC9Shift_JIS\x82ŕ\\x8C\xBB\x82ł\xAB\x82Ȃ\xA2Unicode\x95\xB6\x8E\x9A\x82\xF0\x8F\x91\x82\xAB\x8D\x9E\x82ނ\xC6"?"\x82ɒu\x8A\xB7\x82\xB3\x82\xEA\x82ď\x91\x82\xAB\x8D\x9E\x82܂\xEA\x82܂\xB7\x81B</li>
+ <li>If the file is a Unicode ini file, it is read/written as Unicode.</li>
+ <li>If the file is not a Unicode ini file, it reads and writes as Shift_JIS (ACP) in Japanese environment.</li>
+ <li>So possible to use the API transparently regardless of the character encoding of the ini file.</li>
+ <li>If Unicode characters that cannot be represented by ACP are written to a non-Unicode ini file, they are replaced by "?" and written to the file.</li>
</ul>
- <li>Unicode API \x82ōŏ\x89\x82Ƀt\x83@\x83C\x83\x8B\x82\xF0\x8D쐬\x82\xB7\x82\xE9\x82Ƃ\xAB\x81AUnicode ini\x83t\x83@\x83C\x83\x8B\x82ɂȂ\xE8\x82܂\xB9\x82\xF1\x81B</li>
- <li>BOM\x82\xBE\x82\xAF\x82̋\xF3\x83t\x83@\x83C\x83\x8B\x82\xF0\x8D\xEC\x82\xC1\x82Ă\xA9\x82珑\x82\xAB\x8D\x9E\x82ނ\xC6Unicode ini\x83t\x83@\x83C\x83\x8B\x82Ƃ\xB5\x82Ĉ\xB5\x82\xA6\x82܂\xB7\x81B</li>
+ <li>When a file is created with the Unicode API, it will not be a Unicode ini file.</li>
+ <li>When a file is created with only BOM, it will be a Unicode ini file.</li>
</ul>
</html>
Modified: trunk/doc/ja/html/about/qanda.html
===================================================================
--- trunk/doc/ja/html/about/qanda.html 2023-01-12 03:31:19 UTC (rev 10478)
+++ trunk/doc/ja/html/about/qanda.html 2023-01-13 15:54:48 UTC (rev 10479)
@@ -247,8 +247,8 @@
\x95ϊ\xB7\x82\xB5\x82Ă\xAD\x82\xEA\x82邽\x82\xDFUnicode\x94\xC5ini\x83t\x83@\x83C\x83\x8B\x82\xF0\x93ǂݏ\x91\x82\xAB\x82\xB7\x82邱\x82Ƃ\xAA\x82ł\xAB\x82܂\xB7\x81B
\x82\xBD\x82\xBE\x82\xB5\x81AANSI/Unicode\x82ŕ\xB6\x8E\x9A\x82\xF0\x95ϊ\xB7\x82ł\xAB\x82Ȃ\xA2\x8Fꍇ\x95\xB6\x8E\x9A\x89\xBB\x82\xAF\x82\xAA\x94\xAD\x90\xB6\x82\xB5\x82܂\xB7\x81B
-\x82܂\xBD\x81A9x\x8CnOS\x82ɂ͕\xB6\x8E\x9A\x8Eq\x83R\x81[\x83h\x82̕ϊ\xB7\x8B@\x94\\x82\xAA\x82Ȃ\xA2\x82\xBD\x82\xDFUnicode\x94\xC5ini\x83t\x83@\x83C\x83\x8B\x82\xCD
-\x8Eg\x97p\x82ł\xAB\x82܂\xB9\x82\xF1\x81B
+\x82܂\xBD\x81A9x\x8CnOS\x82ɂ\xCCAPI\x82ɂ͕\xB6\x8E\x9A\x83R\x81[\x83h\x82̕ϊ\xB7\x8B@\x94\\x82\xAA\x82Ȃ\xA2\x82\xBD\x82\xDFUnicode\x94\xC5ini\x83t\x83@
+\x83C\x83\x8B\x82͎g\x97p\x82ł\xAB\x82܂\xB9\x82\xF1\x81B
<a href="../reference/dev/win32api.html">API \x82̓\xAE\x8D\xEC</a>\x82\xE0\x8EQ\x8Dl\x82ɂ\xB5\x82Ă\xAD\x82\xBE\x82\xB3\x82\xA2\x81B
</p>