ConvertZ version 4.02 (Freeware)                            Apr 2, 2002


Description: Chinese Big5/GBK/Unicode/UTF8 code converter.


System requirement: Win9x/ME/2000/XP

System tested:  
- Traditional Chinese Win98, and
- English Win2000, which system locale and keyboard layout are changed to either
  Traditional or Simplified Chinese.


Installation:
Just un-zip all files to a new empty folder, and then run convertz.exe
from windows explorer.  


Uninstallation:
The program makes no change to system registry. If you don't want it for
whatever reason, just delete the provided files and its shortcut from your hardisk.



Revision history:

Ver 4.02
* rewrite rountine for checking source docuement's coding method.
  the accuracy is highly improved. gbk doc with tradtional typeface
  should no longer be mistakenly detected as big5.
* add several missing gbk characters.
- fixed several charset-related bugs during html conversion.
- some other minor bug fixes.


Ver 4.01
- Unicode conversion was disabled in Explorer Mode, fixed.
- fixed several minor bugs.

Ver 4.0
+ Add support of Unicode Big Endian, Unicode Little Endian, and UTF8 file
  conversion.
+ typeface of all output-codes, except big5, can be optionally assigned to be
  traditional or simplified chinese.
+ Add hotkeys for clipboard conversion btwn simplified/traditional chinese
  unicode text.
+ Add option to FileCon window for changing filename only. (no change to
  file content)


Ver 3.14
- fixed a bug that may give wrong result after clipboard's unicode conversion
  when the length of input and output strings are diff.

Ver 3.13 
- could not display long filename in explorer mode (win9x only). fixed.
- the program reported wrong no. of bytes after clipboard conversion
  (win9x only). fixed.
- during clipboard conversion, the program give wrong warning if the length
  of clipboard content is less than 32 bytes. fixed.
- fixed a Win95 only bug which may cause "Win32 Error Code: 3" and failure
  to display Chinese captions when executing the file conversion window.
+ add and revised hundreds of gbk characters. (most of them are ancient
  chinese characters.)

Ver 3.10
+ Add "SmartRepace" for Big5 > GBK, so that user can fix mis-mapped Simplified
  Chinese characters too.
+ Eliminate the string length restriction in SmartReplace. Now, the length of
  string in "Original" field can be different from that in "Replace with" field.


Ver 3.00
+ New button is added to main toolbar for exchanging clipboard's unicode text
   between Simplified/Traditional Chinese. Suitable for use in unicode-supported 
   applications  (ie. Internet Explorer, Ms Office, etc.).

+ To speed up the time of loading ConvertZ, 3 files (gb.ndx, b5.ndx, key.ndx) would be
   generated whenever b5fix.dat is revised. These 3 files are marked read only. Don't ever
   try to edit their content, otherwise the text would not be converted properly.

+ Command line support is added.
  ** Note that ConvertZ is not a console application. You cannot type and execute
     the command from Win9x's MS DOS Mode direct. (NT/Win2k's Command Mode is OK.)
     User can use one of the following ways to run the command in Win9x/Me:
     a. put the commands in a batch file and execute the bat file instead.
     b. choose Start/Run in Menu, type execute the command from the dialog.
     c. call the command from another application.

