==============================================================================
* 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
  cygterm.exe             "Cygterm" main program
  cygterm.cfg             "Cygterm" configuration file
  TERATERM.INI            ini sample file
  binary directory        UTF-8 version TeraTerm Pro binary files
  ---------------------+-----------------------------------


* Installation
  The binary files overwrite in the TeraTerm original directory.
  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.


* External Setup dialog
  Select "External setup" from Edit menu, can configure the option
  UTF-8 patch later.


* Available for SSH1
  SSH(Secure SHell) can be used on this program with attached SSH2 version TTSSH.
  In case of TTSSH original or Japanized TTSSH as is doesn't work, please be careful.

  These are the following options of SSH.
  
     option     explanation
     /1         connection with SSH1
     /2         connection with SSH2(Not support SSH2 at server, do SSH1 connection)
  
  Example of commad line option (IPv4 & SSH2 & UTF-8)

    ttermpro.exe /KR=utf8 /4 192.168.1.3:22 /ssh /2



* 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
  

* 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 Hirata.
  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. 

  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.
  - Using font BOLD style, the string right is cut.

* History

2004.10.11 (Ver 2.05)
  - attach SSH2 version TTSSH(1.00alpha2)
  - attach MFC7.1 runtime library
  - despite of setup environmetal variable 'TERATERM_EXTENSIONS', always load TTSSH.
  - fix UTF-8 encoding of HANKAKU KANA.
  - add /nossh option (fix problem that doesn't kick Cyterm with TTSSH section(Enabled=1) of TERATERM.INI file)

2004.9.29 (Ver 2.04a)
  - change patch to binary files for distribution style
    I replied permission from the TeraTerm original author (Mr.Teranishi). I appreciate.

2004.9.5 (Ver 2.04)
  - fix running macro halt problem on logging
  - add 'External setup' dialog on Edit menu
  - save ANSI color setting to ini file

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!

