==============================================================================
* UTF-8 version TeraTerm Pro        [User's Manual]
==============================================================================

* Introduction
  This program makes the terminal emulator "TeraTerm Pro" with UTF-8.


* Archived files
@If an archive is unfreezed, there are following files.

@---------------------+-----------------------------------
@readme.txt @@@       this file
@teraterm_utf8_xxx.exe@ self updater against TeraTerm Pro 2.3
@cygterm.exe@@@@@@ "Cygterm" main program
@cygterm.cfg@@@@@@ "Cygterm" configuration file
@TERATERM.INI@@@@@@ini sample file
@---------------------+-----------------------------------


* Installation
  This program is provided with the patch and it does not execute as it is.
  'teraterm_utf8_XXX.exe' is a executable self updater against TeraTerm Pro 2.3.
  Copy it to "TeraTerm Pro 2.3" directory and execute.
  Executable and DLL files will be updated.
  And also "cygterm.exe" and "cygterm.cfg", copy its to the same directory.
  
  [NOTICE] behavior mode
    UTF-8 function can work at Japanese mode.
    Beforehand install original TeraTerm Pro at Japanese mode.


* Unicode configuration
  For doing UTF-8-ization, select "Terminal" from TeraTerm Pro "Setup" menu.
  On the dialog-box, select "UTF-8" from "Kanji(receive)" or "Kanji(transmit)".
  The reboot of TeraTerm Pro is not required.
@When "UTF8" is specified in the '/KT' or '/KR' option of a command line,
@UTF-8 enconding/decondig can be set as a transmission and a receiving code.
@
@In order to enable it to display languages other than Japanese character, 
@need to do setting locale and codepage in 'teraterm.ini'. It is shown below.
@About of locale and codepage value, show the following web-site.

@@http://www.microsoft.com/japan/msdn/library/default.asp?url=/japan/msdn/library/ja/vclib/html/_crt_language_strings.asp
@@http://msdn.microsoft.com/library/default.asp?url=/library/en-us/intl/unicode_81rn.asp

------------------------------------------------------------------------------------
; Locale for Unicode
Locale = japanese

; CodePage for Unicode
CodePage = 932
------------------------------------------------------------------------------------

  [NOTICE] Mac OS X
    "UTF-8m" is the encoding for Mac OS X(HFS+). Now only support receive mode.
    At '/KR' command line, can specify "UTF8m".


* ANSI color change & concatenating multi-line patch
  This patch is available for "ANSI color & concatenating multi-line patch".
  The following descriptions are added, its function can be confirmed.

------------------------------------------------------------------------------------
;	ANSI color definition (in the case FullColor=on)
;	* UseTextColor should be off, or the background and foreground color of
;	  VTColor are assigned to color-number 0 and 7 respectively, even if
;	  they are specified in ANSIColor.
;	* ANSIColor is a set of 4 values that are color-number(0--15),
;	  red-value(0--255), green-value(0--255) and blue-value(0--255).
ANSIColor=0,0,0,0, 1,255,0,0, 2,0,255,0, 3,255,255,0, 4,128,128,255, 5,255,0,255, 6,0,255,255, 7,255,255,255, 8,0,0,0, 9,255,0,0, 10,0,255,0, 11,255,255,0, 12,128,128,255, 13,255,0,255, 14,0,255,255, 15,255,255,255

;	Enable continued-line copy
EnableContinuedLineCopy=on
------------------------------------------------------------------------------------

  [HINT]
    Setting "xterm" at TermType, the application(i.e. vim6) supporting the the ANSI color
    can be shown by the color.
    This is the function from original TeraTerm.


* Wheel mouse
  This patch is available for wheel mouse button.



* Mouse cursor
  The classification of a mouse cursor can be set up.

------------------------------------------------------------------------------------
; Mouse cursor type (arrow/ibeam/cross/hand)
MouseCursor = hand
------------------------------------------------------------------------------------

@@arrow = standard arrow cursor
@@ibeam = ibeam cursor(default)
@@cross = cross cursor
@@hand  = hand cursor



* Translucent window
  This patch is available for translucent window(Windows2000 later available).
  Default value is 255(opaque).

------------------------------------------------------------------------------------
; Translucent window (0 - 255)
AlphaBlend = 230
------------------------------------------------------------------------------------


* Cygwin connection
  This patch is available for connecting to the local Cygwin. 
  Cygterm is used inside.
  Select "Cygwin connection" from file menu or push "Alt + G " and will be 
  connected to Cygwin.
  Beforehand need to configure Cygwin install path in TeraTerm ini file.
  The format is "drive-letter:\directory".

------------------------------------------------------------------------------------
; Cygwin install path
CygwinDirectory = c:\cygwin
------------------------------------------------------------------------------------

  [NOTICE]
    If cygterm doesn't kick, try to rebuild cygterm.


* Select all buffer
  Select "Select all" from Edit menu, screen all buf is selected and 
  copy its to clipboard.
  
  [HINT]
    Pusing SHIFT key and drag the mouse, can do block-select the text.
    This is the function from original TeraTerm.


* Add comment to log file
  Select "Comment to Log..." from File menu, can add the comment to the 
  logging file. The comment is up to max 255 characters.


* Available for SSH1
  With following steps, SSH(Secure SHell) can be used on this program.
  In case of TTSSH original as is doesn't work, please be sure to 
  complete the following step2 and 3.
@
  1. Install TTSSH original 
@  By using TTSSH (SSH Extention to Teraterm) by Mr. Robert O'Callahan, 
@  SSH (protocol version 1.5) can be used on this program. 
@  TTSSH can be downloaded from the following site.
@
@@http://www.zip.com.au/~roca/ttssh.html

  2. Install IPv6 version TeraTerm DLL
    Copy DLL files(ttxssh.dll, libeay32.dll and zlib1.dll) included in IPv6 version 
    TeraTerm by Mr. Junya Kato to TeraTerm directory.
@  IPv6 version TeraTerm can be downloaded from the following site.

@@http://win6.jp/TeraTerm/index.html

  3. Install VC++ 7.1 runtime library
    When Visual Studio. NET is not installed, it is necessary to copy 
    the VC++ 7.1 run time to %SystemRoot%system32 directory.
@  The runtime library can be downloaded from the following site.
@
@@http://win6.jp/misc/mfc71.zip

  4. setting environment value
     Setup "TERATERM_EXTENSION environment value to '1'.



* Developement
@OS: Windows XP Professional
@Compiler: Visual Studio .NET 2003
@
@Software:
@TeraTerm Pro 2.3
@IPv6 0.81
@Cygterm 1.06
@TTSSH 1.5.4
@
@Update patch was made by udm 1.30.


* Copyright
  This program is free software.
  
@TeraTerm Pro original has copyright in Mr. T.Teranishi.
@ANSI color change & concatenating multi-line patch has copyright in Mr. N.Taga.
@UTF-8 code has copyright in YUTAKA(myself).
@IPv6 version TeraTerm Pro has copyright in Mr. J.Kato.
@Cygterm has copyright in Mr. NSym.

  Although this program can be used gratuitously, the author is in charge of 
  use of this program. No responsibility is taken to the obstacle and problem 
  to produce. Moreover, distribution of the reconstruction version TeraTerm 
  is not accepted by the original author's intention.

@e-mail : yutakakn@mail.goo.ne.jp
@URL    : http://hp.vector.co.jp/authors/VA013320/
@TeraTerm Pro: http://hp.vector.co.jp/authors/VA002416/
@ANSI color change & concatenating multi-line patch: http://www.sakurachan.org/ml/teraterm/msg00264.html
@IPv6 version TeraTerm Pro: http://win6.jp/TeraTerm/index.html
@Cygterm: http://www.dd.iij4u.or.jp/~nsym/cygwin/cygterm/index.html


* Restriction matter
  - The character that can't be converted UTF-8 to Shift_JIS display the '?'.
  - The EUC output in UTF-8 environment may not be shown on TeraTerm screen.

* History

2004.8.6 (Ver 2.03)
  - assign the accelerator key of Cygwin connection menu to 'Alt + G'
  - add the fullpath show on the logging dialog
  - support adding the user comment to the logging file
  - change static link to dynamic load of SetLayeredWindowAttributes() API (for NT4.0)
  - change WDiff to udm of difference making tool

2004.4.12 (Ver 2.02)
  - support UTF-8 for Mac OS X(HFS+)
  - support showing the languages other than Japanese character(need locale and codepage setting)
  - support inputing the languages other than Japanese character(link 'imm32.lib')
  - delete BOM(Byte Order Mark) at receive mode
  - In addition, fine bug fix

2004.3.19 (Ver 2.00a)
  - fix README

2004.3.18 (Ver 2.00)
  - Base source changes original to IPv6 version (thanks to Mr.J.Kato).
  - support translucence window
  - support Cygwin connection
  - support selecting all buffer
  - support configuring mouse cursor type
  - switch WinSock1.1 to 2.2
  - In addition, fine bug fix

2004.3.13 (Ver 1.02)
  - back to hostname max-length is 80.
  - support UTF-8 for sending

2004.3.9 (Ver 1.01a)
  - fix README
  - check of SSH operation is TTSSH 1.5.4 + IPv6 0.81

2004.3.6 (Ver 1.01)
  - support wheel mouse
  - add "UTF8" on /KR option of command line
  - power up of a UTF-8 conversion (addition referrer table)
  - extend hostname max-length from 80 to 1024

2004.3.2 (Ver 1.00)
  - first release


See you next version. Up to it, happy TeraTerm life!