+ ConvertZ runs in different modes according to parameters passed to the pragram.

  1. Stanard mode: 
     No parameter. It executes the standard main toolbar.

  2. Command mode:
     Syntax: convertz <option> <infile> [outfile]
     <option>  -g2b  -----> GBK to Big5
               -b2g  -----> Big5 to GBK
     <infile>  input filename
     [outfile] output filename (optional). The program will convert and overwrite <infile>
               if this parameter is omitted.
     * For long filename with space, enclose it with " character.
     Example:  convertz -g2b a.txt b.txt
               convertz -g2b "a a.txt" b.txt
               convertz -g2b c:\aa\bb.html "c:\a folder\dd.html"

  3. Explorer mode: 
     Syntax: convertz <infile1> [infile2] [infile3] [infile4] .........
     <infile*> = input filename (with full path)
     It makes the file conversion via Windows's Explorer handy.
     Just add a shortcut of convertz.exe to Windows's 'Send to' folder.
     (In ConvertZ's Option dialog, click 'Add shortcut to / Send to' button to automate
     the shortcut's creation).
     User can select file(s) in Explorer, right click to activate popup menu,
     and choose 'Send to / ConvertZ'. The 'File Conversion' window would be loaded
     with all selected file(s) added to 'File List' and ready for conversion.
     * If the selected item is a folder, all files in the folder (excluding those ignored
       file types) would be added to 'File List'. ** Only one folder can be selected.

+  Improved popup menu so that all characters could be displayed properly in both
   Simplified or Traditional Chinese.


Ver 2.84
- Fixed a Win9x only bug that causes failure to auto-select folder when clicking source or destination button.
- fixed a bug which report wrong number of bytes after clipboard conversion
- rewrite some routines.

Ver 2.83
- Fixed a careless bug when interface was set to English.
  The captions of below menu items in tray-icon's popup-menu were upended:
  'Clipboard: GB>Big5' & 'Clipboard: Big5>GB'
- Some minor bug-fixes

Ver 2.82
- fixed a stupid bug in ver 2.81. I forgot go link filter combobox to filelist box. the filter should work properly now.

Ver 2.81
- fixed some new bugs introduced in ver 2.8
+ Enhanced filelist box

Ver 2.8
+ File filter editor is added so that user can self-define filtered file types.
+ New button is added to file conversion window. It adds the ability to convert
  all files, including all those in sub-folders, from the source.
  *  To reduce danger of this operation, When above feature is activated, then
      1) the source must not be root directory of a disk drive.
      2) the destination cannot be the same as source folder.
      3) the destination cannot be child-folder of source folder.
  * User should carefullly configure 'Ignored file types' to avoid converting binary files mistakenly.
  * Sequence of the operation:
     1) Replicate the structure of  sub-directories from source to destination.
     2) Copy Ignored files to corresponding folder/sub-folders in destination.
     3) Convert all files in 'File list' and save them to corresponding
        folder/sub-folders in destination.


Ver 2.73
-fixed 2 mis-mapped characters.

Ver 2.72
- fixed a bug that appends a null char to end of html doc.
- fixed a bug that causes AV error when re-executing a exist modal form via tray menu.


Ver 2.71
- unselect all items in filelistbox after file conversion, to avoid wrong detection of
  conversion mode in some cases.
- fixed a bug that may raise a exception error in B5fix dialogbox.

Ver 2.7
+ Add user-defined hotkeys for clipboard's conversion. 
+ Enhanced tray icon's right-click menu.
+ Rewrite some routines to speed up conversion of html files.

Ver 2.61
- fixed a bug that causes mis-rename of the chinese filename
  which happens when the source and target folder are not the same.
- fixed a bug in file renaming routine (used in right-click context menu)
  for warning of registered file types.
+ add a new entry in option dialog to let user self-define those html file-types
  needed to update lang charset.

Ver 2.6
+ The time used for GB > Big5 conversion is 2 times faster then previous version.
  ie. GB to Big5 --> 3.4 sec per MB 
      Big to GB --> 0.4 sec per MB   (Celeron 487 MHz)
+ update the charset of some other html related docs during file conversion   (ie. asp, php3, shtml, shtm, js, inc, apsx, pl, cgi).
+ revised b5fix.dat.
+ revised help file with simplified chinese support.
- some minor bug fixes and rewrite some routines.
- save the font character set of window text to ini.

Ver 2.56
- for html file only. fixed a bug that causes preview of excessive scrambled characters
  if the file size is less than 10 kb.

Ver 2.55:
- fixed a bug that disable replacement of html charset in meta tag.
+ some minor enhancements.

Ver 2.54:
- fixed a bug that causes error when using the send-key feature in win9x.

Ver 2.52 / 2.53:
- fixed several bugs and add some enhancements.

Ver 2.51:
+  New color background with buttons changing color on enter.
+  Right click the filename in source file list will display context menu same
   as that appear in windows explorer, so that user can do the copy, delete,
   rename, or display file property, etc feature. (File Conversion Dialog)
+  A 'Convert & SendKey' feature is added. Thus, user can type in a dialog box and 
   send the converted string to target application as assigned by user. Great for
   using it in IRC client and chat in channel of diff chinese encoding.  I don't have
   time to rewrite the help file. Please read 'SendKey.txt' for details.
+  Additional feature for 'Convert & Sendkey': 
    Let user to assign commands (a combination of characters and keywords)
    to target application, after sending text, for emulation of specific keystrokes
    and actions.
