readme.txt

JAVA程序开发编码：语言转换器（简体中文和繁体中文）

ConvertZ version 2.8 (Freeware)                            Aug 1, 2001


Description: Chinese GB <> Big5 code converter.


Mail me if you have any comments or bugs report.


System requirement: Win9x, Win2000

System tested:  
- Traditional Chinese Win98, and
- English Win2000, which system locale and keyboard layout are changed to either
  Traditional or Simplified Chinese.
(* I haven't tested it in NT4 and PWin9x. let me know if it works).


Installation:
Just un-zip all files to a new empty folder, and then run convertz.exe
from windows explorer.  ConvertZ's Option dialog has 3 buttons that
can automate creation of the shortcut.


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 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 text windows 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 with the send-key feature in win9x.

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

Ver 2.51:
1. New color background with buttons changing color on enter.
2. 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)
3. 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.
4. 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.
5. Fixed 2 serious bug which cause memory leak in previous version. 
6. Allow user to add file shortcut to desktop, start menu, or program menu. (Option dialog)
7. 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
8. Allow user to change location of default folder. (Option dialog)
9. Added a option to convert & rename the chinese filename's encoding
    method during conversion of the file content. Turn it off if the chinese filename
    is already in system language but the content are not.  Use it with care.
10. Synchronize the position of source/preview memo box in 'File conversion' .  Their top
     line would always be same when scrolling either of the window.
11. Revised big5fix.dat. Its size is bigger and take much long time for GB > Big5
      conversion. However, acuracy is my concern. ;-)
12. Fixed font display problem in Simplified Chinese Window (tested only in
      win2k). Stupid me found that the same string resource file complied in PWin
      and CWin are totally different. After checking the Win32 help file, the 32bit
      complied string resource are stored as unicode according to system's default
      locale, and therefore caused the wrong chinese characters' code mapping
      when loading in diff locale system. I decided to put all label captions in source
      unit instead of inside a resource file and now the font should display correct
      in both traditional and simplified version of windows.  
13. Monitor changes in source folder and update filelist automatically.
14. Rewrite many routines and some bug-fixs. 


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

Version 2.23
1. minor bug-fix.
2. b5fix.dat revised.

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

Version 2.21
1. 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.
2. Fixed a bug which slowed down preview of html doc.

Version 2.2
1. 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. ;-)
2. 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.
3. for html doc only: convert UNIX text to DOS format.
4. a smarter method is implented for mode (GBK/Big5) detection.

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

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

Version 2.0
1. Automatically change the charset (ie. charset=gb2312 or charset=big5)
   in html header while converting html documents.
2. 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.
3. Fixed a bug which causes scrambled characters starting from GBK
   character (ie. internal code < A1A1) to end of a line.
4. Help file is available now. User can access it by pressing  the 'F1'
   key while ConvertZ is running.
5. Re-compile the source code with Delphi 5.

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

Version 1.1:
1. Fixed a bug which causes the display problem in systems with 'Large 
   Font' setting.
2. remember the fonts settings (ie. font name, color, size) in text
   viewers.
3. 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.)
4. Users can optionally hide/show the main window and use only the tray
   icon.
5. Some other minor enhancements and bug-fixes.

ver 1.0
First release.


To-do List:
- Command line support
- Unicode support



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   : [e-mail]
Homepage: http://www.alf2.f2s.com