update

TeraTermProject · Jun 1, 2024 · 02d5399 · 02d5399
1 parent fe417d1
commit 02d5399
Show file tree

Hide file tree

Showing 20 changed files with 228 additions and 133 deletions.
diff --git a/manual/5/en/about/ctrlseq.html b/manual/5/en/about/ctrlseq.html
@@ -755,10 +755,10 @@ <h3 id="decmode">Modes (DEC/xterm specific)</h3>
 	<td> Clear screen, switch to normal screen buffer, and restore cursor position. </td>
     </tr>
     <tr>
-	<td> 2004 </td>
+	<td id="Bracketed"> 2004 </td>
 	<td> RL_BRACKET </td>
-	<td> <a href="../usage/tips/vim.html#Bracketed">Enables Bracketed paste mode</a>. </td>
-	<td> <a href="../usage/tips/vim.html#Bracketed">Disables Bracketed paste mode</a>. </td>
+	<td> Enables <a href="../about/glossary.html#Bracketed">Bracketed paste mode</a>. </td>
+	<td> Disables Bracketed paste mode. </td>
     </tr>
     <tr>
 	<td> 7727 </td>

diff --git a/manual/5/en/about/glossary.html b/manual/5/en/about/glossary.html
@@ -98,6 +98,30 @@ <h1>Glossary</h1>
 
 </dl>
 