-  Fixed 2 serious bugs which cause memory leak in previous version. 
+  Allow user to add file shortcut to desktop, start menu, or program menu. (Option dialog)
+  Default folder is now 'My Documents' (the special virtual folder in explorer).
    Its actual location is:
	Win9x 	- C:\My Documents
	WinNT 4.0 - C:\WINNT\Profiles\%user\Personal Files
	Win2000 	- C:\Documents and Settings\%user\My Docuements
+  Allow user to change location of default folder. (Option dialog)
+  Added a option to convert & rename the chinese filename's encoding
    method when converting files. Turn it off if the chinese filename
    is already in system language but the content are not.
+  Synchronize the position of source/preview memo box in 'File conversion'.  Their top
    line numbers are always the same when scrolling either of the window.
+  Revised big5fix.dat. Its size is bigger and take much long time for GB > Big5
   conversion. However, acuracy is my concern. ;-)
-  Fixed text display problem in Simplified Chinese version of Windows.
+  Monitor changes in source folder and update filelist automatically.
-  Rewrite many routines and some bug-fixs. 


Ver 2.24 to 2.50
- unreleased versions
- fixed some bugs.
- rewrite some routines, but have introduced many new bugs as well. :-)

Version 2.23
-  minor bug-fix.
+  b5fix.dat revised.

Version 2.22
- fixed a bug which added a null character at end of converted
  html documents.
- removed duplicated records in character mapping table to 
  increase program loading speed. file size is reduced by 30k.

Version 2.21
+ Well. just a minor improvement but it's handy. now click the
  tray-icon will make ConvertZ re-appear on top if it is hidden
  by other windows.
- Fixed a bug which slowed down preview of html doc.

Version 2.2
+ Fully support conversion between GBK and Big5 now. 
  It spent me long time to find resources from the net and 
  took serveral days to recompile the list. ;-)
- Fixed a bug which cut the file size after conversion.
  The problem occurred only in corrupted html doc with null 
  character (/0) found before end of the file. All null characters
  will convert to '~' if found.
+ for html doc only: convert UNIX text to DOS format.
+ a smarter method is implented for mode (GBK/Big5) detection.

Version 2.1
- fixed serveral bugs in vulcabulary editor for gb>b5 characters
  replacement.
- fixed a bug which causes wrong sorted order when loading b5fix.dat
  to internal arrays.
- some other minor bug fixes.

Version 2.01
- There is a bug in ver 2.0 which causes a problem to restore the old
  settings. Fixed.

Version 2.0
+ Automatically change the charset (ie. charset=gb2312 or charset=big5)
  in html header while converting html documents.
+ A new smart-replace scheme is used for fixing variant Big5 characters 
  after GB_to_Big5 conversion. A built-in utilty is included so that 
  user can re-define the vocabularies for string's replacement.
- Fixed a bug which causes scrambled characters starting from GBK
  character (ie. internal code < A1A1) to end of a line.
+ Help file is available now. User can access it by pressing  the 'F1'
  key while ConvertZ is running.
- Re-compile the source code with Delphi 5.

Version 1.2:
- Fixed a bug which causes re-arrangement of desktop icons while another
  hidden window is already located at the same edge as ConvertZ toolbar.
+ Only one instance of the application is allowed.
+ New button for synchronizing the Source and Dest Dir.
- Other minor fixes.

Version 1.1:
- Fixed a bug which causes the display problem in systems with 'Large 
  Font' setting.
+ remember the fonts settings (ie. font name, color, size) in text
  viewers.
+ capable of accessing all commands via the tray icon in windows tasker
  by right clicking on it. (So users can access it even there is any 
  fullscreen application on foreground.)
+ Users can optionally hide/show the main window via the tray icon.
- Some other minor enhancements and bug-fixes.

ver 1.0
First release.


DISCLAIMER
==========
THIS SOFTWARE IS DISTRIBUTED "AS IS". IT MAY CONTAIN BUGS. 
I AM NOT RESPONSIBLE FOR ANY DAMAGE TO YOUR SYSTEM DUE TO
THE USE OR MIS-USE OF THIS PROGRAM, OR WHATSOEVER. USE IT
AT YOUR OWN RISK.


Author  : Alfred, Li Chi Shing (Hong Kong)
Email   : csli534@ctimail3.com
Homepage: http://alf-hothere.com    or  http://alf-li.tripod.com