+<h2>Control Sequence</h2>
+
+About Control Sequence.
+
+<dl>
+<dt id="Bracketed">Bracketed Paste Mode</dt>
+<dd>
+  The bracketed paste mode is the xterm extension feature. When this feature is enabled, the pasted text is bracketed with control sequences.<br>
+  Specifically, it is enabled by <a href="../about/ctrlseq.html#Bracketed">DECSET 2004(&lt;CSI&gt;?2004h)</a> sequence, the program will receive: ESC [ 200 ~, followed by the pasted text, followed by ESC [ 201 ~.<br>
+  Bracketed paste is a mode which allows programs running in the terminal such as sh to treat pasted text differently from text typed normally.<br>
+
+  For example, a pasted characters can be treated as undecided, highlighted, and confirmed by pressing the Enter key, etc.
+On the other hand, when pasted characters is overwritten again to remove the highlight, it will be recorded twice in the log.<br>
+  <br>
+  Related Pages
+  <ul>
+    <li><a href="../usage/tips/vim.html#Bracketed">Vim Control Sequence Examples / Auto indent can be disabled on pasting from clipboard</a>
+    <li><a href="../setup/teraterm-misc.html#BracketedSupport">Tera Term setup file / Miscellaneous / Supports bracketed paste</a>
+    <li><a href="../setup/teraterm-misc.html#BracketedControlOnly">Tera Term setup file / Miscellaneous / Limit bracketed pasting to cases containing control characters</a>
+
+  </ul>
+</dd>
+</dl>
+
 <h2>Charactor code</h2>
 
 Glossary related to character codes.
@@ -108,7 +132,7 @@ <h2>Charactor code</h2>
   <dd>
     <p>
       Languages with a writing system that includes Kanji characters.
-      CJK(CJKV) = Chinese, Japanese, Korean, (Vietnamese)B
+      CJK(CJKV) = Chinese, Japanese, Korean, (Vietnamese).
     </p>
 
     <p>

diff --git a/manual/5/en/about/history.html b/manual/5/en/about/history.html
@@ -43,7 +43,8 @@ <h3 id="teraterm_5.3">YYYY.MM.DD (Ver 5.3 not released yet)</h3>
       <li>allow users to select creating automatic backup or not by <a href="../setup/teraterm-misc.html#IniAutoBackup">IniAutoBackup</a> when overwriting the ini file.
       <li><a href="../setup/teraterm-win.html#space">VTFontSpace</a> can be used to adjust to narrow the space between characters.
       <li>Fixed some Emoji which character widths did not change with Override Emoji Characters width option. (Changed referenced Emoji table.)</li>
-      <li>Disabled COM ports are not included when making list of COM ports.</li>
+      <li>Only available COM ports are listed.<br>
+        COM ports that are disabled and failed to initialize are not included.</li>
       <li>improve Broadcast command dialog:
         <ul>
           <li>edit control now support paste by R/M mouse clicking and Shift-INS.</li>
@@ -56,7 +57,11 @@ <h3 id="teraterm_5.3">YYYY.MM.DD (Ver 5.3 not released yet)</h3>
       </li>
       <li>Default port settings is moved to <a href="../menu/setup-additional-general.html#Port">General tab</a> of Additional settings dialog.</li>
       <li>Display lng file information when <a href="../menu/setup-general.html#UILanguageFile">LanguageUI</a> is selected. Remove language setting.</li>
-      <li>Bracket paste behavior can be adjusted with <a href="../setup/teraterm-misc.html#BracketedSupport">BracketedSupport</a> and <a href="../setup/teraterm-misc.html#BracketedControlOnly">BracketedControlOnly</a> .</li>
+      <li><a href="glossary.html#Bracketed">Bracket paste</a> behavior can be adjusted with <a href="../setup/teraterm-misc.html#BracketedSupport">BracketedSupport</a> and <a href="../setup/teraterm-misc.html#BracketedControlOnly">BracketedControlOnly</a> .
+        <ul>
+          <li>When pasting string from clipboard that does not contain control codes such as line feeds, characters are not outputted twice in the log with the default settings.</li>
+        </ul>
+      </li>
       <li>Download folder setting is moved to <a href="../menu/setup-additional-general.html#DownloadFolder">General tab</a> of Additional settings dialog.</li>
       <li>Modified to <a href="../setup/teraterm-ssh.html#AuthBanner">display SSH authentication banner in VT window</a> regardless of receiving character code.
       <li>Keyboard setting dialog is moved to Keyboard tab of Additional setting dialog.</li>
@@ -83,9 +88,10 @@ <h3 id="teraterm_5.3">YYYY.MM.DD (Ver 5.3 not released yet)</h3>
       <li>Fixed wrong characters were sent when transmit character code is JIS.
         <ul>
           <li>Fixed wrong character output at end of line.</li>
-          <li>Fixed wrong character output when local echo is on.<li>
+          <li>Fixed wrong character output when local echo is on.</li>
         </ul>
       </li>
+      <li>MACRO: Fixed path of <a href="../macro/command/basename.html">basename</a> and <a href="../macro/command/dirname.html">dirname</a> macro commands were not Unicode-compatible.</li>
     </ul>
   </li>
 

diff --git a/manual/5/en/index.html b/manual/5/en/index.html
@@ -140,7 +140,7 @@ <h1 class="center">Tera Term Help Index</h1>
  <LI><A HREF="reference/RE.txt">Oniguruma Regular Expressions</A></LI>
 </UL>
 
-<div class="topic">For developer</div>
+<div class="topic"><A HREF="reference/develop.html">For developer</A></div>
 <UL>
  <LI><A HREF="reference/develop-environment.html">Development environment & Libraries</A>
  <LI><A HREF="reference/develop-build.html">Create development environment & Build</A>

diff --git a/manual/5/en/macro/command/dirname.html b/manual/5/en/macro/command/dirname.html
@@ -41,7 +41,7 @@ <h2>Example</h2>
 
 <h2>See also</h2>
 <ul>
-  <li><a href="basename.html">dirname</a></li>
+  <li><a href="basename.html">basename</a></li>
   <li><a href="makepath.html">makepath</a></li>
 </ul>
 

diff --git a/manual/5/en/reference/dev/unicode.html b/manual/5/en/reference/dev/unicode.html
@@ -0,0 +1,73 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+  "http://www.w3.org/TR/html4/strict.dtd">
+<HTML>
+<HEAD>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<TITLE>Internal block diagram</TITLE>
+<META http-equiv="Content-Style-Type" content="text/css">
+<link rel="stylesheet" href="../../style.css" type="text/css">
+</HEAD>
+<BODY>
+
+<h1>Internal block diagram</h1>
+
+<p>
+  Before Tera Term 5, the character set of the internal buffer was DBCS (Double byte Character Set).
+  For example, when "Language" is set to "Japanese", character coding in internal buffer was Shift_JIS.
+</p>
+
+<p>
+  The character encoding of Tera Term 5 internal buffer is Unicode.
+</p>
+
+<p>
+  The data flow is as follows.
+</p>
+
+<font size="1">
+<pre>
+                                                                              +--------------+
+                              +------------------------+ Code:Unicode         |              |
+                              |                        +--------------------->+  Window      |
+                              |  [email protected]       |                      |   Display    |
+                              |   Code:Unicode         | Code:Unicode         |   Print      |
+                              |                        |  BuffPutUnicode()    |              |                                         +----------+
+                              |                        +<------------------+  +--------------+          +-----------------------+      |          |
+                              +------------------------+                   |                            |                       |      |Log File  |
+                                                                           +----------------------------+ VTParse()@vtterm.c    +----->+          |
+                              +------------------------+ CommRead1Byte()                                |  Terminal             |      |          |
+                              |                        +----------------------------------------------->+                       |      +----------+
+                              |  Input buffer@ttpcmn   |                                                |                       |
++-----------+                 |   Code:Input           | Code:                                          +----+------------------+
+|           |                 |                        |  Unicode to Input    +--------------+               |
+|  Socket   +---------------->+                        +<---------------------+              |               |
+|  Serial   |  CommReceive()  +------------------------+  CommTextEchoW()     |  Talker      |               |
+|  Pipe     |                                             CommBinaryEcho()    |   Keyboard   |               | Code:Unicode(UTF-8)
+|  Plugin   |                 +------------------------+                      |   SendMem    |               |  DDEPut1()
+|           +<----------------+                        | Code:                |    File      |               |
++-----------+  CommSend()     |  Output buffer@ttpcmn  |  Unicode to Output   |    Clipboard |               |
+                              |   Code:Output          +<---------------------+    macro     +<---------+    |
+                              |                        |  CommTextOutW()      |              |          |    |
+                              |                        |  CommBinaryOut()     +--------------+          |    |
+                              +------------------------+  CommRawOut()                                  |    |
+                                                                                                        |    |
+                                                                                                        |    |
+                                                                                                        |    |
+                                                                                                        |    v
+                                           +-------------------+      DDE, UTF-8/binary               +-+----+-----------+
+                                           |                   +------------------------------------->+                  |
+                                           |  ttpmacro.exe     |                                      |  ttdde.c         |
+                                           |                   |                                      |                  |
+                                           |                   |      DDE, UTF-8                      |                  |
+                                           |                   +<-------------------------------------+                  |
+                                           +-------------------+                                      +------------------+
+</pre>
+<font size="3">
+
+<p>
+  On Windows 95/98/Me, key input is converted to Unicode before processing.
+  When drawing, characters are converted from Unicode to MBCS.
+</p>
+
+</BODY>
+</HTML>
diff --git a/manual/5/en/reference/develop.html b/manual/5/en/reference/develop.html
@@ -18,6 +18,7 @@ <h1>Tera Term Development</h1>
   <li><a href="develop-release.html">How to release Tera Term installation package</a></li>
   <li><a href="sourcecode.html">Source Code Overview</a></li>
   <li><a href="dev/win32api.html">Notes on Win32 API</a></li>
+  <li><a href="dev/unicode.html">Internal block diagram</a></li>
 </ol>
 
 </body>

diff --git a/manual/5/en/setup/teraterm-misc.html b/manual/5/en/setup/teraterm-misc.html
@@ -446,9 +446,7 @@ <h1 id="IniAutoBackup">Auto backup of Tera Term setup file</h1>
 <h1 id="BracketedSupport">Supports bracketed paste</h1>
 
 <p>
-Bracketed paste is a mode which allows programs running in the terminal such as sh to treat pasted text differently from text typed normally.
-Tera Term by default supports this mode, but it is ineffective if the program running in the terminal does not support it.
-If you do not need Bracketed paste, change the BracketedSupport entry of [Tera Term] section as the following:
+If you do not need <a href="../about/glossary.html#Bracketed">Bracketed paste</a>, change the BracketedSupport entry of [Tera Term] section as the following:
 </p>
 
 <pre>
@@ -462,7 +460,7 @@ <h1 id="BracketedSupport">Supports bracketed paste</h1>
 
 <h1 id="BracketedControlOnly">Limit bracketed pasting to cases containing control characters</h1>
 <p>
-Bracket pasting is useful because it allows the pasted content to be confirmed before fixateing it,
+<a href="../about/glossary.html#Bracketed">Bracket pasting</a> is useful because it allows the pasted content to be confirmed before fixateing it,
 but it requires two steps of pasting and fixating even if the pasted content does not include control characters such as line changings.
 If you want to enable bracket pasting only when control characters are included, change the BracketedControlOnly entry of [Tera Term] section as the following:
 </p>

diff --git a/manual/5/en/usage/tips/vim.html b/manual/5/en/usage/tips/vim.html
@@ -71,7 +71,7 @@ <h2 id="Bracketed">Auto indent can be disabled on pasting from clipboard</h2>
 
 <p>
 Basically, the host application can not recognize the difference between the user input and pasting from clipboard.
-However, when a user uses the Bracketed Paste Mode as the xterm extension, the application can recognize its difference and a user can change the behavior of pasting from clipboard.
+However, when a user uses the <a href="../../about/glossary.html#Bracketed">Bracketed Paste Mode</a> as the xterm extension, the application can recognize its difference and a user can change the behavior of pasting from clipboard.
 </p>
 
 <p>
@@ -137,12 +137,6 @@ <h2 id="Bracketed">Auto indent can be disabled on pasting from clipboard</h2>
 endif
 </pre>
 
-<h4>About Bracketed Paste mode</h4>
-<p>
-The bracketed paste mode is the xterm extension feature. When this feature is enabled, the pasted text is bracketed with control sequences so that the program can differentiate the pasted text from typed-in text.<br>
-The program will receive: ESC [ 200 ~, followed by the pasted text, followed by ESC [ 201 ~.
-</p>
-
 
 <h2 id="IMEcontrol">Controlling IME</h2>
 <p>

diff --git a/manual/5/en/usage/unicode.html b/manual/5/en/usage/unicode.html
@@ -24,7 +24,6 @@ <h1>Unicode</h1>
 </ul>
 
 <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>
@@ -33,52 +32,5 @@ <h1>Unicode</h1>
 UTF-8 encoding/decoding can be used during transmitting and receiving of data.
 </p>
 
-<h1>Internal block diagram</h1>
-
-<p>
-  Before Tera Term 5, the character set of the internal buffer was DBCS (Double byte Character Set).
-  For example, when "Language" is set to "Japanese", character coding in internal buffer was Shift_JIS.
-</p>
-
-<p>
-  The character encoding of Tera Term 5 internal buffer is Unicode.
-</p>
-
-<p>
-  The data flow is as follows.
-</p>
-
-<pre>
-                                                                              +--------------+
-                              +------------------------+ Code:Unicode         |              |
-                              |                        +--------------------->+  Window      |
-                              |  [email protected]       |                      |   Display    |
-                              |   Code:Unicode         | Code:                |   Print      |
-                              |                        |  Input to Unicode    |              |
-                              |                        +<------------------+  +--------------+
-                              +------------------------+                   |
-                                                                           |
-                              +------------------------+   CommRead1Byte() |
-                              |                        +-------------------+
-                              |  Input buffer@ttpcmn   |
-+-----------+                 |   Code:Input           | Code:
-|           |                 |                        |  Unicode to Input    +--------------+
-|  Socket   +---------------->+                        +<---------------------+              |
-|  Serial   |  CommReceive()  +------------------------+  CommTextEchoW()     |  Talker      |
-|  Pipe     |                                             CommBinaryEcho()    |   Keyboard   |
-|  Plugin   |                 +------------------------+                      |   SendMem    |
-|           +<----------------+                        | Code:                |    File      |
-+-----------+  CommSend()     |  Output buffer@ttpcmn  |  Unicode to Output   |    Clipboard |
-                              |   Code:Output          +<---------------------+              |
-                              |                        |  CommTextOutW()      +--------------+
-                              |                        |  CommBinaryOut()
-                              +------------------------+  CommRawOut()
-</pre>
-
-<p>
-  On Windows 95/98/Me, key input is converted to Unicode before processing.
-  When drawing, characters are converted from Unicode to MBCS.
-</p>
-
 </BODY>
 </HTML>
diff --git a/manual/5/ja/about/ctrlseq.html b/manual/5/ja/about/ctrlseq.html
@@ -761,10 +761,10 @@ <h3 id="decmode">モード (DEC/xterm拡張)</h3>
 	<td> 画面全体を消去し、標準画面バッファに切り替えた後、保存したカーソル位置を復元する。 </td>
     </tr>
     <tr>
-	<td> 2004 </td>
+	<td id="Bracketed"> 2004 </td>
 	<td> RL_BRACKET </td>
-	<td> <a href="../usage/tips/vim.html#Bracketed">Bracketed paste mode</a> を有効にする。 </td>
-	<td> <a href="../usage/tips/vim.html#Bracketed">Bracketed paste mode</a> を無効にする。 </td>
+	<td> <a href="../about/glossary.html#Bracketed">Bracketed paste mode</a> を有効にする。 </td>
+	<td> Bracketed paste mode を無効にする。 </td>
     </tr>
     <tr>
 	<td> 7727 </td>

diff --git a/manual/5/ja/about/glossary.html b/manual/5/ja/about/glossary.html
@@ -75,6 +75,28 @@ <h1>用語集</h1>
 
 </dl>
 
+<h2>制御シーケンス</h2>
+
+制御シーケンスに関する用語
+
+<dl>
+<dt id="Bracketed">Bracketed Paste Mode</dt>
+<dd>
+  xterm 拡張で、有効時、クリップボードから貼り付け時に文字列の前後にTera Term が特別なシーケンスを付加します。<br>
+  具体的には、<a href="../about/ctrlseq.html#Bracketed">DECSET の 2004(&lt;CSI&gt;?2004h)</a> で有効になり、貼り付け時に文字列の前に &lt;ESC&gt;200~, 後ろに &lt;ESC&gt;201~ が付くようになります。<br>
+  sh のようなシェル等が普通にタイプされた文字とペーストされた文字を区別することができるようになります。<br>
+  例えば、貼り付けた文字を未確定として扱いハイライトで表示し、Enterキー等で確定することができます。一方でハイライトを消すためにハイライトオフで再度文字を上書き出力するとログには二重に記録されることになります。
+  <br>
+  関連ページ
+  <ul>
+    <li><a href="../usage/tips/vim.html#Bracketed">vim からの制御シーケンスの使用例 / クリップボードからの貼り付け時に自動インデントを無効にする</a>
+    <li><a href="../setup/teraterm-misc.html#BracketedSupport">Tera Term 設定ファイル / その他 / ブラケットペーストのサポート</a>
+    <li><a href="../setup/teraterm-misc.html#BracketedControlOnly">Tera Term 設定ファイル / その他 / ブラケットペーストを制御文字を含む場合に限定する</a>
+
+  </ul>
+</dd>
+</dl>
+
 <h2>文字コード</h2>
 
 文字コードに関連する用語