; Unicode text file.
;       - Version:  WinVNKey 5.5.452
;       - Author:   Hoc D. Ngo
;       - Email:     Winvnkey-users@lists.sf.net  , hoc96@yahoo.com, hocngo@gmail.com
;       - Date:      December 30, 2008
;
; This file contains English text used in the English user interface 
; of WinVNKey such as labels, edit boxes, comboboxes, lists, help dialogs, etc.
; It should be viewed correctly with any Unicode editor using any Unicode font
;      - Unicode editor: Notepad 2000 or later, Wordpad 2000 or later,  Word 2000 or later, etc. 
;      - Unicode font: Arial, Courier New, Times New Roman, Arial Unicode MS, etc
;
; To display WinVNKey in any other language (say French), you can do as follows:
;        - Make a copy of English.ini and rename to French.ini
;        - Edit French.ini to translate all the English text that appears on the right of the equal
;          sign to French. 
;        - The base filename will automatically appears in the language combobox
;          of the page:  Run button ==> Preferences ==> Appearance.
;        - To change WinVNKey display to French, simply choose French in the combobox
;
;  Note on translation:
;
;  1. The text on the right hand side of an equal sign can be long and can spread over
;      many lines.  In this case, all the subsequent lines must begin with a special
;     sequence "& " (an ampersand and a space) or "+ " (a plus sign and a space).
;        .  Use the ampersand when the text is concatenated to the previous line.
;        .  Use the plus sign when you want to insert a carriage return before concatenation.
;        .  Real text for the subsequent lines is considered to begin at column 3.
;
;      Before joining a subsequent line, all trailing spaces from the previous line will be removed.
;      If the last character of the line is a period, WinVNKey will add two spaces before joining
;      the next line.  Otherwise, WinVNKey adds a single space.
;
;  2. If the right hand side of an equal sign is empty, translate the English text on the
;      left of the equal sign and place the translation on the right hand side.
;
;  3. All lines beginning with a semicolon are comments and are ignored by WinVNKey.
;
; To see how the translation was done, you can take a look at Vietnamese.ini, 
; which was translated by the author to display Vietnamese.
;-----------------------------------------------------------------------------------------------------
;
; Note: When the right hand side of an equal sign, "=", is empty, WinVNKey uses
; the text on the left of the equal sign to display in dialogs.  The right hand
; side is empty when it does not contain anything, even a space or tab.
; This feature is not standard for INI files; WinVNKey defines the syntax this
; way to prevent text from disappearing from dialogs.

[Common Terms]
Help=
Default=
Cancel=
OK=
Clear=
Clear All=
Save=
Save As=
Delete=
Font=
Exit=
Quit=
Done=
Run=
Minimize=
Add=
All=
Look up ?/~=
Change Font=
Failed=
Successful=
Error=
Warning=
Version=
Add Row=
Delete Row=

; for use in converter
failed=
done=
Location=
or=

Directory=

[Menu]
;;; Viet chars
Typing Method=
Save=
Save As ...=
Open Folder=
Reset this typing method=
Restore all original typing methods=
Delete this typing method=

New=
Delete=
Change EditBox Font=
Change ListBox Font=
Exit=
Properties=
Unicode Typepad=
Run Character Map=
Reset this file to default behavior=Reset Ending Type and Properties to default for this file

;; Run button
Prepare/Send bug report=
Prepare bug report=
Open WinVNKey Install Folder=

Option Page=
Reset this page=
Restore all original pages=
Delete this page=
Menu for file===== Menu for file "XXX" ====

Change Unicode Font=
Check All Files=
Uncheck All Files=

Check all red lines=
Uncheck all red lines=
Choose first option in comboboxes=Choose first option (choose a) in comboboxes
Choose second option in comboboxes=Choose second option (choose b) in comboboxes
Choose first option in comboboxes below red lines=Choose first option (choose a) in comboboxes below red lines
Choose second option in comboboxes below red lines=Choose second option (choose b) in comboboxes below red lines 
Collapse all rows=Collapse listing (Display main rows only)
Expand all rows=Expand listing (Display every row)



Refresh List=
Get File Info=
Set File Info=
Duplicate File=
Delete File=
Duplicate File and Sort All Macros=
Remove Trailing Spaces on All Lines of this File=
Remove Trailing Spaces on All Lines of All Files=

; Replace Fonts
Delete Row=
Create Table=
Delete Table=
Save Table=
Save As=
Back Up Table=
Restore Table=
Show Capital Font Column=
Open Table=
Open File: Bad Chars=
Open File: My Own List of Fontnames=

; Check Conversion
Open Conversion File=
Back Up Conversion File=
Restore Conversion File=
Delete Conversion File=
How to edit table?=

; Hannom

Display Unicode value next to character=
Change Hán-Nôm Font for U+xxXX characters=
Change Hán-Nôm Font for U+XxxXX chars (Extension B)=
Setup Hán-Nôm=
Hide WinVNKey panel=
Show WinVNKey panel=
Show Row=
Show Column=
Get Info=
Help=
Display Hán Chars Only=
Display Nôm Chars Only=
Display Hán Chars Before Nôm=
Display Nôm Chars Before Hán=

Display characters only=
Display characters and Unicode values=
Display characters and pronunciation=

Use Traditional Chinese for Han=

Hide WinVNKey panel=
Show WinVNKey panel=
Change color=
Font and Color=
Enable four-corner-index typing method=

Browse=
Update Hán-Nôm database=
About=

Type Backspace=
Undo=
Select All=
This is Vietnamese word No.=
which has no Nôm characters=
which has no Hán characters=

This is Vietnamese word No. %d, which has=
Han characters=
Nom characters=
Han characters in black=
Nom characters in red=
Nom characters in black=
Han characters in red=
This is four-corner index %s=
which has %d characters=

There is XXX HAN entry=
There are XXX HAN entries=

- NNN HAN characters=
Total:  NNN characters=

Text size 10=
Text size 12=
Text size 14=
Text size 16=
Text size 18=

Run Character Map=
Choose a Unicode Character=
Choose Font Characters=
Change Font=
Change Font for Extension A=
Change Font for Extension B (U+2xxxx)=
Change Font for All Other Characters=
Goto Character=

List fonts used in file=

Unicode Typepad=
M2=Change Font

WinVNKey Setting Summary:=

; Conversion Menu when user types <CTR><RMOUSE>

Convert character case=Change character case:
UPPER CASE=
lower case=
Title Case=
Sentence case=
tOGGLE cASE=
Convert character set=Convert based on preselected character sets
from "XXX" to "YYY"=Preselected Charsets: from "XXX" to "YYY"
Run Full Converter=

Convert charset and display in temporary file=Convert charset and display in temporary file:
Convert charset and display=Convert based on preselected character sets in (C)

Convert VIQR to Unicode=
Convert to Unicode=Convert to Unicode (source charset unknown)
Convert Unicode to VIQR=
Convert text to a webpage=Convert text (and fix UTF-8 errors) to a web page (HTML)

Fix weird chars in email=Fix weird chars in email (e.g. Yahoo email)

Setup VIQR source=
Close=

[MyButton]
Download=
Default=
Browse=
Edit=
Rebuild=
Source charset=Source charset:
Destination charset=Destination charset:
Retype=Retype text to correct spelling based on the following settings
Extract=

HNList.A1=Numbering Style
HNList.A2=For fast typing choose the option that requires only one key press per label
HNList.A3=1. Numbering with 123...789abc...xyzABC...XYZ (e.g. US Keyboard)
HNList.A4=2. Numbering with abc...xyzABC...XYZ (e.g. French Keyboard)


HNList.B1=Handle Long Han Nom List
HNList.B2=1. Resizing the Han Nom dialog by dragging down the bottom edge
HNList.B3=2. Or scrolling back and forth by typing an appropriate symbol
HNList.B4=Forward
HNList.B5=Backward
HNList.B6=Scroll Quantity

HNSelect.A1=1. Each database can have its own selector (double click on it to change)
HNSelect.A2=2. Other commands
HNSelect.A3=a. Repeater command.  Type it before typing another label in
HNSelect.A4=the same Han/Nom list to choose more than one character.
HNSelect.A5=b. Enable typing character by its hex code using 0h ... $ format.
HNSelect.A6=For example, to get character U+54C0, type 0h54C0$

HNSelect.Selector=Selector Command



[MyComboBox]
$$$ Other Foreign Codepages $$$=
0. Auto-guess charset=
8. Unicode with Composed Viet chars=

0. None (no Vietnamese typing)=
1. VIQR - fast=
2. VIQR - flexible=
3. VIQR - avoiding SHIFT & punctuations=
4. VIQR - standard (unchangeable)=


type - after d=
type - before d=

(blank)=
$$ Decimal $$=
$$ Octal $$=
$$ Hex $$=
$$ Binary $$=
$$ User $$=

$$$ Hán/Nôm data $$$=
100. Hán/Nôm/Vietnamese text=100. Hán/Nôm/Vietnamese Unicode text
200. Using keyboard settings on page Main=200. Use typing method, Viet option page, and macros on Main page

1. Convert U+xxxx to true chars=
2. Convert Han/Nom chars to U+xxxx=
3. Insert a space between adjacent Han/Nom chars=
4. Compute statistics of Han Nom chars=

First selected database=

[HyperLink]
A1=Click to see explanation
A2=Click here to change font
A3=Click here to change font for input box
A4=Click here to change font for output box
A5=Click here to change font for list box
A6=Click here for more information

Open file=Click here to open this file with Notepad
Open dir=Click here to open this directory

Main.K1=Keyboard Settings
Main.K2=Charset
Main.K3=Output Method
Main.K4=Typing Method
Main.K5=Keyboard mode
Main.K6=Viet Option Page
Main.K7=Macros

Main.H1=About WinVNKey history
Main.H2=Go to TriChlor home page at winvnkey.sf.net
Main.H3=Click here for info on keyboard mode
Main.H4=Click here for more info on this character set
Main.H5=Click here to set up Vietnamese typing methods
Main.H6=Click here to set up Vietnamese options
Main.H7=Click here to enable macro files or modify/create them
Main.H8=Click here for an overview of settings

Typing.E1=1. Common accent marks and currency symbol
Typing.E2=2. Enable fast accent marks for specific letters
Typing.E3=3. Enable mapping keys to single accented characters
Typing.E4=4. Enable mapping keys to consonant compounds
Typing.E5=5. Enable editing-accent keys
Typing.E6=6. Delay echo until Viet char is complete

Typing.E7=7. Typing the same key again gives back the original (cá' ==> ca')
E7next=for all keys used as marks and mapped keys shown in groups 1 to 4
Typing.E8=8. Typing a different mark right after another mark replaces it (cá` ==> cà)
E8next=for all keys used as marks shown in group 1
Typing.E9=9. Enable smart key mapping (don't map if not forming Vietnamese word)

SpecialKeys.E2=Choose an ASCII character rarely used but fast to type:
SpecialKeys.H2=2. How to undo/toggle marks and macros:
SpecialKeys.H3=3. How to type an invisible space to split words:
SpecialKeys.H4=4. How to display conversion menu:
SpecialKeys.M1=5. Click for more special key sequences ...

Appearance.P4=Language:
Surrogate.A1=Requirements to display surrogate characters (U+10000 or greater):
Surrogate.C2=Fixed font
Surrogate.C3=Proportional font
Surrogate.D3=For characters in
Surrogate.D4=Use fallback font

; Converter
Properties=
Source is in=
Destination is in=
Source File=
Directory=
Filename=
Destination File=
Option=
Subdirectory:=
Suffix=
Prefix=


Converter.C12=Click to open subdirectory
Converter.C13=Click to open input file
Converter.C14=Click to open output file of the last conversion
Converter.C15=Click to view full status

Converter.C16=Click for an overview
Converter.C17=How to specify multiple files

Status=

; RTF converter
Choose a font replacement table=
Table=


RTF.C1=How to specify multiple source files?
RTF.C2=What is a font replacement table?
RTF.C3=Click to view, change, or add/delete font replacement tables

; Page ToCode
Source text=
Output=
ToCode.A1=Transform source text characters as follows:
ToCode.A2=Copy output back to source text box
ToCode.A3=Click to copy output back to source text box

; Page Viet Words
Word Separators=
Viet Dictionary=Supplemental Vietnamese Dictionary

Retype.A1=Choose Viet Option page for automatic retyping:

Same filename, different subdirectory=
Same directory, different filename suffix=
Same directory, different filename prefix=
Directory and filename are specified=
Same directory=
Different directory=

[Page Titles]
Vietnamese Multilingual Keyboard=asd

Select Macros=
WinVNKey Preferences=
Hot Keys=
Add New Hot Keys=
WinVNKey - Conversion=
Plain Text=
RTF Files=
Char Codes=
Doc/Html Files=

Switch Mode Commands=
RTF Font Conversion=
Viet Options=
Setup For Vietnamese Only=
Look up ?/~ Tonemarks=

About WinVNKey=
Reset WinVNKey=
Unicode Typepad=
Font Typepad=
Contributions=

Change Character To Number=
Change Number to Character=

Han/Nom Set up=

Set Up Hán Nôm=
Update Hán Nôm Database=Update Database
About Hán Nôm=


Main=
Advanced=
Languages=
Special keys=
Commands=
Switch Mode Commands=
Accent Mark Options=
Viet Word Processing=
Viet Dictionary=
Hot Key Table=
Appearance=
Dead Keys=
Surrogate Fonts=

Viet Chars=
Remap=
Tuning Fast Accent Keys=


AutoExpand 1=
AutoExpand 2=
Lazy Syllables=
Shorthands=
Lazy Words=

Replace Fonts=
Check Charsets=
Check Unicode Conversion=

Convert From VIQR=
Choose Retyping Option=Choose Viet Option Page for Retyping

[Page Choose]
A1=Choose default settings for Main page
A2=When you click on the Default button on the Main page, all settings on that page are reset to the default values.
& The default values can be changed.  You can choose either the factory settings 
& or the settings currently displayed on the Main page.

A3=Please choose your default for Main page:

A4=Save the factory settings as the default
A5=Save the current settings as the default

[Page Main]
M1=Multilingual Keyboard
B1=Run

K1=Keyboard Settings
K2=Charset
K3=Output Method
K4=Typing Method
K5=Keyboard Mode
K6=Viet Option Page
K7=Macros


;Taskbar
T1=Restore
T2=Exit
T3=Typing
T4=Mode
R5=WinVNKey Manual ...

;Messages

H3=Can't find help file

Help-KBSettings=For WinVNKey manual, click on Run -> WinVNKey Manual.
& Specific help is also available at many places:
+     - hyperlinked text
+     - click on buttons with downward arrow or buttons labeled with "?"
+     - right click inside list boxes.
+
+ If you click the Default button, you should be able to type Vietnamese Unicode in
& most applications such as Microsoft Word, Excel, Notepad, Wordpad, ... version 2000
& or later.
& Simply choose a Microsoft font such as Arial or Courier or Times New Roman
& and begin typing the following example:
+     Lo`ng me. bao la nhu+ bie^?n Tha'i Bi`nh 
+ You will see true Vietnamese appear immediately as follows:
+      Lòng mẹ bao la như biển Thái Bình
+
+ If you see question marks appear in place of Vietnamese letters, then
& try to choose another output method, one at a time.
& If no method is successful, it is likely your application does not support Unicode.
& In this case you can choose the Viscii charset and use VISCII fonts, not Microsoft fonts.
& For further information, after you choose Viscii, click on the "Charset" hyperlink.
+
+ Note that Unicode is not supported in Office 97, Word and Notepad in Windows NT 4.
& In this case you should click on the Default button, then change the "Charset" box
+     - to VISCII and choose VISCII fonts in your applications
+     - or to VNI and use VNI fonts in your applications
+     - or to VPS and use VPS fonts in your applications
+     - etc.
+ For more information on fonts, please click on the "Charset" hyperlink
& after choosing the charset as described above.
+

Help-Output-VIQR=When choosing VIQR, you will not see true Vietnamese characters.
& Instead, your text contains English letters plus symbols representing Vietnamese
& accent marks.  For example,
+
+       Tra(m na(m trong co~i ngu+o+`i ta,
+       Chu+~ ta`i chu+~ me^.nh khe'o la` ghe't nhau
+       Tra?i qua mo^.t cuo^.c be^? da^u
+       Nhu+~ng ddie^`u tro^ng tha^'y ma` ddau ddo+'n lo`ng
+
+ This is the convention commonly used on the Internet for typing Vietnamese.
& Most symbols are self-explanatory, except
+
+     a( for ă, u+ for ư, o+ for ơ,  dd for đ, DD for Ð
+
+
+ Ambiguity problem:
+ ==============
+
+ Ending vowels followed by punctuation marks like
& . and ? are ambiguous: they can be understood either as
& accent mark or true punctuation mark.
& Let's consider this example:
+        To^i dda~ tha^'y qua.
+ It can be interpreted as
+        Tôi đã thấy qua.       (. is true punctuation, a stand-alone character)
+ or
+        Tôi đã thấy quạ        (. is an accent mark)
+
+ To remove this ambiguity, the VIQR standard (vietstd.sf.net) recommends
& the use of an escape character, which is the backslash.
& When a character is preceded by an escape character, it will appear
& as is, i.e., as a stand-alone character, not an accent mark.  
+
+ Thus, if a punctuation mark is truly a punctuation, it should be preceded
& with a backslash:  
+        Tôi đã thấy qua. ==> To^i dda~ tha^'y qua\.
+        Tôi đã thấy quạ ==> To^i dda~ tha^'y qua.
+
+
+ Solutions
+ =======
+
+ WinVNKey allows the user to choose one of the following three output methods:
+
+   1. Friendly VIQR - Don't add \ to output
+       e.g.   Chuye^.n Mu`a Thu.   Con nho+' ba me.  Con xa nha` dda~ la^u ro^`i.   
+
+ This method can lead to ambiguity in the output text.  It is up to the reader
& to decide the meaning from the context.  But clearly the output text is easy
& to read.
+
+   2. Standard VIQR - Add \ between vowel and punctuation mark
+       e.g.   Chuye^.n Mu`a Thu\.   Con nho+' ba me\.  Con xa nha` dda~ la^u ro^`i\.   
+
+ In this method WinVNKey ALWAYS adds a backslash between a vowel
& and a punctuation mark even if the mark clearly cannot combine with
& the vowel as in the case of "rồi."   The additional backslashes make the output
& text difficult to read but the meaning is always clear.
+
+   3. Smart VIQR - Add \ if really needed
+       e.g.   Chuye^.n Mu`a Thu\.   Con nho+' ba me\.  Con xa nha` dda~ la^u ro^`i.
+
+ In the smart VIQR output method, WinVNKey recognizes
& that there is no such word as "rồị".   
& Hence it will leave the dot alone without adding a backslash.   
& In general, it will not output
& an additional backslash between a vowel and a mark if it can
& identify that the mark is really a punctuation mark, not a tonemark.
& Thus this method combines the advantages of both methods 1 and 2.
+


Help-Output-Unicode=When you choose Unicode charset, you have to choose an appropriate
& output method.  If one method does not work, try another.  If a non-clipboard method works,
& choose it to avoid clipboard conflict.
+
+ How to know if an application (Word, Excel, etc) supports Unicode?
+
+ Try typing a Unicode character whose Unicode value is greater than 255, such as
+    - any Vietnamese vowel with a dot below:  ạ ẹ ị ọ ụ ỵ and upper case
+    - any Vietnamese vowel with a hook above:  ả ẻ ỉ ỏ ủ ỷ and upper case
+    - any Vietnamese vowel with double accent marks:  ắ ấ ế, etc.
+
+ You need to test just a single character, such as ạ.  If you type a. (a followed by a period)
& and get ạ, your application does support Unicode.  If you see a question
& mark instead, try selecting a different output method.
& If you ALWAYS get a question mark for every output method,
& then your application does NOT support Unicode.
+
+ For example, Office 97 does not support Unicode.  Office 2000 and 
& later do support Unicode.  If you are using Office 97, you have to choose
& other Vietnamese character sets such as VISCII, VPS, ABC,etc.
+
+ Older applications usually do not support Unicode.  Some do support
& Unicode through the clipboard output methods only.  Modern applications
& may support many more output methods:
+
+    1. Clipboard using CTRL-V:
+        WinVNKey outputs Unicode characters greater than 255
& into clipboard, then fakes a CTRL-V event as if the user
& typed CTRL-V from keyboard.  Your application processes CTRL-V
& by pasting the clipboard contents into your text where the cursor is.
+
+    2. Clipboard using SHIFT-INSERT:
+        WinVNKey outputs Unicode characters greater than 255
& into clipboard, then fakes a SHIFT-INSERT event event as if the user
& typed SHIFT-INSERT from keyboard.  Your application processes SHIFT-INSERT by
& pasting the clipboard contents into your text where the cursor is.
+
+    3. Regular method:
+        WinVNKey sends all Unicode characters to your
& applications in the same way as any ASCII characters a, b, c, ...
& Older applications process only 8 bits, hence characters larger
& than 8 significant bits will be truncated and become wrong.
& Newer applications process 16 bits in full, hence all
& characters are received correctly.
+
+    4. Simulation method:
+        WinVNKey aks Windows to fake the keyboard as a Unicode keyboard.
& Older applications do not understand any Unicode keyboard, hence cannot
& process Unicode characters.
+
+    5. Unicode method:
+        WinVNKey creates a Unicode event when sending out Unicode characters.
& Older applications do not understand this event.  Newer applications
& understand this event and hence process Unicode characters correctly.
+
+    6. Clipboard using CTRL-V for all non ASCII chars
+        This is the same method as #1 except that it applies
& to all characters whose character codes are greater than 127.
& This is necessary for applications like GAIM, PIDGIN.
+
+    7. Clipboard using SHIFT-INSERT for all non ASCII chars
+        This is the same method as #2 except that it applies
& to all characters whose character codes are greater than 127.
& This is necessary for applications like GAIM, PIDGIN.
+
+
+ Note:
+ If you choose a clipboard method, the clipboard is frequently
& overwritten with single Unicode characters by WinVNKey.  Thus if
& you want to do copy/cut and paste of your own data, make sure you do
& not type any accented characters between the copy step and paste step.
+
+ Explanation:  If you copy/cut a sentence, it will go into the clipboard.
& If you next type an accented character like ạ, WinVNKey will copy ạ into
& the clipboard, hence erasing your sentence.  Now if you paste,
& you will get ạ, not your original sentence.
+



[Page Advanced]

A1=1. Enable hot keys
A2=2. Switch mode by keyboard commands
A3=3. Change certain characters to numbers
A4=4. Change certain numbers to characters
A5=5. Change ALL deadkeys into normal keys

B1=Your current keyboard state is xxx

Help=Skip this help page 
+     - if your keyboard has no dead keys (such as US keyboards).
+     - or if your keyboard has dead keys but you don't define
& them as accent marks in Vietnamese typing methods or in the Languages control panel.
+
+ Some keyboards that have dead keys are as follows:
+       French, with 4 dead keys ^, ~, ` and diaeresis (double dots)
+       Canadian French, with 5 dead keys ^, '. `, cedilla, and diaeresis
+       German, with 3 dead keys ^, ', and `
+       Danish, with 5 dead keys ^, ', `, ~, and diaeresis
+
+ A key is normal if when you type it, some character will show up on screen or some action will take place.
& A key is dead if when you type it, no character appears until you type a second key.
+
+ For instance, when you type the dead key ^, the accent mark ^ does not appear and the cursor does not move.
+     - If you next type a space, a stand-alone accent mark ^ will appear.
+     - Or if you type a character instead, say a, the full accented letter â will appear.  
+
+ If the accented letter â is not available in the current character set, you will get two characters as is, i.e., ^a in
& the said example.
+
+ Thus the dead key rule is typing the accent before the base letter.
+
+ But most Vietnamese users are more comfortable with typing accent marks after base letters.
& For example, they want to type o^ and get ô because that is how they write ô with a pen.
& If the ^ key is a dead key, this can be done as follows:
+
+       type (o)  (dead key ^) (space)  ==> get ô
+
+ (Note the parentheses and spaces were added for improve readability; you should not type them.)
+
+ However, typing an extra space for every dead key is not desirable because 
& over 80% of Vietnamese words have one or more accent marks.  This would slow down typing
& significantly and is totally unacceptable.
+
+ For this reason WinVNKey offers an option in the "Advanced" control panel
& to convert dead keys to normal keys so
& that users can type accent after letters.
+
+ If this option is enabled, all the dead keys become "normal" and are no longer "dead".
& But sometimes there is a need to restore the dead key behavior temporarily.
& To do this you must type an escape character, which is \, before typing the dead key.
+
+     e.g.   To get  aû,  type   (a) (\) (dead key ^) (u)
+
+ This is because one of the properties of an escape character is to make the next
& character literal, i.e., make it regain its original behavior.
+

[Page SpecialKeys]
E1=1. Define Escape Character
E2=Choose an ASCII character rarely used but fast to type:
E3=(e.g.,  \ for US keyboard, ! for French, # for German, ' for Danish, etc)

E4=The escape character box must never be empty!  
+ WinVNKey has reset to a backslash \ for you.

H1.0=a. Press and release both left and right SHIFT keys
H1.1=b. Press and release the right SHIFT key alone

H2.0=a. Press and release both left and right CTRL keys
H2.1=b. Press and release just one CTRL key

H3.0=a. Press and release left CTRL key, then right mouse
H3.1=b. Press and release left CTRL key twice, then right mouse
H3.2=c. Press and release left CTRL, then left SHIFT, then right mouse


Help-Undo/ToggleKey=Sometimes you want to type a character as is, but it combines with
& the preceding characters or triggers a macro that changes your text against your will.
& Well, WinVNKey provides
& a mechanism for you to undo the combining or the macro.  All you need to do is to
& type one or two keys immediately after the error; these keys are called the UNDO key(s).
+
+ You can choose the UNDO key(s) to be
+          (a) both the left and right SHIFT keys,
+          (b) or just the right SHIFT key alone.
+
+ If you choose option (a), you can do:
+       - press and release both SHIFT keys at the same time,
+       - or press and release the left key first, then the right key,
+       - or press and release the right key first, then the left key,
+
+ If you choose option (b), you must press and release the right SHIFT key
& alone.
+
+ Which option to choose is up to you.  Because the right SHIFT key is 
& positioned very close to the Enter key, many people tend to hit it by mistake when
& typing the Enter key.  In this case option (a) is recommended.  If you choose option
& (a), you should press and release one SHIFT key at a time to avoid conflict with
& other applications.
+
+ Example 1.  Choose option (a):  <UNDO> is both SHIFT keys
+
+     Type c, a, m, '     ==> get cám
+     Now press and release both SHIFT keys to undo  ==> get cam' (accent is detached) 
+     Now press and release both SHIFT keys again to undo ==> get cám (accent is attached)
+
+ Thus the UNDO keys are used to toggle combination and uncombination.
& You can use them to undo macros as well.
+
+ Example 2.  Choose option (b): <UNDO> is just the Right SHIFT key
+
+     Type c, a, m, '     ==> get cám
+     Now press and release right SHIFT key to undo  ==> get cam'  (accent is detached) 
+     Now press and release the right SHIFT key again to undo ==> get cám  (accent is attached) 
+
+ Thus the UNDO key is used to toggle combination and uncombination.
& You can use them to undo macros as well.
+
+ NOTE FOR NOTEPAD USERS:
+
+ If you accidentally press <Left CTRL> <Right SHIFT> together, the entire text may
& be shifted to the right.  You can undo by pressing <Right CTRL> <Left SHIFT> together.
& That is why it is highly recommended that you should press and release one key
& at a time.
+

Help-InvisibleSpaceKey=This option is irrelevant if you choose a non-smart typing method
& such as typing method number 0, or choose a non auto-combine keyboard mode.
+
+ You can read the section below if you choose the auto-combine keyboard mode
& AND a smart typing method.
+
+ In this case accent marks will combine
& with preceding letters if and only if the resulting string is forming
& a legal Vietnamese word or syllable.  Note that Vietnamese words are monosyllable,
& hence a multisyllable word is not Vietnamese.
+
+ But Vietnamese text sometimes contains
& words with multiple syllables, such as Inđônêxia. You would normally type this word as follows:
+      Inddooneexia  -- if using fast keys dd for đ, oo for ô, and ee for ê
+      Ind-o^ne^xia   -- if using common VIQR marks: d- for đ, o^ for ô, and e^ for ê
+
+ Unfortunately, the typing sequence above did not combine marks to produce Inđônêxia
& because WinVNKey recognized the sequence above as not a legal Vietnamese word.
& In this case what you need is a space that
& can split a string into monosyllable words, such as
+      In đô nê xi a
+ WinVNKey can then identify each word as legal Vietnamese and hence can
& place marks correctly for each monosyllable word.
+
+ Well, if you use spaces, you have to go back and erase them so that the final
& result is a multisyllable word:
+       Inđônêxia
+ That's a lot of
& work.  What you want is an invisible space so that you do not have to go back
& and erase them.  That is exactly what WinVNKey offers.  To enter an invisible
& space, you can choose to
+      (a) press and release both CTRL keys,
+      (b) or press and release a single CTRL key (either left or right)
+
+ Note: if you choose option (a), you can:
+       - press and release both CTRL keys at the same time,
+       - or press and release the left key first, then the right key,
+       - or press and release the right key first, then the left key,
+ If you choose option (b), you need to press and release only one single CTRL key.
& Because the CTRL keys are positioned very close to the SHIFT keys, you can
& hit them accidentally when typing a SHIFT key, especially when
& capitalizing a single letter.  If you make this mistake very frequently, perhaps
& you should choose option (a).   If you choose option
& (a), you should press and release one CTRL key at a time to avoid conflict with
& other applications.
+
+ It should be pointed out that WinVNKey is very smart with the invisible space:
& you need to enter just a single invisible space in a multisyllable word and
& WinVNKey will automatically insert invisible spaces between all the remaining syllables in the word.
+
+ Example for option (a):  <INVISIBLE SPACE> is both CTRL keys
+
+     1) Type Inddo^ne^xia ==> get  Inddo^ne^xia  (no combine  because the result is not Vietnamese).
+
+     2) Type In<INVISIBLE SPACE>ddo^ne^xia ==> get Inđônêxia.
+         In other words, type In<Left CTRL><Right CTRL>ddo^ne^xia  ==> get Inđônêxia.
+         Note that you need not type an <INVISIBLE SPACE> between ddo^ and ne^ or
& between ne^ and xia.  Typing an <INVISIBLE SPACE> before typing
& the second syllable is enough to inform WinVNKey of your intention to type
& a multisyllable string.
+
+ Example for option (b):  <INVISIBLE SPACE> is a single CTRL key
+
+     1) Type Inddo^ne^xia ==> get  Inddo^ne^xia  (no combine  because the result is not Vietnamese).
+
+     2) Type In<INVISIBLE SPACE>ddo^ne^xia ==> get Inđônêxia.
+         In other words, type In<Left CTRL>ddo^ne^xia  ==> get Inđônêxia.
+         or type In<Right CTRL>ddo^ne^xia  ==> get Inđônêxia.
+
+
+ IMPORTANT NOTE:
+ --------------------------
+
+ If you frequently type multisyllable words like Inđônêxia, you may be better off choosing
& a special Viet Option page that supports multisyllables such as the predefined page #7:
+
+     7.  Multi-Syllable with free marking (Type mark anywhere & Combine with last syllable)
+
& For more info go to the Viet Option page, click on the button to the right of checkbox 1, 
& see combobox B, select item number 4.
+ 
+ NOTE FOR NOTEPAD USERS:
+
+ If you accidentally press <Left CTRL> <Right SHIFT> together, the entire text may
& be shifted to the right.  You can undo by pressing <Right CTRL> <Left SHIFT> together.
& That is why it is highly recommended that you should press and release one key
& at a time.
+

Help-DisplayConversionMenu=After selecting (highlighting) text, you can enter a spmenu 
& sequence of key strokes and press the right mouse to display a conversion menu. This menu allows you
& to change the selected text to upper case, lower case, mixed case, etc.
+

Help-MoreKeys=Note: The notation <X> means press and release the key labelled with X
& immediately, irrespective of the character case.  For example, <CTRL> means
& press and release the CTRL key, <A> means press and release the 'A' key.
+
+ 1. Type <CTRL> <ALT> <ALT> <A> directly in an application to customize WinVNKey options for that application:
& keyboard mode, Unicode output method, fix overbackspacing problem,
& and fix multilined macros that fail to expand into many lines.
+     Type <CTRL> <ALT> <ALT> and 
+     - <V> to change the keyboard mode to "Auto-combine (Viet)"
+     - <M> to change the keyboard mode to English
+     - <L> to change the keyboard mode to Literal
+     - <S> to change the keyboard mode to Sleep
+     - <O> to change the keyboard mode to Off
+     - <R> to display the Run menu
+     - <T> to restore (maximize) the WinVNKey control panel
+     - <B> to minimize the WinVNKey control panel
+     - <C> to display the Converter dialog
+     - <X> to exit WinVNKey
+
+ 2. Type <Left CTRL> <Left CTRL> <Right Mouse> to display a conversion menu.
& This key sequence can be changed via option 4 on page "Special Keys".
+
+ 3.  Convert selected text using keyboard sequence:
+ Type <CTRL-C> to copy text to clipboard, then immediately type:
+
+      - <CTRL> <U> to convert selected text into "UPPER CASE"
+      - <CTRL> <L> to convert selected text into "lower case"
+      - <CTRL> <S> to convert selected text into "Sentence case"
+      - <CTRL> <T> to convert selected text into "Title Case"
+      - <CTRL> <G> to convert selected text into "tOGGLED cASE"
+
+      - <CTRL> <B> to convert selected text from one predefined charset to another
+
+      - <CTRL> <D> to convert selected text from one predefined charset to another and display in Notepad
+      - <CTRL> <A> to convert to Vietnamese Unicode by autoguessing the source charset and display in Notepad
+      - <CTRL> <V> to convert VIQR to Vietnamese Unicode and display in Notepad
+      - <CTRL> <Q> to convert to VIQR (VietNet) and display in Notepad
+      - <CTRL> <F> to fix weird characters in email (e.g. Yahoo email) and display in browser
+      - <CTRL> <W> to convert text (and correct UTF-8 errors if any) to a web page (html) and display in browser
+
+
+ 4. Convert selected text using mouse
+      - Hightlight text in an application,
+      - Type <Left CTRL> <Left CTRL> <Right Mouse> to display a conversion menu (this key sequence
& can be changed via option 4 on page "Special Keys),
+      - Choose an appropriate conversion type in the menu.
+
+ The conversion menu labels all conversion options with A1, A2, etc.
+ For conversion of character cases (option A1--A5) 
& or based on  predefined charset (option B)
& the result will be automatically pasted back to the application to replace the original text.
+
+ For other plain text conversion (option E1--E4) the result will be displayed in
& a separate scratch file.  By default, WinVNKey displays this file with Notepad.
& But you can change to Wordpad on page: Preferences | Miscellaneous.
+
+ For HTML conversion (option E5, E6) the result will be displayed in a separate browser.
+

[Keyboard Modes]

Help=Whether or not characters can combine depends on the keyboard mode:
+
+   0. OFF mode -- WinVNKey is inactive as if it were never running.
+   1. Autocombine (Viet Mode) -- In this mode every character you type
&  in will automatically combine with the previous character into Vietnamese if possible.
&   This mode is recommended if you are typing text mostly in Vietnamese.
&   For instance, ma' to^i  ==> má tôi
+
+   2. Combine On Request (English Mode) -- In this mode characters do
& not combine unless you request explicitly by preceding the base letter
& with an escape character, which is \.  For instance, Hello Kh\o^i ==> Hello Khôi.
& This mode is recommended if you are typing text mostly in English
& and occasionally in Vietnamese.  Smart Viet options are not available in this mode;
& accent marks must be typed immediately after the base letters.
+
+   3. Literal Mode -- In this mode what you type is what you get except
+        - the escape char \: you must type twice to get a single escape character
+        - and perhaps these special sequences:  \V, \M, \L, \S, \v, \m, \l.
& These sequences allow fast mode switching and can be enabled or
& disabled in the Advanced page.
+
+       Languages and macros are still active in literal mode. Thus if you want
& to type foreign languages and not Vietnamese, you should consider using
& the literal mode.
+
+   4. Sleep Mode -- In this mode WinVNKey sleeps and hence does not
&  combine characters.  Basically, what you type is what you get
&  except the wake-up sequence, defined by default as \WK!
&  (exactly four characters \ W K and ! ).  When you type \WK!,
&   WinVNKey will wake up and generate 4 backspaces to erase \WK!.
&   The new mode will be the same mode that WinVNKey was in before the sleep.
&   The sleep mode is as good as OFF mode for use in typing characters without accent marks to avoid
&  unwanted combination.  The advantage is that it allows fast mode switching
&  via keyboard strokes so that the user does not have to switch to a mouse.
+
+ Note that for keyboarding purposes it is sufficient to support only one mode
&  (mode 1) because the user can use hot keys to turn on/off Vietnamese mode.
&  However, the purpose of WinVNKey is to support the VIQR standards, which
&  were designed to handle Vietnamese data in keyboard entry and
&  in input/output streams (e.g. text files, where hot keys are impossible).
&  Thus WinVNKey decides to support all VIQR modes
&  including the sleep mode extension first introduced in MacVNKey.  
+

      
[Charsets]
A0=Other foreign codepages

[ComboHelp-Charsets]
title=Help on Character sets


;===============================
topic1=1. General
topic1.help=If your system is Windows 2000 or later and you use Office 2000 or later, you can choose
& Unicode character set.  If you use Office 97, you cannot use Unicode.  In this case you can use
& VISCII, VPS, VNI, or other 8-bit Vietnamese character sets.
+
+ You have to choose the appropriate fonts for each charset so that the characters will appear correct.  
& You can download various Vietnamese fonts by clicking on WinVNKey Run button -> Browse -> Links.
+

topic2=2. VISCII and MacVISCII charsets
topic2.help=VISCII is a Vietnamese character set designed by the VietStd Group in 1992 and was
& the main reason for WinVNKey development.   WinVNKey was designed to
& support this character set alone in versions 1 through 3.
& WinVNKey 4.x and 5.x continue to support it as the main character set for 8-bit applications.
+
+ MacVISCII is a superset of VISCII for use in the Macintosh world.
+
+ Fonts for both VISCII and MacVISCII:
+
+            1. ÁnhMinh 1.1,  ÁnhMinhH 1.1
+            2. Heo May 1.1,  Heo May Hoa 1.1
+            3. HoangYen 1.1,  HoangYenH 1.1
+            4. MinhQuân 1.1,  MinhQuânH 1.1
+            5. PhuongThao 1.1,  PhuongThaoH 1.1
+            6. ThaHuong 1.1,  ThaHuongH 1.1
+            7. UHoài 1.1,  UHoàiH 1.1
+            8. and all font names beginning with "VI " (meaning VISCII).
& Note there is a space following VI.
+
+ Note: MS Word XP may not display ở, ễ, ... correctly in certain VISCII fonts.  If this is
& the case, please download the latest version visfont0.exe from
+         http://winvnkey.sf.net
+ or specifically,
+         http://prdownloads.sf.net/winvnkey/visfont0.exe?download
+
+

topic2.link1.label=Download basic VISCII fonts visfont0.exe
topic2.link1.url=http://prdownloads.sf.net/winvnkey/visfont0.exe?download
topic2.link2.label=Visit archive of VISCII fonts at winvnkey.sf.net
topic2.link2.url=http://sf.net/project/showfiles.php?group_id=39420&package_id=33563


topic3=3. Unicode
topic3.help=Unicode is in general a 16-bit character set that contains characters from
& almost all languages ever known in the world.
& You can choose Unicode charset to type Vietnamese, Hán, Nôm, and many other
& languages.  But whether or not you can get 
& Unicode characters depends
& on your choice of Unicode output method and your applications.
+
+      1) Win 95: usually supports two clipboard methods only.
+      2) Win 98/ME: usually supports two clipboard methods and perhaps simulation.
+      3) Win NT/2000/XP: supports all Unicode output methods.
+
+ If an application does not support Unicode, there is no way you can get Unicode characters.
& One method to finding it out is to copy some Unicode chars whose code points are 
& greater than 255 (e.g. ạ ẹ ẻ)
& from a well known Unicode application (e.g. Notepad 2000 or later, Wordpad 2000 or later,
& Word 2000 or later) and paste into your application.  If you see question marks appears
& in place of Vietnamese letters, you can
& conclude the application does not support Unicode.
+
+ It is well known that the following applications support Unicode:
& Notepad 2000/XP, Wordpad 2000/XP, Microsoft Office 2000/XP/2003, Photoshop 7, etc.
+
+ If an application does not support Unicode, you can switch to an 8-bit charset such
& VISCII, VPS, or VNI, and choose VISCII, VPS, or VNI fonts, respectively.
+
+ Fonts for composed and precomposed Vietnamese Unicode:
+
+            1. Most Microsoft fonts released in Windows/Office 2000 or later like 
& Arial, Courier, Courier New, Tahoma, Garamond, Verdana, etc.
+
+            2. TriChlor fonts whose names begin with "VU " such as "VU AnhMinh", etc (vietunicode.sf.net)
& The TriChlor Group released a Unicode version of all its popular VISCII fonts in April 2004
& (VietFonts_TriChlor_Windows.zip at http://vietunicode.sf.net).
& Thus, if you have been using "Ánh Minh 1.1", "MinhQuân 1.1", ..., when switching to
& Unicode you can choose the corresponding fonts like
& "VU AnhMinh", "VU MinhQuan", ... to get the same look and feel of Vietnamese characters.
+
+            3. Any Unicode fonts that support Latin-based characters
+
+            4. VPS also releases a number of Vietnamese Unicode fonts (www.vps.org)
+
+ Following are a just a few websites that offer Vietnamese Unicode fonts.
+

topic3.link3.label=Download TriChlor Viet Unicode fonts
topic3.link3.url=http://sf.net/project/showfiles.php?group_id=39420&package_id=34111

topic3.link2.label=Download Viet Unicode fonts at zencomp.com
topic3.link2.url=http://zencomp.com/greatwisdom/fonts/

topic3.link1.label=Check 150 Viet Unicode fonts designed by Nguyen Van Hiep 
topic3.link1.url=http://www.echip.com.vn/echiproot/weblh/link/kho/funidhbk.htm

;====================
topic4=4. VIQR Convention
topic4.help=⁭If you choose VIQR or Vietnet, all true Vietnamese characters that you type in
& will be converted to VIQR format.
+
+ Regardless of the typing method chosen, you will get the output text in ASCII
& characters with ' ` ? ~ . representing Vietnamese tonemarks, etc.  For example,
+
+          To^i thi'ch mu`a thu.
+
+ As you can see, the ending dot is ambiguous: it can be a true period or just part of
& the letter u with a dot below.  It is up to the reader to understand the context.
+
+ To avoid this kind of ambiguity the standard VIQR convention adds a backslash before
&  a punctuation if it is really a punctuation and not a tonemark.  So this example becomes
+
+          To^i thi'ch mu`a thu\.
+
+ You can choose any of the following output methods:
+
+   1. Friendly VIQR - Don't add \ to output
+       e.g.   Chuye^.n Mu`a Thu.   Con nho+' ba me.  Con xa nha` dda~ la^u ro^`i.   
+
+   2. Standard VIQR - Add \ between vowel and punctuation mark
+       e.g.   Chuye^.n Mu`a Thu\.   Con nho+' ba me\.  Con xa nha` dda~ la^u ro^`i\.   
+
+   3. Smart VIQR - Add \ if really needed
+       e.g.   Chuye^.n Mu`a Thu\.   Con nho+' ba me\.  Con xa nha` dda~ la^u ro^`i.
+

topic4.link1.label=Read more about VIQR convention at Vietstd.org
topic4.link1.url=http://vietstd.sf.net


topic5=5. Cannot display ở, ễ, correctly in certain VISCII fonts.
topic5.help=MS Word XP may not display ở, ễ, ... correctly in certain VISCII fonts because
& they were designed before Unicode was supported.  If this is
& the case, please download the latest version visfont0.exe from
+         http://winvnkey.sf.net
+ or specifically,
+         http://prdownloads.sf.net/winvnkey/visfont0.exe?download
+

topic5.link2.label=Download visfont0.exe
topic5.link2.url=http://prdownloads.sf.net/winvnkey/visfont0.exe?download

topic5.link1.label=Go check all fonts at WinVNKey website
topic5.link1.url=http://sf.net/project/showfiles.php?group_id=39420


topic6=6. Download VNI fonts
topic6.help=All VNI font have names beginning with "VNI" such as "VNI Times."
& Most VNI fonts are commercial.  But the company also offers some fonts for free
& at its website
+          http://www.vnisoft.com
+
+ At the present time (Feb 2005) the following fonts are available:
+          VNI-Aptima
+          VNI-Helve
+          VNI-Times
+          VNI-Internet Mail
+
+ Once you have VNI fonts, you can use WinVNKey to type Vietnamese using VNI fonts.
& Simply choose charset "10. VNI Windows".
+

topic6.link1.label=Visit VNI website to download fonts
topic6.link1.url=http://www.vnisoft.com

topic7=7. VPS Character set
topic7.help=This character set was designed by the Vietnamese Professional Society.
& All VPS fonts have names beginning with "VPS " such as "VPS Times."
& You can visit www.vps.org to download fonts or software for free.
+
+ In addition to VPS fonts, the site also offers fonts for Vietnamese Unicode characters.
+


topic7.link2.label=Visit VPS website
topic7.link2.url=http://www.vps.org

topic7.link1.label=or visit the software page
topic7.link1.url=http://www.vps.org/rubrique.php3?id_rubrique=22

;====================================================

topic8=8. TCVN-3 or ABC
topic8.help=This character set does not have capital Vietnamese letters with tone marks
& such as Á, À, etc.   If you need these capital letters, you have to type 
& the corresponding lower case, then select the text and switch it to a capital font.
& The first task has been automated by WinVNKey; i.e., you can type capital tonemarked letters
& but WinVNKey& will automatically convert to lower case for you.  All you have
& to do is to change the text to an appropriate capital font.
+
+ For this reason ABC fonts are usually offered in pairs: a regular font and
& a capital font.  They are usually named based on the following convention:
+
+    - Regular font names begin with ".Vn" such as .Vn Time, .Vn Arial, etc.
+
+    - Capital font names begin with ".VN" or "VN" and end with "H" such as
& .Vn TimeH, .Vn ArialH, .Vn Lincoln H, etc.  Note that "H" can be preceded by a space or
& followed by style such as Bold, Italic, Bold Italic, Medium, etc: .Vn Arial H Bold
+

topic8.link1.label=Check ABC fonts at echip.com.vn
topic8.link1.url=http://www.echip.com.vn/echiproot/weblh/andi/ndc.htm

;====================================================

topic9=9. VietWare_F and VietWare_X
topic9.help=There are two types of VietWare charsets:
+       1) VietWare_F: single byte character set (F=fixed width character)
+       2) VietWare_X: double byte character set
+
+ Fonts for single-byte VietWare_F: font names begin with "SVN" (S == Single-byte)
+
+ Fonts for double-byte VietWare_X: font names begin with "VN" such as "VNtimes new roman", "VNArial".
+
+ A number of fonts for VietWare_F and VietWare_X are available in PcLeHoan archive at echip.com.vn:
+
+   http://www.echip.com.vn/echiproot/weblh/andi/ndc.htm
+

topic9.link1.label=Check VietWare F/X fonts at echip.com.vn
topic9.link1.url=http://www.echip.com.vn/echiproot/weblh/andi/ndc.htm

;====================================================

topic10=10. DHBK-1 and DHBK-2
topic10.help=There are two types of DHBK charsets:
+       1) DHBK-1: single byte character set
+       2) DHBK-2: double byte character set
+
+ Fonts for single-byte DHBK-1: font names begin with "Vn" such as "VnTimes", "VnArial", etc.
+
+ Fonts for double-byte DHBK-2:font names begin with "Vn" and end with "2" such as "VnTimes2"
+
+ A number of fonts for DHBK-1/2 are available in PcLeHoan archive at echip.com.vn:
+
+   http://www.echip.com.vn/echiproot/weblh/andi/ndc.htm
+
+ Note the DHBK font names are similar to VietWare_X at first look but DHBK-1 begins with
& "Vn" and  VietWare_X with "VN".
& This causes problem in RTF file conversion.  For example, suppose 
& your system has VnArial of DHBK-1 but you want
& to view your friend's MS Word files or RTF files that use VNArial of VietWare_X.  In this case MS Word on
& your system automatically replaces VNArial with VnArial because it is the only font available in
& your system that matches the name except for the upper/lower case.  However, this is completely wrong
& because the two fonts belong to different character sets and cause your text to look like garbage.
& To fix this you have to reset the character set associated with the fonts correctly.
+

topic10.link1.label=Check DHBK-1/2 fonts at echip.com.vn
topic10.link1.url=http://www.echip.com.vn/echiproot/weblh/andi/ndc.htm


topic11=11. TCVN-1 charset and LacViet fonts
topic11.help=This character set was defined by the Vietnamese government but is rarely used in practice.
& There are a number of fonts supporting this character set:
+
+     LacViet fonts -- used in Lac Viet Dictionary software
+

topic11.link1.label=Visit Lac Viet website in Vietnam
topic11.link1.url=www.lacviet.com.vn

topic12=12. Charsets U8HN, U8DN, U7HN, U7DN
topic12.help=1) U8HN = Unicode in 8 bits and Hex NCR
+     This is not exactly a character set but rather an HTML convention to express all Unicode characters
& greater than 8 significant bits in Numerical Character Reference in hex, i.e., &#xhhh; where
& hhh is the Unicode value in hex.  All characters less than or equal to 8 significant bits (less than 256)
& are represented as single bytes.
+
+ 2) U8DN = Unicode in 8 bits and Decimal NCR
+     This is not exactly a character set but rather an HTML convention to express all Unicode characters
& greater than 8 significant bits in Numerical Character Reference in decimal, i.e., &#ddd; where
& ddd is the Unicode value in decimal.  All characters less than or equal to 8 significant bits (less than 256)
& are represented as single bytes.
+
+ 3) U7HN = Unicode in 7 bits and Hex NCR
+     This is not exactly a character set but rather an HTML convention to express all Unicode characters
& greater than 7 significant bits in Numerical Character Reference in hex, i.e., &#xhhh; where
& hhh is the Unicode value in hex.  All characters less than or equal to 7 significant bits (less than 128,
& i.e., ASCII) are represented as single bytes.
+
+ 4) U7DN = Unicode in 7 bits and Decimal NCR
+     This is not exactly a character set but rather an HTML convention to express all Unicode characters
& greater than 8 significant bits in Numerical Character Reference in decimal, i.e., &#ddd; where
& ddd is the Unicode value in decimal.  All characters less than or equal to 7 significant bits (less than 128,
& i.e., ASCII) are represented as single bytes.

topic13=13. Vietnamese in ASCII, Windows 1252, Windows 1250
topic13.help=These are not exactly character sets but rather conventions to display Vietnamese.
+
+  1. Vietnamese in ASCII (no mark)
+      If you choose this, you can type in Vietnamese characters using any typing method but WinVNKey
& will drop all accent marks and keep only ASCII characters. 
& The final result you get is characters with no marks, i.e., just English characters.
& For example, type "Tooi ddi ho.c" but get "Toi di hoc"
+
+  2. Vietnamese in Windows 1252
+      If you choose this, you can type in Vietnamese characters using any typing method but WinVNKey
& will drop all accent marks that would produce characters not in Microsoft Windows codepage 1252.
& The final result you get is characters that are either ASCII or have accent marks in Windows codepage 1252 only.
& For example, type "Tooi ddi ho.c" but get "Tôi di hoc" because ô is a legal character in Windows 1252.
+
+  3. Vietnamese in Windows 1250
+      If you choose this, you can type in Vietnamese characters using any typing method but WinVNKey
& will drop all accent marks that would produce characters not in Microsoft Windows codepage 1250.
& The final result you get is characters that are either ASCII or have accent marks in Windows codepage 1250 only.
& For example, type "Tooi ddi ho.c" but get "Tôi đi hoc" because ô and đ are legal characters in Windows 1250.
+

topic14=14. VIQR in Windows 1252, Windows 1250
topic14.help=1. VIQR in Windows 1252
+ If you choose this, all Vietnamese characters if present in Windows 1252 will be displayed as is.  Otherwise, they
& will be displayed in VIQR convention.
+
+ For example, typing "Tooi ddi ho.c" will give "Tôi ddi ho.c" because ô is a legal character in Windows 1252.
+
+ 2. VIQR in Windows 1250
+ If you choose this, all Vietnamese characters if present in Windows 1250 will be displayed as is.  Otherwise, they
& will be displayed in VIQR convention.
+
+ For example, typing "Tooi ddi ho.c" will give "Tôi đi ho.c" because both ô and đ are legal characters in Windows 1250.
+


topic15=15. Don't see my character set in WinVNKey listing
topic15.help=If you have a character set not listed in WinVNKey,
& please contact the author to get support:
+
+     Author: Hoc D. Ngo
+     Email: Winvnkey-users@lists.sf.net  , hoc96@yahoo.com
+     Forum: http://www.vn.net/viewforum.php?forum=3

topic15.link2.label=Contact Hoc D. Ngo at Winvnkey-users@lists.sf.net  
topic15.link2.url=topic7.link1.url=mailto:Winvnkey-users@lists.sf.net  
topic15.link1.label=Visit WinVNKey forum
topic15.link1.url=http://winvnkey.sf.net/forum/index.php



[Output Method]
U0=0. Automatic
U1=1. Clipboard using CTRL-V
U2=2. Clipboard using SHIFT-INSERT
U3=3. Regular (e.g. Outlook 2000 or later)
U4=4. Simulation (Other Office 2000 or later)
U5=5. Unicode (Win 2000/XP or later)
U6=6. Clipboard using CTRL-V for all accented chars (e.g. Pidgin)
U7=7. Clipboard using SHIFT-INSERT for all accented chars (e.g. Pidgin)

V1=1. Friendly VIQR - Don't add \ to output
V2=2. Standard VIQR - Add \ between vowel and punctuation
V3=3. Smart VIQR - Add \ if really needed

A0=When the "Output Method" is automatic, WinVNKey will automatically select the following method
+     XXX
+ for all applications except some well-known programs such as:
+       - Microsoft Office:  automatically select "3. Regular"
+       - pidgin or gaim: automatically select "6. Clipboard using CTRL-V for all accented chars"
+
+ But if you have some applications that you want to set specific output methods for them, how do you do?
+
+ Answer: WinVNKey allows you to customize certain settings for individual applications.  To this
& end, you first run the application, then type directly into it the following four key strokes:
+
+         <CTRL>  <ALT>  <ALT>  <A>
+
+ that is, press and release CTRL, press and release ALT twice, then press and release key "A"
& (do not press SHIFT key).  When a dialog appears, you can adjust the settings to apply to the application alone:
+
+         - change keyboard mode
+         - change output method
+         - fix some macro bugs
+     

[Keyboard Mode]
K1=0. OFF
K1=0. Tạm ngưng hoạt động
K2=1. Auto combine (Viet)
K3=2. Combine On Request (English)
K4=3. Literal (no combine, except \)
K5=4. Sleep (no combine)

[Run Button]
R1=Hiển thị chữ Việt
R2=About ...
R3=Browse ...
R3A=Download ...
R3B=Open folder ...
R3C=Report bugs ...

R4=WinVNKey Manual ...
R5=Preferences ...
R5.1=Choose default for Main page
R6=Look up Hoinga ...
R7=Spell check ...
R8=Type Hán Nôm ...
R9=Run Charmap ...

R10=Unicode Typepad ...
R11=Convert ...
R12=Font browser ...
R13=Reset ...

B1=Contributions ...

Help-Manual=Can't find help file wvnkeyEN.chm in directory:
+           XXX
+
+ Reason: You downloaded and installed a package that do not contain a help file.
& Because the help file is larger than 3MB, it is usually not bundled in every release
& to help reduce download time.   
+
+ You have two choices:
+
+ 1) View the online manual:
+          - Visit WinVNKey home page:  http://winvnkey.sf.net
+          - Click on the "Online Help" hyperlink on the left pane
+
+     You can also change WinVNKey menu to link directly to the online help:
+          - Click on the Run button on the Main page
+          - Choose menu:  Prefererences | Appearance
+          - Choose option B1.
+
+ 2) Or you can download the help file wvnkeyEN.chm from http://winvnkey.sf.net
& and place it in the directory mentioned above.
+


[Browse Menu]

menu1.name=What's New?
menu1.address=http://winvnkey.sf.net/whatsnew.html
menu2.name=Online Help
menu2.address=http://winvnkey.sf.net/webhelp/index.htm
menu3.name=Main forum
menu3.address=http://winvnkey.sf.net/forum/index.php
menu4.name=Forum at Vietunicode
menu4.address=http://vietunicode.sf.net/forum/viewforum.php?f=2
menu5.name=Mailing Lists
menu5.address=http://sf.net/mail/?group_id=39420

menu6.name=WinVNKey home page
menu6.address=http://winvnkey.sf.net
menu7.name=Trichlor home page
menu7.address=http://trichlor.sf.net
menu8.name=Viet-Std home page
menu8.address=http://vietstd.sf.net
menu9.name=VietUnicode
menu9.address=http://vietunicode.sf.net
menu10.name=vn.net
menu10.address=http://www.vn.net

; Blank separator
menu11.name=---
menu11.address=

menu12.name=Other Links
menu12.address=file:html\links.html



[Download Menu]

menu1.name=Download WinVNKey
menu1.address=http://sf.net/projects/winvnkey

menu2.name=Download WinVNKey beta at VietPali
menu2.address=http://sf.net/projects/vietpali

menu3.name=Download fonts from WinVNKey website
menu3.address=http://sf.net/project/showfiles.php?group_id=39420

menu4.name=Download fonts from VietUnicode website
menu4.address=http://vietunicode.sf.net/main.html#UNICODE-COMPLIANT_FONTS

menu5.name=Download fonts from PcLeHoan website
menu5.address=http://www.echip.com.vn/echiproot/weblh/andi/taifonvn.htm

menu6.name=Download font "HANNOM A/B" (either low or high resolution)
menu6.address=http://sf.net/project/showfiles.php?group_id=39420&package_id=164613

menu7.name=Download font Arial Unicode MS (14 MB)
menu7.address=http://www.star-italia.net/home/download/aruniupd.exe 


[OpenFolder Menu]
menu1.name=WinVNKey Install Folder
menu1.address=installdir

menu2.name=WinVNKey EXE / DLL Folder
menu2.address=exedir

menu3.name=Macro Folder
menu3.address=dir:Macros

menu4.name=Han Nom Folder
menu4.address=dir:HanNom


[Page HoingaLookup]
L0=Look up ?/~
L1=Type one Vietnamese Word with hook-above or tilde
L2=Look up
L3=Change Font
L4=Found
L5=Status:
L6=This word is not Vietnamese!
L7=Try another word.
L8=%s has no hook-above or tilde!
L9=%s has no match!
;
Help=1. Whether a Vietnamese word goes with a tilde or hook-above tonemark
& depends on the context in which it is used.
+
+ Simply type a single Vietnamese
& word with either a tilde or a hook-above, then click on the
& "Look up" button to see its use in different scenarios.
+
+
+ 2. The input box and the output box use the charset
& currently selected in the main control panel.
& Thus you have to choose the correct font
& in order to display text correctly.
& For example:
+    - "Arial" for Unicode
+    - "Sans Serif VISCII 1.1" for VISCII
+    - "Sans Serif ABC" for TCVN-3 aka ABC
+    - "Sans Serif VNSCII" for VPS
+    - font with prefix "VNI" for VNI


A2=Switch mode by keyboard commands
A4=Change certain characters to numbers
A5=Change certain numbers to characters
A6=Enable hot keys

W1=Some options on this page were changed and have not been saved yet.
W2=Do you want to keep these changes?


[Page Options]


0. No Smart (type mark after letter)=
1. Syllable in VietNet style (Type mark after letter & Combine with syllable)=
2. Word in VietNet style (Type mark after letter & Combine with word)=
3. Syllable with fast marking (Type mark after word & Combine with syllable)=
4. Word with fast marking (Type mark after word & Combine with word)=
5. Syllable with free marking (Type mark anywhere & Combine with syllable)=
6. Word with free marking (Type mark anywhere & Combine with word)=
7. Multi-Syllable with free marking (Type mark anywhere & Combine with last syllable)=
8. Viet Syllable with free marking (Type Viet only & Don't correct spelling)=
9. Viet Word with free marking (Type Viet only & Correct spelling)=
10. VietAnh Syllable with free marking (Type Viet and English & Don't correct spelling)=
11. VietAnh Word with free marking (Type Viet and English & Correct spelling)=
12. Delay echoing accented chars (Type mark after letter, no smart)=
13. My first options=
14. My second options=

indo=- Inddo^ne^xia --> Inđônêxia (multi-syllable)

Current settings for this page:=

X1=The following smart features are available when the keyboard mode is Autocombine:

Enable smart typing method=
Autochange letters=
Change syllables=Change syllables by a single key (useful if using lazy syllable macros)
Enable syllable correction=
Uncombine as soon as syllable becomes non Vietnamese=
Enable single word correction on word completion=
Uncombine as soon as word becomes non Vietnamese=
Delay echo until Viet char is complete=
Delay.Explain=When checked, all smart features are disabled and accent marks must be typed after base letters.

A. Where to type common accent marks?=
1. After vowel (e.g., ca', ba~i, hoa`ng)=
2. After word (e.g., ca', bai~, hoang`)=
3. Anywhere in syllable (e.g. to`an, toa`n, toan`)=

B. Combine the accent mark if the result is forming ...=
1. a Viet syllable of a mono-syllable word=a Viet syllable of a mono-syllable word (syllable is Viet but the whole word may not be Viet, e.g. crôm)
2. a pronounceable Viet word regardless of spelling=
3. a pronounceable Viet word with correct spelling=
4. a Viet syllable of a multi-syllable word=4. a Viet syllable of a multi-syllable word (e.g. Inđônêxia)

is forming tuân, perhaps=
mono-syllable=mono-syllable, the syllable part must be Vietnamese although the whole word may not be Vietnamese 

multi-syllable=
oaý is not a Vietnamese syllable=
pronounceable=
wrong spelling but pronounceable=
not pronounceable, only xoáy is pronounceable=
not Vietnamese=
correct spelling=
wrong spelling=
not Vietnamese syllable=
not pronounceable=
auto-adjustment=


Autochange consonants before vowel=
Autochange initial letters of words=
g <-> gh, ng <-> ngh when typing mark=
f -> ph when typing mark=
z -> gi when typing mark=

Autochange consonants after vowel=
ic -> ich automatically=
ic -> ich when i has tonemark=
k -> ch when vowel has mark=
g -> ng when vowel has mark=
h -> nh when vowel has mark=

Autochange syllables starting with i and y=
i -> y when syllable has accent mark=
y -> i/uy when y has tonemark=

Quick vowels=

Adjust tonemark on strong vowel=
Auto add/delete second horn=
Autochange ưn -> ưng=
Autoadd ^=
Autoinsert ơ into ưm (except ừm, hừm)=
Autoinsert ơ into ưp=
Correct tone marks:=
Correct ?/~ tonemark=
Add ' to words ending in c, ch, p, t=
Add ' to accented words ending in c, ch, p, t=

Correct vowels:=
Add/Delete ê=
Add/Delete ô=
Add/Delete ơ=
Add/Delete ^=
Add/Delete ê for words with accent marks only=
Add/Delete ô for words with accent marks only=
Add/Delete ơ for words with accent marks only=
Add/Delete ^ for words with accent marks only=
Change ending letter I to i

List-Tip=(Right click to see menu)


Correct beginning consonants:=
Correct s <-> x=
s <-> x for words with accent marks only=
Correct p -> ph=
p -> ph for words with accent marks only=

Correct ending consonants:=
Correct c <-> t for words with accent marks only=
Add/Delete ending g=
Add/Delete g for words with accent marks only=
Add/Delete ending h=
Add/Delete h for words with accent marks only=




@Help=SMART DIACRITICAL MARK PLACEMENT
+
+ You can click on the button to the right of checkbox 1 to see all the methods of
& typing diacritical marks and combining them.
+
+ WinVNKey currently supports 3 ways of typing an accent mark (methods A1, A2, A3) and 
& 4 ways of combining it (methods B1, B2, B3, B4), resulting in 12 different combinations.
& For each combination there are a number of sub-options to check spelling
& and provide correction.  
& For simplicity WinVNKey predefines a number of frequently used settings known as 
& Viet Option pages.
+
+ If you choose method B3, an accent mark will combine if the result is a legitimate Vietnamese word.
& In other words, the accent mark will not combine if the resulting word does not exist in
& Vietnamese dictionaries.  WinVNKey relies on its internal dictionary to make this decision.
+
+ For example, tãn has Vietnamese pronunciation but is not meaningful (incorrect spelling) and
& hence is not listed in WinVNKey's internal dictionary.
& Thus, typing tan~ does not combine into tãn for method B3.
& If you really want tan~ to combine into tãn, you must choose method B1 or B2, which combines accent
& marks based on the syllable part only.  In this case, the syllable an and the tonemark ~ will combine into ãn.
+
+ It is possible in method B3 that WinVNKey does not combine accent marks for a legitimate
& Vietnamese word.  This is because this word is missing from WinVNKey's dictionary.
& For example, if WinVNKey's dictionary does not have "coàn", you will not get "coàn" when typing "coan`".
& In this case, please report the bug to the author at Winvnkey-users@lists.sf.net or hoc96@yahoo.com.
& While waiting for the next WinVNKey release, you can work around as follows: 
+
+        - Go to the tabbed page entitled: "Viet Word Processing"
+        - Click on the hyperlink containing "MyVietDict.txt"
+        - Add the word "coàn" to the file (the line must not begin with a semicolon)
+        - Save the file
+        - Click the "update" button to update the dictionary.
+
+ Because method B3 knows when to combine accent marks for every Vietnamese word, it is the
& smarttest method offered to advanced users.  However, if you find out that too many words are missing
& from WinVNKey internal dictionary, you can switch to method B1 or B2, in which accent marks
& always combine as long as the syllable is pronunciable in Vietnamese.  That's why WinVNKey
& chooses Viet Option Page #5 as the default in the main control panel.
+
+ Note on typing speed:
+ -----------------------------
+
+ All smart typing methods are a little bit slower than the no-smart method (method 0) because of
& extra processing.   Usually you should see no typing speed difference
& among these smart methods.  However, if your machine
& is very old, you may notice some delay between typing and seeing characters appear on screen.
& If this is the case and you really want speed, go back to the no-smart method
& (method #0).
+

Help-Autochange=AUTOCHANGE LETTERS
+
+ Note: When the listbox appears, you can right click on any row to see a menu of options.
& In addition, you can right click on the column header for a different menu as well.
+
+ To understand the autochange feature, let's consider the case of c converted
& to k and vice versa.
+
+ All Vietnamese words starting with c can only be legally followed by a, ă, â, o, ô, ơ, u, ư.
& and all Vietnamese words starting with k can only be legally followed by e, ê, i, y.  In short,
+       1. c + (a, ă, â, o, ô, ơ, u, ư)
+       2. k + (e, ê, i, y)
+ Based on this rule, WinVNKey can replace c with k if users wrongly type e, ê, i, or y after c.
& Or replace k with c if users wrongly type a, ă, â, o, ô, ơ, u, or ư after k.
+
+ This option is very convenient if users want to type Vietnamese text only.  But if they
& want to type both Vietnamese and foreign languages, this option can change text
& against their intention.  This is because the c/k rule mentioned above is correct
& in Vietnamese only.  It may be wrong in foreign languages.  In English, for example, the vowels
& e, i, y can legally follow c such as cent, city, cigarette, Cynthia.
+
+ To minimize unwanted replacement you should apply the c/k rule only to those words that
& are surely Vietnamese.  There are two common scenarios:
+    (a) If you know in advance the text is purely Vietnamese, you can always apply the c/k rule.
+    (b) If the text consists of both Vietnamese and foreign languages, you should apply
& the c/k rule to those words that have Vietnamese accent marks.  Consider the case you are
& typing both Vietnamese and English.  If you type ce, WinVNKey is not sure if the current
& word is Vietnamese or English.  But if you type cê, WinVNKey is sure that you are typing
& a Vietnamese word.
+
+ This is why WinVNKey supports two options for c/k changes, which are labeled as options 2a
& and 2b as follows:
+       2a. c <-> k (unconditionally, applicable to pure Vietnamese text)
+       2b. c <-> k when typing mark (applicable when typing both Vietnamese and foreign languages)
+
+ In general, you can control when autochange occurs:
+        a.  Autochange occurs unconditionally
+        b.  Autochange occurs when the existing string has Vietnamese accent marks or when you type
& a Vietnamese accent mark.
+
+
Help-ChangeSyllable=CHANGE SYLLABLES BY ADDING A DIFFERENT ENDING LETTER
+
+ Note:  When the list box appears, you can right click inside the box to see additional options.
& In addition, you can right click on column headers to see menu.
+
+ Goal:
+                     Type:  thanhg => thang
+                     Type:  thiêngm => thiêm
+                     Type:  hoàngh => hoành
+
+ "Change Syllable" is an option that allows WinVNKey to quickly change an existing syllable
& to another syllable when the two syllables differ, in general, only in the ending character.
+
+ Example:  
+ "anh" and "ang" are two syllables that differ only in the last character.  Suppose
& you have typed "anh" and now want to change it to "ang".  Normally, you need two keystrokes:
+      - type backspace to erase 'h'
+      - then type 'g'
+ and the result is "ang".
+
+ But if you use the "Change Syllable" option, you need only one keystroke:
+      - type 'g' immediately after "anh"
+ and the result is "ang".  In short, typing "anhg" will give "ang".
+
+ Let's now consider another example.  Suppose you have turned on option 2.2 as follows:
+        2.2  a.. + i -> ai
+ i.e., typing 'i' after all syllables beginning with 'a' will change them to syllable "ai".  However,
& if you type "Manila" (Capital of the Philippines), you will get "Maila".  
+
+ This example shows
& that the "Change Syllable" option is most appropriate to typing pure Vietnamese text only.
+
+ If you need typing both Vietnamese and English together, you should turn on option 5 or
& 7 (uncombine option) so that when the sequence of letters becomes non Vietnamese,
& WinVNKey will undo, restoring all the original raw characters that you typed in.  
+
+ In the said example, if you turn on option 5, then when you type the letter l, the word 
& "Mail" becomes non Vietnamese and WinVNKey will restore it to "Manil" immediately.
+
+ WHY DOES WINVNKEY SUPPORT "CHANGE SYLLABLE" CAPABILITY?
+ ----------------------------------------------------------------------------------------------
+
+ The majority of Vietnamese typists do not need this capability.  Normally, if they want to get 
& "ang", they will type three letters a n g directly.  Rarely do they mistype "anh" and have to
& correct to "ang".  So, why does WinVNKey support this feature?
+
+ The answer is that this capability works best when used in conjunction with lazy syllables.
+
+ The goal of lazy syllables is to help type Vietnamese syllables quickly with short macros.
& But there are hundreds of syllables in the Vietnamese language.  To define lazy syllables
& for all Vietnamese syllables and to remember them all defeat the initial goal of
& lazy syllables.  Thus, it is best to define just a small number of lazy syllables for
& those syllables that need many key strokes like "iêng" (5 key strokes), oăc (4 key strokes),
& "uyêt" (5 key strokes), etc.  After using lazy syllables, we can use
& the "Change Syllable" option to quickly change to a different syllable.
+
+ Example:  If the lazy syllable file "4. Change single symbols" is enabled, you can type / to get "iêng".
& Thus to obtain "tiêm", you can type as follows:
+         t/  => tiêng
+         tiêngm => tiêm
+ i.e., you need only 3 key strokes: t / m
+
+ Thus this Change Syllable option is most useful when applied to a syllable that is generated by
& a macro.  Therefore, WinVNKey allows users to control when the change can occur.  There are
& two options:
+
+     (a) Change syllable if and only if it is not typed directly.
+          That is, change syllable if and only if it is generated from a macro or autochange. This is the
& case of typing t/m in the example above:  the iêng syllable was not typed letter by letter directly
& but was created by a lazy syllable macro;
+ 
+     (b) Always change syllable no matter how it is created
+          If this option is chosen, typing tiêngm always gives tiêm, even if users type every letter 
& directly or use the lazy syllable /.
+
+
+ HOW TO ADD MORE "CHANGE SYLLABLE" CASES
+ ----------------------------------------------------------------------
+
+ WinVNKey currently supports 20 syllable cases.   The first case consists of all syllables ending in ch, ng
& and nh.  The remaining cases are for syllables starting with a, ă, â, e, ê, etc.  WinVNKey processes these
& cases from top to bottom, i.e., from case 1 to 20.
+
+ If all these change syllable cases do not meet all your typing need, you can change
& syllables by defining lazy syllable macros.
+
+ For example, suppose WinVNKey did not define the option for changing iêngm into iêm.
& You can simply define a new lazy syllable
+         iêngm =iêm
+ This will work as long as you turn off options 5 and 7 on the "Viet Option Page".
& If you turn on option 5 or 7, WinVNKey will automatically uncombine the circumflex as soon as
& you type 'm'.  Depending on your settingmu(see "4. Enable Syllable Correction | 4. Autoadd ^"), 
& iêngm can become ie^ngm or iengm.  Because there is no lazy syllable that matches
& either ie^ngm or iengm, typing iêngm will never be changed to iêm.
+
+ Although lazy syllables can address syllable change issue,
& they are not as powerful as the "Change Syllable" option because they do not offer users
& the fine control over when to change the syllable.
+
+

Help-SyllableCorrection=ENABLE SYLLABLE CORRECTION
+
+ Note: When the listbox appears, you can right click on any row to see a menu of options.
& In addition, you can right click on the column header for a different menu as well.
+
+ Syllable correction is an option that allows WinVNKey to automatically correct illegal
& syllables or adjust syllable properties (such as positioning accent marks).  When correcting
& syllables, WinVNKey ignores the initial consonants and considers only the syllable part.
& It corrects only the syllable part without paying attention to the meaning or spelling of the whole word.
+
+ Example 1:  Type "lước".
+ If we consider the whole word, "lước" is a mispelled word and should be changed to "lướt" (as used
& in "lướt sóng", "đọc lướt qua", etc).  But if we consider only the syllable part, "ước" is
& a correct syllable.
+
+ Example 2: Type "nuớc".
+ If we consider the syllable part only, then "uớc" is a wrong syllable.  It should have two horns, i.e., "ước". 
& This is why WinVNKey supports option "2. Auto add/delete second horn".
+
+
Help-WordCorrection=ENABLE WORD CORRECTION UPON WORD COMPLETION
+
+ Note: When the listbox appears, you can right click on any row to see a menu of options.
& In addition, you can right click on the column header for a different menu as well.
+
+ Word correction is an option that allows WinVNKey to automatically correct illegal word spelling.
& Correcting word spelling is a complex task.  At the present time WinVNKey offers only a limited
& capability of correcting word based on single word context.  That is, the correction
& process does not rely on surrounding words.
+
+ When does WinVNKey correct word spelling?
+ -----------------------------------------------------------
+
+ When you type in letters and accent marks, WinVNKey will always check if the sequence of characters
& is complete.  When the sequence becomes a complete word, WinVNKey will proceed to correct the word.
+
+ Example 1:  The process of typing the word "cỏng" can be detailed as follows (omit all double quotes):
+   - type c => "c":  word is incomplete because it can accept letters h and other vowels.
+   - type o => "co":  word is incomplete because it can accept a mark and/or other letters c, i, m, n, p, t, etc.
+   - type ? => "cỏ":  word is incomplete because it can accept a circumflex or horn, and/or other letters c, i, m, n, p, t, etc.
+   - type n => "cỏn":  word is incomplete because it can accept a circumflex or horn, and/or g
+   - type g => "cỏng":  word is incomplete because it can accept a circumflex.
+   - type space => "cỏng ":  word is complete because the space is a word delimiter.
+
+ In this example WinVNKey will check spelling as soon as you type the space or any other word
& delimiter (comma, semi-colon, etc).
+
+ Example 2:  The process of typing the word "cổng" can be detailed as follows (omit all double quotes):
+   - type c => "c":  word is incomplete because it can accept letters h and other vowels.
+   - type o => "co":  word is incomplete because it can accept a mark and/or other letters c, i, m, n, p, t, etc.
+   - type ^ => "cô":  word is incomplete because it can accept a tonemark, and/or other letters c, i, m, n, p, t, etc.
+   - type ? => "cổ":  word is incomplete because it can accept other letters  i, m, n, etc.
+   - type n => "cổn":  word is incomplete because it can accept g
+   - type g => "cổng":  word is now complete because it can no longer accept any mark or letter.
+
+ In this example WinVNKey will check spelling as soon as you type 'g' without waiting for a space
& or any other word delimiter.
+
+




Help-DelayEcho=A Vietnamese character is said to be incomplete when it can combine
& with the next character such as a, â, d, e, ê, i, etc.    An incomplete character
& can combine with subsequent characters until the new character becomes complete, i.e.,
& cannot combine anymore.
+
+ For instance, typing a single vowel e is not enough to say it is a complete
& Vietnamese vowel.  If you next type one of the following characters:
+     - char n, then e does not combine with n, hence e is complete.
+     - char ', then e combines with ' into é.  In this case, é is complete.
+     - char ^, then e combines with ^ into ê.   ê is still incomplete because
& it can combine with a subsequent tonemark such as ' ` ? ~ .
+
+ When you enable 'delay echo', WinVNKey delays displaying an incomplete
& character.  You have to continue typing; whenever the character becomes
& complete,  WinVNKey will display it.
+
+ Normally when you type e, WinVNKey will display e.  If you next type ', WinVNKey
& will convert it into two characters:  one backspace and letter á in that order. The backspace
& is used to erase the last character e.  The net result is a single letter á in place of the old letter e.
& But if an application does not see the backspace and see only letter á, the result becomes aá.
& In this case it helps to choose the delay echo mode.  In this mode, when you type a, you will
& see nothing. Then if you type ', the letter á will appear because it is complete.  No backspaces are
& generated in this process.
+
+ Delay echo mode is useful for certain applications where you type in a single
& accented Vietnamese vowel but get multiple of them, say typing e^' but getting eêế.
& These applications ignore the generated backspaces.  There are many reasons for this.
& For example, the applications can recognize
& fake backspaces and discard them.
& Or the generated backspaces do not arrive at the applications at all.
& Or they do arrive asynchronously out of sequence.  Note that for these applications,
& smart Vietnamese typing, languages, macros, and Han/Nom typing do not work because they
& all need to generate backspace characters to erase the old strings.
+

;=======================
Help-Toggle=Press and release immediately the right SHIFT key to undo
& unwanted combination or uncombination.
+
+ If combination or uncombination occurs against your will, you can undo it
& immediately by a single press and release of the right SHIFT key.  For example,
+
+     Type c, a, m, '     ==> get cám.  
+     Now type s  ==> get cam's  (' becomes detached)
+     Now press and release right SHIFT key to undo  ==> get cáms.  
+     Now press and release the right SHIFT key again to undo ==> get cam's.  
+
+ Thus the right SHIFT key is used to toggle combination and uncombination.
+

Help-BeginNewWord=Press and release immediately a CTRL key to make
& WinVNKey forget the current word and begin a new word for accent-combining purposes.
+
+ Thus if a word is not Vietnamese, you can force an accent mark to combine
& with a vowel by pressing and releasing a CTRL key before typing & the vowel.  For example,
+
+     1) Type h, a, ', o, ` ==> get háo`  (no combine  because the result is not Vietnamese).
+
+     2) Type h, a, ', press and release CTRL, o, `  ==> get háò (grave combines with o).
+
+ Note that immediately after you pressd and released a CTRL key, WinVNKey forgot all the
& characters you had been typed in and began to wait for a new word.  When you next
& typed o`, WinVNKey thought that the new word was ò, which was legal.  Hence it
& combined ` with o into ò.
+

@Hyperlink-Autochange initial letters of words=These options are also available in option 4 of "Typing Method" page.
& But the options presented on this page offer users fine control over when the change can occur.
+
+     a.  Always change unconditionally
+     b.  Change only when the word is unambiguously Vietnamese, i.e., contains Vietnamese mark.
+
+
+ Note: When the listbox appears, you can right click on any row to see a menu of options.
& In addition, you can right click on the column header for a different menu as well.
+

@Hyperlink-Autochange syllables starting with i and y smartly=This option relies on 
& the whole word being typed and if the word spelling is incorrect, WinVNKey
& will proceed to change the ending syllables in an effort to correct its spelling.
+
+     -  if the typed word has correct spelling, WinVNKey will not change it, e.g. khi -> khi
+     -  if the typed word has incorrect spelling, WinVNKey will attempt to change it, e.g. khy -> khuy (see 7a)
+
+ Depending on the individual words the change can be different.  You can choose when
& the change can occur, i.e., 
+
+     a.  Always change unconditionally
+     b.  Change only when the word is unambiguously Vietnamese, i.e., contains Vietnamese mark.
+
+ You can achieve the same result of options 8 through 14 by using Lazy Syllable macros.
+
+ Note: When the listbox appears, you can right click on any row to see a menu of options.
& In addition, you can right click on the column header for a different menu as well.
+

@Hyperlink-Change i->y=This option applies to all syllables starting with i,
& or more precisely, all words that begin with a vowel and that vowel is i.
& If these words do not exist with the initial y (i.e. iên) but exist with the alternative vowel y (i.e. yên),
& WinVNKey will use the alternative form (i.e. yên).
+
+ Examples:  iên => yên,  iêu => yêu
+
+ Exception: uinh => uynh
+ The exception means that WinVNKey will convert i to y if the syllable containing i (not necessarily at
& the start of syllable) does not exist but the counterpart (with i replaced with y) does exist.
+
+

@Hyperlink-Change y->uy=This option applies to all words that have a 'y' syllable, i.e., the
& syllable part contains only one letter y.
+
+ WinVNKey will convert from y to uy if the result
& is a legal word.
+
+ Example: khy => khuy.  Because "khy" is never a legal word, 
& WinVNKey will try converting it to "khuy".
& Because this is a legal Vietnamese word, WinVNKey will keep this result. 
+

@Hyperlink-Change yn->uyên=This option converts yn to uyên or uyn.
& You have control over when to change yn to uyên or uyn:
+          (a) always change unconditionally irrespective of the word having a tonemark,
+          (b) change only when yt carries a tone mark (ýn, ỳn, ỷn, ỹn, ỵn)
+
+ How does this option work?
+ -----------------------------------
+
+ First, WinVNKey tries converting yn to uyên.  If the result becomes a legal Vietnamese word,
& WinVNKey will keep it.
+
+ If not legal, WinVNKey will try converting to the alternative form uyn.  
& If the result becomes a legal Vietnamese word, WinVNKey will keep it.
& Otherwise, WinVNKey will keep the original syllable yn.
+
+ How to type uyn if both forms uyên and uyn are legal ?
+ ----------------------------------------------------------------------
+
+ Consider tuyên and tuyn.  Both end with the same letter n.
& Therefore, tyt can be converted to either tuyên or tuyn. 
& But WinVNKey decides to convert yn to uyên simply because the uyên syllable
& occurs more often than the uyn syllable.
+
+ After typing tyn and getting tuyên, if you really want to change to tuyn,
& you can simply retype the last character n.
+        - tyn -> tuyên
+        - retype n: tuyênn -> tuyn
+

@Hyperlink-Change yt->uyêt=This option converts yt to uyêt or uyt.
& You have control over when to change yt to uyêt or uyt:
+          (a) always change unconditionally irrespective of the word having a tonemark,
+          (b) change only when yt carries a tone mark (ýt or ỵt)
+
+ How does this option work?
+ -----------------------------------
+
+ First, WinVNKey tries converting yt to uyêt.  If the result becomes a legal Vietnamese word,
& WinVNKey will keep it.
+
+ If not legal, WinVNKey will try converting to the alternative form uyt.  
& If the result becomes a legal Vietnamese word, WinVNKey will keep it.
& Otherwise, WinVNKey will keep the original syllable yt.
+
+ How to type uyt if both forms uyêt and uyt are legal ?
+ -------------------------------------------------------------------
+
+ Consider huyêt and huyt.  Both are legal because they are the intermediate forms
& of the legal Vietnamese words, say, huyết and huýt.  Both end with the same letter t.
& Therefore, hyt can be converted to either huyêt or huyt. 
& But WinVNKey decides to convert yt to uyêt simply because the uyêt syllable
& occurs more often than the uyt syllable.
+
+ After typing hyt and getting huyêt, if you really want to change to huyt,
& you can simply retype the last character t.
+        - hyt -> huyêt
+        - retype t: huyêtt -> huyt
+

@Hyperlink-Correct compound HoiNga=WinVNKey can correct  ?/~ for multiple words based on its internal database (see Run | Lookup Hoinga)
& and some hoinga algorithm for two words that begin with the same consonants (such as mạnh mẽ, lấp lửng, bảnh bao, v.v.).
& This support is in no way perfect.  It will be improved over time with newer releases of WinVNKey.
+
+ In cases where WinVNKey cannot correct  ?/~ for certain compound words, users have a choice of entering the correction in the form of Lazy Word macros
& and enable them on the Main page.  To this end WinVNKey releases a macro file sample named "Correct compound word spellings.txt".
+

@Hyperlink-Correct word spacing=The correct spacing between two consecutive words is one space.
+
+ If this option is enabled and if you have more than one space between two words, WinVNKey will keep only one and erase the rest. 
+
+ This option is very helpful in checking Vietnamese spelling of multiple words.
+

@Hyperlink-Correct sentence spacing=A sentence is usually ended with a period, or a question mark, or an exclamation mark.  
+
+ If this option is enabled and if you have one or more spaces after a sentence, WinVNKey will 
& either add or delete them to make sure there are only two spaces after a sentence.
+
+ NOTES:
+ There is no unique rule on the number of spaces after a sentence ending mark.  The common practice is as follows:
+             - leave only one space if you are in Europe
+             - leave two spaces if you are in the United States.
+
+ However, the two space practice is commonly used in the United States if you are using typewriters or fixed fonts like Courier.  For typesetting
& with proportional fonts a single space is preferred.  For more information on this topic, read this link about the double space debate:
+
+          http://rosendorf.us/blogdorf/archive/2005/07/14/449.aspx
+




[Page VietWord]
Word Separators=

A1=WinVNKey can combine Viet accent marks smartly if it can recognize
& where a new word begins based on word separators.
+
+ For example,  if the hyphen is defined as a word separator, "anh-hung"
& will be treated as two separate words, hence typing anh-hung`  will give
& anh-hùng because ` combines with hung.
+
+ If the hyphen is NOTdefined as a word separator, "anh-hung" will be
& treated as ONE word, which is clearly not Vietnamese.
& Hence typing anh-hung`  does not combine into anh-hùng.

A2=Add missing Vietnamese words

Help-A3=WinVNKey offers a smart typing mode where an accent mark will
& combine with the current word
& if and only if it forms a legal Vietnamese word.  This feature relies on
& an internal Vietnamese dictionary maintained by WinVNKey.
&  However, this dictionary is not complete.
+
+ If you discover that a word is correctly spelled in Vietnamese but 
& you cannot type in because WinVNKey does not allow
& an accent mark to combine, it is because
& this word is not available in its internal dictionary.
& There are many solutions to this problem:
+     - choose a combination method based on syllables, not words, such as
& Viet option page #5.
+     - or keep your combination method based on words, but update
& WinVNKey internal dictionary as follows:
+          1. Open the dictionary file (click the link below)
+          2. Add all the words you think missing from WinVNKey internal dictionary.
+          3. Save the file
+          4. Click on "Update" button
+
+ Note you have to save the file before clicking the "Update" button. 
+
+ If you put the mouse on the link for a second or two, it 
& will show the dictionary folder. You can have more than
& one dictionary file in this folder.  When you click the
& "Update" button, all of them will be processed.
+

A4=A word separator is a space, a tab, or any of the 
& following symbols that you can define by yourself:

Foreign Consonants=

A5=For combining/spelling purposes the following foreign consonants will be treated as Vietnamese:


; Page VietWord
DictFile=Personal Viet Dictionary File

A6=WinVNKey did not accept the
& following words because they are not legal Vietnamese words:

A7=A total of XXX illegal Vietnamese words are rejected.
A8=There are YYY Vietnamese words accepted into WinVNKey internal dictionary.

B1=dz, treated as d as far as spelling is concerned
B2=f, treated as ph as far as spelling is concerned
B3=j, which can combine with all Vietnamese syllables
B4=w, which can combine with all Vietnamese syllables
B5=z, which can combine with all Vietnamese syllables


[Page VietDictionary]



[Keyboard Setup]
K2=Viet Chars

[Viet Chars]

C1=Dong
C2=Erase
C3=Bind
C4=Retrieve
C5=Escape


D1=a. Delete space if the next char is one of the following:
D2=e.g. Type @, space, %, get @%
D3=b. Want to type - before d to get đ ( -d => đ )

E1=1. Common accent marks and currency symbol
E2=2. Enable fast accent marks (must be typed immediately after base letters)
E3=3. Enable mapping keys to single accented characters
E4=4. Enable mapping keys to consonant compounds
E5=5. Enable editing-accent keys

E6=6. Typing the same key again gives back the original (cá' ==> ca')
E6next=for all keys used as marks and mapped keys shown in groups 1 to 4
E7=7. Typing a different mark right after another mark replaces it (cá` ==> cà)
E7next=for all keys used as marks shown in group 1
E8=8. Enable smart key mapping (don't map if not forming Vietnamese word)
E8next=for all mapped keys shown in groups 3 and 4 above

F1=Type this character to combine an accent mark with the preceding vowel
F2=Type this character to uncombine an accent mark
F3=Type this character to erase an accent mark in the preceding letter
F4=Type this character before typing an accent mark to prevent it from combining
F5=Type these two characters to get the Vietnamese currency symbol ₫
F6=Type a space before an accent mark to prevent combination
F7=Click for help

@M0=This box does not distinguish upper case or lower case characters (case-insensitive).
+ But WinVNKey prefers the lower case.
+

@M1=Error: You cannot use upper case XXX in the "YYY" box!!
+ Please use lower case for Fast Mark boxes and then click
+ the  >> button to fine-tune upper case.
+
@M2=You don't have to enter the second character
+ if it is the upper case of the first letter.
+

@M3=Error: You already have character XXX in the box.
+ Will discard it and change YYY to ZZZ.
+

@M4=Error: The character XXX in the "YYY" box was already used
+ in the "ZZZ" box of "TTT"!
+
@M5=Will discard it.
+
@M6=Will discard it and change XXX to YYY.
+
@M7=If you really want XXX in the "YYY" box, you have to first
+ change the character in the "ZZZ" box to something else.
+
@M8=Invalid Character

Group 1 (Common Accent Marks)=
Group 2 (Fast Accent Marks)=
Group 3 (Key Remap)=
Group 4 (Fast Consonant Compound)=
Group 5 (Editing Accent Keys)=

acute=
grave=
hook-above=
tilde=
dot-below=
breve=
circumflex=
horn=
d-bar=
dong=
fast breve=
fast a-circumflex=
fast e-circumflex=
fast o-circumflex=
fast o-horn=
fast u-horn=
fast d-bar=
full a-breve=ă
full a-circ=â
full e-circ=ê
full o-circ=ô
full o-horn=ơ
full u-horn=ư
full d-bar=đ
full d=d
erase=
bind=
retrieve=
escape=



;=======================================
Help-Microsoft=This page explains the Microsoft typing method.
+
+ This is a WinVNKey method to partially simulate, on the US keyboard, 
& the Vietnamese keyboard layout designed by Microsoft
+
+ 1) What is the Microsoft Vietnamese keyboard layout?
+ ========================================
+
+ It is similar to the US keyboard layout except that a total of 13 unshifted keys and
& 12 shifted keys are dedicated to Vietnamese-specific characters.   For a visual layout,
& please see here:
+
+    http://www.microsoft.com/globaldev/keyboards/kbdvntc.htm
+
+ To understand it easily, imagine that you have a US keyboard but some of the key labels are different.
& For example, key '1' is now labeled ă.
& Thus if you press key '1', you will get ă.  If you press key '1' while holding down SHIFT, 
& you will get an upper case letter Ă.
+
+ 2) How to type digits 1234... and symbols !@#$... ?
+  ======================================
+
+ The AltGr key is used for this purpose.   It corresponds to the right Alt key on the US keyboard.
& If you hold this AltGr key down while typing the ă key, you will get the original US digit '1'.
& If you hold both AltGr and Shift keys down while typing the ă key, you will get the original US symbol '!'.
+
+ Note you can type digits faster by using the numeric keypad on the right of the keyboard.
+
+ 3) What is WinVNKey support for Microsoft typing method?
+
+ The table below shows the corresponding characters between US and Vietnamese keyboards:
+
+          Key 1 ==> ă   Key 1 shifted: ! ==> Ă
+          Key 2 ==> â   Key 2 shifted: @ ==> Ă
+          Key 3 ==> ê   Key 3 shifted: # ==> Ă
+          Key 4 ==> ô   Key 4 shifted: $ ==> Ă
+          Key 5 ==> `    Key 5 shifted: % ==> `   (same grave accent mark)
+          Key 6 ==> ?   Key 6 shifted: ^ ==> ?    (same hook-above accent mark)
+          Key 7 ==> ~   Key 7 shifted: & ==> ~   (same tilde accent mark)
+          Key 8 ==> '    Key 8 shifted: * ==> '     (same acute accent mark)
+          Key 9 ==> .    Key 9 shifted: (  ==> .    (same dot-below accent mark)
+          Key 0 ==> đ,  Key 0 shifted: ) ==> Ð
+          Key = ==> ₫   (Vietnamese currency symbol)
+          Key ] ==> ơ,  Key ] shifted:  } ==> Ơ
+          Key [ ==> ư,  Key [ shifted:  { ==> Ư
+
+ WinVNKey supports the mapping above when you choose Microsoft typing method.
& But it does not support the AltGr key combinations.  If you want to type digits, you can
& use the numeric keypad or use the escape mechanism.  If you want to type symbols !@#$...,
& you have to use the escape mechanism.  
+
+ For convenience the 25 keys listed above are called Microsoft keys for Vietnamese,
& or just Microsoft keys for short.
+
+ 4. What is the escape mechanism?
+ ==========================
+
+ It is a method where you type an escape character (backslash by default)
& before typing the real character in order to get the real character itself.  That is,
& to get 1, you type \1.  To get @, you type \@, etc.
+
+ 5. How do smart options on the Viet Option Page affect Microsoft keys?
+ =====================================================
+
+ It is easier to illustrate with an example, say typing "1h" when using Microsoft typing method.
& What you get when typing 1h depends on the particular smart option you chose.   Smart option is listed as
& "Viet Option Page" on "Page Main".  For example,
+
+       a) you get ăh if choosing no smart option (option #0)
+       b) you get 1h if choosing smart syllable option #5.  
+
+ In case (a), WinVNKey blindly honors whatever characters you requested even if the result does not make sense.
+
+ In case (b), choosing smart option means WinVNKey will honor your requested characters
& if and only if the result makes sense.  Because you chose "smart syllable" option and
& ăh is NOT a correct Vietnamese syllable,
& WinVNKey thinks what you really wanted is "1h", not "ăh".  So it undoes the Microsoft key mapping
& to give you back the original characters "1h".  
+
+ Fortunately, you can turn off this undo feature in smart syllable option #5.  Just click
& on the hyperlink "Viet Option Page" on "Page Main" and then uncheck option #4.
& Then when you type 1h, you will get ăh even though it does not make sense.
+
+ But if you do not want to uncheck option #4, you can still do something to change "1h" back to "ăh".
& This is explained in topic #7 on the Viet Option Page:
+      - press and release the Right Shift key once:  it will undo "1h" into "ăh". 
+      - press and release the Right Shift key again:  it will undo "ăh" into "1h".
+      - press and release the Right Shift key as many times as you want.  It just keeps toggling
& back and forth between "1h" and "ăh".
+
+
+ NOTES:
+
+ If you made some changes to the Microsoft typing method
& but now change your mind and want to restore the original behavior, 
& please click on the arrow
& on the top button "Typing Method", then select the menu "Reset this method".
+ 

;====================================================

Help-Common=A character is called a common accent mark if
& it is an accent mark that can combine with all letters if permitted.
+
+ For example, if ' is defined to be a common acute accent mark,
& you can type it after any of the 12 Vietnamese vowels
+        a ă â e ê i o ô ơ u ư y 
+ to produce these letters
+        á ắ ấ é ế í ó ố ớ ú ứ ý.
+
+ You can click on any icons on this page for more information.
+
+ You can define up to 4 characters in each of the first twelve edit boxes
& for use as common accent marks.
& Normally each box has one character but you can add
& additional characters if you really want.  
& These characters are case-insensitive but the box requires you to enter the lower case. 
& For currency symbol, please
& click on the icon labelled with ₫ for more information.
+
+ Suppose you put ' and s in the first box.  Then 
+   - typing a' or as both give the same result á.
+   - typing e' or es both give the same result é.
+   - typing i' or is both give the same result í.
+   - etc
+
+ Depending on your smart settings (see Viet Option Page), you can type common marks immediately
& after base letters, or anywhere on syllables, or at the end of words.
+
+
+ Why typing accent marks after vowels?
+ ==============================
+
+ Vietnamese users prefer typing accent marks after base letters.
& For example, they want to type o^ and expect to get ô because that is
& exactly how they write Vietnamese letters in practice.
+
+ If an accent mark, say ^, is a dead key, you have to type a space after the dead key:
+            type  (o) (dead key ^) (space)   ==> get ô
+
+ But the extra space slows down typing Vietnamese text significantly.
& So you may want to go to the "Advanced" control panel
& and enable the option to change all the dead keys into normal keys.
& Once this option is enabled, all dead keys become normal and
& you do not need to type a space after each dead key.
+

;===========================================

Help-FastAccentMarks=This option allows you to type accented marks quickly for
& seven specific Vietnamese letters, either lower case or upper case.
+
+            ă   â   ê   ô   ơ   ư   đ
+
+ You can click on individual icons for specific help.
+
+ You can define up to 4 characters (symbols or lower case letters)
& in the edit box below each icon.  
& Each of them equally represents the accent mark that goes with 
& the specific letter specified in the icon. It must be typed immediately
& after the base letter regardless of smart settings you set in the Viet Option Page.
+
+ For example, if the first box has j, then j represents the breve accent and typing 
+         aj  => ă
+         Aj => Ă
+         AJ => Ă
+
+ Now, let's consider the sixth box.  If it contains uj, then either u or j represents the horn that accompanies u.
& Hence, typing 
+         uu   => ư  (the second u plays the role of a breve)
+         uj    => ư  (j plays the role of a breve)
+         Uu  => Ư
+         Uj   => Ư
+         UU => Ư
+         UJ  => Ư

;=========================

Help-FastAccentedChars=This option allows quick typing of any
& of the following seven Vietnamese letters by a single keystroke:
+            ă   â   ê   ô   ơ   ư   đ
+ This method is used in Vietnamese keyboard layout designed by Microsoft.
+
+ You can click on individual icons for specific help.
+
+ The edit box below each icon can be empty or contain two symbols or characters.
+      - The first character represents the complete lower case character as shown on the icon 
+      - The second character represents the complete upper case character.
+
+ Example 1:  Consider the first icon labelled with ă.   If you place 
& 1! in the edit box below the icon, then 
+      - 1 represents  ă  (when you type 1, you get ă instead)
+      - !  represents  Ă (when you type !, you get Ă instead)
+
+ Example 2:  Consider the fifth icon labelled with ư.   If you place 
& wW in the edit box below the icon, then 
+         w represents  ư (when you type w, you get ư instead)
+         W  represents  Ư (when you type W, you get Ư instead)
+
+ Note:  If the first character is a lower case letter and the second character
& is simply the corresponding upper case letter (such as in example 2), you can
& drop the second letter from the edit box.  In other words, you could have specified a single
& letter w in the edit box for the second example.
+

;==================

Help-FastConsonantCompounds=This option allows quick typing of any of the following
& 9 Vietnamese consonant compounds by a single keystroke:  
+          ch   gi   kh   ng   nh   qu   ph   th   tr
+
+ But whether a single keystroke is mapped to two character pairs is subject to options 7
& (typing character twice) and 9 (smart key mapping).
+
+ There are nine edit boxes.  Each box can be empty or contain two symbols or characters.
+      - The first character represents the consonant compound in lower case (e.g. ch, gi, kh, ...)
+      - The second character represents the consonant compound in mixed case with 
& the first consonant in upper case (e.g. Ch, Gi, Kh, ...).   See note 2 below on how to
& get the entire compound in upper case.
+
+ You can click on any label above the edit boxes for more information.
+
+ Example:  Consider the seventh box labelled with "ph".   If you place 
& fF in the box, then 
+         f represents  ph  (when you type f, you get ph instead)
+         F represents  Ph (when you type !, you get Ph instead)
+
+
+ Note 1:  You can specify a single letter f in the example above.
+ ===============================================
+
+ In general, if the first character is a lower case letter and the second character
& is simply the corresponding upper case letter, you can
& drop the second letter from the edit box. 
+
+ Note 2: How to get the entire compound in upper case (e.g. CH, GI, KH, KH, ...) ?
+ =============================================================
+
+    - Turn on CAPS LOCK while typing
+                  + With CAPS LOCK off, type F => Ph
+                  + With CAPS LOCK on, type F => PH
+
+    - Or type a capital letter after the consonant compound:
+                  + Type  F => Ph
+                  + Type A next =>  PHA  (h is changed to H as soon as you type A)
+
+ The examples above have assumed you defined f => ph.  
+
+ Note 3:  Is there quick typing for consonant compounds gh, ngh?
+ ================================================
+
+ Although these compounds are not supported here, you can tell WinVNKey to
& smartly add h to g and ng whenever they are followed by e, ê, or i.  You can click on
& "Viet Option Page" >> "2. Autochange letters" >> then enable the second checkbox for 
+
+                   g <-> gh,  ng <-> ngh
+
+ Note that the "Autochange letters" option also supports mapping q => qu, f => ph, and z => gi.
& The main differences are as follows:
+      - On the Viet Chars Page:  you can choose any letters to map to qu, ph, and gi.
+      - On the Viet Option Page:  you can choose when the mapping should occur.
+

;==================

Help-EditingKeys=You can define 4 keys to behave like a command to manipulate
& accent marks.
+
+ 1. Erase key: used to erase the most recently typed accent mark.
+
+ 2. Bind key: used to bind, or force the preceding char to combine as an accent mark.
+
+ 3. Retrieve key: used to retrieve, or unbind, or uncombine, the most recently typed accent mark.
+
+ 4. Escape key: used to separate the next character from the preceding character, i.e., to prevent 
& the character following the escape key from combining with the character preceding the escape key.
& The escape key is definable in the "Advanced" page.
+
+ You can click on the individual icons or hyperlinks to see detailed examples.
+

;======================

Help-MapKeySmart=This option applies to those keys specified in group 3 (map to single accented letters)
& and group 4 (map to consonant compounds) only.
+
+ When this option is disabled, the keys are ALWAYS mapped as specified without consideration of whether
& the result is forming a legal Vietnamese word.
+
+ When this option is enabled, the keys are mapped and stay mapped when you type in new keys
& as long as the result would form a legal Vietnamese word.  However, if a newly typed key causes the result
& to be illegal Vietnamese, the mapped keys are restored immediately.
& For example, suppose f is defined to be mapped to ph.  Then
+      - typing f gives ph
+      - then typing a gives pha
+      - then typing x does not give phax (not Vietnamese).  Instead, typing x restores ph to f and the result is fax.
+
+ A.  Examples for group 3 (map to single accented letters):   
+ ===========================================
+
+ Suppose 1 represents "ă"  and the smart option 8 is enabled.  Consider these cases:
+  Example 1:
+                   - First type 1 ==> ă
+                   - next type n ==> ăn
+                   - next type g ==> ăng  (pronounceable in Vietnamese, hence legal)
+
+  Example 2:
+                   - First type 1 ==> ă
+                   - next type 2 ==> 12 (ă was unmapped because the result ă2 would be illegal Vietnamese)
+
+  Example 3:
+                   - First type t ==> t
+                   - next type 1 ==> tă
+                   - next type q ==> t1q (ă was unmapped because the result tăq would be illegal Vietnamese)
+
+ B.  Examples for group 4 (fast consonant compound):  
+ ---------------------------------------------------------------------
+
+ Suppose w represents "ch" and the smart option is enabled.  Consider these cases:
+
+  Example 4:
+                   - First type w ==> ch
+                   - next type a ==> cha
+                   - next type w ==> chach  (mappable to ch because it is forming a legal Vietnamese word, 
& which is the intermediate form of chạch or chách)
+
+  Example 5:
+                   - First type w ==> ch
+                   - next type a ==> cha
+                   - next type r ==> war  (unmapped ch back to w immediately
& because r causes the word "char" to become an illegal Vietnamese word)
+
+  Example 6:
+                   - First type w ==> ch
+                   - next type r  ==> wr (unmapped ch back to w immediately because r causes the word "chr" 
& to become an illegal Vietnamese word)
+

;=========================

Help-SameKey=This option allows you to type and get any character that has been reserved as accent marks
& or mapped keys in groups 1 through 4 by typing it twice. 
+
+ Note that you can press and release the Right SHIFT key
& (or both Right and Left SHIFT key depending on how you configure option 2 on page "Special keys")
& to undo any change and get the same effect.  
+
+ Example 1:  group 1 for "Common accent marks and currency symbol"
+ Suppose the symbol ' is defined as an acute and it has combined with
& the preceding character.  You can type it again to get back the true character '.
+          - First type a'  => á
+          - then either type ' again => a'       ( i.e., type a'' => a' )
+          - or press and release Right SHIFT key => a'   ( i.e., type  a'<RightSHIFT> => a' )
+
+ Example 2:  group 2 for "Fast accent marks for specific letters"
+ If j is defined as a breve, typing it twice will give you the true character j.
+          - First type aj  => ă
+          - then either type j again => aj      ( i.e.,  type ajj => aj )
+          - or press and release Right SHIFT key => aj    (i.e., type  aj<RightSHIFT> => aj )
+
+
+ Example 3:  group 3 for "Mapping keys to single accented characters"
+ If [ is defined as ơ, typing it twice will give you the true character [.
+          - First type [  => ơ
+          - then either type [ again => [       ( i.e.,  type [[ => [  )
+          - or press and release Right SHIFT key => [   ( i.e., type  [<RightSHIFT> => [ )
+
+ Example 4:  group 4 for "Mapping keys to consonant compounds"
+ If f is defined as ph, typing it twice will give you the true character f.
+          - First type f  => ph
+          - then either type f again => f    ( i.e.,  type ff => f )
+          - or press and release Right SHIFT key => f     ( i.e., type  f<RightSHIFT> => f )
+

;=========================

Help-DiffKey=This option allows quick replacement of an existing accent mark with another accent mark
& for all accent marks in group 1.  It requires that the two marks be typed immediately one after another.
+
+ Example: 
+    - First type  ca' => cá
+    - Now you realize it was wrong.  You want cà, not cá. 
+    - If option 7 is enabled, you can simply type ` immediately after cá:  cá` => cà
+
+ Without this option you would have to backspace to erase á, then retype a` to get cà.
& That takes 3 key strokes.  When this option is enabled, it saves you 2 keystrokes.
+

;+
;+ Example 2: 
;+    - First type  ca^ => câ
;+    - Now you realize it was wrong.  You want că, not câ
;+    - If option 7 is enabled, you can simply type j immediately after câ:  câj => că
;+

;=======================

Help-acute=This icon shows an acute accent mark in red.
& In the edit box immediately below it you can enter 1, 2, 3, or 4 characters to
& represent an acute accent mark that can combine with any Vietnamese vowel.
+
+ Example: Suppose you put ' and s in the box.  Then 
+   - type  a'  => á,   as => á
+   - type  e'  => é,   es => é
+   - type  o'  => ó,   os => ó
+   - etc
+
+ To prevent combination, you can 
+    - type an escape char before the accent mark:  a\' => a'
+    - or type the accent mark twice if option 6 (type same key) is enabled:   á' => a'
+    - or press and release a CTRL key to begin a new word before typing the accent mark:   a<CTRL>' => a'
+    - or press and release the right SHIFT key to undo:   á<RSHIFT> => a'
+
+ Note: The undo operation can be configured on page "Special keys".  You can
& configure to use just the right SHIFT key or both SHIFT keys.
+

Help-grave=This icon shows a grave accent mark in red.
& In the edit box immediately below it you can enter 1, 2, 3, or 4 characters to
& represent a grave accent mark that can combine with any Vietnamese vowel.
+
+ Example: Suppose you put ` and f in the box.  Then 
+   - type  a`  => à,   af => à
+   - type  e`  => è,   ef => è
+   - type  o`  => ò,   of => ò
+   - etc
+
+ To prevent combination, you can 
+    - type an escape char before the accent mark:  a\` => a`
+    - or type the accent mark twice if option 6 (type same key) is enabled:   à` => a`
+    - or press and release a CTRL key to begin a new word:   a<CTRL>` => a`
+    - or press and release the right SHIFT key to undo:   à<RSHIFT> => a`
+
+
+ Note: The undo operation can be configured on page "Special keys".  You can
& configure to use just the right SHIFT key or both SHIFT keys.
+

Help-hook-above=This icon shows a hook-above accent mark in red.
& In the edit box immediately below it you can enter 1, 2, 3, or 4 characters to
& represent a hook-above accent mark that can combine with any Vietnamese vowel..
+
+ Example: Suppose you put ? and r in the box.  Then 
+   - type  a?  => ả,   ar => ả
+   - type  e?  => ẻ,   er => ẻ
+   - type  o?  => ẻ,   or => ỏ
+   - etc
+
+ To prevent combination, you can 
+    - type an escape char before the accent mark:  a\? => a?
+    - or type the accent mark twice if option 6 (type same key) is enabled:   ả? => a?
+    - or press and release a CTRL key to begin a new word:   a<CTRL>? => a?
+    - or press and release the right SHIFT key to undo:   ả<RSHIFT> => a?
+
+
+ Note: The undo operation can be configured on page "Special keys".  You can
& configure to use just the right SHIFT key or both SHIFT keys.
+

Help-tilde=This icon shows a tilde accent mark in red.
& In the edit box immediately below it you can enter 1, 2, 3, or 4 characters to
& represent a tilde accent mark that can combine with any Vietnamese vowel.
+
+ Example: Suppose you put ~ and x in the box.  Then 
+   - type  a~  => ã,   ax => ã
+   - type  e~  => ẽ,   ex => ẽ
+   - type  o~  => õ,   ox => õ
+   - etc
+
+ To prevent combination, you can 
+    - type an escape char before the accent mark:  a\~ => a~
+    - or type the accent mark twice if option 6 (type same key) is enabled:   ã~ => a~
+    - or press and release a CTRL key to begin a new word:   a<CTRL>~  => a~
+    - or press and release the right SHIFT key to undo:   ã<RSHIFT> => a~
+
+
+ Note: The undo operation can be configured on page "Special keys".  You can
& configure to use just the right SHIFT key or both SHIFT keys.
+

Help-dot-below=This icon shows a dot-below accent mark in red.
& In the edit box immediately below it you can enter 1, 2, 3, or 4 characters to
& represent a dot-below mark that can combine with any Vietnamese vowel.
+
+ Example: Suppose you put . and j in the box.  Then 
+   - type  a.  => ạ,   aj => ạ
+   - type  e.  => ẹ,   ej => ẹ
+   - type  o.  => ọ,   oj => ọ
+   - etc
+
+ To prevent combination, you can 
+    - type an escape char before the accent mark:  a\. => a.
+    - or type the accent mark twice if option 6 (type same key) is enabled:   ạ. => a.
+    - or press and release a CTRL key to begin a new word:   a<CTRL>. => a.
+    - or press and release the right SHIFT key to undo:   ạ<RSHIFT> => a.
+
+
+ Note: The undo operation can be configured on page "Special keys".  You can
& configure to use just the right SHIFT key or both SHIFT keys.
+

Help-breve=This icon shows a breve accent mark in red that is placed above letter a.
& In the edit box immediately below it you can enter 1, 2, 3, or 4 characters to
& represent a breve accent mark to combine with Vietnamese vowel a.
& Depending on the smart settings (Viet Option Page), these accent marks can be typed
& immediately after the letter, or anywhere in the syllable, or after the syllable.
+
+ Example: Suppose you put ( and < in the box.  Then 
+   - type  a(  => ă,   a< => ă
+   - type  A(  => Ă,   A< => Ă
+
+ To prevent combination, you can 
+    - type an escape char before the accent mark:  a\( => a(
+    - or type the accent mark twice if option 6 (type same key) is enabled:   ă( => a(
+    - or press and release a CTRL key to begin a new word:   a<CTRL>( => a(
+    - or press and release the right SHIFT key to undo:   ă<RSHIFT> => a(
+
+
+ Note: The undo operation can be configured on page "Special keys".  You can
& configure to use just the right SHIFT key or both SHIFT keys.
+

Help-a-circumflex=This icon shows a circumflex accent mark in red that is placed above letter a.
& In the edit box immediately below it you can enter 1, 2, 3, or 4 characters to
& represent a circumflex accent mark to combine with Vietnamese vowels a or A.
& Depending on the smart settings (Viet Option Page), these accent marks can be typed
& immediately after the letter, or anywhere in the syllable, or after the syllable.
+
+ Example: Suppose you put ^ and > in the box.  Then 
+   - type  a^  => â,   a> => â
+   - type  A^  => Â,   A> => Â
+
+ To prevent combination, you can 
+    - type an escape char before the accent mark:  a\^ => a^
+    - or type the same accent mark twice if option 6 (type same key) is enabled:   â^ => a^
+    - or press and release a CTRL key to begin a new word:   a<CTRL>^ => a^
+    - or press and release the right SHIFT key to undo:   â<RSHIFT> => a^
+
+
+ Note: The undo operation can be configured on page "Special keys".  You can
& configure to use just the right SHIFT key or both SHIFT keys.
+

Help-e-circumflex=This icon shows a circumflex accent mark in red that is placed above letter e.
& In the edit box immediately below it you can enter 1, 2, 3, or 4 characters to
& represent a circumflex accent mark to combine with Vietnamese vowels e or E.
& Depending on the smart settings (Viet Option Page), these accent marks can be typed
& immediately after the letter, or anywhere in the syllable, or after the syllable.
+
+ Example: Suppose you put ^ and > in the box.  Then 
+   - type  e^  => ê,   e> => ê
+   - type  E^  => Ê,   E> => Ê
+
+ To prevent combination, you can 
+    - type an escape char before the accent mark:  e\^ => e^
+    - or type the same accent mark twice if option 6 (type same key) is enabled:  ê^ => e^
+    - or press and release a CTRL key to begin a new word:   e<CTRL>^ => e^
+    - or press and release the right SHIFT key to undo:   ê<RSHIFT> => e^
+
+
+ Note: The undo operation can be configured on page "Special keys".  You can
& configure to use just the right SHIFT key or both SHIFT keys.
+

Help-o-circumflex=This icon shows a circumflex accent mark in red that is placed above letter o.
& In the edit box immediately below it you can enter 1, 2, 3, or 4 characters to
& represent a circumflex accent mark to combine with Vietnamese vowels o or O.
& Depending on the smart settings (Viet Option Page), these accent marks can be typed
& immediately after the letter, or anywhere in the syllable, or after the syllable.
+
+ Example: Suppose you put ^ and > in the box.  Then 
+   - type  o^  => ô,   o> => ô
+   - type  O^  => Ô,   O> => Ô
+
+ To prevent combination, you can 
+    - type an escape char before the accent mark:  o\^ => o^
+    - or type the same accent mark twice if option 6 (type same key) is enabled:   ô^ => o^
+    - or press and release a CTRL key to begin a new word:   o<CTRL>^ => o^
+    - or press and release the right SHIFT key to undo:   ô<RSHIFT> => o^
+
+
+ Note: The undo operation can be configured on page "Special keys".  You can
& configure to use just the right SHIFT key or both SHIFT keys.
+

Help-o-horn=This icon shows a horn accent mark in red that is placed above letter o.
& In the edit box immediately below it you can enter 1, 2, 3, or 4 characters to
& represent a circumflex accent mark to combine with Vietnamese vowels o or O.
& Depending on the smart settings (Viet Option Page), these accent marks can be typed
& immediately after the letter, or anywhere in the syllable, or after the syllable.
+
+ Example: Suppose you put + and * in the box.  Then 
+   - type  o+  => ơ,   o* => ơ
+   - type  O+  => Ơ,   O* => Ơ
+
+ To prevent combination, you can 
+    - type an escape char before the accent mark:  o\+ => o+
+    - or type the same accent mark twice if option 6 (type same key) is enabled:   ơ+ => o+
+    - or press and release a CTRL key to begin a new word:   o<CTRL>+ => o+
+    - or press and release the right SHIFT key to undo:   ơ<RSHIFT> => o+
+
+
+ Note: The undo operation can be configured on page "Special keys".  You can
& configure to use just the right SHIFT key or both SHIFT keys.
+

Help-u-horn=This icon shows a horn accent mark in red that is placed above letter u.
& In the edit box immediately below it you can enter 1, 2, 3, or 4 characters to
& represent a circumflex accent mark to combine with Vietnamese vowels u or U.
& Depending on the smart settings (Viet Option Page), these accent marks can be typed
& immediately after the letter, or anywhere in the syllable, or after the syllable.
+
+ Example: Suppose you put + and * in the box.  Then 
+   - type  u+  => ư,   u* => ư
+   - type  U+  => Ư,   U* => Ư
+
+ To prevent combination, you can 
+    - type an escape char before the accent mark:  u\+ => u+
+    - or type the same accent mark twice if option 6 (type same key) is enabled:   ư+ => u+
+    - or press and release a CTRL key to begin a new word:   u<CTRL>+ => u+
+    - or press and release the right SHIFT key to undo:   ư<RSHIFT> => u+
+
+
+ Note: The undo operation can be configured on page "Special keys".  You can
& configure to use just the right SHIFT key or both SHIFT keys.
+

Help-bar stroke=This icon shows a d bar stroke in red crossing letter d.
& In the edit box immediately below it you can enter 1, 2, 3, or 4 characters to
& represent a bar stroke that can combine with d. 
& Depending on the smart settings (Viet Option Page), these accent marks can be typed
& immediately after the letter, or anywhere in the syllable, or after the syllable.
+
+ Example: Suppose you put d and - in the box.  Then 
+   - type  dd  => đ,   d- => đ
+   - type  DD  => Đ,   D- => Đ
+
+ Normally, the bar stroke must follow the letter d.  But if the bar stroke
& is a minus sign and you want to enter it before the letter d,
& you can do so if you turn on option 1b (Want to type - before d ...)
+
+ To prevent combination, you can 
+    - type an escape char before the bar stroke:  d\d => dd
+    - or type the accent mark twice if option 6 (type same key) is enabled:   đd => dd
+    - or press and release a CTRL key to begin a new word:   d<CTRL>đ => dd
+    - or press and release the right SHIFT key to undo:   đ<RSHIFT> => dd
+
+
+ Note: The undo operation can be configured on page "Special keys".  You can
& configure to use just the right SHIFT key or both SHIFT keys.
+

;==================================================

Help-fast bar stroke=This icon shows a red bar stroke crossing letter d.
& In the edit box immediately below it you can enter 1, 2, 3, or 4 characters to
& represent a bar stroke crossing letter d.
& These characters must be typed immediately after letter d.
& You should choose a character
& that can be typed quickly.  A solution is to choose the same character
+
+ Example: Suppose you put d in the box.  Then 
+   - type  dd  => đ,   DD => Đ
+
+ To prevent combination, you can 
+    - type an escape char before the bar stroke:  d\d => dd
+    - or type the accent mark twice if option 6 (type same key) is enabled:   đd => dd
+    - or press and release a CTRL key to begin a new word:   d<CTRL>đ => dd
+    - or press and release the right SHIFT key to undo:   đ<RSHIFT> => dd
+
+
+ Note: The undo operation can be configured on page "Special keys".  You can
& configure to use just the right SHIFT key or both SHIFT keys.
+

Help-fast a-breve=This icon shows a red breve accent mark above letter a.
& In the edit box immediately below it you can enter 1, 2, 3, or 4 characters to
& represent a breve accent mark above letter a.
& These characters must be typed immediately after letter a.
& You should choose a character that can be typed quickly.  
& A solution is to choose the an alphabetic character that does not require holding
& down a SHIFT key.
+
+ Example: Suppose you put j in the box.  Then 
+   - type  aj  => ă,   AJ => Ă
+
+ To prevent combination, you can 
+    - type an escape char before the accent mark:  a\j => aj
+    - or type the accent mark twice if option 6 (type same key) is enabled:   ăj => aj
+    - or press and release a CTRL key to begin a new word:   a<CTRL>j =>aj
+    - or press and release the right SHIFT key to undo:   a<RSHIFT> => aj
+
+
+ Note: The undo operation can be configured on page "Special keys".  You can
& configure to use just the right SHIFT key or both SHIFT keys.
+

Help-fast a-circ=This icon shows a red circumflex accent mark above letter a.
& In the edit box immediately below it you can enter 1, 2, 3, or 4 characters to
& represent a circumflex above letter a.
& These characters must be typed immediately after letter a.
& You should choose a character that can be typed quickly.  
& A solution is to choose the an alphabetic character that does not require holding
& down a SHIFT key.
+
+ Example: Suppose you put a in the box.  Then 
+   - type  aa  => â,   AA => Â
+
+ To prevent combination, you can 
+    - type an escape char before the accent mark:  a\a => aa
+    - or type the accent mark twice if option 6 (type same key) is enabled:   âa => aa
+    - or press and release a CTRL key to begin a new word:   a<CTRL>a => aa
+    - or press and release the right SHIFT key to undo:   â<RSHIFT> => aa
+
+
+ Note: The undo operation can be configured on page "Special keys".  You can
& configure to use just the right SHIFT key or both SHIFT keys.
+

Help-fast e-circ=This icon shows a red circumflex accent mark above letter e.
& In the edit box immediately below it you can enter 1, 2, 3, or 4 characters to
& represent a circumflex above letter e.
& These characters must be typed immediately after letter e.
& You should choose a character that can be typed quickly.  
& A solution is to choose the an alphabetic character that does not require holding
& down a SHIFT key.
+
+ Example: Suppose you put e in the box.  Then 
+   - type  ee  => ê,   EE => Ê
+
+ To prevent combination, you can 
+    - type an escape char before the accent mark:  e\e => ee
+    - or type the accent mark twice if option 6 (type same key) is enabled:   êe => ee
+    - or press and release a CTRL key to begin a new word:   a<CTRL>e => ee
+    - or press and release the right SHIFT key to undo:   ê<RSHIFT> => ee
+
+
+ Note: The undo operation can be configured on page "Special keys".  You can
& configure to use just the right SHIFT key or both SHIFT keys.
+

Help-fast o-circ=This icon shows a red circumflex accent mark above letter o.
& In the edit box immediately below it you can enter 1, 2, 3, or 4 characters to
& represent a circumflex above letter o.
& These characters must be typed immediately after letter o.
& You should choose a character that can be typed quickly.  
& A solution is to choose the an alphabetic character that does not require holding
& down a SHIFT key.
+
+ Example: Suppose you put o in the box.  Then
+    - type oo => ô,  OO => Ô
+
+ To prevent combination, you can 
+    - type an escape char before the accent mark:  o\o => oo
+    - or type the accent mark twice if option 6 (type same key) is enabled:   ôo => oo
+    - or press and release a CTRL key to begin a new word:   o<CTRL>o => oo
+    - or press and release the right SHIFT key to undo:   ô<RSHIFT> => oo
+
+
+ Note: The undo operation can be configured on page "Special keys".  You can
& configure to use just the right SHIFT key or both SHIFT keys.
+

Help-fast o-horn=This icon shows a red horn accent mark on top of letter o.
& In the edit box immediately below it you can enter 1, 2, 3, or 4 characters to
& represent a horn on top of letter o.
& These characters must be typed immediately after letter o.
& You should choose a character that can be typed quickly.  
& A solution is to choose the an alphabetic character that does not require holding
& down a SHIFT key.
+
+ Example: Suppose you put j in the box.  Then 
+   - type  oj  => ơ,   OJ => Ơ
+
+ To prevent combination, you can 
+    - type an escape char before the accent mark:  o\j => oj
+    - or type the accent mark twice if option 6 (type same key) is enabled:   ơj => oj
+    - or press and release a CTRL key to begin a new word:   o<CTRL>j => oj
+    - or press and release the right SHIFT key to undo:   ơ<RSHIFT> => oj
+
+
+ Note: The undo operation can be configured on page "Special keys".  You can
& configure to use just the right SHIFT key or both SHIFT keys.
+

Help-fast u-horn=This icon shows a red horn accent mark on top of letter u.
& In the edit box immediately below it you can enter 1, 2, 3, or 4 characters to
& represent a horn on top of letter u.
& These characters must be typed immediately after letter u.
& You should choose a character that can be typed quickly.  
& A solution is to choose the an alphabetic character that does not require holding
& down a SHIFT key.
+
+ Example: Suppose you put u and j in the box.  Then 
+   - type  uu  => ư,   UU => Ư
+   - type  uj => ư,   UJ => Ư
+
+ To prevent combination, you can 
+    - type an escape char before the accent mark:  u\j => uj
+    - or type the accent mark twice if option 6 (type same key) is enabled:   ưj => uj
+    - or press and release a CTRL key to begin a new word:   u<CTRL>j => uj
+    - or press and release the right SHIFT key to undo:   ư<RSHIFT> => uj
+
+
+ Note: The undo operation can be configured on page "Special keys".  You can
& configure to use just the right SHIFT key or both SHIFT keys.
+

;==================================================

Help-full d-bar=This icon shows a full đ in red; it is a complete letter d with a bar stroke crossing it.
& In the edit box immediately below it you can enter two characters: the first one
& representing đ and the second one Đ, respectively.
+
+ Example: Suppose you put 0 and ) in the box.  Then 
+      - type  0  => đ,   ) => Đ
+
+ Note that this example is used in Microsoft typing method.
+
+ To prevent character remapping, you can 
+    - type an escape char before the character:  \0 => 0
+    - or type the character twice if option 6 (type same key) is enabled:   type 00 => 0
+    - or press and release the right SHIFT key to undo:  đ<RSHIFT> => 0
+
+
+ Note: The undo operation can be configured on page "Special keys".  You can
& configure to use just the right SHIFT key or both SHIFT keys.
+

Help-full a-breve=This icon shows a full ă in red; it is a complete letter a with a breve accent mark.
& In the edit box immediately below it you can enter two characters: the first one
& representing ă and the second one Ă, respectively.
+
+ Example: Suppose you put 1 and ! in the box.  Then 
+   - type  1  => ă,   ! => Ă
+
+ Note that this example is used in Microsoft typing method.
+
+ To prevent character remapping, you can 
+    - type an escape char before the character:  \1 => 1
+    - or type the character twice if option 6 (type same key) is enabled:   type 11 => 1
+    - or press and release the right SHIFT key to undo:  ă<RSHIFT> => 1
+
+
+ Note: The undo operation can be configured on page "Special keys".  You can
& configure to use just the right SHIFT key or both SHIFT keys.
+

Help-full a-circ=This icon shows a full â in red; it is a complete letter a with a circumflex accent mark.
& In the edit box immediately below it you can enter two characters: the first one
& representing â and the second one Â, respectively.
+
+ Example: Suppose you put 2 and @ in the box.  Then 
+   - type  2  => ă,   @ => Ă
+
+ Note that this example is used in Microsoft typing method.
+
+ To prevent character remapping, you can 
+    - type an escape char before the character:  \2 => 2
+    - or type the character twice if option 6 (type same key) is enabled:   type 22 => 2
+    - or press and release the right SHIFT key to undo:  â<RSHIFT> => 2
+
+
+ Note: The undo operation can be configured on page "Special keys".  You can
& configure to use just the right SHIFT key or both SHIFT keys.
+

Help-full e-circ=This icon shows a full ê in red; it is a complete letter e with a circumflex accent mark.
& In the edit box immediately below it you can enter two characters: the first one
& representing ê and the second one Ê, respectively.
+
+ Example: Suppose you put 3 and # in the box.  Then 
+   - type  3  => ê,   # => Ê
+
+ Note that this example is used in Microsoft typing method.
+
+ To prevent character remapping, you can 
+    - type an escape char before the character:  \3 => 3
+    - or type the character twice if option 6 (type same key) is enabled:   type 33 => 3
+    - or press and release the right SHIFT key to undo:  ê<RSHIFT> => 3
+
+
+ Note: The undo operation can be configured on page "Special keys".  You can
& configure to use just the right SHIFT key or both SHIFT keys.
+

Help-full o-circ=This icon shows a full ô in red; it is a complete letter o with a circumflex accent mark.
& In the edit box immediately below it you can enter two characters: the first one
& representing ô and the second one Ô, respectively.
+
+ Example: Suppose you put 4 and $ in the box.  Then 
+   - type  4  => ô,   $ => Ô
+
+ Note that this example is used in Microsoft typing method.
+
+ To prevent character remapping, you can 
+    - type an escape char before the character:  \4 => 4
+    - or type the character twice if option 6 (type same key) is enabled:   type 44 => 4
+    - or press and release the right SHIFT key to undo:  ô<RSHIFT> => 4
+
+
+ Note: The undo operation can be configured on page "Special keys".  You can
& configure to use just the right SHIFT key or both SHIFT keys.
+

Help-full o-horn=This icon shows a full ơ in red; it is a complete letter o with a horn accent mark.
& In the edit box immediately below it you can enter two characters: the first one
& representing ơ and the second one Ơ, respectively.
+
+ Example: Suppose you put ] and } in the box.  Then 
+   - type  ]  => ơ,   } => Ơ
+
+ Note that this example is used in Microsoft typing method.
+
+ To prevent character remapping, you can 
+    - type an escape char before the character:  \] => ]
+    - or type the character twice if option 6 (type same key) is enabled:   type ]] => ]
+    - or press and release the right SHIFT key to undo:  ơ<RSHIFT> => ]
+
+
+ Note: The undo operation can be configured on page "Special keys".  You can
& configure to use just the right SHIFT key or both SHIFT keys.
+

Help-full u-horn=This icon shows a full ư in red; it is a complete letter u with a horn accent mark.
& In the edit box immediately below it you can enter two characters: the first one
& representing ư and the second one Ư, respectively.
+
+ Example: Suppose you put [ and { in the box.  Then 
+   - type  [  => ư,   { => Ư
+
+ Note that this example is used in Microsoft typing method.
+
+ To prevent character remapping, you can 
+    - type an escape char before the character:  \[ => [
+    - or type the character twice if option 6 (type same key) is enabled:   type [[ => [
+    - or press and release the right SHIFT key to undo:  ư<RSHIFT> => [
+
+
+ Note: The undo operation can be configured on page "Special keys".  You can
& configure to use just the right SHIFT key or both SHIFT keys.
+

Help-full d=This icon shows a full d in red.
& In the edit box immediately below it you can enter two characters: the first one
& representing d and the second one D, respectively.
+
+ Example: Suppose you put z and Z in the box.  Then 
+      - type  z  => d,   Z => D
+ Actually, because the second character is the upper case of the first character,
& you can omit it; i.e., you can enter just a single letter z in the edit box.
+
+ To prevent character remapping, you can 
+    - type an escape char before the character:  \z => z
+    - or type the character twice if option 6 (type same key) is enabled:   type zz => z
+    - or press and release the right SHIFT key to undo:  z<RSHIFT> => z
+
+ In the last example you may have to type both the left and right SHIFT keys
& simultaneously.  This is configurable in option 2 of the "Special keys" page.
+
+ Note: 
+ Statistically, there are more Vietnamese words starting with đ than with d.
& A number of users think that changing the d key (key labeled with 'd') into đ
& will speed up typing.  If so, the users need a way to get the letter d.
& For this reason WinVNKey provides support for changing another key into d.
& But even if WinVNKey does not provide this support in the typing method page,
& users can still convert one key into another via Shorthand macro
& (using Shorthand with autoexpand feature).
+

;=====================================

Help-SpaceSeparator=When using punctuations to represent accent marks, 
& you will frequently run into problem of unwanted combination.  For example, 
& you want to type the sentence "Con yêu ba." using a VIQR method as follows:
+             Type:  Con ye^u ba.
+             Get:    Con yêu bạ
+
+  What you wanted is a period to terminate a sentence, not a dot-below accent mark.  
& But WinVNKey combines it with ba into bạ,
& which is a meaningful Vietnamese word by itself but is wrong in context.
+
+ To avoid  unwanted combination, you can
+        1. Type the same mark again to undo it.
+        2. Or type an escape char (backslash) before the mark.
& This backslash forbids the next character from combining.
+        3. Or press and release the CTRL key before typing the mark.
& This makes WinVNKey forget everything and begin a new word
+        4. Or click the mouse anywhere.  This makes WinVNKey forget everything and begin a new word.
+        5. Or type a space before the mark.  This option requires that you turn
& on the option "Delete space ...".
+                   Type:   ...  b, a, space, .
+                   Get:      ...  ba.
+             What happened was that the period was moved immediate to the right
& of the letter a after WinVNKey erased the space.
+

Help-erase=You can define up to 4 characters in this erase char box.  Normally it is z for Telex, 0 for VNI,
& x for other methods.  But you can define additional characters if you really want.
+
+ When option #5 is enabled in the "Viet Chars" page, the erase char % becomes a command that you can type to
& erase the most recently typed accent mark.  To make % loose its command meaning,
& you have to type an escape character before it, i.e., type \%, or press and release CTRL before typing %.
+
+ For example, to erase the acute in á, you can simply type % as follows:
+
+           á% --> a,  á\% --> a%
+           toán% --> toan, toán\% --> toán%   (for smart typing method)
+
+ Note that you can also type the same accent mark again to undo the last accent mark and
& then use backspace to erase it:
+           á' --> a'
+ This feature is available as option #5 in the Viet Chars page.
+

Help-bind=You can define up to 4 characters in this bind char box.  Normally it is b but you can
& define additional characters if you really want.
+
+ When option #5 is enabled in the "Viet Chars" page, the bind char % becomes a command that you can type to
& bind (combine) the most recently typed accent mark.  To make % loose its command meaning,
& you have to type an escape character before it, i.e., type \%, or press and release CTRL, before typing %.
+
+ For example, if you see a' instead of á because ' did not combine with a for some reason,
& you can type % to force ' to combine with a:
+
+          a'%  --> á,  a'\%  --> a'%
+          toan'%  --> toán,  toan'\%  --> toan'%  (for smart typing)
+

Help-retrieve=You can define up to 4 characters in this retrieve char box.  Normally it is r but you can
& define additional characters if you really want.
+
+ When option #5 is enabled in the "Viet Chars" page, the retrieve char % becomes a command that you can type to
& retrieve the most recently typed accent mark.  To make % loose its command meaning,
& you have to type an escape character before it, i.e., type \%, or press and release CTRL, before typing %.
+
+ For example, you really want a' but what you get is á after typing 2 keys a and '.
& In this case you can undo the combination by typing % to retrieve the acute accent mark.
+
+          á% --> a',   á\% --> á%   (the backslash \ makes % normal)
+          toán% --> toan',  toán\% --> toánr   (for smart typing)
+
+ Note that you can also type the same accent mark again to undo the last accent mark.
& This feature is available as option 5 in the "Viet Chars" page.

Help-escape=The escape character is defined on the "Special Keys" page.
+
+ The escape character behaves like a command acting on the next character.
& The primary use of this command is to display the next character as is.
& Because it is a command, not a normal character, it will not show up on screen when you type it.
& When you type a second character, the command knows what to do
& and hence something will appear on screen.
+
+ Thus if you type an escape character once, nothing will appear on screen. If you really want to see
& the escape character on screen, you have to type it twice.
+
+ In order not to slow down your typing,
& you should choose a 7-bit ASCII character such that
+     - it can be typed fast, preferrably with only one key stroke (no Shift, no Ctrl-Alt, no AltGr)
+     - it is rarely used in normal text to avoid interference with your text typing.
+
+ For instance, you can choose BACKSLASH for US keyboards, ! for French, # for German, etc.
+
+ The escape character has many functionalities in WinVNKey:
+
+ 1. Makes an accent mark loose its accent mark meaning, hence preventing it from combining.
& The same result can be obtained by pressing and releasing the CTRL key instead of \.
+
+         Example 1: ta'  ==> tá but ta\'  ==> ta'  (\ makes the next character ' appear as is)
+
+         Example 2: Type t, a, press and release CTRL key, then type '  ==> ta'
+
+ 2. Prevents a macro from expanding when preceding the last macro character.
& The same result can be obtained by pressing and releasing the CTRL key instead of \.
+
+         Example: Suppose vn is a macro that expands into Vietnam.
& Then typing vn gives Vietnam and typing v\n gives vn.  This
& is because \ forces the next character n to appear as is, hence untransformable.
+
+ 3. Changes keyboard mode when preceding V, M, L, S.
& This feature is optional in WinVNKey 4.0.
& See page Advanced ==> Switch keyboard mode.
+
+ 4. Makes the forward slash appear as is, i.e., makes it loose its special meaning when
& typing Han Nom by pronunciation in Quoc Ngu.
+
+ Suppose you choose Unicode charset and Hannom typing from the Run button menu.
& Then typing tam/ will display a list of Han/Nom characters that read as tam in Vietnamese, 
& but typing tam\/ will display tam/ and no Han/Nom characters.
+
+ 5. Difference between (a) typing the escape character and (b) pressing and releasing CTRL key:
+
+ Both of them prevent the subsequent accent mark from combining with the previous letters.
& But only method (b) will treat the new characters after the CTRL key as beginning a new word.
& This feature.enables you to force an accent mark to combine with any character against 
& the Vietnamese spelling rule.
+
+ For example, suppose you want to get toân by typing toa^n.  You can do this by
& using Viet option page #0.  If you choose other smart Viet options, WinVNKey will recognize
& that oân is not a legitimate Vietnamese syllable and refuse to combine ^ with a.
& To force ^ to combine with a, you can type t, o, press and release CTRL, then type a, ^, n.  
& In this way WinVNKey treats a^n as a new word and combines them into ân.
+
+
+ How to turn off the escape character?
+ =============================
+
+ The escape character is an integral part of the character transformation engine of WinVNKey.
& Therefore, it must be defined for WinVNKey to work properly. 
& But if this character interferes with your typing 
& and you don't need the escape capability at all, you can define it to be some character
& that is not available on your keyboard. For example, you can use ả, ạ, ấ, ắ, ọ, ...
+
+ The reason is as follows. The WinVNKey typing engine processes raw input characters one at a time.
& It always checks individual raw characters to see if there is any escape character.
+
+ Thus if you choose, say, ả to be an escape character, this character cannot be typed directly from the keyboard. 
& This means WinVNkey will never encounter a raw character ả from your typing. 
& (WinVNKey must combine at least two raw characters, a and ?, if using VIQR, in oder to get ả.)
& Hence you have effectively turned off the escape capability.
+
+




;=======================
Help-dong=This icon shows the Vietnamese currency symbol ₫ called đồng. 
& The box below it contains what you need to type in order to produce the Vietnamese currency symbol.
& It can be empty, or contain 1 character such as the equal sign =, or 2 characters such as $$. 
& If it contains two characters, you have to type both of them
& in order to get ₫.  Normally the box contains two characters $$.
+
+ Suppose you define $$ to represent ₫.
+
+ If you are using a character set that supports symbol ₫, then typing $$ will give ₫.
& Otherwise, nothing happens, i.e., typing $$ will give you exactly $$.
+
+ Normally ₫ is available in Unicode or UTF-8
& but is not available in VISCII, VPS, VNI, ABC, DHBK, VietWare, etc.
+
+

Help-dong1=If you really want Q and not ₫, you have to choose one of the following typing methods:
+
+       (a)  type an escape character before it, i.e., type \Q => Q
+       (b)  type Q twice if option 6 (type same key) is enabled: type QQ => Q
+       (c)  press and release the Right SHIFT key immediately after ₫ to undo:  ₫<RSHIFT> => Q
+
+
+ Note: The undo operation can be configured on page "Special keys".  You can
& configure to use just the right SHIFT key or both SHIFT keys.
+

Help-dong2=If you really want QW and not ₫, you have to choose one of the following typing methods:
+
+       (a)  type an escape character before W, i.e., type Q\W => QW
+       (b)  type Q, press and release CTRL to start a new word, then type W:  Q<CTRL>W => QW
+       (c)  type the last char W twice if option 6 (type same key) is enabled: type QWW => QW
+       (d)  press and release the Right SHIFT key immediately after ₫ to undo: ₫<RSHIFT> => QW
+
+
+ Note: The undo operation can be configured on page "Special keys".  You can
& configure to use just the right SHIFT key or both SHIFT keys.
+

; ========================================

Help-full ch=The box below can accept two characters:
+     - the first character represents "xy"
+     - the second character represents "Xy" (first consonant is in upper case)
+
+ You cannot enter a third character to represent "XY".  Usually this case
& is handled smartly by WinVNKey
& based on the case of the surrounding characters or the state of the CAPS LOCK key.
+
+ For example, suppose you have typed the second character to get "Xy".
& If you then type A, WinVNKey will automatically change XyA to XYA.
+
+ Or if you type the second character while the CAPS LOCK key is enabled, 
& you will get "XY" instead of "Xy".
+
+ Note that the mapping of a single character to two characters is subject to
& options 6 and 8.
+
+ For more information please click on the hyperlink below.   
+

[Typing Method]

Help-Tubinhtran-codau=This is the Tubinhtran typing method for typing accented Vietnamese words.
+
+ If you choose this method, you shoud also choose the following:
+        - Viet Option Page: "15. Tubinhtran method (full diacritics)"
+        - Macro: Lazy Syllables
+
+ Then click on the hyperlink "Macro" (on Main page) and select the following macro file:
+       "6. Cach Tubinhtran (co dau)
+
+ All of these selections will support the Tubinhtran typing method consistently.
+ This method is explained in detail at http://vietpali.sf.net/binh.
+

Help-Tubinhtran-khongdau=This is the Tubinhtran typing method for typing
& Vietnamese words without accent marks.
+
+ If you choose this method, you shoud also choose the following:
+        - Viet Option Page: "16. Tubinhtran method (no diacritics)"
+        - Macro: Lazy Syllables
+
+ Then click on the hyperlink "Macro" (on Main page) and select the following macro file:
+       "7. Cach Tubinhtran (khong dau)
+
+ All of these selections will support the Tubinhtran typing method consistently.
+ This method is explained in detail at http://vietpali.sf.net/binh.
+

[Languages]
A0=Languages
A1=Select Languages
A2=List all checked languages
A3=Edit File
A4=Note: Macros listed in red color are unavailable in the current charset
A5=Characters in red are unavailable.
A6=Click here for other Viet characters.

[Macro Listbox]
C0=Typing
C1=To get

[Remap Listbox]
C0=Map Char
C1=To Char

[SortList]
Typing=
To get=
Tip=
Note=
Map Char=
To Char=
Autochange=
Change syllable=Change Syllables
Examples=
Correct Syllables=
Correct Words=
Replace Fonts=
With Fonts=
Font Names=
Conversion Files=
Character Sets=
Font Char=
Unicode Char=
Char Value=
Unichar Value=

Hot Key=
Action=
Details=

Change Unicode Font=
Get File Info=
On left clicking on combobox arrow, display ...=

Display system fonts=
Display RTF file fonts=
Display My Own List Of Font Names=
Change Column 1 Font=
Change Viscii Font (default: Sans Serif Viscii 1.1, 8 points)=
Check All Items=
Uncheck All Items=
Add {All other fonts}=
Replace with {All other fonts}=
Add a row=
Insert a row=
Refresh=
Choose a font char=
Choose a Unicode char=
Show Macro Count=
Total: XXX macros=

P1=This box accepts one symbol only
P2=This box accepts one and only one symbol (no letter, no digit)

[Preferences]
P1=Preferences
P2=A. Interface
P3=Display interface in:
P4=Language:
P5=Dialog Font
P6=Vietnamese
P7=Vietnamese without marks

C1=Reset all menus to use English font

W1=B. When user clicks any HELP button
W2=1. Display help file (*.chm) in installation directory
W3=2. Browse up-to-date HTML help files on the Internet:


Help-Language=The user interface can be displayed in English and Vietnamese.
+
+ By default, the user interface text is displayed in English based on the Unicode
& text file named English.ini in the following folder:
+
+       XXX
+
+ The combobox automatically picks up the names of all the .INI files
& in this folder and displays them for you to choose.
+
+ You can translate the master file English.ini into any language and put the translation file in the folder above.
& For example, the author translated English.ini into Vietnamese in the file Vietnamese.ini.
& You can do this for German, French, etc and name the files as German.ini, French.ini, etc.
& If you really do this, please send a copy to the author (hoc96@yahoo.com) so that
& it can be included in future releases of WinVNKey.
+
+


[Reset WinVNKey]
R1=Restore all typing methods to factory settings
R2=Restore all others to factory settings
R3=Delete temporary files and empty cache
R4=Delete conversion settings
R5=Reset done
R6=Please restart WinVNKey

[Tuning]
T1=Tuning fast key combinations
T2=Enable fast key combinations
T3=Enable lower case pair
T4=Enable upper case pair
T5=Enable lower-upper case pair
T6=for example:


[HanNom]


Han Nom Manager=
Hán character, Unicode value=
Nôm character, Unicode value=

B1=This is HAN character number XXX/NNN, Unicode value
@B1A=This is HAN entry number XXX/NNN
@B1B=Unicode values
@B1C=Pronunciation

B2=This is Nôm character, Unicode value
B3=surrogate pair
B4=Look up at HanViet ChuThich website
B5=Look up at Nom Foundation website

C1=Send decimal NCR
C2=Send hex NCR
C3=Send UTF-8 char sequence
C4=Send UTF-8 in hex sequence
C5=Send Unicode value in hex
C6=Send Unicode value with 0x
C7=Send Unicode codepoint with U+

D5=Send raw surrogate pair (hi,lo) in hex
D6=Send high and low surrogates with 0x
D7=Send high and low surrogates with U+

H1=HanNom Char
H2=Hannom Choice
H3=Viet Word
H4=Options
H5=Select char
H6=Recall typed word:



J1=Information about the Han Nom database
J2=Location
J3=Version
J4=Created on
@J4a=You can also recreate the database binary yourself.  You should do this in these scenarios:
+         - you have changed or updated the source files mentioned above,
+         - or if your binary data file is corrupt.  If it is corrupt, you cannot type any Hán Nôm characters.
+
@J4b=Note the file XXX is always regenerated from the master file
+        YYY\HanNom\InternetSources\cedict_ts.u8
+ whenever a Pinyin database (HanPhonThe-Pinyin or HanGianThe-Pinyin) is rebuilt.
& The master file can be downloaded from
+         http://us.mdbg.net/chindict/chindict.php?page=cedict
+ or from:
+         http://www.mdbg.net
+         http://cc-cedict.org/wiki
+ Your system currently has a version of cedict_ts.u8 dated DDD (this info is in the file).
& Because the master file is frequently updated on the Internet, you may want to visite these websites often and
& download the zip file, unzip it to extract cedict_ts.u8, and then place it 
& in the folder
+        YYY\HanNom\InternetSources
+ Then run update to recreate file XXX and the binary database.
+

@J4c=The procedure to recreate the database binary is as follows:
+       - Choose the menu:   Options | "Update Hán-Nôm database"
+       - Select the database you want to update
+       - Click the "Rebuild" button
+       - The rebuild process is normally very fast but may take as long as 1 minute for large databases.
+       - When done, restart WinVNKey.
+
J5=Contributors
J6=from source files

J7=and from Nom-Viet source files
J8=raw entries



@K1=Character counts
+ ===============
+
@K2A=In terms of single ideograph characters this version of the database has:
@K2=XXX unique ideograph characters
@K3=XXX characters are surrogates
@K4=XXX ways to pronounce in Vietnamese (of which YYY are unique)
@K4A=XXX ways to type using pronunciations or keyboard characters

@K5=In terms of Vietnamese this database has
+   -  XXX simple Vietnamese words
+   -  YYY archaic Vietnamese words or mingled multiVietnamese words

@K6=In terms of compound ideograph characters this database has
+   -  XXX compound ideographs
@K6A=XXX Vietnamese compound words
@K6B=XXX Pinyin compound words
@K6C=XXX compound pronunciations or compound encodings



@K10=Details on file


@K11===============================
+
+ This Han-Viet database is courtesy of Thanh Sơn Lê.  The data comes
& from several sources:
+
+ 1. Private database compiled by Bảo Quốc Đỗ
+ 2. Private database compiled by Thanh Sơn Lê
+ 3. Han-Viet pronunciation table from "Hán Việt tự điển" by Thiều Chửu, 1943 
& [compiled by Kiệt Thế Đặng in cooperation with Vinh Hữu Nguyễn and Đặng Văn Lê]
+ 4. Han-Viet pronunciation table from "Hán Việt tân tự điển" by Nguyễn Quốc Hùng, 1943 
& [compiled by Bảo Quốc Đỗ]
+ 5. Han-Viet pronunciation table from "Tự điển Hán Việt: Hán ngữ cổ đại và hiện đại" 
& by Trần Văn Chánh (2000) [compiled by Trần Văn Chánh]
+
+ This database is not intended to be a comprehensive study of Hán characters.
& It merely provides all possible Vietnamese pronunciations of Hán characters
& so that software tools (e.g. WinVNKey) can be developed to help type
& Hán characters by transforming Vietnamese typing.  Thus it is not necessary
& to give detailed citations of the sources mentioned above as well as 
& the percentage of the database coming from each source.
+
+ This database allows entry of about 19,200 Hán characters by typing
& 31,000 Latin-based Vietnamese words.
+
+ It is continually corrected and updated for release with WinVNKey.
& Please check the website 
+
+           http://winvnkey.sf.net             (official)
+           http://winvnkey.sf.net/beta     (beta testing)
+
+ for the latest version of WinVNKey, which will carry the latest version
& of the database.
+
+
@K12================================
+
+ The Traditional Chinese database used in WinVNKey was provided by
& Vượng Doãn Nguyễn in Feb 2003 based on Thiêu Chuu Dictionary version 1.5.
& This database has been used exclusively in WinVNKey 5.0.0 to 5.3.397.
& It has Vietnamese pronunciations of 9123 single Hán characters.
+
+ Because this WinVNKey version is now able to support more than one
& database, it is necessary to change names to avoid confusion:
+      - Han database provided by Vượng Doãn Nguyễn is now called HanPhonThe or Traditional Chinese.
+      - Han database provided by Thanh Sơn Lê is now called Han to imply it can contain
& both Traditional and Simplified Chinese.
+
+

@K13================================
+
+ This Nôm-Viet database is courtesy of Thanh Sơn Lê.  The data comes
& from several sources:
+
+ 1. "Bảng tra chữ nôm" by Viện Ngôn ngữ học (1976)  [compiled by Thanh Sơn Lê]
+ 2. "Tự điển chữ Nôm" by Vũ Văn Kính và Nguyễn Quang Xỹ (1971) [Thanh Sơn Lê]
+ 3. "Bảng tra chữ Nôm sau thế kỷ XVII" by Vũ Văn Kính (1994) [Thanh Sơn Lê]
+ 4. "Giúp đọc Hán Nôm" by Trần Văn Kiệm (1999) [Thanh Sơn Lê]
+ 5. "Đại Nam quấc âm tự vị" by Huình Tịnh Paulus Của (1895-1896) [Thanh Sơn Lê]
+ 6. Table of Nom characters undefined in the Unicode Standard,
& recently defined in HAN NOM A font in the Private Use Area Exxx
& and the Private Surrogate Plane Fxxxx by Bảo Quốc Đỗ and Thanh Sơn Lê
+ 7. Table of 9299 Nôm characters proposed by Việt Nam and accepted by
& the Unicode Consortium in the Unicode Standard.
+
+ This database is not intended to be a comprehensive study of Nôm characters.
& It merely provides Nôm characters and pronunciations in Latin-based Vietnamese
& so that software tools (e.g. WinVNKey) can be developed to help type
& Nôm characters easily.  Thus it is not necessary to give detailed citations
& of the sources mentioned above as well as the percentage of the 
& database coming from each source.
+
+ This database allows entry of about 23,000 Nôm characters by typing
& 41,000 Latin-based Vietnamese words.
+
& It is continually corrected and updated for release with WinVNKey.
& Please check the website http://winvnkey.sf.net for the latest version
& of WinVNKey, which will carry the latest version of the database.
+
+

@K14=History of Nom database used in WinVNKey
+ =======================================
+ a) WinVNKey 4.X
+ All these versions use Nom data from file nommap.txt provided by Vượng Doãn Nguyễn in Dec 2001.
& This file contains Vietnamese pronunciations of a mixture of 6497 single Han and Nom characters.
+
+ b) WinVNKey 5.0.0 to 5.3.391
+ All these versions use Nom data from file NomReadings.xls provided by Bảo Quốc Đỗ in Jan 2003.
& The file was processed and renamed Nom-Viet.txt for release with WinVNKey.
& It contains Vietnamese pronunciations of about 9215 to 9259 
& (depending on WinVNKey version) single Nom characters, including
& pronunciations written in archaic Vietnamese Quốc Ngữ.
+
+ c) WinVNKey 5.3.392 and later
+ All these versions use Nom data from text files provided by Thanh Sơn Lê.
& The first version is file DatabaseNom-AL.txt received by WinVNKey author on April 11, 2006.
& Since then he has sent several updates as Data-NomViet-xxx.txt.  The current version,
& dated July 6, 2006, contains VVV Vietnamese pronunciations for NNN single Nom characters.
+

@K15================================
+
+ This is the work of a group of people at viethoc.org forum as mentioned above.
+
+ This has 144 commonly used Traditional Chinese characters that are missing from HanViet.jar.
& For more information please visit
+
+           www.viethoc.com/phorum/read.php?f=15&i=5208&t=5140#reply_5208
+           www.viethoc.org/phorum/read.php?f=15&i=5513&t=5513
+           www.viethoc.org/phorum/read.php?f=15&i=5140&t=5140
+
+ It should be noted that a majority of these characters have been incorporated
& into file Data-HanViet-LST.txt.
+

@K16=History of Han database used in WinVNKey
+ =======================================
+ a) WinVNKey 4.X
+ All these versions use Han data from file nommap.txt provided by Vượng Doãn Nguyễn in Dec 2001.
& This file contains Vietnamese pronunciations for single Han or Nom characters.
& There are 6497 characters in total and no attempt was made to
& distinguish Han and Nom characters.
+
+ b) WinVNKey 5.0.0 to 5.3.397
+ All these versions use Han data from file HanViet.txt provided by Vượng Doãn Nguyễn in Feb 2003.
& This file contains Vietnamese pronunciations for 9123 single Han characters.  The provider said
& the data comes from Han Viet Thiêu Chuu Dictionary, version 1.5.
+
+ Starting with WinVNKey 5.3.398, this database is renamed "Han PhonThe" or "Traditional Chinese".
+
+ c) WinVNKey 5.3.398 and later
+ - Starting with version 5.3.398, WinVNKey supports two types of Han databases:
+       1.  HanPhonThe or Traditional Chinese: this database is the same as that used in earlier versions
& of WinVNKey, which was provided by Vượng Doãn Nguyễn in Feb 2003.
+       2.  Han (general): this database contains both Traditional and Simplified Chinese.  It 
& came from file "DataHan-xxx.txt", provided by Thanh Sơn Lê on April 28, 2006.
& The file was renamed Data-HanViet-xxx.txt for release with WinVNKey. It contains
& 30944 pronunciations for 19241 single Hán characters only.
+
+ - Starting with version 5.3.418, WinVNKey also supports databases that contain 
& Vietnamese pronunciations for multiple Hán characters:
+      - TuPhuc-HanViet.txt, containing about 7000 entries, provided by Kiệt Thế Đặng on May 21, 2006.
& The original file sent by him was ndh.mdb.
+      - TuPhuc-HanQNgu.txt, containing 19996 entries, provided by Thanh Sơn Lê on May 26, 2006.
+
+ Although these two files contain many identical entries, WinVNKey is able to eliminate
& all of them from the final binary database.
+
+ Note: TuPhuc means Từ Phức in Vietnamese, meaning Compound Words.
+
+ d) WinVNKey 5.3.431 and later
+ Starting with version 5.3.431, WinVNKey supports entry of Buddhist Han characters by
& Vietnamese pronunciation.  This database is downloaded from the Internet (see Section K below.)
+
+

@K17===============================
+
+ This Hán-Viet compound database is courtesy of Thanh Sơn Lê.
& It has EEE entries.
+

@K18===============================
+
+ This Hán-Viet compound database is courtesy of Kiệt Thế Đặng.
& It has EEE entries.
+

@K19===============================
+
+ This Nôm-Viet compound database is courtesy of Thanh Sơn Lê.
& It has EEE entries.
+

@K20===============================
+
+ This Viet-Hán Buddhist database was written by Cuong Mai and posted on the Internet:
+           http://www.buddhism-dict.net/ddb/indexes/read-vi.html
+ It has EEE entries.  You can update this file if there is a new 
& version at the website.  The update procedure is given
& at the top of this file.
+

@L1=Information about XXX Four Corner Index Method database
@L2=Source files
@L3=These files were obtained from
@L3A=For example, go to link
+      http://en.wiktionary.org/wiki/Wiktionary:Chinese_four_corner_index_0
+ highlight all the data lines, from the first
& line starting with index "00104" to the ending line starting with index "09720",
& then copy and paste into Notepad, and save as Chinese_four_corner_index_0.
+
@L3B=These 10 files have
+    - COUNT indices 
+    - CCC raw characters, SSS of which are surrogate pairs.
+

@L4=This version of the database has:
+    - COUNT indices 
+    - CCC characters, SSS of which are surrogate pairs.
+
@L5=The source tables were originally created by XXX and YYY
& and placed in public domain.
& Note that they do not cover all standard characters in Unicode.  See more info
& about these authors at 
+         http://idp.bl.uk/archives/news05/idpnews_05.a4d
+
+

@L6=This file was downloaded from
@L7=The version currently used by WinVNKey is CCDICT 5.1.1 generated 2006-07-04,
& Copyright © www.chineselanguage.org 1994-2006.  This version of ccdict.txt has 
+    - COUNT indices 
+    - CCC raw characters, SSS of which are surrogate pairs.
+


;Warning

MH1=Missing subfolder Hannom\4CornerIndex\Han.
+ Thus you cannot rebuild the four-corner-index database file Han.4ci
+ in the Hannom folder.
+
+ WinVNKey will continue to use the existing database file Han.4ci
+ to support typing Han characters using the four-corner index method.

MH2=1. Missing four-corner-index database file Han.4ci in the Hannom folder.
+ 2. Missing subfolder Hannom\4CornerIndex\Han
+
+ Thus you cannot use the four-corner-index method to type Hán characters.
+

M1=Missing subfolder Hannom\4CornerIndex\Han.
+ Thus you cannot rebuild the four-corner-index database file Han.4ci
+ in the Hannom folder.
+
+ WinVNKey will continue to use the existing database file Han.4ci
+ to support typing Han characters using the four-corner index method.

M2=1. Missing four-corner-index database file Han.4ci in the Hannom folder.
+ 2. Missing subfolder Hannom\4CornerIndex\Han
+
+ Thus you cannot use the four-corner-index method to type Hán characters.
+

M3=Too many subfolders in "Hannom". Limit is 20.

@M4=The list is too long.
+ Only the first XXX entries will be displayed.
+



@N0=You are using the light-weight version of WinVNKey.
+ Because this version does not have the HanNom folder and data,
+ it cannot support Han/Nom typing.
+
+ To enable Han/Nom typing, you have to download the full version
+ or copy the HanNom folder into the WinVNKey install directory.
+

N1=This charset does not support HánNôm.
& The HanNom window will be closed.

@N1A=This keyboard mode does not support HánNôm typing.
+ The HanNom window will be closed.

@N1B=WinVNKey has been recreating Han/Nom databases
+ from source files since XXX.  It will take about
+ 3 minutes or less.  Please try again later.
+

@N1C=For typing Han Nom characters using Vietnamese pronunciation, it is best to turn
+ on support for typing multi-syllable Vietnamese words by choosing Viet Option page #7.
+
+ This method allows typing the pronunciation of several Vietnamese words as a single string
+ without spacing, such as  anhhùng, hàokiệt, mỹnhân, etc. Thus you can type the following easily:
+
+        - type hàokiệt/   to list Hán Nôm characters whose pronunciation is "hào kiệt"
+        - type tânkh*/   to list Hán Nôm characters whose pronuncation, when written together
+          without space, contains substring "tânkh".  e.g., tân khách, tân khoa, tân khổ, tấn khảo.
+          Note tấnkhảo contains tânkh.
+        - type tânkh=/   to list Hán Nôm characters whose pronuncation, when written together,
+          matches exactly with "tânkh". e.g., tân khách, tân khoa, tân khổ.  Note the start of 
+          tấnkhảo, namely tấnkh, does not match exactly with tânkh, hence it is ruled out.
+
+ Note: Instead of typing words without spacing you can use a hyphen to separate words.
+ The typing has the same effect:  hào-kiệt/, tân-kh*/, tân-kh=/.
+
+ Do you want to switch to Viet Option page #7 to support multi-syllable typing?
+

N2=Error reading datafile FFFF in HanNom directory.
@N2A=The Windows operating system needs to reallocate shared memory for Han/Nom databases.
+  Please quit WinVNKey and reboot your system to fix it.
+

N3=Cannot find database file FFFF in Hannom directory.
N3A=Cannot find database file FFFF in Hannom directory for the four-corner-index typing method.

N4=The current file FFFF is in format XX.
+ But this WinVNKey version supports format YY only.

N5=Do you want to recreate the binary database file FFFF?
N6=The database file FFFF is not available.
+ Thus you cannot use this database.

N6A=The database file FFFF is not available.
+ Thus you cannot use the four-corner-index method to type Hán/Nôm characters.


N7=Recreated the database file FFFF successfully:
N8=But failed to read FFFF back.
N9=Failed to recreate the database FFFF.

N10=To support typing Hán/Nôm characters based on the Four-Corner-Index Method,
+ WinVNKey has to use the database file Hannom\FFFF.  This database file is normally
+ built from source files in directory Hannom\4corner.  
+
+ But the following source files appear to be more recent than the database file FFFF:

N11=Will re-use the old database file FFFF.
N12=The newly created database will be deleted.

N13=Failed to read 4-corner-index database file FFFF.
+ Thus you cannot use the four-corner-index method to type LANG characters.

N14=Do you want to update the database yourself?


P1=Your system needs Han Nom fonts to display Han Nom characters correctly.
P2=You don't have font "Arial Unicode MS" 
P3=You don't have font "Han Nom A"
P4=You don't have font "Han Nom B"
P5=Please click on the top button of the Han Nom Manager to display
+ a dropdown menu and select "Install Hán-Nôm Fonts" to guide you 
+ through the download and installation process.
+


R1=Han/Nom Database
R2=Database of Four Corner Index Typing Method

[Page HannomSelect]
A1=Floating selector, always applied to the database that is first chosen in the Hán Nôm dialog
A2=First selected database

@W1=You cannot use a symbol already used for the repeat
+ command (defined on page "Selector Commands").
+ WinVNKey will reset it to the default.

@W2=You cannot use a symbol already used for the forward-scrolling
+ command (defined on page "Listing Commands").
+ WinVNKey will reset it to the default.

@W3=You cannot use a symbol already used for the backward scrolling
+ command (defined on page "Listing Commands").
+ WinVNKey will reset it to the default.

Help-Selector=1. What is a selector?
+ -----------------------------
+
+ Before answering this question, let's see how to get a Han character in 
& your application (MS Word, Notepad or Wordpad) if you know
& its Vietnamese pronunciation in Quoc Ngu.  
+
+ Suppose this Han character is pronounced as "tâm" in Vietnamese.
+     - First, type: tâm    (type directly in your application)
+     - Then type $ immediately after it: tâm$
+       This will display a list of 11 Han characters labeled with 1, 2, ..., a, b as follows:
+               1. 伈
+               2. 僒
+               3. 兓
+               4. 嶜
+               5. 心
+               6. 忄
+               7.  沁
+               8.  芯
+               9.  鈊
+               a.  㣺
+               b.  𢖩
+        ( If you do not see the characters appear properly, try another font: Right click on this page
& and change the font to Arial Unicode MS or HANNOM A .)
+
+     - Next, if you want to select any Han character, just type its label immediately after $ to select it.
+
+ For example, you can type tâm$2 to get 僒, tâm$3 to get 兓.
& Note that this typing method is not based on IME so you do not need to press the Enter key.
& Alternatively, you can click directly on the character you want.
+
+ The character $ is called a selector because it helps select a Han/Nôm character.  
& You can change it if you want.
& It must be non-alphanumeric, i.e., it must be a symbol (not a letter and not a digit).
& In addition, it must be distinct from the repeater character (see topic 4 below).
+
+ The default selector is the forward slash character, which is conveniently
& chosen for US keyboards because it requires only one keypress; you do not
& need to press the SHIFT key, saving time.  You can change
& any selector by double clicking on it in the third column.
+
+ Note: If you really want to use $ as the normal character and not the selector command, 
& then escape it as follows:  Type the escape character EEE before $, i.e., type EEE$.
+
+ 2. Multiple database support
+ -------------------------------------
+
+ This version of WinVNKey supports more than one database.  The Han Nom dialog
& offers a check combobox with an arrow to the left of the text box.
& When this arrow is clicked, a dropdown list of databases will appear with a
& checkbox to the left.  Users can click on the checkbox to enable or disable
& individual databases.  If checked, the database is enabled and
& its short name will appear in the textbox to the right of the arrow. If unchecked,
& the database is disabled and its short name will disappear.  
& The order in which the database names appear
& is very important.  This is the order in which
& WinVNKey will look up the enabled databases, one after another.
+
+ You can choose the same selector for more than one database.  Or you can use
& different selectors for different databases.  To help users know the 
& selectors of each database, WinVNKey displays them in the dropdown
& menu attached to the arrow that appears second from top of the Han Nom dialog.
+
+ 3. Floating selector
+ ---------------------------
+
+ There is a special selector that is not tied to any fixed database.  Rather, it is floating (going)
& with the first selected database in the Han Nom dialog.
+
+ Consider this example.  Suppose three databases have been enabled in this order:
+
+         Nom, Han, Cantonese
+
+ Thus the first enabled database is "Nom".   Because it is the first,
& it has two selectors: the first one is its own specific selector and 
& the other is the floating selector.  You can use either one to display a list of Han Nom chars.
+
+ The floating selector eases the need to remember all selectors for individual databases.
& If users always use one database at a time, they can always use the floating selector
& all the time.
+
+
+ 4. Repeater Command
+ -------------------------------
+
+ Suppose you want to list all Hán Nôm characters that read "tâm" in Vietnamese.
& You can type tâm$ directly into MS Word and see the Hán Nôm Manager
& dialog display 11 Hán Nôm characters as follows.
+
+         1. 伈
+         2. 僒
+         3. 兓
+         4. 嶜
+         5. 心
+         6. 忄
+         7.  沁
+         8.  芯
+         9.  鈊
+         a.  㣺
+         b.  𢖩
+
+ If you want to get the Hán Nôm character labeled with '2', you will have to type tâm$2 in MS Word.
+
+ What if you want to get another character labeled with '3'? 
+
+  (a) You can retype tâm$3.
+  (b) You can use the mouse to click on the character you want.  In fact this is the method available since WinVNKey version 4.
+  (c) Or you can simply type XXX3 as long as the same list of Hán Nôm chars 
& still shows up in the Hán Nôm dialog.  In other words, when you type
+             tâm$2 XXX3 XXX4 XXX5
+ you will get the following:
+             僒 兓 嶜 心
+
+ It can be seen that the symbol  "XXX" is completely equivalent to "tâm/".
& It is hereafter called a repeater command because it repeats the command last used to display the
& Hán Nôm characters.
+
+ The repeater command  must be a non-alphanumeric and must be different from all selectors.
& It always applies to the list currently displayed.  It saves
& you from typing tâm$ again. It is a new feature introduced in WinVNKey 5.3.412.
+
+ Consider another example.  Suppose you type this sequence in MS Word:
+             tâm$2 XXX3 XXX4 XXX5 XXX6 XXX7 and XXX8 and XXX9
+ What you see is this:
+             僒 兓 嶜 心 忄 沁 and 芯 and 鈊 
+
+ Let's take a look at the token XXX8 above.  Note that you can type other 
& text before XXX8.  As long as the Hán Nôm characters are still displayed in
& the Hán Nôm Manager dialog, you will have XXX8 replaced with the Hán Nôm character labeled "8".
+
+
+ NOTE: If you really want to use XXX as the normal character, then escape it by typing
& the escape character EEE before it.  For example, you can type:
+             tâm$2 XXX3 XXX4 XXX5 EEEXXX6 XXX7 and XXX8 and EEEXXX9
+ What you see is this:
+             僒 兓 嶜 心 XXX6 沁 and 芯 and XXX9
+
+
+
+ 5. Enable typing hex code using 0h...$ format
+ -----------------------------------------------------------
+
+ By enabling this feature, you can type any Han/Nôm characters that have no pronunciations in
& the database.  The format is as follows:
+
+       <prefix 0h><hex code><floating selector>
+
+ For example, to get the Han character that has Unicode value U+54C0, type 0h54C0$.
+
+
+ 6.  About databases for Four-Corner-Index Method (4CI)
+ -------------------------------------------------------------------------
+
+ Currently there is only one 4CI database for Han characters only.  But 4CI databases for Nom,
& Korean, and Japanese characters may be developed in the future and WinVNKey will
& then support more than one 4CI database.
+ 
+ What is the Four-Corner-Index Method?
+
+ Each Han character is described by an index of 4 or 5 decimal digits, 
& each of which ranges from 0 to 9 that describes the orientation of the strokes at the four
& corner and optionally at the center of the box enclosing the character.  This kind
& of description does not necessarily produce a unique relation between characters and 
& indices.  For example, many different Han characters may have the same index value.
& An arbitrary index value may correspond to no real Han character at all.  Nevertheless,
& this method allows grouping Han characters into smaller groups that are easy to look up.
&
& Suppose you want to show all Han characters corresponding to index 00104.  It's simple; you
& need to type
+       00104$
+
+ Thus this typing method is identical to typing Vietnamese pronunciation.  The only difference
& is that it uses decimal digits rather than letters.  Because of this difference, you can use the
& same floating selector for both kinds of databases (4CI database and pronunciation-based database).
& WinVNKey can identify the correct database based on the nature of the leading string.
+
+ In other words, the floating selector applies to the first selected non 4CI database 
& as well as the first selected four-corner-index method database.
+
+ That's why when clicking on the first check combobox on the Han/Nom dialog, you will
& see that the 4CI database menu has two selectors if they are different.
+
+
+ 7. Hot key support to select/deselect databases
+ ---------------------------------------------------------------
+
+ There are 5 hot key sequences currently defined to select a database.  To use it, you
& must enable the hot key feature on Page Advanced.  Specifically,
+
+    <Alt> <Alt> <1>  -- to select database number 1 only
+    <Alt> <Alt> <2>  -- to select database number 2 only
+    <Alt> <Alt> <3>  -- to select database number 3 only
+    <Alt> <Alt> <4>  -- to select database number 4 only
+    <Alt> <Alt> <5>  -- to select database number 5 only
+
+ Note that the notation <Alt> <Alt> <1> simply means as follows:
+     - press and release the Alt key twice
+     - then press and release the key that is labeled with "1" (not meant to get number 1)
+
+ On US keyboards you press the key labeled with "1" to get number 1.
& On other keyboards such as French, to get number 1 you have to hold down a SHIFT key; otherwise, 
& you will get the ampersand character "&".  But this is not how the hot key sequence is defined.
+
+ The hot key sequence is defined with key that bears the label.   You simply type the key that has that label
& and do not care about the resulting character.
+
+ Thus, even on French keyboards, you must not hold down a SHIFT key while typing 1.  Rather, you must do:
+     - press and release the Alt key twice
+     - then press and release the key that is labeled with "&1" (no SHIFT key, please)
+ 
+
+ 8.  How to change or add more hot keys?
+ -------------------------------------------------------
+
+ You can customize hot keys by clicking on the first button on the Advanced page.  A hot key table will appear
& with many buttons to allow you to enable, disable, delete, or add new hot keys.
+
+ To add a new hot key, click on the rightmost button.  A dialog will appear which guides you step by step
& to create a new hot key.
+
+ For Han Nom there are specifically two types of hot keys:
+     a) hot key to select databases (Purpose #13 in "Add New Hot Keys" dialog)
+     b) hot key to toggle a single database (Purpose #14)
+
+ The predefined hot keys <Alt><Alt><n> listed in Section 7 belong to type (a).
& Type (b) is a toggle functionality.  It means if the chosen database is currently enabled, 
& typing a hot key sequence will disable it and vice versa.  You should experiment yourself.
& The dialog should display an appropriate message explaining the result of
& what you defined.
+
+

[HanNomTyping LongName]
han-viet=Type Chinese by Vietnamese followed by XXX
nom-viet=Type Nôm by Vietnamese followed by XXX
hanphonthe-viet=Type Traditional Chinese by Vietnamese followed by XXX
hangianthe-viet=Type Simplified Chinese by Vietnamese followed by XXX
cantonese-viet=Type Cantonese Chinese by Vietnamese followed by XXX
han-4corner=Type Chinese by Four Corner Index Method followed by XXX
han-pinyin=Type Traditional/Simplified Chinese by Pinyin followed by XXX
hanphonthe-pinyin=Type Traditional Chinese by Pinyin followed by XXX
hangianthe-pinyin=Type Simplified Chinese by Pinyin followed by XXX
han-cangjie=Type Chinese by Cangjie method followed by XXX

[HanNomTyping ShortName]
han-viet=Hán
nom-viet=Nôm
hanphonthe-viet=Chinese Trad.
hangianthe-viet=Chinese Sim.
cantonese-viet=Cantonese
han-4corner=4-Corner
han-cangjie=Cangjie

[Page Hannom Select]
@H1=You must enter a symbol such as / in this box.

[HanNom Websites]
; Each site needs two lines: one for the name to display, one for the actual address
; The site numbers must be consecutive.

site1.name=Han Viet Dictionary Online 
site1.address=http://www.viethoc.org/hannom/

site2.name=Thieu Chuu Dictionary
site2.address=http://perso.wanadoo.fr/dang.tk/langues/hanviet.htm

site3.name=Chu Thich Han Viet --1
site3.address=http://www.petrus-tvk.com/ChuThich.html

site4.name=Chu Thich Han Viet -- 2
site4.address=http://www.vietngu.org/ChuThich.html

site5.name=Han Nom Software
site5.address=http://www.hanosoft.com

site6.name=Institute of Vietnamese Studies
site6.address=http://www.viethoc.org

site7.name=Nom Foundation
site7.address=http://www.nomfoundation.org

site8.name=Vietnam Lexicography Centre
site8.address=http://www.vietlex.com

[HanNomFont]

A1=Type
A2=Don't autochange Hán/Nôm fonts in MS Office

@Intro=To change font/color for each type of characters, right click on the box 
& containing the appropriate representative character.  To get help,
& click on the blue labels.
+
+ For convenience WinVNKey groups all the Han/Nom characters into one of the four following types:
+
+   - Type A:  All characters of the form U+xyzt (4 hex digits) where the first digit is not 'E'.  If the first digit is 'E', the character belongs to type E.
+
+   - Type B:  All characters of the form U+2xyzt (4 hex digits following '2'). .  These characters belong to Plane 2 (Han Nom Extension B)
+
+   - Type E:  All characters of the form U+Eyzt (3 hex digits following 'E'). These characters fall into the Private Use Area in the Basic Multilingual Plane (Plane 0). 
+
+   - Type F:  All characters of the form U+Fxyzt (4 hex digits following 'F').  These characters belong to Plane F (Private Surrogate Characters) 
+
+ For example, the Vietnamese word "trong" has Nôm characters that fall into 4 types A, B, E, and F.  There is no single Han/Nom font that can
& cover characters of all four types.  Most fonts cover a single type (e.g. "HAN NOM B" covers type B only); a few others 
& may cover more (e.g. "HAN NOM A" covers type A, E, and F).  To be able to display characters of all four types, it is necessary
& to specify a font for each type.
+
+
+ Basically, you need to have at least these fonts:
+       1. HAN NOM A
+       2. HAN NOM B
+       3. Arial Unicode MS
+ If you don't have any of these fonts, click the Download button below to download.
+
+ ===============================
+ 
+ Note on the checkbox at the bottom:  This box is applicable when you
& are typing Han/Nom in MS Office such as Word. 
+
+ 1) Checkbox is empty (default behavior)
+ In this case WinVNKey always detects the type of each Hán/Nôm character
& you type in (type A, B, E, or F).  Thus it knows which font should be
& used for this character based on the four fonts specified in this dialog.
& WinVNKey then tries to force MS Office to change to this font
& for the character you just typed in.  However, this method
& works for Office XP (2002) and Office 2003 only.
+
+ 2) Checkbox is checked
+ WinVNKey does not try to change fonts in MS Office for you.
& This means you have to change fonts frequently, from HAN NOM A to
& HAN NOM B and vice versa whenever the character you typed in
& changes its type.  It's annoying.
+
+ Fortunately, if you use Office XP/2003 on Windows XP, there's good news
& for you.  Windows XP can change fonts automatically for all 
& surrogate characters in Plane 2 (type B) and Plane 15 (type F)
& if you have set up the system registry:
+        - Click Run | Preferences | Surrogate Fonts | Default
+        - Read the last two comboboxes to see if Plane 2 uses font
& HAN NOM B and Plane 15 uses HAN NOM A.
+
+ However, this mechanism does not work 100%.  If it does not
& work, you have to change fonts yourself in MS Office for
& all characters that appear as empty square boxes.
+



Help-FontColor-U+xyzt=Right click on the Han/Nom character box to change font/color for characters of this type.
& This change affects all Unicode characters of the form U+xyzt (4 hex digits x, y, z, t)
& where the first digit is not E.
+
+ The default font for type A is "HAN NOM A".

Help-FontColor-U+Exyz=Right click on the Han/Nom character box to change font/color for characters of this type.
& This change affects all Unicode characters of the form U+Eyzt (3 hex digits x, y, z after 'E')
+
+ The default font for type E is "HAN NOM A".

Help-FontColor-U+2xyzt=Right click on the Han/Nom character box to change font/color for characters of this type.
& This change affects all Unicode characters of the form U+2xyzt (4 hex digits x, y, z, t after '2')
+
+ The default font for type B is "HAN NOM B".

Help-FontColor-U+Fxyzt=Right click on the Han/Nom character box to change font/color for characters of this type.
& This change affects all Unicode characters of the form U+Fxyzt (4 hex digits x, y, z, t after 'F')
+
+ The default font for type A is "HAN NOM A".

Help-Download-HANNOM-A=Your system has an older version of font "HAN NOM A", 
+ which does not cover Nôm characters in the private surrogate plane F.  
+ A newer version is now available that supports plane F.
+ It can be downloaded from http://winvnkey.sf.net
+
+ Do you want to download the new version (12,750 KB) ?
+


[Han Websites]

site1.name=Look up at Han Viet Chu Thich (bestbeez.com)
site1.address=http://www.bestbeez.com/HvDict/servlet/HanVietChuThich

; This address was found by visiting http://www.petrus-tvk.com/ChuThich.html
; Then pasted a Han character and when the result came back, watched
; the address in the address box of the browser.
;

site2.name=Look up at Han Viet Chu Thich (vietngu.org)
site2.address=http://www.vietngu.org/servlet/HanVietChuThich

[Nom Websites]
site1.name=Look up at Nom Foundation
site1.address=http://www.nomfoundation.org

[Hannom Setup Dialog]

A1=Han Nom Selector

A2=Typing this symbol immediately after a valid Vietnamese word
& in any application will display a list of 
& Han Nom characters.

C1=How to type a Han/Nom character that is pronounced as "tâm" in Vietnamese?
+     - First, type: tâm$ to display a list of Han Nom for "tâm"
+     - Next, to select the character labeled "2", type tâm$2 or click on it.
+ The character $ is called a selector because it helps select a character.
+
+ This version of WinVNKey supports more than one database.  Users can enable
& individual databases through a combobox dropdown list.  The order of selecting
& a database is important.  The order is shown up in the text box.

A6=Enable typing character by its hex code using 0h ... $ format.
A7=For example, to get character U+54C0, type 0h54C0$

B1=Handle Long Han Nom List
B2=1. Resizing the Han Nom dialog by dragging down the bottom edge
B3=2. Or scrolling back and forth by typing an appropriate symbol

B4=Forward
B5=Backward
B6=Scroll Quantity

@W1=You cannot use letter, digit, or space!  
+ Please use symbol only.  Try again.

W2=You must enter one symbol such as /
@W3=You must enter a symbol, up to as many as 4, such as [ or < or [<
@W4=You must enter a symbol, up to as many as 4, such as > or ] or >]
@W5=You cannot use letter, digit, or space!  
+ Please use a symbol only (e.g. a semicolon).
+ WinVNKey will reset to default.

@W6=You cannot use a symbol already used for scrolling forward.
+ Please try again.

@W7=You cannot use a symbol already used for scrolling backward.
+ Please try again.


[Hannom Update Dialog]

@Help=WinVNKey's Unicode Han Nom databases are still in development.
& Many Hán Nôm characters may be wrong or missing from the database.
& Fortunately, the source databases are stored in plain text files with
& the .txt extension so you can edit them with Notepad or Wordpad.
& Thus you can fix wrong characters or add new ones to appropriate
& files, and then use the Han Nom Update dialog to recreate the binary databases.
& It is these binary files that WinVNKey uses at runtime to support Han Nom typing.
+
+ A.  Database subdirectories and text files
+ -------------------------------------------------------
+ Currently there are 10 types of Han Nom databases.  Each type is associated
& with a subdirectory under the folder $. 
+     1. Han-Viet
+     2. Nom-Viet
+     3. HanPhonThe-Viet   (HanPhonThe means Traditional Chinese)
+     4. HanGianThe-Viet   (HanGianThe means Simplified Chinese)
+     5. Cantonese-Viet
+     6. Han-4Corner
+     7. Han-Pinyin
+     8. HanPhonThe-Pinyin
+     9. HanGianThe-Pinyin
+   10. Han-Cangjie
+
+ The directory name is purposely chosen to contain two parts separated by a hyphen.
& The first part is the name of the ideographic language (Han, Nom, or Cantonese, etc).
& The second part is keyboard entry method, which can be
& the pronunciation written in a particular language (Vietnamese Quốc Ngữ or Pinyin),
& or certain encoding scheme (Four corner method, Cangjie, etc).
& For example, the directory name Han-Viet is meant to store text databases
& for Han (Chinese) characters and their pronunciation in Vietnamese.  
+
+ Each directory can contain zero, one, or more text files. 
& These text files have basically two columns:
+          - One column is the Han or Nom characters
+          - Another column is pronunciation or string to enter on the keyboard
+ The files can be named arbitrarily but must have the ".txt" extension.  They
& can contain characters in Unicode or UTF-8 format.  Lines beginning with "#"
& or blank lines are comment and are ignored.
+
+
+ B.  Database binaries
+ -----------------------------
+ When you run Update on each directory,
& WinVNKey will read all text files (again, files with .txt extension) in that directory, combine them into
& a single binary file, and put it in the parent directory, namely $.  This binary file has the same basename
& as the directory name, and its extension is
+          - usually ".dat" for Vietnamese pronunciation or Cangjie,
+          - ".py" for Pinyin pronunciation,
+          - ".4ci" for Four-corner-index method.
+
+ The following listing shows all binary database names:
+
+     1. Han-Viet                    => Han-Viet.dat
+     2. Nom-Viet                   => Nom-Viet.dat
+     3. HanPhonThe-Viet       => HanPhonThe-Viet.dat
+     4. HanGianThe-Viet       => HanGianThe-Viet.dat  (currently not available)
+     5. Cantonese-Viet          => Cantonese-Viet.dat	
+     6. Han-4Corner              => Han-4Corner.4ci
+     7. Han-Pinyin                 => Han-Pinyin.py
+     8. HanPhonThe-Pinyin    => HanPhonThe-Pinyin.py
+     9. HanGianThe-Pinyin     => HanGianThe-Pinyin.py
+   10. Han-Cangjie               => Han-Cangjie.dat
+
+ These binary files have an interesting feature. You can issue a "type" command to
& see the detailed info in the header of the file.  For example,
& you can open a command prompt, change to the folder $, and issue the command
+
+            type Han-Viet.dat
+
+ The text output by this command is also displayed when you select the "About" menu in the Han Nom Manager.
+
+ C. How to add your new text databases
+ --------------------------------------------------------
+ As an example, consider the folder Han-Viet.  When WinVNKey is first installed, this 
& subdirectory should contain a few text files. You can open any file to see its format.
& If you see any errors in the file, you can correct them, or even add new characters.
+
+ In general, if WinVNKey sees a .txt file in the directory Han-Viet, it will treat the file
& as raw Hán-Việt data.   Thus if you drop a new .txt file into directory Han-Viet,
& this file must better contain two columns similar to the sample file, say, Data-HanViet-LST.txt:
+
+      -  the first column is Hán characters
+      -  the second column is the corresponding Vietnamese pronunciation.
+
+ You can use this feature to add new characters: simply collect your new characters
& into one or more new files as long as the filenames have the .txt extension.
& If you have new Hán characters, it is recommended that you create your own files to store them
& because it is easier to exchange smaller files with other people.
+
+ D. How to update a particular binary database
+ -----------------------------------------------------------------
+ Suppose you want to modify Han-Viet database or add new characters to it.
& This can be done as follows in the Update dialog:
+
+       1. Select an appropriate database name in the combobox.
+           Choose "Han-Viet", which means choosing subdirectory Han-Viet.
+       2. Click the "Edit" button.  
+           This will display a dropdown list of text files in this directory.
+           Choose an appropriate file, or choose the menu for creating a new file.
+           Then edit file and save ịt
+       3. Click the "Rebuild" button
+           This process can take a minute or two.  Be patient.  
+
+ When the binary database is fully created, you can repeat this process to update other databases, one at a time.
& When you are done with the update process, you need to restart WinVNKey so that the new databases
& will take effect.
+

B1=I want to update the following database:

B2=Procedure to update database

B3=1.  Click left button to choose file to edit/create
B4=2.  Click left button to rebuild the database

@W1=You have modified the text database 
+ but have not rebuilt the binary database file yet.
+ Thus WinVNKey will still use the old database.
+
+ To rebuild the database, you should go back to the page
+ and click on the "Rebuild" button.
+


M1=Rebuilding database XXX ...
@M1A=Successfully recreated two Han-Pinyin text files
+      - XXX  (NNN single chars, KKK compound chars)
+      - YYY  (NNN single chars, KKK compound chars)
+ from the following source file:
+         ZZZ.
@M1B=Failed to recreate two Han-Pinyin text files
+      - XXX
+      - YYY
+ from the following source file:
+         ZZZ.
M2=Read all .txt files in folder
M2A=Read all .txt files that do not begin with "Data-" in folder
@M2B=Read folder

M3=Read file
M4=Can't open this file.  Will skip it
M5=File is empty or has no data.  Will skip it
M6=Memory error
M7=- Single character entries: File has XXX new unique entries
M8=XXX of which are in Extension B
M9=These entries do not include XXX duplicates
M10=(see file "XXX" in subfolder Output)
@M7A=- Multi-character entries: File has XXX new unique entries

M11=- There are NNN errors listed in file "XXX"
M12=Error!  File is not in the correct Unicode format!
& The file XXX
+ was saved wrongly as YYY.
+
+ You must reopen the file with Notepad,
& then choose File | "Save As" Unicode  (not Unicode big endian, not UTF-8).
+
+ The update process is aborted!

M13=- A total of XXX misspelled Vietnamese words or foreign words were
& successfully included in the database.  They were forced into the
& database because "@OK" is specified in the comment column.

M14=Finally, created master file "XXX" (in subdirectory "Output") 
& to combine all .txt database files into a single file.
& This file contains only single-ideograph entries that were successfully processed into the database.
& WinVNKey does not use any files in the "Output" directory.  All the files in this directory
& are created for your information only.

M15=Created new subdirectory "Output" to store temporary files.
M16=Will store all temporary files in subdirectory "Output" for you to review.

M17=Directory has no data files

@M18=Total: XXX indices and YYY unique characters, of which ZZZ characters are surrogates.
@M19=Total: XXX indices and YYY unique characters (no surrogates)
@M20=Memory error while saving database to disk
@M21=File has XXX indices, YYY characters (of which ZZZ characters are surrogates), and
& TTT duplicated characters
@M22=File has XXX indices, YYY characters (no surrogates), and
& TTT duplicated characters
@M23=No source text files with ".txt" extension are found in the folder
+              XXX

@M24=Note:
+ A character is said to be duplicated if it is already listed in the same
& file that WinVNKey is reading or in previous files that WinVNKey has
& already read.  All duplicated characters
& will be eliminated from the final database.
+

@M25=Update can take as long as a minute.  Please wait ...
@M26=Update completed.  Total time = XXX seconds.

N1=Combine Han and Nom into XXX
N2=Error opening output file XXX
N3=New database XXX was created successfully.
N4=Aborted
N5=You must restart WinVNKey to use the new database.
N6=You must restart WinVNKey for your changes to take effect.

P1=LIST OF CHARACTER DUPLICATES WHEN READING FILE

P2=All characters that already appeared in the same file or
+ in previous files will be dropped from the database to make
+ sure the database does not contain duplicated entries
+
P3=Already read file
P4=Now reading file
P5=Line
P6=Character duplicate
P7=First appeared in file #/Line #
P8=There are XXX duplicates in the file.

Q1=LIST OF ERRORS WHEN READING FILE
Q2=The following lines have errors. 
+ Perhaps the following Vietnamese words are misspelled, or
+ simply classic Quoc Ngu writing, or the result of concatenating
+ many Vietnamese words together.  They can be foreign
+ words as well.   They were not included in the database.
+
+ If you really want to include in the database, open the original txt file,
+ add "@OK" to the comment field after the misspelled Vietnamese word. 
+ For example,
+
+       U+8419      kutabireru   # @OK
+       U+F029C   hơng           # @OK
+
+ Note that "#" starts the comment field and you can place "@OK"
+ anywhere as long as it is after "#".
+
+ In short, if a line contains "@OK" after "#", it means all data on the line
+ is OK and WinVNKey will add it to the database.

Q3=Error

R1=This file was created by program XXX
+ and was saved in Unicode on YYY.
+
+ Its goal is to combine all distinct entries from all individual
+ database files in the folder
+          ZZZ
+ Specifically, the following files were combined:

R2=This master file guarantees that all entries in it are distinct
+ and have correct Vietnamese spelling.  Thus,
+     - All duplicated entries are excluded.  They are listed in .dup files.
+     - All misspelled Vietnamese words, including words written in
+       classic spelling (e.g., duợt) and foreign words, are excluded 
+       as well unless there is a note "@OK" in the comment field.
+       The excluded words are listed in *.err files.
+

R3=Summary for this file:
+       GGG distinct entries (included)
+       DDD duplicated entries (excluded)
+       EEE invalid or misspelled entries (excluded)

R4=This file was created by program XXX
+ and was saved in Unicode on YYY.
+
+ Its goal is to combine all entries marked with "@OK" from all individual
+ database files in the folder
+          ZZZ
+ Specifically, these entries come from the following files:

R5=Unicode Vietnamese              Count File/Line

Help-CEDICT1=# Don't edit this file because it is autogenerated!
+ #
+ # This file is generated from HanNom\InternetSources\cedict_ts.u8
+ # whenever HanPhonThe-Pinyin or HanGianThe-Pinyin database is
+ # rebuilt. The master file can be downloaded from
+ #         http://us.mdbg.net/chindict/chindict.php?page=cedict
+ # or from:
+ #         http://www.mdbg.net
+ #         http://cc-cedict.org/wiki/
+ # Note that the master file cedict_ts.u8 contains Traditional Chinese
+ # in column 1 and Simplified Chinese in column 2.
+ #
+ # If you find out a newer version at this website, please download
+ # and save it as cedict_ts.u8 (without .txt extension) in the folder
+ # HanNom\\InternetSources.  Then rebuild this file as follows:
+ #     Run | Type Han Nom | Options | Update Han Nom databases 
+ # Then select HanPhonThe-Pinyin or HanGianThe-Pinyin and rebuild.
+ #
+ # ---------------------------------------------------------------------------------------------------
+ #
+ # Xin vui lòng đừng thêm bớt vào tệp này vì tệp này được tạo ra tự động.
+ #
+ # Tệp này được WinVNKey tạo ra từ tệp HanNom\InternetSources\cedict_ts.u8 mỗi
+ # khi bạn xây dựng lại kho dữ liệu HanPhonThe-Pinyin hoặc HanGianThe-Pinyin.
+ # Bạn có thể hạ tải tệp gốc từ
+ #         http://us.mdbg.net/chindict/chindict.php?page=cedict
+ # hoặc từ:
+ #         http://www.mdbg.net
+ #         http://cc-cedict.org/wiki/
+ # Chú ý rằng tệp gốc cedict_ts.u8 chứa chữ Hán Phồn thể ở cột 1 và Hán
+ # Giản thể ở cột 2.
+ #
+ # Nếu bạn khám phá ra website này phát hành một phiên bản mới hơn, bạn có
+ # thể hạ tải và lưu trữ dưới tên là cedict_ts.u8 (không có đuôi .txt) trong thư mục
+ # HanNom\\InternetSources.  Xong xây dựng lại kho dữ liệu như sau:
+ #        Chạy | Gõ Hán Nôm | Chọn lựa | Cập nhật kho dữ liệu Hán Nôm
+ # Trên trang "Cập nhật kho dữ liệu", bạn hãy chọn HanPhonThe-Pinyin
+ # hoặc HanGianThe-Pinyin, rồi xây dựng lại.
+ # 
+ # ---------------------------------------------------------------------------------------------------
+

Help-CEDICT2=# File Trad-Simp.txt
+ # Don't edit this file because it is autogenerated!
+ #
+ # This file contains the Traditional-Simplified conversion table in the following format:
+ #   <Traditional UnicodeValue> <Simplified UnicodeValue> <Traditional Char> <Simplified Char> <Pinyin>
+ #
+ # where only columns 1 and 2 are used by WinVNKey for Han Nom conversion
+ # from Traditional to Simplified or vice versa.   Columns 3, 4, 5 are treated as comment; they
+ # show the true Traditional and Simplified characters together with Pinyin pronunciation
+ # to help readers check the accuracy of the conversion in columns 1 and 2.
+ #
+ # If you want to add missing conversion entries, add to file Trad-Simp-Supplement.txt instead.
+ #
+ # The file Trad-Simp.txt is generated from HanNom\InternetSources\cedict_ts.u8
+ # whenever the database HanPhonThe-Pinyin or HanGianThe-Pinyin is
+ # rebuilt. The master file can be downloaded from
+ #         http://us.mdbg.net/chindict/chindict.php?page=cedict
+ # or from:
+ #         http://www.mdbg.net
+ #         http://cc-cedict.org/wiki/
+ # Note that the master file cedict_ts.u8 contains Traditional Chinese
+ # in column 1 and Simplified Chinese in column 2.
+ #
+ # If you find out a newer version at this website, please download
+ # and save it as cedict_ts.u8 (without .txt extension) in the folder
+ # HanNom\InternetSources.  Then rebuild this file as follows:
+ #     Run | Type Han Nom | Options | Update Han Nom databases 
+ # Then select HanPhonThe-Pinyin or HanGianThe-Pinyin, then click the Rebuild button.
+ #
+ # ---------------------------------------------------------------------------------------------------
+ #
+ # Xin vui lòng đừng thêm bớt vào tệp này!
+ # Tệp này chứa bảng đổi chữ từ Phồn thể sang Giản thể và ngược lại.  Các cột có
+ # ý nghĩa như sau:
+ #        <Mã Phồn thể>  <Mã Giản thể>   <Chữ Phồn thể>  <Chữ Giản thể>   <Pinyin>
+ # Thực sự, WinVNKey chỉ sử dụng 2 cột đầu tiên, còn 3 cột còn lại được coi như phần
+ # chú thích giúp cho độc giả có thể nhìn thấy chữ Hán thật sự và dò lỗi sai.
+ #
+ # Nếu bạn thấy tệp này thiếu một số chữ mà bạn biết cách đổi, hãy thêm vào
+ # tệp khác có tên là Trad-Simp-Supplement.txt.
+ #
+ # Tệp Trad-Simp.txt  được WinVNKey tạo ra từ tệp HanNom\InternetSources\cedict_ts.u8 mỗi
+ # khi bạn xây dựng lại kho dữ liệu HanPhonThe-Pinyin hoặc HanGianThe-Pinyin.
+ # Bạn có thể hạ tải tệp gốc từ
+ #         http://us.mdbg.net/chindict/chindict.php?page=cedict
+ # hoặc từ:
+ #         http://www.mdbg.net
+ #         http://cc-cedict.org/wiki/
+ # Chú ý rằng tệp gốc cedict_ts.u8 chứa chữ Hán Phồn thể ở cột 1 và Hán
+ # Giản thể ở cột 2.
+ #
+ # Nếu bạn khám phá ra website này phát hành một phiên bản mới hơn, bạn có
+ # thể hạ tải và lưu trữ dưới tên là cedict_ts.u8 (không có đuôi .txt) trong thư mục
+ # HanNom\InternetSources.  Xong xây dựng lại kho dữ liệu như sau:
+ #        Chạy | Gõ Hán Nôm | Chọn lựa | Cập nhật kho dữ liệu Hán Nôm
+ # Trên trang "Cập nhật kho dữ liệu", bạn hãy chọn HanPhonThe-Pinyin
+ # hoặc HanGianThe-Pinyin, rồi nhấn nút "Xây dựng".
+ # 
+ # ---------------------------------------------------------------------------------------------------
+


[MacroHelp DlgTitle]
Language=Help on Language
AutoExp1=Help on Auto Expand Level 1 Macros
AutoExp2=Help on Auto Expand Level 2 Macros
Tail=Help on Tail Macros
Syllable=Help on Lazy Syllable Macros
Shorthand=Help on Shorthand Macros
LazyWord=Help on Lazy Word Macros

[Macro Help]

A1=Note: You can right click inside each list box to see options available to you in the dropdown menu.
B1=File XXX is too big.
+ It may take a long time to read and display all macros.
+ Do you still want to read and display this file?

C1=All changes are not effective until you close the dialog
+ and save the file.

C2=WinVNKey will do the following:
+    1. Remove all trailing spaces in the replacement text in column 2
+    2. Save all macros to file
+    3. Close the dialog
+
+ Do you want to proceed?
+
Help-SelectLanguage=SELECT LANGUAGE FILES
+
+ Each language is supported via a macro file which consists of macros to produce
& all letters of the alphabet of that language.  The file is generally named after
& the language and is located in the directory Macros\Language.  All the help
& on macro files is also applicable to language files.  It is listed below for reference.
+
+
+

Help-SelectFiles=SELECT MACRO FILES
+
+ - You can right click inside the boxes below on the left and on the right
& to see additional options to manipulate files.  For the box on the right, you
& can also right click on each column header to see more options.
+
+ - If you want to edit any macro file, simply select that file in the left box
& and click the "Edit" button below.
+
+ - If you want more info about the type of macros being selected in the combobox,
& click on the "?" button.
+
+ - If you want to turn on any macro file, just enable the checkbox next to the file.
& When you click to enable a file, all the macros in the file will be listed in the box on the right.
& If you select the next file, all the old macros will disappear giving room for new macros.
& If you don't want the old macros to disappear, you can enable the checkbox "List all selected files".
& In this way you can check macros for conflict by clicking on the first column header entitled "Typing"
& to sort the first column alphabetically.
+
+
+ A. MACRO CONFLICT
+ -----------------------------
+
+ In general, macro files are independent and can be enabled arbitrarily.
& But you can create two or more macro files and allow users to choose only one file at a time.
+
+ Example:  Suppose you have two macro files as follows:
+        - Geography.txt:  this file has a macro "vn" that expands into "Việt Nam".
+        - Culture.txt:  this file has a macro "vn" that expands into "Văn nghệ".
+
+ Because both files define the same macro name with different replacement text,
& they are conflicting.  If you enable both files, which replacement text will be used when you type "vn"?
& Depending on which file is processed first you will have a different result.
& In general, it is very difficult to know the outcome.  Thus, you should choose one file at a time.
+
+ Suppose you send these two files to other users.  They may enable two files at the same time
& without knowing if they are in conflict.  Thus you have to inform them of the conflict.
& But what if they forget?  There is nothing in place to guarantee they will remember this forever.
& For this reason WinVNKey has a built-in mechanism to prevent macro conflicts.
+
+ B. HOW TO RESOLVE CONFLICT
+ ---------------------------------------------
+
+ WinVNKey defines a mechanism in the filename to allow only one file in a group to be
& selected at a time.  For instance:
+
+        - Geography@[group1].txt
+        - Culture@[group1].txt
+
+ Rules:
+    1) If a file belongs to a group named "xxx", append a string of the form "@[xxx]" to the basename of the file.
+    2) For each group "xxx", WinVNKey will allow only one file to be selected at a time. If you enable a file
& in the group, all other files in the group will be deselected.
+
+ In the examples above, the two files belong to a group named "group1".  The group name is an arbitrary
& string of characters as long as the entire filename is legal (i.e., cannot contain illegal
& characters like / or <, >, etc.).  For example, you can name the files above as
+
+        - Geography@[abcxyz].txt
+        - Culture@[abcxyz].txt
+
+ Other examples:
+     - Typing-Russian@[2007].txt
+     - Typing-Russian@[2007].txt
+     - Typing-Russian@[2007].txt
+     - Typing-Pali@[hoc].txt
+     - Typing-Pali@[hoc].txt
+
+ There are two different groups in this example: group "2007" has 3 files and group "hoc" has two files.
+
+

Help-MacroType=OVERVIEW OF MACRO PAGES
+
+ When you type text, WinVNKey always tries
& to match the last string you typed with macros.  For each enabled macro,
& the matching is done from right to left, starting with the most recently typed character.
& There are many ways of grouping macros.  We can group them based on
& WHERE to type the first macro character and WHEN to expand the macro.
+
+ I. WHERE TO TYPE THE FIRST MACRO CHARACTER
+ ------------------------------------------------------------------------
+
+  For convenience, WinVNKey classifies macros based on WHERE you can type the first macro character.
& For example, you can type the first letter of a macro
+     (a) at any place in a typed word or string, or
+     (b) only after some character of a typed word or string, or
+     (c) only at the beginning of a typed word or string.
+
+ Thus there are only three main types of macros based on where you can type the first macro character.
& In principle WinVNKey can just offer three pages of macros.  However, for user's convenience,
& WinVNKey offers seven different macro pages numbered from 0 to 6 as follows:
+        Page 0. Language macros: supports type (a)
+        Page 1. AutoExpand1: supports type (a)
+        Page 2. AutoExpand2: supports type (a)
+        Page 3. Tail macros:    supports type (b)
+        Page 4. Lazy Syllable macros: supports type (b)
+        Page 5. Shorthand macros:    supports type (c)
+        Page 6. Lazy Word macros:    supports type (c)
+
+ Each page can contain one or more macro files so that each of which can be
& enabled or disabled independently. Each time you enter a character from the keyboard, 
& WinVNKey will determine if the resulting string
& is a macro.  To this end it will check each macro page in 
& the ascending order of the page number, and within each page, it will check
& every enabled file.
+
+ II. WHEN TO EXPAND MACRO
+ ------------------------------------------
+
+ Within each macro file you can control WHEN the macro expands into the replacement string.
& For instance, you can specify one of the following conditions:
+       A. Expands immediately as soon as the last macro character is entered, or
+       B. Expands only when you type a delimiter after the last macro character, or
+       C. Expands only when you type a punctuation mark after the last macro character, or
+       D. Expands only after you type a space command character (the space is discarded), or
+       E. Expands only after you type a TAB command character (the TAB is discarded)
+
+ Each expanding condition is known as an expanding method. 
& Macros in the last two expanding methods (D) and (E)
& are also called "sleeping macros" because they do not expand even if
+     - you already entered the last macro character, or
+     - you already entered a delimiter after the last macro character.
+ You need to type a command to wake them up so that they can expand.
& This command is a special character called "expand command character".
& Because it is a command, it is not part of the text.  In other words, the command character is discarded
& after WinVNKey expands the macro.
+
+ The formal definition of the expand command character is as follows.
& An expand command character is a user-definable key that must be typed immediately
& after the last character of a macro to tell WinVNKey to expand the macro.  The command character
& does not appear in the text after the expansion is done.
+
+ But for this version of WinVNKey, the command character is not user-definable yet.
+
+ For backward compatibility WinVNKey
& offers a default expanding method for each macro page as follows:
+        Page 0. Language macros:  expanding method A
+        Page 1. AutoExpand1:   expanding method A
+        Page 2. AutoExpand2:   expanding method A
+        Page 3. Tail macros:      expanding method A
+        Page 4. Lazy Syllable macros:   expanding method A
+        Page 5. Shorthand macros:   expanding method B
+        Page 6. Lazy Word macros:   expanding method B
+
+ Following are the details of macro pages.
+
+ III.  MACRO PAGE DETAILS
+ --------------------------------------
+
+ A.  Type (a)
+ ----------------
+ The first macro character can be typed anywhere in the typed text such as
+              - at the start of a word/string, 
+              - in the middle of a word/string,
+             - at the end of a word/string
+ There are three macro pages supporting this macro type:
+        - Page 0. Language macros
+        - Page 1. AutoExpand1
+        - Page 2. AutoExpand2
+
+ and by default they all expand automatically as soon as you enter the last macro character.
& The only difference among them is the order of processing.  WinVNKey processes
& matching first with the Language page:
+         - If there is no match, it will try to match with the AutoExpand1 page.
+         - Otherwise, it expands the macro and then tries to match the new result with the AutoExpand1 page.
+ When processing the AutoExpand1 page, 
+         - If there is no match, it will try to match with the AutoExpand2 page.
+         - Otherwise, it expands the macro and then tries to match the new result with the AutoExpand2 page.
+ When processing the AutoExpand2 page, 
+         - If there is no match, it will try to match with the Tail macro page.
+         - Otherwise, it expands the macro and then tries to match the new result with the Tail macro page.
+ etc.
+
+ The Language page is useful for defining single characters of foreign languages, hence the name.
& This page appears as a tabbed page in the main WinVNKey control panel.
& Do not be misled by the name; you can define a macro to stand for 
& a string of arbitrary letters/words/symbols and put it in the Language page if you want it
& to be matched before all other types of macros.
+
+ The auto expand 1 and 2 pages are useful for defining a string of one or more
& characters of any language.  
& An example of usage is for auto syllable/word correction.
& Note that you are not limited to a string of characters; you
& can define a number of words/sentences if you want.
+
+ B.  Type (b)
+ -----------------
+ The first macro character must be typed after the initial character(s) of a typed word or string.
& There are two macro pages supporting type (b):
+
+       - Page 3. Tail (trailing) macros
+       - Page 4. Lazy Syllable macros
+
+ Page 3. Tail (trailing) macros
+ --------------------------------------
+ This type of macros cannot match with an entire typed word; it can only match
& with a trailing part of a typed word or string.  In other words, you must type
& the macro after another character. 
& If the letter case smart feature is enabled, you can type the macro in any letter case
& you want and the replacement text will change its letter case accordingly.
& If not enabled, you have to type the macro exactly in the way it is defined.
+
+ Suppose you define "tn =tion" to be a tail macro with case smart turned off.  Then
+       - typing natn => nation  (expands because tn follows 'a')
+       - typing NATN => NATN  (tail macro is case sensitive and we did not define TN)
+       - typing tnet => tnet   (does not expand because it is at the start of a word)
+
+ This page is similar to "Lazy Syllable Macros" but it does not limit to the Vietnamese language.
+
+ Page 4. Lazy Syllable macros
+ ---------------------------------------
+ This type of macros cannot match with an entire typed word; it can only match
& with a trailing part of a typed word or string. The matching is case-smart, meaning
+      - case-insensitive, 
+      - and the replacement text can change its letter case depending on the 
& starting consonants and the individual letters in the macros.
+
+ For example, if you define only one form:  "bb" stands for "ong", then
+       typing  cbb => cong
+       typing  CBB => CONG  (although BB was not defined as a macro).
+
+ This type of macros is commonly used to define Vietnamese syllables.
& Because the intention is to help lazy users define a minimum number
& of Vietnamese syllables and be able to use them in all scenarios of
& changing letter cases, this type of macro is called "lazy syllables,"
& which is very smart macros.
+
+ C.  Type (c)
+ ----------------
+ The first macro character must be typed at the beginning of a typed word or string.
+ There are two macro pages as follows:
+
+        - Page 5. Shorthand macros
+        - Page 6. Lazy Word macros
+
+ Page 5. Shorthand macros
+ -----------------------------------
+ This type of macros must match an entire typed word or string in a case-sensitive manner.
& In other words, the typed macro must be preceded and followed by a space
& or punctuations.  
+
+ For example, if you define "vn" to stand for "Việt Nam", then
+     - typing: I love vn. => I love Việt Nam.
+     - typing: I love VN. => I love VN.  (shorthand macro is case-insensitive and we did not define VN)
+     - typing: I love Winvnkey. => I love Winvnkey.   (vn does not expand)
+
+ This type of macros is commonly used to abbreviate a single word/phrase/sentence.
+
+ Page 6. Lazy Word macros
+ ------------------------------------
+ This type of macros must match an entire typed word or string in a case-smart manner, i.e.,
+       - case-insensitive matching
+       - words in the replacement text will change their character cases
& automatically depending on the case of the individual character in the typed string.
+
+ For example, if you define "vn" to stand for "việt nam", then
+       - typing: I love Vn. => I love Việt nam.   (case changes depending on the case you typed)
+       - typing: I love VN. => I love Việt Nam.
+       - typing: I love Winvnkey. => I love Winvnkey.   (vn does not expand)
+
+ This type of macros is commonly used to abbreviate a single word/phrase/sentence.
& Because the intention is to help lazy users to define a minimum number
& of word macros and be able to use them in all scenarios of
& changing letter/word cases, this type of macro is called "lazy words."
+
+
+ IV. NOTES
+ --------------
+
+ This is just an overview of the basic constraints on the seven macro pages that WinVNKey currently supports.
& However, each macro page can contain one or more macro files and
& WinVNKey offers additional constraints on each file, which affect
& all macros in the entire file.  
+
+ 1) Constraint on the ending macro character
+ -----------------------------------------------------------
+ This is discussed earlier in Section II.
& For example, for certain macro files, one has to type a delimiter after the ending macro character.& 
+
+ 2) Additional properties
+ -------------------------------
+ Each macro page can offer optional features that vary from page to page.  
& To see them, you can click
& on the "Edit" button and look for the properties combobox near the top of the dialog.
+
+

Help-Auto=WinVNKey processes each typed character in the following order:
+
+ 1. check if it can combine with the previous character 
& based on the accent mark table defined in the Viet Chars page
& and the combination rule defined in the Viet Option page.
+
+ 2. check for Language macros and expand automatically if matched.  This type 
& of macros is commonly used to define accented characters for foreign languages.
+
+ 3. check for AutoExpand1 macros and expand automatically if matched.  This type
& of macros is commonly used to define accented characters or part of a word.
+
+ 4. check for AutoExpand2 macros and expand automatically if matched. This type
& of macros is commonly used to define accented characters or part of a word.
+
+ 5. check for Tail macros and expand if matched.  This type
& of macros is commonly used to define a trailing part of a word or string.
+
+ 6. check for Lazy Syllable macros and expand if matched and if the
& result is or can be a legal Vietnamese syllable.  This type
& of macros is commonly used to define Vietnamese syllables.
+
+ 7. check for Shorthand macros and expand if matched.  Macros of
& this type must be preceded and followed by a space or punctuations.  This type
& of macros is commonly used to represent a group of words or phrases.
+
+ 8. check for Lazy Word macros and expand if characters are matched irrespective of cases.  
& Macros of this type must be preceded and followed by a space or punctuations.
& They are smart in that the replacement text can change character cases automatically.
& This type of macros is commonly used to abbreviate a group of words.
+
+
+
+ If you don't want WinVNKey to process a character, just type an escape
& character immediately before it.  For example, type a\' ==> WinVNKey
& will not process ', hence the acute accent mark does not combine,
& no macros are checked, and you will get exactly a'.   You can take
& advantage of this feature to prevent a macro from expanding.  For
& instance, if macro a- is ā, typing a\- will give a-.
+
+ After a character is typed in, WinVNKey will find if the text matches
& any macro name in the macro list, starting from the longest macro name to the shortest.
& If a macro is N characters long, WinVNKey will use
& the most recently typed N characters for comparison.
& To understand this, assume there are two AutoExpand2 macros:
+        oq =ó
+        aoq = ã
+ When you type baoq, you will get bã and not baó because WinVNKey
& compares aoq first and immediately gets the match.
+
+ There is no restriction on Language, AutoExpand1, or AutoExpand2 macros.
& They automatically expand if matched.  There are restrictions on 
& Lazy Syllables, Shorthands, and Lazy Words.  Please click on the "?" button
& on the relevant macro pages for more information.
+
+ Note that after a macro is replaced, you can immediately undo the replacement
& text by pressing and releasing the Right Shift key. In fact, you can toggle
& between the macro and the replacement text by pressing and releasing the Right Shift key
& multiple times.

Help-AutoExp2=This set of macros is processed after "AutoExpand 1".
& The new string you get after "AutoExpand 1" will be checked
& for any match with macros in "AutoExpand 2".  If there is a match,
& the string will be replaced again.

Help-Tail=Tail macros are processed after "AutoExpand 2".
& The new string you get after "AutoExpand 2" will be checked
& for any match with macros in "Tail".  If there is a match,
& the string will be replaced again.
+
+ This type of macro must be typed after one or more characters.
& They are intended to represent the suffix of a word or syllables in any language.
& For example, many English words end with "ation" or "ition".  We can
& define a tail macro named "tn" to represent "tion".  Thus if "tn" is typed
& at the start of a word, it will not expand into "tion".  But if "tn" is typed
& after another character, it will expand:  vacatn => vacation.
+

Help-Syllable=Lazy Syllables macros are a special type of smart abbreviations for
& Vietnamese syllables.  Because they stand for Vietnamese syllables, they
& expand only when the result is forming a legal Vietnamese word.
+
+ A. When to expand?
+ ---------------------------
+
+ The macro expansion does not normally take place unless
+     - the macros follow Vietnamese consonants that begin a new word such as b, c, ch, d, đ, ...
+     - or the macros follow a comma and if this comma follows a space or
& follows a press and release of a CTRL key.
+ 
+ In addition, the expansion takes place if and only if the result is forming a legal Vietnamese word.
& If the macros follow a comma, the comma will be erased
& before the macro expansion takes place.
+
+ Example:
+ Suppose the macro "bb" represents syllable "ong" and "!" represents "ươc".  Then typing
+     1) cbb  ==> cong       (because bb follows a Vietnamese consonant)
+     2) zbb  ==> zbb         (because z is not a Vietnamese consonant)
+     3) con ,bb ==> con ong    (because bb follows a comma, and comma follows a space)
+     4) j<CTRL>,bb ==> jong   (comma can follow a CTRL press and release)
+     5) b!     ==> bươc      (because ! follows a Vietnamese consonant)
+     6) tôi ,! ==> tôi ươc    (because ! follows a comma, and comma follows a space)
+     7) tôi \,! ==> tôi ,!      (the backslash causes the comma to loose its special meaning)
+
+ Note on example 2:
+ Typing zbb does not expand into zong because consonant z is not Vietnamese.
& However, WinVNKey allows you to treat consonant z (and other foreign consonants like f, j, w) as
& Vietnamese so that typing z! will give you zươc.  You can do this from the main page
& by clicking on Viet Option Page ==> Viet Word Processing.
+
+ Note on examples 3 and 6:
+ Many Vietnamese words are themselves syllables, i.e., they begin with a vowel
& such as ong, ông, etc.  Because normal words are commonly preceded by at least a space
& and are almost never preceded by a comma, WinVNKey defines the sequence
+          <space><comma><syllable macro>
+ to be transformed into
+          <space><syllable macro expansion>
+ In short, if you have already typed a space and now want to type a Vietnamese
& word that begins with a vowel as in examples 3, 5, just type a comma before typing
& the macro syllable.
+
+ Note on example 4:
+ Although "ong" is a Vietnamese syllable, "jong" is not a legal Vietnamese word.
& But you do want to type jong fast by leveraging the macro bb.  This can be
& accomplished by pressing and releasing a CTRL key to signal to WinVNKey
& to forget whatever you have typed and to begin a new word.
+
+
+ B. Know how to change to upper/lower case
+ ----------------------------------------------------------
+
+ Although defined in lower case or in caseless symbols,
+ these lazy macros are smart in that they know how to expand into
+ upper case or lower case by relying on the case of the macro letters typed in
& or the state of the CAPS LOCK key.
+
+ Example: 
+     - b<CAPS LOCK>!   ==> bƯơc
+     - B<CAPS LOCK>!  ==> BƯƠC (relies on the case of the preceding letter, B)
+     - <CAPS LOCK>B!  ==> BƯƠC
+     - cBB ==> cONG 
+     - cBb ==> cOng
+
+
+
+ C.  Predefined macro tables
+ -------------------------------------
+
+ You can define your own macro tables.  However, to help you get started,
+ WinVNKey predefines 5 tables of Lazy Syllable macros:
+      1. Change double letters
+      2. Change single letters
+      3. Change single digits
+      4. Change single symbols
+      5. Change punctuations
+
+ Macros in each table can be turned on/off individually.
& However, you should not enable all the tables at the same time.
& In particular, never enable  tables 1 and 2 at the same time
& because the shorter macros in table 2 will override the longer macros in table 1.
& You can add/delete/change these macros or create new tables.
& When you define a new macro, find an appropriate table or create a new one to put it in.
& Each table has some common characteristics to help you remember easily.
& The following sections describe these characteristics.
+
+ C1. Single digits: containing digits only.  Even though digits represent accent marks
& in VNI typing method, they are never used after consonants that start a Vietnamese word.  Thus they
& can be used to represent Vietnamese syllables.
& In general, these macros are fast on US keyboards because
& users do not need to press a SHIFT key.
+
+ C2. Single symbols: containing symbols like '  `  ? ~ @ # $ % etc
& because they never follow Vietnamese consonants that begin a word.
+
+ In fact, have you ever seen an acute accent mark follow a Vietnamese consonant like b?
& Thus if   '  stands for syllable ăc,  you can type b' and get băc, saving a few key presses.
+
+ Because symbols are usually suggestive of pictures or sounds, they are
& relatively easy to remember.  Some symbols are very fast because they
& do not need a SHIFTkey.  In addition,
& using symbols do not interfere with typing English or foreign words.
+
+ For example, suppose syllable macro "k" stands for "ông".
& Because it is a letter, using it can cause undesirable expansion when you really
& want to type a foreign word, say ski.  Fortunately, this version of WinVNKey is very smart.
& If the "Uncombine" option is enabled in the "Viet Option" page, you can keep typing
& and WinVNKey will automatically fix it:
+                    typing sk  ==> getting sông
+                    typing i ==> would expand into sôngi
+ But because sôngi is not a correct Vietnamese word, WinVNKey will undo the macro
& operation (ông ==> k) and you will get ski exactly as intended.
+
+ C3. Single letters:  This table contain letters like b, c, k, q, ... that never follow a Vietnamese consonant 
& For example, if c stands for ươc, you can type bc' to get bước.
+
+ Using a single letter macro makes typing fast but difficult to remember.
& In general, avoid this table if you want to type both Vietnamese and foreign text at
& the same time because foreign words may legally contain these letters after consonants.
& For example, letters c, k, l never follow consonants for Vietnamese words
& but may follow for English words (such as scan, ski, blow, etc)
+
+ C4. Double letters: This table contains letter pairs that never follow a  Vietnamese consonant
& such as bb, cc, dd, mt, nd, ...
& In general you can define a pair of arbitrary consonants
& except "gh" because it can follow "n", e.g. nghiêng.  Therefore, this table can potentially
& contain hundreds of macros.
+
+ But the main challenge is to come up with a way to remember these macros easily
& so that you can use them effectively to speed up typing.
& WinVNKey has predefined a number of letter pairs along with tips to remember.
& For example, if dd stands for "uyên" (tip: both d's are the initials of duyên dáng),
& you can type "tdd" to get "tuyên".
& You can certainly have your own preferences.
& If you do not like the WinVNKey way, just modify to suit your need.
+
+
+ In general, if well defined, these macros are easy to remember and can
& save you many keystrokes if they stand for syllables
& that require typing three or more keys.  In the said example typing dd is faster than uyên not only
& because uyên requires 5 keys but also because repeating the same key is always faster
& than moving your fingers around to type two different letters.
+
+ C5. Punctuations:  This table contains punctuations like period, comma, semicolon, colon, etc
& because they usually do not appear after single-letter words.
& For example, if : stands for uyêt (: looks like two falling snow drops), you can type "ng:" to get "nguyêt".
& In general, this table should be avoided to avoid interference with true punctuation marks.
& However, if knowing in advance your text does not contain single-letter words,
& you can enable this table to speed up typing significantly.
+
+
+ D. How to undo macro expansion?
+ ----------------------------------------------
+
+ Again, if you don't want a macro to expand, just press and release a CTRL key
& or type an escape char
& (the backslash by default) before the last character of the macro names.
+
+ Example:
+        t\: ==> t:
+        t<CTRL>:  ==> t:
+
+ If the macro already expands against your will, you can always undo it by pressing and releasing
& the Right Shift key.  You can press and release it multiple times to toggle back and forth
& between the macro and the expanded text.
+
+ Example:
+     - Type   b!  ==> bươc
+     - Then press and release Right Shift key ==> b!  (undo expansion)
+     - Then press and release Right Shift key again ==> bươc  (undo again -- toggle back)
+
+ The undo feature is described in detail at hyperlink 7 on "Viet Option Page".
+

Help-Shorthand=Shorthand macros are a type of case-sensitive abbreviation of
& one or more words, phrases, or sentences in Vietnamese or any languages.
+
+ A shorthand macro is a group of characters that behave like a word and
& expansion takes place when you type a space or punctuation or symbol immediately
& after the macro name.   The macro name can contain spaces and symbols.
+
+ In order to behave like a word, the macro must be surrounded by spaces,
& tabs, carriage returns, punctuations, or symbols.   In other words,
& the macro name must begin after a space, tab, CR, (, [, {, etc,
& and must be followed by a space, tab, ), ], }, etc. 
+
+ In addition, the characters you typed in must first match
& the macro name in a case sensitive manner.  If you want case-insensitive matching,
& you must use Lazy Word Macros instead.
+
+ Suppose you have a shorthand macro "vn" standing for "Việt Nam".
+
+       Type: Tôi yêu vn rất nhiều ==> Tôi yêu Việt Nam rất nhiều
+
+       Type: Winvnkey ==> Winvnkey
+
+ In the last example, you do not get WinViệt Namkey
& because vn is part of a longer word.  To be expanded, shortcut macros must
& be an independent word, i.e., surrounded by spaces or punctuations or symbols.
+
+
+ How to undo macro expansion?
+
+ If you don't want a macro to expand, just press and release a CTRL key
& or type an escape char
& (the backslash by default) before the last character of the macro names.
+
+ Example:
+        v\n ==> vn
+        v<CTRL>n  ==> vn
+
+ If the macro already expands against your will, you can always undo it by pressing and releasing
& the Right Shift key.  You can press and release it multiple times to toggle back and forth
& between the macro and the expanded text.
+
+ Example:
+     - Type   vn  ==> Viet Nam
+     - Then press and release Right Shift key ==> vn  (undo expansion)
+     - Then press and release Right Shift key again ==> Viet Nam  (undo again -- toggle back)
+
+ The undo feature is described in detail at hyperlink 7 on "Viet Option Page".
+


Help-LazyWords=Lazy word macros are a special type of smart (case-insensitive) abbreviation of
& words.  The words can be in Vietnamese or any languages.
+
+ They are subject to the same
& requirements as shorthand macros, i.e., 
& the macro name must begin after a space, (, [, {, etc,
& and must be followed by a space or a punctuation mark.
& This type of macros is commonly used to abbreviate a group of words.
+
+
& It is recommended that the number of letters in the macro name be equal
& to the number of words in the replacement text so that you can have complete
& control over the letter case of the expanded text.  In this case each letter in the
& macro name is associated with each word in the replacement text.
+
+ Suppose you want to abbreviate the phrase "văn học nghệ thuật".
& There are four words in the phrase.  So you should define a macro
& with at least four characters, say, "vhnt".
+
+       Type: Tôi thích vhnt dân gian ==> Tôi thích văn học nghệ thuật dân gian.
+
+ Lazy word macros are smart in that they know how to change cases automatically based
& on the case of the macro letters you type in AND the state of the CAPS LOCK key.
+
+ To this end WinVNKey identifies the first/second/third/... character in the abbreviation 
& with the first/second/third/... word in the replacement text.  If an abbreviation
& character is upper case, the initial letter of the corresponding replacement word
& will become upper case:
+
+       Tôi thích VhNt dân gian ==> Tôi thích Văn học Nghệ thuật dân gian
+       Tôi thích VHNT dân gian ==> Tôi thích Văn Học Nghệ Thuật dân gian
+
+ However, it is not necessary that the number of letters in the macro name be equal
& to the number of words in the replacement text.  When it is not equal,
& WinVNKey will figure out what letter should be associated with what word in
& the replacement text.  You can define the following macros and try them out:
+
+   Define:
+        "vh nt" = "văn học nghệ thuật"
+        "vhc nt" = "văn học nghệ thuật"
+        "vhc ngt" = "văn học nghệ thuật"
+        "v  nt" = "văn học nghệ thuật"
+        "v  x nt" = "văn học nghệ thuật"
+
+
+ What if you use CAPS LOCK while typing an abbreviation character?
+
+ In this case the corresponding replacement word will have all letters changed to the same case:
+
+       (a) Tôi thích <CAPS LOCK on>VH<CAPS LOCK off>Nt dân gian ==> Tôi thích VĂN HỌC Nghệ thuật dân gian
+
+       (b) Tôi thích <CAPS LOCK on>VhNt<CAPS LOCK off> dân gian ==> Tôi thích VĂN học NGHỆ thuật dân gian
+
+ Note that you had to hold a SHIFT key down while typing the letters 'h' and 't' in example (b).
+
+
+ How to undo macro expansion?
+
+ If you don't want a macro to expand, just press and release a CTRL key
& or type an escape char
& (the backslash by default) before the last character of the macro names.
+
+ Example:
+        v\n ==> vn
+        v<CTRL>n  ==> vn
+
+ If the macro already expands against your will, you can always undo it by pressing and releasing
& the Right Shift key.  You can press and release it multiple times to toggle back and forth
& between the macro and the expanded text.
+
+ Example:
+     - Type   vn  ==> Viet Nam
+     - Then press and release Right Shift key ==> vn  (undo expansion)
+     - Then press and release Right Shift key again ==> Viet Nam  (undo again -- toggle back)
+
+ The undo feature is described in detail at hyperlink 2 on the "Special keys" tabbed page.
+



Help-MacroSyntax=SYNTAX OF MACRO FILE
+ =====================
+
+ The filename must have the ".txt" extension.  The file contents consist of two parts:
+         - The header part, which MUST BE terminated with a special line starting with at least ";xxxx".
+         - The macro definition section, which must follow the header. It begins with a line starting with "[Macro definitions]"
& and continues to the end of the file. This macro section contains macro definitions.
+ 
+ The following are a number of rules for macro files.
+
+ A) HEADER PART
+ ==============
+
+ This part consists of these sections:
+    1) Section named "Notes"
+        This section begins with a line starting with "[Notes]" and ends just before the line starting with "[General]".
& You can write one of more lines of notes in free format in this section.  The text is preserved as is.  If you write your
& notes elsewhere, they will be lost when the file is updated (such as after you add/delete a macro).
+
+    2) Section named "General":
+        This section begins with a line starting with "[General]" and ends just before the line starting with "[For ".
& It is used to store macro properties and settings for WinVNKey to use.  
& You should never edit them by hand unless you know what you do.
& Note that this section can have comment lines, which are either blank or 
& starting with "; " (semicolon in column 1 and a space in column 2).
+
+    3) One or more language sections such as "For English GUI", "For Vietnamese GUI", etc.
+        These sections begin with a line starting with "[For English GUI]", "[For Vietnamese GUI]", etc.
& Basically, they save info about the macro file in different languages
& so that WinVNKey can display it in the language that the GUI is currently in.
& You can change this info using the menu "Set File Info".
& You should never edit them by hand unless you know what you do.
& Note that this section can have comment lines, which are either blank or starting with "; " (semicolon in column 1 and a space in column 2).
+
+ Finally, there MUST BE a special line starting with at least ";xxxx" to indicate that the header is terminated.
+
+ B) MACRO DEFINITION PART
+ =======================
+
+ This part begins with a line starting with "[Macro definitions]" and ends at the end of the file.
& It can be empty or contains definitions of macros, line by line.
+
+ 1) Comment lines are either blank or starting with "; " (semicolon in column 1 and a space in column 2).
& If a comment line begins with "; ", it must not contain " =" (space followed by equal sign) elsewhere on the line.
+
+ 2) Each definition is a line of the following form
+                "macroname =replacement text"
+ starting at column 1 (omit the pair of double quotes; they are for illustration purposes only.)
+
+ 3) SYNTAX OF MACRONAME
+      a) There must be a space between the macroname and the equal sign.
+      b) Everything from column 1 to the character before " =" is the macroname.  However, all the trailing spaces in the name are discarded.
+      c) The macroname can contain any characters, including ";" or space at the start or in the middle of the name
+      d) The macro name can be as long as 255 characters.
+
+ 4) SYNTAX OF REPLACEMENT TEXT
+
+     a) The replacement text, also known as the value of the macro, begins immediately after the equal sign '=' 
& and continues to the end of the line.
+         Example 1: TYTNT =Tôi yêu tiếng nước tôi từ khi mới ra đời.
+
+     b) The replacement can be as long as 4095 characters and can contain carriage returns (i.e. multi-lined replacement text).
+
+     c) If the replacement text line is too long, you can break it into shorter lines where
+               - each line must begin with "& " (an ampersand and a space) in column 1 (except the first line, of course) 
+               - each line can optionally end with "&" (a single ampersand) to signify that it is continued on the next line.
+         When WinVNKey reads back macros with continuation lines, it will do as follows:
+              - removes all trailing spaces from every line
+              - if any line ends with an ampersand "&", remove this ending ampersand (just one)
+              - replaces the pattern "& " at the beginning of each line with a single space.
+              - then joins all the lines together.
+
+         Example 2:
+                TYTNT =Tôi yêu tiếng nước    
+                & tôi từ khi     &  
+                & mới ra đời.      
+          Note that the macro above was written with:
+                    - 4 spaces after "nước" (on the first line)
+                    - 5 spaces between "khi" and "&" on the second line
+                    - 3 trailing spaces after "&" on the second line
+                    - 6 trailing spaces after "đời." on the third line
+         This macro definition is equivalent to:
+                TYTNT =Tôi yêu tiếng nước tôi từ khi      mới ra đời.
+          where there are 6 spaces between "khi" and "mới" and no trailing spaces after "đời.".  
+          Thus, when you type:
+                Tôi muốn hát lên: TYTNT
+          you will see
+                Tôi muốn hát lên: Tôi yêu tiếng nước tôi từ khi       mới ra đời.
+
+     d) If the replacement text contains many lines, you must begin each new line
& with "+ " (a plus sign and a space) at column 1.
+        When WinVNKey reads back, it will do as follows:
+              - removes all trailing spaces from each line
+              - keep (i.e. don't join) all the lines starting with two characters "+ " as is after removing "+ ".
+
+         Example 3:
+               TTCDMX =Trên trời có đám mây xanh
+                + Ở giữa mây trắng 
+                & chung quanh mây vàng
+           Thus, when you type:
+                 Tôi muốn hát lên: TTCDMX
+           you will see
+                 Tôi muốn hát lên: Trên trời có đám mây xanh
+                 Ở giữa mây trắng chung quanh mây vàng
+
+
+ C) QUESTIONS & ANSWERS
+ ========================
+
+    1. What if the replacement text is too long a line?
+        Answer: You can break it into many smaller lines, provided that each of the subsequent
& lines must begin with "& " (ampersand in col 1 and space in col 2)
+
+    2. What if the replacement text has more than one line (ie., contains carriage returns)?
+        Answer: You must put each line, starting from the second line, on a separate line
& after "+ " (plus sign in col 1 and space in col 2)
+
+    3. If my macro name begins with "& " or "+ ", how can it be written
& so that it will not be understood as a continuation line?
+        Answer: Add a blank line immediately before the line defining your macro.
+
+   4. Can I define a macro name beginning with "; " (i.e., a semicolon and a space)?
+        Answer: Yes, you can.  Just write it in column 1 as any other macro because
& the line beginning with "; " is not a comment in the macro section.
+
+   5. How can I distinguish a comment and a macro name beginning with "; " ?
+       Answer:  WinVNKey processes each and every line in the macro section
& even if it begins with "; " in order to find out if it contains an equal sign.
& If it does, it is a macro definition.  If it does not, it is an error and the line
& will be discarded.  
& Therefore, your comment line should not contain " =" at all.
& But if you need to have " =" in the comment line, place it at the end of the line
& and make sure the next line does not begin with "+ " or "& ".
+       Example:
+       Column 1
+        |
+        vn =Việt Nam
+        ; This is a multi-line comment.  You can define a macro using the equal sign =
+        ; as a separator.  To the left of the separator is the name of the macro. To the
+        ; right of the separator is the replacement text.
+
+   6. Does WinVNKey remove trailing spaces on every line?
+      Answer:  In general, no.  WinVNKey removes trailing spaces
& ONLY when the macro definition is spread on to more than one line.
& If the macro definition is contained within one line, WinVNKey
& does not remove trailing spaces at the end of the line.
+
+   7. I want to remove all trailing spaces in my macro file. Is there any way to do this?
+       Answer: Yes.  Use the menu from the edit-macro dialog.
& Alternatively, you can right click inside the checklist box (the left box)
& on the macro tabbed page and use the menu from there.
+
+

; 1) Keyword ". HasComment" -- used to handle user interface
;
; This keyword means there is a column to display
;    comments for macros.  In this case the macro definition will have the format:
;        "macroname =replacement text;|| comment"
;    Note there must be a space between the column delimiter ";||" and the comment.
;    A formatting string of the form ";{;[m.n]}" may appear immediately before
;    the column delimiter to tell whether the column has a checkbox or not:
;         m=0 means no checkbox
;         m=1 means displaying a checkbox
;         n=0 means the checkbox is empty
;         n=1 means the checkbox has a checkmark
;         n=2 means the checkbox is invisible, i.e., leave room for a checkbox
;             but do not display it --  text is left aligned with text in other rows)
;
; 2) Keyword ". Programming.level" -- used to handle smart transformation.
;     WinVNKey version 5.3.414 and later understands ". Programming.level : 1",
;     which supports using recently typed words in the replacement text.
;     These words are written symbolically as {w1}, {w2}, etc in the replacement text:
;         - {w1} represents word #1 (the first word to the left of the current word)
;         - {w2} represents word #2 (the second word to the left of the current word)
;
;     For example, if you define a macro like this:
;            add2num =To add {w1} and {w2}, write {w1} + {w2}
;     Then when you type
;            12 15   add2num
;     you will see
;            12  15  To add 12 and 15, write 12 + 15
;
;============

[Shorthand Macros]
A0=Shorthand macros
A1=Select Files
A2=List all checked files
A3=Edit File
A4=Note: Macros in red color are unavailable in the current charset
A5=Note: All macros on this page are case-smart; they can adjust upper/lower case automatically.
A6=Note: All macros on this page are case-sensitive; they must be typed in exactly as is.
A7=Note: Some files (e.g. Hiragana, Katakana) are case-insensitive; others are not.
A8=Macro Page:


[Page ModeCommands]
C1=Keyboard Commands to switch mode
C2=To Vietnamese mode
C3=To Mainly English mode
C4=To Literal mode
C5=To Sleep mode
C6=To wake up from Sleep
C7=Clear All
C8=Default

T1=Undefined Wakeup String!

W1=Wakeup string cannot be empty when you enable the sleep mode command!
+
+
+ Wakeup string is used to wake WinVNKey up from sleep mode
+ and return it to the mode before sleep.
+
+ Reset to default string: XX
+


[Page ChangeNum2Char]
C1=Change Number To Character
C2=Every character has an encoding value.
& For instance, the encoding value of N is 78 in decimal,
& or 4E in hex notation, or 116 in octal notation, or 01001110 in binary.

C3=Replace encoding value with its char representation
C4=For decimal sequence like
C5=For hex sequence like
C6=For octal sequence like
C7=For binary sequence like


P1=Postfix Command
P2=The pattern must be followed by
P3=Example: Type %s and get %c

D1=Default 0n,0h
D2=Default U+

[Page ChangeChar2Num]
C1=Change Char to Number
C2=Example: Typing N%s and get %s
C3=Replace a char with its encoding value formatted like
C4=Replacement occurs
C5=for each visible char that is followed by
C6=automatically for the following chars
A1=All chars greater than 255
A2=All chars greater than 127
A3=All graphic chars not in Windows 1252 font
A4=All chars not displayable in Windows 1252 font
A5=All ASCII alphanumeric chars
A6=All ASCII punctuations and symbols
A7=All ASCII control chars except CR, LF, tabs


D1=Default &&#xBF;
D2=Default U+000F

[Page LongMacros]
AutoExp1=AutoExpand Level 1: can be typed anywhere
AutoExp2=AutoExpand Level 2: can be typed anywhere
Tail=Tail: must be typed after another character (case sensitive)
Syllable=Lazy Syllables: typed after starting Viet consonants (case smart)
Shorthand=Shorthands: typed at start of a word (case sensitive)
LazyWord=Lazy Words: typed at start of a word (case smart)

Tail1=1. Must type macro after letters
Tail2=2. Must type macro typed after digits
Tail3=3. Must type macro after punctuation marks
Tail4=4. Must type macro after other symbols
Tail5=5. Can type macro after a comma prefix command (comma will be discarded)
Tail6=6. Can type macro at start of a word
Tail7=7. Macro is case-smart (knows how to change letter case automatically)

Syl1=1. Must type macro after Viet consonant initials
Syl2=2. Must type macro after a letter
Syl3=3. Can type macro after a comma prefix command (comma will be discarded)
Syl4=4. Can type macro at start of a word
Syl5=5. Expand macro only if it could result in a Vietnamese word
Syl6=6. Can add tonemark to macros in column 1 that have vowels

SH1=1. Can type macro in column 1 in any letter case (upper/lower/mixed)
SH2=2. Enable programming (macro with arguments)

[Page ShortMacros]
AutoExp1=Auto1
AutoExp2=Auto2
Tail=Tail
Syllable=Lazy Syllable
Shorthand=Shorthand
LazyWord=Lazy Word

Tail1=After letters
Tail2=After digits
Tail3=After punctuation marks
Tail4=After other symbols
Tail5=After comma prefix command
Tail6=At start of word
Tail7=Case-smart

Syl1=After Viet initials
Syl2=After letters
Syl3=After comma prefix command
Syl4=At start of word
Syl5=Expand if forming Viet word
Syl6=Can add tonemark to macro

SH1=Case insensitive
SH2=Enable programming

[Help MacroPage]
Language=Help on Language Macros
Remap Macro=Help on Remap Macros
AutoExp1=Help on AutoExpand 1 Macros
AutoExp2=Help on AutoExpand 2 Macros
Tail=Help on Tail Macros
Syllable=Help on Lazy Syllable Macros
Shorthand=Help on Shorthand Macros
LazyWord=Help on Lazy Word Macros


A1=Remove Trailing Spaces on All Lines
A2=Remove trailing spaces on every line in the following file:
A3=Remove trailing spaces on every line in all macro files in directory:

B1=File "%s": %d lines trimmed
B2=File "%s": no lines ended with spaces
B3=Error opening file "%s"
B4=Error opening temporary file "%s"

C1=Delete Macro File
C2=File to delete:
C3=Are you sure you want to delete it?

D1=Duplicate macro file
D2=Enter new macro filename:
D3=New filename is empty. Please enter again.

[Edit Macro]
Language=Edit Language Macros
Remap Macro=Edit Remap Macros
AutoExp1=Edit AutoExpand 1 Macros
AutoExp2=Edit AutoExpand 2 Macros
Tail=Edit Tail Macros
Syllable=Edit Lazy Syllable Macros
Shorthand=Edit Shorthand Macros
LazyWord=Edit Lazy Word Macros

A1=A. Expands immediately after typing the last macro character
A2=B. Expands only when typing a delimiter (space or punctuation mark) after macro
A3=C. Expands only when typing a punctuation mark after macro
A4=D. Expands only after typing a space command char after macro (space will disappear)
A5=E. Expands only after typing a tab command char after macro (tab will disappear)

E1=Edit Macro
E2=File
E5=Edit
E6=Undo
E7=Add
E8=Remove
E9=Clear All
E10=Typing macros in charset
E11=Enter
E12=Don't combine characters when typing macro names in column 1

; File button
M0=New
M2=Save
M3=Save As

M5=Delete

M7=Set List Box Font
M8=Set Edit Box Font
M9=Run Character Map
M10=Unicode Typepad

M12=Properties
M13=File Info

M14=Exit
M15=Expand type
M16=Properties


Help-MacroHelp=All the macro files in this category are located in the following directory:
+
+       $
+
+ They are plain text in 16-bit Unicode chars.
& You can edit them manually with a Unicode editor such as
& Notepad or Wordpad in Win 2000, Win XP, or Office 2000
& or later.  The syntax is explained in each macro file.
& All macro files have extension .TXT or .txt.  The upper case
& .TXT means the file is enabled, lower case .txt means disabled.
+
+ In general, all changes you make to this macro file (options, comboboxes, 
& add/delete/edit macros, etc) will not be effective until you 
& activate the menu File | Save, or close the dialog.
& But if the folder where this file is located contains a big enabled macro file, 
& the changes are still not effective until you close the parent dialog as well.
& The parent dialog is the one entitled "Select Macro".
+
+ NOTE
+
+ You can right click in any edit box or list box to see many menu options.
& For edit boxes: you can type text directly or pick up characters from a Unicode table.
& To display the Unicode table, right click inside the edit box, then select
& the menu "Choose a Unicode Character."  When the table appears, left click
& on the character you want.  That character will be copied to the edit
& box automatically and the table will disappear.  This method offers a convenient way to
& enter characters that are not available from the keyboard.
+
Help-ExpandType="Expand type" specifies when to expand a macro.
& WinVNKey currently supports the following expand types:
+
+ A. Expands immediately after typing the last macro character
+     Assuming that all other conditions are met, the macro will expand immediately
& as soon as you type the last macro character.
+
+ B. Expands only when typing a word ending delimiter after macro
+     Assuming that all other conditions are met, the macro will expand immediately
& as soon as you type a word ending delimiter after the last macro character.
& A word ending delimiter is usually a space, a tab, a punctuation mark, or
& certain symbols like +, =, %, etc.
+     In general, you should choose this type when you want to correct word spelling
& for single words or multiple words.
& The main reason is that WinVNKey cannot correct word spelling unless it knows
& the typing of a word is completed.
+
+ C. Expands only when typing a punctuation mark after macro
+     Assuming that all other conditions are met, the macro will expand immediately
& as soon as you type an additional punctuation mark after the last macro character.
+
+ D. Expands only after typing a space command char after macro (space will disappear)
+     Assuming that all other conditions are met, the macro will expand immediately
& as soon as you type a space after the last macro character.  This space acts as a command
& to tell WinVNKey to expand the macro.  If the expansion is successful, the space itself
& is discarded.
+
+ E. Expands only after typing a tab command char after macro (tab will disappear)
+     Assuming that all other conditions are met, the macro will expand immediately
& as soon as you type a TAB key after the last macro character.  This TAB acts as a command
& to tell WinVNKey to expand the macro.  If the expansion is successful, the TAB itself
& is discarded.
+
+ Note:  If you click the Default button, both the expand type and properties comboboxes
& will be reset to appropriate default values for each macro page.
+
+

Help-Properties.Arrow=The arrow button to the right of "Properties"
& sometimes does not respond to your single mouse click.
& In this case you have to double click quickly on it and the dropdown menu will appear.
+
+

Help-Properties.Tail=The properties combobox specifies all conditions under which
& a tail macro will expand.
+
+ 1. Can type macro after letters
+     The first character of the macro must be typed after another letter.
+     Example: Suppose you define a tail macro as follows:
+                   atn =ation
+        - Typing: formatn => formation   (expanded because macro atn was typed after letter 'm')
+        - Typing: 8atn => 8atn  (not expanded because atn was typed after a digit)
+
+ 2. Can type macro after digits
+     The first character of the macro must be typed after a digit.
+     Example: Suppose you define a tail macro as follows:
+                ts = thousand     (consisting of a space followed by "thousand")
+        - Typing: 8ts  => 8 thousand  (expanded because ts was typed after a digit)
+        - Typing: fivets => fivets  (not expanded because ts was typed after a letter)
+
+ 3. Can type macro after punctuation marks
+     The first character of the macro must be typed after a punctuation mark.
+     Example: Suppose you define a tail macro as follows:
+                wyc =www.yahoo.com
+        - Typing: http://wyc => http://www.yahoo.com  (because wyc was typed after /, which is a word delimiter)
+
+ 4. Can type macro after other symbols
+     The first character of the macro must be typed after other symbols such as $ & % ...
& Symbols are characters that are not letters or digits: & !@#$%^&*()-_+={}[]:"'<>,/ ' ` ? ~ .
+     Example: Suppose you define a tail macro as follows:
+                   yh =yahoo.com
+        - Typing: hoc96@yh  => hoc96@yahoo.com (expanded because it was typed after @)
+        - Typing: mail.yh => mail.yahoo.com (expanded because it was typed after a period)
+
+ 5. Can type macro after a comma prefix command (comma will be discarded)
+     If you enable this option, you can use tail macros to type stand-alone words
+     Example: Typing:  go to ,yh => go to yahoo.com
+
+ 6. Can type macro at start of a word
+     If you enable this option, you can use tail macros to type stand-alone words.
+     Example: Typing:  go to yh => go to yahoo.com
+ 
+ 7. Macro is case-smart (knows how to expand into correct letter cases automatically)
+     Case smart means that you can define a macro in lower case and when you
& use it, the replacement text will change into upper or lower case automatically
& depending on the letter case of each macro character you typed in.
+     Example: Suppose you define a tail macro as follows:
+                  tn =tion
+        - Typing: natn => nation
+        - Typing: NATN => NATION
+        - Typing: naTN => naTION
+     You can turn on Caps Lock to force all subsequent letters of the macro
& to be expanded in upper case.  For example:
+                  gts = go to school
+ (note there is a leading space before "go").  Then
+        - Typing: Igts => I go to school
+        - Typing: IGTS => I Go To School
+        - Typing: IG<Caps Lock>TS => I Go TO SCHOOL
+

Help-Properties.LazySyllable=The properties combobox specifies all cases
& where a lazy syllable macro can be typed and be expanded.
+
+ - Lazy Syllables are a special type of tail macros specifically designed to
& support the Vietnamese language.  They are called "lazy" because the
& intention is to help lazy users type Vietnamese text quickly.
& However, you can define lazy syllables macros in other languages as well.
+
+ - The most desired attribute of Lazy Syllable macros is case-smart feature,
& which allows a macro to be defined in lower case and
& allows the replacement text to change its letter case automatically depending
& on how users enter the case of each character of the macro.
& In other words, when you define a lazy syllable macro, define it in lower case.
& When you use the macro, you should type in
+       - lower case if you want the replacement text to be in lower case
+       - upper case if you want the replacement text to be in upper case
+       - upper case for the only first letter if you want only the first letter
& of the replacement text to be in upper case
+
+ - The Vietnamese language has 27 consonant initials that appear at the beginning of a word:
+                 b c ch d đ g gh gi h k kh l m n ng ngh nh p ph qu r s t th tr v x
+
+ In general, if you append a Vietnamese syllable to any of the 27 consonant initials, the
& result will be a Vietnamese word.  Thus, if you have a macro that stands for a Vietnamese
& syllable, you want it to expand if and only if it is typed after one of the 27 consonant initials above.
& Lazy syllables are designed to meet this need.
+
+ In all the following examples we assume you have a lazy syllable macro defined as follows:
+          bb =ong
+ You can choose the following options to control when to expand bb into ong:
+
+ 1. Can type macro after Viet consonant initials
+     This means the macro will expand if and only if you type it after one of the 27 consonant initials
& listed above.  For example,
+            - Typing: cbb => cong
+            - Typing: bb   => bb  (not expanded because not typed after any consonant intials)
+
+ 2. Can type macro after a letter
+     If option #5 is disabled:  Macro always expands regardless of whether or not the result is a Vietnamese word.
+     Example:   Typing: abb => aong.
+     If option #5 is enabled:  Macro expands if and only if the result is potentially forming a Vietnamese word.
+     Example:   Typing: abb => abb (not expanded because the result is not Vietnamese).
+    
+ 3. Can type macro after a comma prefix command (comma will be discarded)
+     If you enable this option, you can use lazy syllablle macros to type stand-alone syllables, i.e.,
& Vietnamese words that begin with vowels.
+     Example: Typing:  con ,bb => con ong.
+
+ 4. Can type macro at start of a word
+     If you enable this option, you can use lazy syllablle macros to type stand-alone syllables, i.e.,
& Vietnamese words that begin with vowels.
+     Example: Typing:  con bb => con ong.
+
+ 5. Expand macro only if it could result in a Vietnamese word
+     This option has been discussed above in connection with option #2.
+     Thí dụ: gõ crbb   => crbb  (does not expand into crong because it is not a Vietnamese word)
+
+ 6. Can add tonemark to macro in column 1
+     This option applies only to all those macros that contain vowels
+     Suppose you have defined a lazy syllable macro
+               il =uyên
+     Normally, if you type íl, it will not expand into uyến because we have not defined any macro íl.
& But if you enable this option, you can define a macro with no tonemarks and when you use it,
& you can add tonemark to the vowel(s) in the macro name and WinVNKey will automatically
& add the tonemark to the resulting replacement text.  In the said example,
+            - Typing: íl => uyến
+            - Typing: ìl => uyền
+            - Typing: ỉl => uyển
+            - etc.
+
+ Finally, note that Options (1) and (2) are mutually exclusive, so are (3) and (4).  If
& you choose one option, WinVNKey will automatically deselect the other.
+

Help-Properties.Shorthand=A) SUMMARY
+
+ The properties combobox specifies additional properties of all shorthand macro
& in an individual file.
& WinVNKey currently supports the following properties for shorthand macros:
+
+ 1. Can type macro in column 1 in any letter case (upper/lower/mixed)
+     That is, if you define "vn" in column 1 and "VIETNAM" in column 2, then it does not
& matter if you type vn, or VN, or Vn, or vN, all of them will expand into VIETNAM.
+
+ 2. Enable programming (macro with arguments)
+     When this option is selected, all occurrences of the form "{w1}",
& "{w2}", etc, in the replacement text are not normal text but have special meaning.
& They are known as the arguments to the macro:
+    - {w1} means word #1 to the left of the current word
+    - {w2} means word #2 to the left of the current word
+    - etc
+
+ When the macro expands, {w1} will be replaced with word #1, {w2} with word #2, etc.
+
+
+ B) DETAILS ON PROPERTY #1: CHARACTER CASE
+
+ 1.  Box is unchecked
+ ================
+ The macro name is case sensitive,
& i.e., you must type the name exactly as is.
+
+ Example 1: Suppose you have defined the macro "vh" to be expanded into "văn học".
+      - Type:  vh ==> văn học
+      - Type:  Vh ==> Vh   (no match, hence no expansion)
+
+ 2.  Box is checked
+ ===============
+ The macro name is generally case insensitive.  You can type in upper/lower/mixed case and the
& result is still the same, unless the file already contains a different definition for the conflicting form of the macro.
& If what you typed matches exactly ( i.e. in a case-sensitive manner) 
& with a particular form of the macro defined in the file, the definition of that form will be used.  
& Otherwise, if the match is case-insensitive, the definition of the macro where all alphabetic characters are in
& lower case will be used.
+
+ Example 2: Suppose you have defined the macro "vn" to be expanded into "Việt Nam".
+      - Type:  vn ==> Việt Nam
+      - Type:  Vn ==> Việt Nam
+      - Type:  vN ==> Việt Nam
+      - Type:  VN ==> Việt Nam
+
+ Example 3: Suppose you have defined two macros:
+         (a) "dh" => "Đại học"
+         (b) "Dh" => "Đồng Hới"
+ then
+      - Type:  dh ==> Đại học
+      - Type:  dH ==> Đại học
+      - Type:  Dh ==> Đồng Hới      (Note: Because it matches macro (b) exactly, it is used instead of macro (a))
+      - Type:  DH ==> Đại học
+
+ At this point you may think it is ambiguous as to whether the macro "Dh" or "dh" should be allowed to be typed in any case unless there is a conflict.  In
& other words.  In other words, should we also allow the following:
+      - Type:  dh ==> Đại học
+      - Type:  dH ==> Đồng Hới
+      - Type:  Dh ==> Đồng Hới
+      - Type:  DH ==> Đồng Hới
+
+ The answer is that there is no ambiguity. WinVNKey stipulates that only macros defined
& in lower case can be typed in any case (upper/lower/mixed case) and that whenever
& there is a conflict, the definition of the conflicting macro will be used.
+
+ Thus according to this rule, only the macro "dh" is allowed to be typed in arbitrary letter case unless
& there is a conflict.
+
+
+ C) DETAILS ON PROGRAMMING SUPPORT
+
+ Programming support means to allow recently typed words or characters
& to be re-used in the replacement text.  Starting with version 5.3.414, WinVNKey
& offers some limited programming support for
& advanced users.  
+
+ If the current word is the macro name, then all recently typed words are numbered as follows:
+        word 1 is the first word to the left of the macro and is denoted as {w1}
+        word 2 is the second word to the left of the macro and is denoted as {w2}
+        word 3 is the third word to the left of the macro and is denoted as {w3}
+        etc
+
& When programming support is enabled, all the tokens {w1}, {w2}, etc that appear in the
& replacement text are interpreted as commands to insert words numbered 1, 2, etc.
+
+ For example, if you define a macro like this:
+           add2num =To add {w1} and {w2}, write {w1} + {w2}
+ Then when you type 
+            12 15   add2num
+ you will see
+            12  15  To add 12 and 15, write 12 + 15
+
+ In order to accomplish this, WinVNKey has to parse the text to the left of the macro name to
& identify words.  For parsing purposes each character is classified as real or not.
& All non-real characters will be replaced with spaces.  The resulting string
& will then consist of groups of real characters.  Each group is called word.  All
& words are numbered from right to left, with the word closest to the
& macro being number 1.
+
+ Thus depending on the definition of real charaters the parsing of the text
& to the left of the macro may give rise to a different number of words and
& the contents of each word.
+
+ Example:   Suppose you type:
+                  abc.def_xyz  ppp
+ If ppp is the macro name, then:
+    - word 1 is xyz, word 2 = def, word 3 = abc if the period and the underscore are considered false characters.
+    - word 1 is def_xyz, word 2 abc if only the period is considered false.
+
+
+ WinVNKey currently understands the following special tokens:
+
+ 1.  {w1}, {w2}, {w3}, etc
+      Real text: all alphabetic characters, all digits, underscore
+
+ 2.  {s1}, {s2}, {s3}, etc
+      Real text: all visible graphic characters
+
+ 3.  {a1}, {a2}, {a3}, etc
+      Real text: all alphabetic characters
+
+ 4.  {b1}, {b2}, {b3}, etc
+      Real text: all alphabetic characters, all digits
+
+ 5.  {c1}, {c2}, {c3}, etc
+      Real text: all alphabetic characters, all digits, period, underscore
+
+ 6.  {d1}, {d2}, {d3}, etc
+      Real text: all digits
+
+ 7.  {e1}, {e2}, {e3}, etc
+      Real text: all digits, period
+


Help-Option-CaseInsensitive=The checkbox affects all macros within the file.
+
+ 1.  Box is unchecked
+ ================
+ The macro name is case sensitive,
& i.e., you must type the name exactly as is.
+
+ Example 1: Suppose you have defined the macro "vh" to be expanded into "văn học".
+      - Type:  vh ==> văn học
+      - Type:  Vh ==> Vh   (no match, hence no expansion)
+
+ 2.  Box is checked
+ ===============
+ The macro name is generally case insensitive.  You can type in upper/lower/mixed case and the
& result is still the same, unless the file already contains a different definition for the conflicting form of the macro.
& If what you typed matches exactly ( i.e. in a case-sensitive manner) 
& with a particular form of the macro defined in the file, the definition of that form will be used.  
& Otherwise, if the match is case-insensitive, the definition of the macro where all alphabetic characters are in
& lower case will be used.
+
+ Example 2: Suppose you have defined the macro "vn" to be expanded into "Việt Nam".
+      - Type:  vn ==> Việt Nam
+      - Type:  Vn ==> Việt Nam
+      - Type:  vN ==> Việt Nam
+      - Type:  VN ==> Việt Nam
+
+ Example 3: Suppose you have defined two macros:
+         (a) "dh" => "Đại học"
+         (b) "Dh" => "Đồng Hới"
+ then
+      - Type:  dh ==> Đại học
+      - Type:  dH ==> Đại học
+      - Type:  Dh ==> Đồng Hới      (Note: Because it matches macro (b) exactly, it is used instead of macro (a))
+      - Type:  DH ==> Đại học
+
+ At this point you may think it is ambiguous as to whether the macro "Dh" or "dh" should be allowed to be typed in any case unless there is a conflict.  In
& other words.  In other words, should we also allow the following:
+      - Type:  dh ==> Đại học
+      - Type:  dH ==> Đồng Hới
+      - Type:  Dh ==> Đồng Hới
+      - Type:  DH ==> Đồng Hới
+
+ The answer is that there is no ambiguity. WinVNKey stipulates that only macros defined
& in lower case can be typed in any case (upper/lower/mixed case) and that whenever
& there is a conflict, the definition of the conflicting macro will be used.
+
+ Thus according to this rule, only the macro "dh" is allowed to be typed in arbitrary letter case unless
& there is a conflict.
+


Help-Option-ShortHand=The checkbox affects all macros within the file.
+
+ 1.  Box is unchecked
+ ================
+ The macro must match like a complete word,
& i.e., you must have spaces or tabs
& or punctuations or symbols surrounding the macro.
+
+ 2.  Box is checked
+ ===============
+ The macro must match at the start of a word only.  You do not need to
& type an additional tab or space or punctuation or symbol immediately after the macro.
+
+ Example:  Suppose you have defined the macro "bt" to be expanded into "biết".
+
+ If the box is unchecked, then typing (don't type surrounding angle brackets):
+       - <Tôi bt>  => <Tôi bt>      (need to be followed by a delimiter)
+       - <Tôi bt.>  => Tôi biết.>   (bt is preceded by a space and followed by a period)
+       - <Tôi bt >  => Tôi biết >   (bt is preceded by a space and followed by a space)
+
+ If the box is checked, then typing (don't type surrounding angle brackets):
+       - <Tôi bt>  => <Tôi biết>      (bt follows a space and does not need to be followed by a delimiter)
+ In other words, the only requirement is that the macro must match at the beginning of
& a word, and expansion will take place as soon as you type the last character of the macro.
+
+ 3. When to check the box?
+ ====================
+
+ It is recommended that you check the checkbox for macros that define single words without any accent mark.
& Because the macro expands automatically when you type the last character of the macro, the cursor
& will be positioned right after the expanded word.  You
& can then type an accent mark for the expanded word.
+
+ Example:   Suppose "lg" means "long".  Then you can type (if using VIQR typing method):
+          lg' => lóng,   lg` => tòng,  lg. => lọng, lg? = lỏng, lg^ => lông, etc
+
+ Thus by checking the checkbox, you don't have to define too many similar 
& macros like lg', lg`, lg., lg?, lg^, etc,
& all of which differ in the additional accent marks.
& It is always hard to remember too many macros.  In addition, if you
& define macros with accent marks, you have to change them when switching
& to another typing method.  Thus the checkbox solves all these problems for you.
+



[Font Info]
A1=List box is used to list all macros in a file.
& These macros are in Unicode characters.
& You must choose a Unicode font for the macros to display correctly.
& If your system does not have any Unicode font, you can download from:
+          http://sf.net/project/vietunicode
+          http://zencomp.com/greatwisdom/fonts
+          http://www.daouyen.com/download/ARIALUNI.zip
+
+ If you use many languages at the same time, you should consider
& Arial Unicode MS font, downloadable from www.daouyen.com.
& This font is very large (13,687 Kb, compressed).
& It consists of about 52,000 characters, including classic Vietnamese Nôm,
& Chinese, Japanese, Korean, Pali-Sanskrit, etc.  See details in WinVNKey help file.

B1=For edit boxes that accept text you type in, you should choose a font
& designed for the character set that is currently in use.
+ Recommendation:
+     VISCII:  Sans Serif VISCII 1.1
+     VPS Windows:  Sans Serif VNCII 1.0
+     VNI Windows:  VNI-Aptima, VNI-Times
+     TCVN ABC:  VnArial
+     Windows 1252:  MS Sans Serif
+     UTF-8:  Any ASCII font is ok because all accented characters are not readable anyway.
+
+ Note: Independent of the font you choose for edit boxes, the characters
& should show up correctly in the macro list box.  If they show incorrectly,
& then something is wrong:
+    - either you have typed incorrectly, or
+    - the list box font is not Unicode font, or
+    - the Unicode font for list box does not have your characters.

C1=Don't display again
See explanation for Microsoft typing method=

[File Info]
A1=File name:
A2=Name is empty!  Try again.
A3=When the GUI is displayed in
A4=Enter name to display (if different from filename):
A5=Enter file information (type CTRL-Enter to begin a new line)
A6=Website address for help on this file (if any)
A7=Note on filename

B1=Display name:
B2=Directory:
B3=Information:


@A7=Do you want to save changes for the XXX interface?
@A8=File "XXX" already exists.
+ Do you want to overwrite it?
@A9=Failed to overwrite file "XXX".
+ Please specify a different filename.
@A10=Failed to rename file to "XXX".
+ Please try again (perhaps keep old name).

@A11=Filename is empty!
+ You must enter at least a filename before changing
+ to another language. Please try again.

@A12=Failed to save file to "XXX".
+ Please try again!.

@A13=New filename is the same as old filename.
+ Do you want to save it anyway?

@A14=You have to change the display name for the interface in "XXX".
+ Please change the second combobox to the "XXX" to continue.

@A15=You have to change the display name to something different.
+ Otherwise, the old and new files are indistinguishable in the macro list
+ new because both files will be displayed under the same (display) name.


@A1=You are currently working in macro directory:
@A2=You are currently working with the macro file:

@B1=
+ ; ---------------------------------------------------------------------------------------------------------------------
+ ; Depending on the GUI language WinVNKey will choose the appropriate
+ ; info below to display when users click on menu "Get File Info" or "Set File Info".
+ ;
+ ; Tùy theo ngôn ngữ giao diện mà WinVNKey sẽ hiển thị các thông tin thích hợp
+ ; dưới đây khi người dùng chọn menu "Xem thông tin về tệp" hoặc "Thay đổi thông tin về tệp".
+ ; ---------------------------------------------------------------------------------------------------------------------
+

@B2=Please choose a language, say English or Vietnamese.
& Then fill in the text boxes in the said language.
& You can leave a text box blank if you want.
& The purpose is for WinVNKey to display the text for the
& name, info, and website address in the same language as the one the GUI is currently is.
+
+ For completeness, you have to fill in the data for every language supported by WinVNKey.
& Once you're done with a language, you have to click on the OK button to save.
+
+ If you do not fill in a text box in a certain language, WinVNKey will use the 
& English text instead, if any.
+

@B3=DISPLAY NAME
+
+ What is a display name?  Why do we need it?
+
+ Answer: Suppose you have a file named "Dictionary.txt" but want to display as follows:
+       - display name "Dictionary" when the GUI is English
+       - display name "Tự điển" when the GUI is Vietnamese
+       - display name "словарь" when the GUI is Russian
+
+ To this end a file must be associated with multiple names:
+       - the name of the file on disk, or filename
+       - the name displayed in the GUI for each language, or display name.
+
+ In general, you SHOULD always name files in English characters
& and not in your own language (Vietnamese, Chinese, Russian, etc).
& The main reason is for portability across media or platforms: 
& the filenames will not be converted to other weird characters when transported 
& across the Internet or to different operating systems.
+
+ A file can have more than one display name depending on the GUI languages.
& To find out how many languages currently supported by WinVNKey, you can
& simply open the "display" folder under the Install directory (Click Run | Open folder |
& WinVNKey Install Folder | display) and count all the files with ".ini" extension.
& The basename of the file is the name of the language.
+
+ Currently the "display" folder contains two ".ini" files:
+           - English.ini
+           - Vietnamese.ini
+ Thus, WinVNKey currently supports two languages: English and Vietnamese.
+
+ More on the display name
+ ====================
+
+ If you want WinVNKey user interface in, say, Russian, you must translate file
& "English.ini" into Russian and name the file after the language, namely, "Russian.ini".
& The master file "English.ini" consists of many lines of the form:
+
+ key=value
+
+ All you need to do is translate the "value" part, which is to the right
& side of the equal sign and can continue on subsequent lines, provided
& that these lines start with "& " or "+ ".  A line starting with "& " is
& basically joined to the preceding line.  A line starting with "+ " is
& basically a new line, i.e., it will be displayed after a carriage return.
+
+ For now, you can just make a copy of "English.ini" and name it "Russian.ini".
& Because the "display" folder contains 3 ".ini" files, WinVNKey will support 3 languages
& alphabetically sorted as follows:
+      - English
+      - Russian
+      - Vietnamese
+
+ Note that if you choose Russian (Click on Run | Preferences | Appearance | Russian),
& the GUI still displays in English  because you have not done the translation yet.
& However, from the "Set File Info" menu of any file, you can do as follows:
+       - choose language: Russian
+       - choose display name of file "Dictionary.txt" to be: словарь
+

@B4=File Information
+
+ This text box contains information or help on the file that you want users to see.
& You should fill it up in the chosen language.
& If you need to enter a new line, you have to press two keys CTRL-Enter at the same time.
+

@B5=Website address
+
+ If you have a paper describing about this file on the Internet,
& you can fill up this text box with the URL of the paper.
& This address should begin with the string "http://"
+
+ If you have two papers, one in English and one in Vietnamese, you can fill
& up the box with the address of the paper for the language specifically
& chosen in the combobox.
+

@B7=NOTE ON FILENAME
+
+ A filename can contain a string of the form "@[xxx]" before the file extension.
& If it does, it belongs to a group named "xxx".  The name of the group, xxx,
& can be any string of characters as long as it does not render the filename illegal.
+
+ It is a rule of WinVNKey that users can select at most one file in the same group.
& If you choose one file, all the other files in the group will be de-selected.
+
+ Suppose you have two or more files that serve the same purpose
& but you want users to select only one file at a time.  In this case you
& should append a string of the form "@[xxx]" to the basename of each file
& in the group.
+
+ Example:  The following three files belong to the group named "2007":
+     - Typing-Russian (method 1)@[2007].txt
+     - Typing-Russian (method 2)@[2007].txt
+     - Typing-Russian (method 3)@[2007].txt
+
+ The following two files belong to the group named "hoc":
+     - Typing-Pali (method 1)@[hoc].txt
+     - Typing-Pali (method 2)@[hoc].txt
+


[Warning Messages]
A1=This WinVNKey.exe is incompatible with msghook.dll.! 
A2=Internal structures mismatch. 
A3=Please use all files from the same package.

B1=Please quit WinVNKey, then restart it to allocate enough memory for macros.
+ If you don't quit, newly defined macros will not work.


C1=WinVNKey has already been running!  Abort this run!


[Macro Warning]
A1=You can't type Unicode chars directly into edit boxes with this version of WinVNKey.
& Only WinVNKey version for NT, Win2000, and XP will allow Unicode typing.
+
+ Please go back to the main WinVNKey panel and choose a different charset.
+    - If your macros are Vietnamese only, select VISCII because it has all Viet chars.
+    - If your macros are Windows 1252 chars only, select Windows 1252.
+    - If you really want Unicode chars, you can select UTF-8 or Unicode in
& hex or decimal formats.  The chars may look strange when
& you type but are converted correctly for later use.
+    - If you don't like the strange look of UTF-8 or NCR chars AND if
& all of your multilingual macros consist of Latin-based chars only,
& choosing the VNI Windows charset may display them correctly.
+
+ Regardless of what charset you choose, all the macros you type into edit boxes
& will be converted to Unicode internally and will be displayed correctly in the
& summary list box.
+
+ If you don't choose another charset, WinVNKey will switch to UTF-8 temporarily
& while you are editing macros.  The original charset will be restored to Unicode
& when you are done with macros.
+


B0=Try again.
B1=Macro name can't be blank!
B2=Macro name has spaces!
B3=Are you sure you want ỉt?
B4=Macro expansion can't be empty!
B5=Macro filename was already defined!  
B6=Do you want to save anyway?
B7=Name and replacement can have one and only one char!

C1=Macro file has not been saved!
C2=Do you want to save it?
C2=Bạn có muốn lưu trữ không?

D1=Details in macro file
D2=Ignored macro %s -- it is already defined.
D3=Ignored macro %s -- conflicting with existing macro %s.
& If these two macros were accepted, the shorter macro %s
& would be expanded first when you tried to type the longer macro %s

D4=Ignored line
D5=missing space before equal sign
D6=invalid syntax
D7=- Info: line %d: Replacement text of macro "%s" contains trailing spaces
@D8=Incorrect macro file format: 
+ File seems to have NNN macros but there is no line starting 
& with ";xxxx" before the lines defining macros.  Therefore, 
& all macros are ignored.
+

@D9=Macro file was converted to new format supported by WinVNKey 5.4.440
& or later. The original file was saved in "XXX".
+

E1=Error: macro %s already in the list.
+ Try another name.

E2=Error: Conflicting with existing macro: %s
+ The shorter name will be expanded before the longer name.
+ Try another name.
+
+ Suggestion to avoid conflict:
+        Always end macro with a special character like ; or ]

F1=You cannot choose files 1 and 2 at the same time
+ They are mutually exclusive.
+ If you select a file, the other file must be unchecked.

F2=You cannot choose these files simultaneously:
+            "XXXX"
+            "YYYY"
+
+ They are mutually exclusive. If you select a file, WinVNKey will
+ automatically deselect the other file for you.

[Page MacroManagement]

1. Skip autoExpand2 macro if string has just been transformed by another macro=
2. Skip tail macro if string has just been transformed by another macro=
3. Skip lazy syllable macro if string has just been transformed by another macro=
4. Skip shorthand macro if string has just been transformed by another macro=
5. Skip lazy word macro if string has just been transformed by another macro=
6. Skip all macros if string has just been uncombined=

@Hyperlink-SkipAutoExpand2=In general WinVNKey executes all types of macros
& in the following order if they are chosen on the Main page:
+
+              1. AutoExpand 1
+              2. AutoExpand 2
+              3. Tail
+              4. Lasy Syllables
+              5. Shorthand
+              6. Lazy Words
+
+ When it comes to "AutoExpand 2", you can tell WinVNKey to not process
& all "AutoExpand 2" macro files if the original string (i.e., the raw string you originally typed in) has
& been changed by another macro, which, in this case, is an "AutoExpand 1" macro.
+
+  - Checkbox #1 is enabled:
+    If the original string has been changed by AutoExpand 1, WinVNKey will skip AutoExpand 2
& and go to the next macro type in the list above.
+
+  - Checkbox #1 is disabled:
+    WinVNKey processes AutoExpand 2 if it is chosen on the Main page.  Thus a string may
& be changed twice by two different macro types:
+        * The first time: the original string was changed by AutoExpand 1
+        * The second time: the string that has resulted from AutoExpand 1
& will be changed by AutoExpand 2.
+
+ Example:  Suppose you have the following macros (do not read double quotes):
+      * AutoExpand 1 macro:  "%" becomes "ửng"
+      * AutoExpand 2 macro:  "nhửng" becomes "những"
+
+ If checkbox #1 is enabled, typing nh% gives nhửng.  This is because nh% was converted once (by 
& AutoExpand 1) and the resulting string, nhửng, was not going through AutoExpand 2.
+
+ If checkbox #1 is disabled, typing nh% gives những.  This is because nh% was converted twice.
& The first time it was converted to nhửng by AutoExpand 1. Then nhửng was converted to
& những by AutoExpand 2.
+

@Hyperlink-SkipTail=In general WinVNKey executes all types of macros
& in the following order if they are chosen on the Main page:
+
+              1. AutoExpand 1
+              2. AutoExpand 2
+              3. Tail Macros
+              4. Lasy Syllables
+              5. Shorthand
+              6. Lazy Words
+
+ When it comes to "Tail Macros", you can tell WinVNKey to not process
& all tail macro files if the original string (i.e., the raw string you originally typed in) has
& been changed by another macro, which, in this case, can be an "AutoExpand 1" and/or
& "AutoExpand 2" macro.
+
+  - Checkbox #2 is enabled:
+    If the original string has been changed by AutoExpand 1 or 2, WinVNKey will skip Tail Macros
& and go to the next macro type in the list above.
+
+  - Checkbox #2 is disabled:
+    WinVNKey processes Tail Macros if it is chosen on the Main page.  Thus a string may
& be changed twice by two different macro types:
+        * The first time: the original string was changed by AutoExpand 1
+        * The second time: the string that has been changed by AutoExpand 1
& will be changed by AutoExpand 2.
+
+ Example:  Suppose you have the following macros (do not read double quotes):
+      * AutoExpand 1 macro:  "tn" becomes "tion"
+      * AutoExpand 2 macro:  "ntion" becomes "nation"
+      * Tail macro:  "imgnation" becomes "imagination"
+
+ If checkboxes #1 and #2 are enabled, typing imgntn gives imgntion.  This is because imgntn was converted once (by 
& AutoExpand 1) and the resulting string, imgntion, was not going through AutoExpand 2.
+
+ If checkboxes #1 and #2 are disabled, typing imgntn gives imagination.  This is because imgntn was 3 times.
& The first time it was converted to imgntion by AutoExpand 1. Then imgntion was converted to
& imgnation  by AutoExpand 2.  The new string will be processed by Tail macros and become imagination.
+

@Hyperlink-SkipLazySyllable=In general WinVNKey executes all types of macros
& in the following order if they are chosen on the Main page:
+
+              1. AutoExpand 1
+              2. AutoExpand 2
+              3. Tail Macros
+              4. Lasy Syllables
+              5. Shorthand
+              6. Lazy Words
+
+ When it comes to "Lasy Syllables", you can tell WinVNKey to not process
& all Lasy Syllables files if the original string (i.e., the string you originally typed in) has
& been changed by another macro, which, in this case, can be an "AutoExpand 1", and/or
& "AutoExpand 2" macro, and/or "Tail Macros".
+
+  - Checkbox #3 is enabled:
+    If the original string has been changed by AutoExpand 1, 2, or Tail Macros, 
& WinVNKey will skip Lasy Syllables
& and go to the next macro type in the list above.
+
+  - Checkbox #3 is disabled:
+    WinVNKey processes the Lasy Syllables type if it is chosen on the Main page.  Thus a string may
& be changed many times by previous macro types.
+
+ Example:  Suppose you have the following macros (do not read double quotes):
+      * AutoExpand 1 macro:  "z" becomes "ng"
+      * Lasy Syllables macro:  "ing" becomes "iêng"
+
+ If checkbox #3 is enabled, typing tz gives ting.  This is because tz was converted once (by 
& AutoExpand 1) and the resulting string, ting, was not going through Lasy Syllables.
+
+ If checkbox #3 is disabled, typing tz gives tiêng.  This is because tz was converted twice.
& The first time it was converted to ting by AutoExpand 1. Then ting was converted to  
& tiêng by Lasy Syllables.
+

@Hyperlink-SkipShorthand=In general WinVNKey executes all types of macros
& in the following order if they are chosen on the Main page:
+
+              1. AutoExpand 1
+              2. AutoExpand 2
+              3. Tail Macros
+              4. Lasy Syllables
+              5. Shorthand
+              6. Lazy Words
+
+ When it comes to Shorthand, you can tell WinVNKey to not process
& all Lasy Syllables files if the original string (i.e., the string you originally typed in) has
& been changed by another macro, which, in this case, can be "AutoExpand 1", and/or
& "AutoExpand 2", and/or "Tail", and/or Lazy Syllable.
+
+  - Checkbox #4 is enabled:
+    If the original string has been changed by AutoExpand 1, 2, Tail, or Lazy Syllables,
& WinVNKey will skip Shorthand
& and go to the next macro type in the list above.
+
+  - Checkbox #4 is disabled:
+    WinVNKey processes the Shorthand type if it is chosen on the Main page.  Thus a string may
& be changed many times by previous macro types.
+
+ Example:  Suppose you have the following macros (do not read double quotes):
+      * AutoExpand 1 macro:  "lt" becomes "inh"
+      * Shorthand macro:  "qinh" becomes "quynh"
+
+ If checkbox #4 is enabled, typing qlt gives qinh.  This is because qlt was converted once (by 
& AutoExpand 1) and the resulting string, qinh, was not going through Shorthand macro.
+
+ If checkbox #4 is disabled, typing qlt gives quynh.  This is because qlt was converted twice.
& The first time it was converted to qinh by AutoExpand 1. Then qinh was converted to  
& quynh by Shorthand macro.
+

@Hyperlink-SkipLazyWord=In general WinVNKey executes all types of macros
& in the following order if they are chosen on the Main page:
+
+              1. AutoExpand 1
+              2. AutoExpand 2
+              3. Tail Macros
+              4. Lasy Syllables
+              5. Shorthand
+              6. Lazy Words
+
+ When it comes to Lazy Words, you can tell WinVNKey to not process
& all Lazy Words files if the original string (i.e., the string you originally typed in) has
& been changed by another macro, which, in this case, can be "AutoExpand 1", and/or
& "AutoExpand 2", and/or "Tail", and/or Lazy Syllable, and/or Shorthand.
+
+  - Checkbox #5 is enabled:
+    If the original string has been changed by AutoExpand 1, 2, Tail, Lazy Syllables, or Shorthand,
& WinVNKey will skip Lazy Words
& and go to the next macro type in the list above.
+
+  - Checkbox #5 is disabled:
+    WinVNKey processes the Lazy Words type if it is chosen on the Main page.  Thus a string may
& be changed many times by previous macro types.
+
+ Example:  Suppose you have the following macros (do not read double quotes):
+      * AutoExpand 1 macro:  "lt" becomes "inh"
+      * Lazy Words macro:  "qinh" becomes "quynh"
+
+ If checkbox #5 is enabled, typing qlt gives qinh.  This is because qlt was converted once (by 
& AutoExpand 1) and the resulting string, qinh, was not going through Lazy Words macro.
+
+ If checkbox #5 is disabled, typing qlt gives quynh.  This is because qlt was converted twice.
& The first time it was converted to qinh by AutoExpand 1. Then qinh was converted to  
& quynh by Lazy Words macro.
+
+ The difference between Lazy Words and Shorthand macros is that the former is case-smart,
& i.e., it knows how to change the letter cases based on the case of the macro letters you typed in.
+
+


@Hyperlink-SkipAllMacrosAfterUncombine=Checkbox number 6 has no effect unless you have
& checked (enabled) one of the following options:
+
+        (a) option #8 (smart key mapping) on Typing Method page, or
+        (b) option #5 or #7 (smart uncombine) on Viet Option page.
+
+ If you do not turn on any of these options, you can ignore checkbox #6.  Otherwise, WinVNKey will 
& process as follows.
+
+ It is easier to explain with an example.  Suppose you use a VIQR typing method and
& have defined a shorthand macro "ta^z" to represent "tân gia".
+
+ Now you start by typing the following four keys in this order:
+       - type t a ^ ==> tâ
+       - type z ==> you get tâz momentarily.  
+ WinVNKey will apply all macro types to "tâz" in the following order:
+
+              1. AutoExpand 1
+              2. AutoExpand 2
+              3. Tail Macros
+              4. Lasy Syllables
+              5. Shorthand
+              6. Lazy Words
+
+ Because you do not have macros z, âz, or tâz, the string stays unchanged.
& After done with macro processing, WinVNKey will proceed as follows:
+       - check if the original string is not changed by any macro
+       - if not changed, it will check if the string is a legal sequence of Vietnamese characters.   
+       - if not legal, it will restore all the original characters that were physically typed in if requested
& by option 8 on the typing method page, or option 5 or 7 on the Viet option page.
+
+ In the said example WinVNKey will uncombine "tâz", i.e., restore the sequence to the original raw
& characters "ta^z".
+
+ At this point the sequence "ta^z" appears to you as if it has not gone through 
& any macro processing at all.  Because you already have a macro "ta^z =tân gia", you would expect 
& WinVNKey to convert it to "tân gia".  This means, internally, WinVNKey has to compare the unmodified
& string "ta^z" with all macro types again.  Instead of doing this automatically, WinVNKey offers this
& as an option (checkbox #6) so that you have more flexibility in deciding how WinVNKey will proceed.
+
+ Thus, if WinVNKey is allowed to run macros again on the string "ta^z", 
& this string will change into "tân gia" because "ta^z" is defined to be a macro.
+
+ By default, checkbox #6 is unchecked and WinVNKey will always run macros again
& on the original sequence of characters.
+


[Converter]

C1=Properties
C2=Source is in
C3=Destination is in
C4=Source File
C5=Directory
C6=Filename
C7=Destination File
C8=Option
C9=Subdirectory
C10=Suffix
C11=Prefix
C12=Click to open subdirectory
C13=Click to open input file
C14=Click to open output file of the last conversion
C15=Click to view full status

C16=Click for an overview
C17=How to specify multiple files
C18=Check and correct mispelled words

converted=

B0=Clear
B1=Browse
B2=Convert
B3=Status
B4=done
B5=failed
B6=Conversion failed
B7=file is empty
B8=Guessing charset ....
B9=Converting file ....
B9A=Finding statistics ...
B10=Converting clipboard ....
B11=Guessing charset for "XX"
B12=based on spelling error count in each charset
B13=failed, let's assume VISCII to proceed further
B14=unpronounceable words
B15=plus NN meaningless words
B16=Note: This file has no unpronounceable words in NN charsets.
B17=Conversion Error
B18=guessed charset
B19=Guessing charset for text in clipboard
B20=Clipboard seems to be empty!
+ You have to copy data to clipboard first
+ before clicking the "Convert" button.

B21=Conversion Warning
@B22=Source data is not Unicode nor UTF-8. Aborted

@B23=Clicking this hyperlink will open Windows Explorer if
& you specified an existing directory in the box.
@B24=Clicking this hyperlink will open the file specified in the box
& if it exists.
@B25=Clicking this hyperlink will display a detailed summary of your conversion.
& In particular, if the source charset is unknown, 
& you can choose is as "0. Auto (Guess charset)" to allow WinVNKey
& to determine the correct charset automatically.  In this case the
& hyperlink will give you a lot of details such as the number of mis-spellings
& for each charset.  You can rely on this information to decide
& the best charset of the source text in case WinVNKey guess is wrong.

D1=File
D2=Clipboard
D3=Unicode in RTF File (font: Times New Roman)
D4=Composed Unicode in RTF File (Times New Roman)

E1=Same filename, different subdirectory
E2=Same directory, different filename suffix
E3=Same directory, different filename prefix
E4=Directory and filename are specified

F1=same filenames

G1=Errors in source filename:
G2=When the destination is clipboard, you can convert one file at a time only.
G3=Please choose an explicit source filename!

H1=When converting to clipboard:
H2=You can't specify * or ? in source filename
H3=When converting from clipboard:
H4=You can't specify * or ? in destination filename
H5=You have to enter the name of the file you want to convert!
H6=You have to enter the name of the output file!
H7=Destination contains invalid chars
H8=You have to enter a valid name!
H9=Couldn't open source file
H10=Reason:
H11=Couldn't open destination file
H12=Destination file already exists.
H13=Do you want to replace it?
H14=Destination file is the same as the source file.
H15=Please change the destination and try again.
@H16=Source file is not found.

K1=For multiple source files, you can't select option:
K3=Please choose a different option so that you don't
K4=have to specify output filenames individually.

K5=Cannot allocate memory

K6=Cannot lock clipboard memory

K7=Clipboard seems to be empty!
K8=You have to copy data to clipboard first
K9=before clicking the Convert button
K10=Cannot open clipboard to read data

L1=Destination and source can't be the same!
L2=Computing statistics ...
@L3=Source Files:
@L4=SUMMARY
@L5=Total count of Han/Nom characters = NNN
@L5.1=Total distinct Han/Nom characters = DDD 
@L5.2=These characters are distributed in the following Unicode regions:

@L6=Failed to open output file to write statistics

@L7=Cannot open file XXX to write data!
@L7.1=Cannot open file XXX to read data!
@L7.2=File XXX is not found!
@L7.1.1=Permission denied!

@L8=File XXX is currently opened.
+ Please close it and repeat the operation!
+
@L9=Source text does not contain Hán Nôm characters.
+ Thus no statistics will be computed!
+
@L10=Cannot open destination file XXX to write data!
@L11=WinVNKey is currently XXX and hence does not support retyping!
+ To use the retyping capability of the converter, you have to adjust the keyboard
& settings as if you were going to retype the source text by yourself. This means
& you have to adjust the following:
+      - Page Main:
+             1.  Choose an appropriate keyboard  mode.  For instance,
+                    - Choose "1. Auto combine (Viet)" if the source text is Vietnamese
+                    - Choose "3. Literal (no combine, except \)" if the source text is Pinyin using 1, 2, 3, 4 for tonemarks.
+             2.  Choose an appropriate charset.  This is used as the destination character.
+             3.  Choose an appropriate typing method, Viet option page, and macros.
+      - Page Languages
+             Choose an appropriate language.  For instance, select "Pinyin" on the Language page
& if your source text is Pinyin like ba1, ba2  and you want to convert to bā, bá.
+      - Pages Advanced and Special keys
+             If you want to use any features on these pages, you have to enable them.
+

@L12=SLEEP
@L13=OFF


@M1=Character
@M2=Unicode Value
@M3=Count
@M4=Percentage %
@M5=Han-Viet
@M5.1=Nom-Viet
@M6=Pinyin
@M7=Unicode Region


Help-Properties=HIGHLIGHTS OF WINVNKEY PLAIN TEXT CONVERTER
+
+ The plain text converter has the following capabilities:
+         - Convert character set from plain text file and save the result in another plain text file or RTF file.
+         - Automatically retype a plain text file based on a specified typing method and a specified Viet option page.
+         - Perform certain conversion on Hán Nôm plain text files and calculate Hán Nôm character statistics.
+
+ A. Convert character set from plain text file and save the result in another plain text file or RTF file
+ ---------------------------------------------------------------------------------------------------------------------------------
+      - Can convert from file to file or to clipboard
+      - Can convert from clipboard to file or to clipboard
+      - Can convert multiple files in the same directory at the same time.
+      - Support all character sets listed in the main control panel, where the character sets are numbered from 1 to 95.
+      - WinVNKey can autoguess the character set of the source file or clipboard when you choose the source character set numbered 0.
+      - The source files must be plain text.
+      - The destination can be chosen to be plain text or Rich-Text-Formatted (RTF) file.
+
+        If you choose RTF file for destination:
+             - the converted text will be in Unicode and in "Times New Roman" font
+             - WinVNKey does not support any other fonts.
+
+        But you can later use the RTF converter to convert to any other fonts if you want to.
+
+ B. Automatically retype a plain text file based on a specified typing method and a specified Viet option page
+ ---------------------------------------------------------------------------------------------------------------------------------------------
+ This capability allows you to easily convert text formatted in VIQR,VNI, Telex, Microsoft, etc to Unicode
& or any other character set (charset).
+
+ When you select source charset number 200 or greater, WinVNKey will automatically retype every character
& in the source text and save the result in the destination file or clipboard depending on your choice.
+
+     1. If you select source charset number 200
+         WinVNKey will retype source text based on all the keyboard settings on pages:  Main,
& Advanced, Languages, Special keys.  Result: After the conversion, you will get the output text
& exactly as if you retyped every character in the source text.
& For more information, please choose source character set number 200, then click on the button labelled "?" next to it.
+
+ Example 1:  Suppose your source text contains Pinyin characters with numbers 1, 2, 3, 4 as tone marks
& (such as ba1, ba2, ba3, ba4).
& You can use source text charset number 200 to convert to true Pinyin Unicode charaters (such as bā, bá, bǎ, bà).
& To this end you should set up the keyboard as follows:
+               (a) Page Main:
+                        - Click on "Default" button
+                        - Choose Keyboard mode: "3. Literal (no combine, except \)"
+               (a) Page Languages:
+                        - Select "Pinyin"
+
+     2. If you select source charset number 201 or greater
+         WinVNKey will retype source text based solely on the typing method and the Viet option page, both of
& which are specified separately from the Main page.  (Note that WinVNKey does not process macros or languages.  If your source text
& contains macros, you need to select source charser number 200 as discussed above.)
+             - Typing Method: You specify the typing method by selecting an appropriate source charset number.
& The typing method number is equal to the source charset number minus 200.  In other words, the charsets
& #201 through 215 correspond to typing methods #1 through 15 on the Main page, respectively.
+             - Viet Option Page:  After you have chosen a source charset greater than 200, click on the button labelled ">>" next to it.
& This will display a dialog that allows you to choose a Viet Option page.
+
+ Example 2: Suppose you want to convert text written in Telex convention to Unicode, where
& the accent marks are written immediately after base letters, say,
+                  Tooi yeeu tieesng nuwowsc tooi tuwf khi mowsi ra ddowfi
+ You can choose one of the following methods:
+        (a) Set source charset to 200, then on page Main: click "Default" button, then select typing method "8. Telex 1".
+        (b) Set source charset to 208, destination charset to "4. Unicode",  then click on the ">>" button next to it.
+        (c) Set source charset to "47. Telex Accent Mark Convention", destination charset to "4. Unicode".  This is the simplest method.
+
+ Example 3: Suppose you want to convert text written in Telex convention to Unicode, where
& the accent marks are arbitrarily placed at anywhere after the base letters, say,
+                  Tooi yeeu tieengs nuwowcs tooi tuwf khi mowis ra ddowif
+ In this case you cannot use source charset number 47.  You have to ask WinVNKey to retype
& the source text based on:
+        (a) Set source charset to 200, then on page Main: click "Default" button, then select typing method "8. Telex 1".
+        (b) Set source charset to 208, destination charset to "4. Unicode",  then click on the ">>" button next to it.
& Then you can select an appropriate Viet option page, for instance,
+                     5. Syllable with free marking (Type mark anywhere & Combine with syllable)
+               or   7. Multi-Syllable with free marking (Type mark anywhere & Combine with last syllable)
+
+ C. Perform certain conversion on Hán Nôm plain text files and calculate Hán Nôm character statistics
+ -------------------------------------------------------------------------------------------------------------------------------------
+ This capability applies to plain text that contains Hán Nôm characters in true form or in Unicode hex values of the form U+xxxx.
& To see this capability, you have to select source charset number 100.  Then the destination charset combobox will list these operations:
+     1. Convert U+xxxx to true chars
+         This operation will convert all occurrences of U+xxxx, where xxxx are 4 or 5 hex digits, to true Hán Nôm characters.
+
+     2. Convert Han/Nom chars to U+xxxx
+         This operation will convert all true Hán Nôm characters to Unicode values formatted as U+xxxx.
+
+     3. Insert a space between adjacent Han/Nom chars
+         If two adjacent Hán/Nôm characters do not have any space or other character in between, it is very hard to read.
& Thus this operation is supported to insert a space between two adjacent Hán Nôm characters.
+
+     4. Compute statistics of Han/Nom chars
+         This operation will count:
+               - total number of Hán Nôm characters in source text (in file or clipboard)
+               - and for each distinct Hán Nôm character in source text, count total number of occurrences.
+         The result will be saved in a plain text file with ".csv" extension so that it can be opened by Excel.
+         Each distinct character will be written on one line, which includes the following tab-separated information:
+               - true Hán Nôm character
+               - Unicode value formatted as U+xyyyy (using 5 hex digits for sorting purposes)
+               - frequency (number of occurrences)
+               - percentage (equal to frequency divided by total character count, then multiplied by 100)
+               - pronunciation in Vietnamese and Pinyin
+               - name of Unicode region (for example, Ext A, Ext B, etc).
+         You can use the sorting feature of Excel to sort the file in any way you want.  
+
+ REMARK:
+ WinVNKey can compute statistics for multiple files at the same time.  In other words, it will
& count all characters in all the specified files before computing statistics.  There are many ways
& to specify multiple source files.
+     - Click on the arrow of the source file combobox and select *.txt.  The notation "*.txt" means
& all files that end with ".txt".
+     - You can type directly in the source file combobox.  You can type *.txt, or *.han, or *.nom,
& or *.* (the notation *.han means all files ending with ".han", *.nom means all files ending with ".nom",
& and *.* means all files that have a dot in their names).
+     - You can click on the open file icon next to the source file combobox. Then browse
& to the source directory and select multiple files at the same time.
+
+ After you select multiple source files, click on the Convert button.  WinVNKey will count all characters
& in all the files, calculate the statistics, then write the result to a single output file.
+
+
+


Help-SourceFile=WinVNKey can convert one or more plain text
& files at the same time.
+
+ You can specify many files in the "Filename" box by
+   1. clicking the open folder button and selecting several files
+   2. or typing filenames with wild-card characters * and ? where
+        - each * represents zero, one, or more arbitrary characters
+        - each ? represents exactly one and one arbitrary character
+      Example:
+         *.txt        -- convert all txt files in the directory
+         letter*.txt  -- convert all txt files beginning with "letter"
+         poem?.txt    -- convert all txt files whose basenames have exactly
+                          5 characters with the first four being "poem".
+
+ Note:
+ If you click on the "File" hyperlink, WinVNKey will open the relevant file with Notepad
& or Wordpad for you to review.  You can specify your choice of Notepad or Wordpad
& on page Miscellanous:
+       Click on Run button | Preferences | Miscellaneous | Checkbox 6.
+


Help-Vietnet=When converting a file written in VIQR (VietNet) style, 
& WinVNKey will use the following settings:
+
+ 1.  Typing method "4. VietNet".
+     All the nine common marks and the first checkbox (Delete space ...)
& at the top of the "Viet Chars" page for this typing method will be used for conversion.
+
+  2. The following three options of the current Viet Option Page will be used:
+       - Option "Adjust tonemark on strong vowel" (listed as sub-option of checkbox #3)
+       - Option #4 (Uncombine as soon as syllable becomes non Vietnamese)
+       - Option #5 (Enable word correction on word completion):  
& Even if the checkbox is greyed out, as long as
& there is a checkmark in checkbox #5, 
& the period and the question mark at the end of a word ending
& with a vowel will be considered true punctuation marks if there is
& at least one space after it and the first letter of the next word
& is capitalized.
+
+ You can put a checkmark in option #5 even if it is greyed out.
& Normally option #5 is not greyed out when the combination of accent marks is based
& on correct word spelling.  So the trick is as follows:
+        - expand option #1 (clicking on button to the right of option #1)
+        - temporarily change combobox B to select option:
+                 "3.  a pronounceable Viet word with correct spelling"
+        - now option #5 becomes active. 
+        - click on checkbox #5 to put a checkmark.
+        - then reset combobox B to its previous setting.
+ Once you're done, you will see that there is a checkmark in checkbox #5
& even though it is greyed out. 
+

Help-UsingKeyboardSetting=If you choose this option (source charset #200), WinVNKey will retype
& the source text based on the current settings of the keyboard on
+          - page Main
+          - page Advanced
+          - page Languages
+          - page Special keys
+
+ What you get from the conversion is exactly the same as if you retyped the source text by yourselves using the same keyboard settings.
& In the following we will discuss some common settings that you have to adjust to get the result you want:
+
+ A. Typing Method
+ ------------------------
+ If your source text is in Telex format, you can set "Typing Method" to "8. Telex 1".
+
+ If it is in VNI format, you can set "Typing Method" to "5. VNI", etc.
+
+ You should click on the "Typing Method" hyperlink on page Main to see what characters represent what accent marks, then determine the correct typing method
& to be used for the conversion.
+
+ Example:
+     - True Vietnamese text:
+                  Phấn son tô điểm sơn hà
+                  Làm cho rỡ mặt đàn bà nước Nam.
+     - The following text
+                  Phaasn son too ddieerm sown haf
+                  Lafm cho rowx mawjt ddafn baf nuwowsc Nam.
+       is Vietnamese written in Telex convention.
+     - The following text
+                  Pha61n son to6 d9ie63m so7n ha2
+                  La2m cho ro74 ma85t d9a2n ba2 nu7o71c Nam.
+       is Vietnamese written in VNI convention for accent marks.
+  
+ B. Viet Option Page
+ ----------------------------
+ If your source text contains accent marks immediately after the base letters (vowels or d), then you can set "Viet Option Page" to
+              "1. Syllable in VietNet style (Type mark after letter & Combine with syllable)"
+
+ If your source text contains accent marks anywhere in the syllable (in the middle or end of syllables), then you can set "Viet Option Page" to
+              "2. Word in VietNet style (Type mark after letter & Combine with word)"
+
+ In principle, if you understand all the options of each Viet Option page, you can choose any page that is appropriate for your source text. 
& Or you can select any page and modify options therein to handle the source text.
+
+ C. Macros
+ ---------------
+ If your source text contains macros and you want them to be expanded during retyping, 
& you have to enable the appropriate macros on page Main.
+
+ D. Pages Languages
+ -----------------------------
+ Your source text may contain ASCII characters that represent alphabetical letters in a foreign language.
& For instance, see Pinyin on page Languages, where 1, 2, 3, 4 are used to represent tone marks.
& In this case you can enable the relevant languages on page "Languages" so that
& WinVNKey can retype the source text and turn it into true characters.
+

[RTF Converter]
A1=Choose a font replacement table
A2=Table


C1=How to specify multiple source files?
C2=What is a font replacement table?
C3=Click to view, change, or add/delete font replacement tables

E1=done
E2=failed
E3=failed, charset conversion file not found

Help-SourceFile=WinVNKey can convert one or more RTF files at the
& same time from one set of fonts to another set of fonts.
& The source fonts as well as the destination fonts
& can be from different character sets.
+
+ You can specify many files in the "Filename" box by
+   1. clicking the open folder button and selecting several files
+   2. or typing filenames with wild-card characters * and ? where
+        - each * represents zero, one, or more arbitrary characters
+        - each ? represents exactly one and one arbitrary character
+      Example:
+         *.rtf        -- convert all RTF files in the same folder
+         letter*.rtf  -- convert all RTF files beginning with "letter"
+         poem?.rtf    -- convert all RTF files whose basenames have exactly
+                          5 characters with the first four being "poem".
+

Help-Table=WinVNKey can convert an RTF file from one set of fonts to
& another set of fonts.  For instance, if your original RTF file
& uses three fonts AnhMinh, MinhQuan, and PhuongThao, you can
& ask WinVNKey to convert as follows:
+       AnhMinh           --> Arial
+       MinhQuan          --> Courier New
+       {All other fonts} --> Times New Roman
+
+ This list is commonly referred to as font replacement table
& because it tells what fonts are replaced with what.  Normally each
& table has a source entry called "{All other fonts}", which catches all
& the fonts not listed in the source column of the table.
+
+ Not only does WinVNKey replace fonts but it also converts text from
& the character sets implied by the source fonts to the new
& character sets implied by the destination fonts.
+
+ WinVNKey is shipped with a number of predefined font replacement
& tables.  You can modify them to suit your need or even
& define new tables by clicking on the "Table" hyperlink.
+

@M1=This original source file contains two consecutive letters xxxx (or XXXX if capital font is used).
+ This is a design bug in the character set of font FONT.  Users have to type the letter xx twice
+ in order to see just one instance of xx.
+
+ Although a single letter xx appears to you in the source text, you will see two letters xxxx
+ appear in the output text after conversion to another character set such as Unicode.
+ If you want, WinVNKey can delete one xx whenever it sees xxxx in the source text.
+ Otherwise, after conversion, you can search and replace xxxx with xx.
+
+ Do you want WinVNKey to keep only one letter (yes/no)?
+
+

@M2=This original source file contains two consecutive letters ưư (or ƯƯ if capital font is used).
+ This is a design bug in TCVN ABC character set.  Users have to type the letter ư twice
+ in order to see just one instance of ư.
+
+ Although a single letter ư appears to you in the source text, you will see two letters ưư
+ appear in the output text after conversion to another character set such as Unicode.
+ If you want, WinVNKey can delete one ư whenever it sees ưư in the source text.
+ Otherwise, after conversion, you can search and replace ưư with ư yourself.
+
+ Do you want WinVNKey to keep only one letter (yes/no)?
+
+

@M3=This original source file contains two consecutive letters ễễ (or ỄỄ if capital font is used).
+ This is a design bug in VISCII character set.  Users have to type the letter ễ twice
+ in order to see just one instance of ễ.
+
+ Although a single letter ễ appears to you in the source text, you will see two letters ễễ
+ appear in the output text after conversion to another character set such as Unicode.
+ If you want, WinVNKey can delete one ễ whenever it sees ễễ in the source text.
+ Otherwise, after conversion, you can search and replace ễễ with ễ yourself.
+
+ Do you want WinVNKey to keep only one letter (yes/no)?
+
+
[Page ToCode]
Source text=
Output=


A1=Transform source text characters as follows:
A2=Copy output back to source text box

B0=    === Transform data from characters to code ===
B1=T1. Transform characters to hex       (hex transform)
B2=T2. Transform characters to codepoint in U+hex notation
B3=T3. Transform characters to decimal   (decimal transform)
B4=T4. Transform characters to octal     (octal transform)
B5=T5. Transform characters to binary    (binary transform)
B6=T6. Transform characters to UTF-8     (UTF-8 transform)
B7=T7. Transform characters to UTF-8 Hex (first to UTF-8, then to hex)
B8=T8. Transform characters to UTF-8 Octal (first to UTF-8, then to octal)
B9=T9. Transform characters to UTF-8 Binary (first to UTF-8, then to binary)
B10=T10. Transform characters from 2-hex digits to UTF-8
B11=T11. Transform characters from 4-hex digits to UTF-8
B12=T12. Transform characters from 2-hex digits to UTF-8 Hex
B13=T13. Transform characters from 4-hex digits to UTF-8 Hex

C0=   === Inverse Transform (Undo) from code back to characters ===
C1=U1. Undo T1  (undo Hex Transform on 2 hex digits at a time)
C2=U2. Undo T1  (undo Hex Transform on 4 hex digits at a time)
C3=U3. Undo T1  (undo Hex Transform on space-delimited hex digits)
C4=U4. Undo T2  (Transform U+hex notation back to character,  U+ is optionally specified)

C5=U5. Undo T4  (undo Octal Transform on 3 octal digits at a time)
C6=U6. Undo T4  (undo Octal Transform on 6 octal digits at a time)
C7=U7. Undo T4  (undo Octal Transform on space-delimited octal digits)

C8=U8. Undo T6  (undo UTF-8 Transform)
C9=U9. Undo T7  (undo UTF-8 Hex Transform)
C10=U10. Undo T8  (undo UTF-8 Octal Transform)
C11=U11. Undo T10 (transform UTF-8 to characters in 2-hex digits)
C12=U12. Undo T11 (transform UTF-8 to characters in 4-hex digits)
C13=U13. Undo T12 (transform UTF-8 hex to characters in 2-hex digits)
C14=U14. Undo T13 (transform UTF-8 hex to characters in 4-hex digits)

Help-Transform=Understanding character data transformation
+
+ What appears to you as a character is actually a value in computer.  You can transform
& that value to a new value by many methods, which are conveniently called character
& data transformations.  You can undo the transformation by applying the inverse transform
& of the new value to get back the original value.  
+
+ When displayed in hex, decimal, or octal,
& all values have their most significant byte (MSB) listed first. In other words,
& if you see a hex value of 1EA0, it means 0x1EA0; i.e. the MSB is 0x1E
& and the least significant byte is 0xA0.  Note that the display order does
& not necessarily represent the order of the data stored in memory.
& For example, in Intel machines this value is stored differently: 
& the first byte is 0xA0, the second byte is 0x1E.
& 
+
+ These transformations are reserved for advanced users and programmers only.
+
+ To understand the following transformations, we will use the following set of data:
+
+ a  is a Unicode letter whose code value is 0x61 hex, 97 decimal,  
& 141 octal, 01100001 binary
+
+ á  is a Unicode letter whose code value is 0xE1 hex, 225 decimal,  341 octal, 11100001
& binary.  Its UTF-8 representation looks like "Ã¡" in Arial font, where
+
+    - Ã  is a Unicode letter whose code value is 0xC3 hex, 195 decimal, 303 octal
+
+    - ¡  is a Unicode letter whose code value is 0xA1 hex, 161 decimal, 241 octal
+
+ Note that when the transformation fails for an invalid source character, the output
& box will display that original character enclosed in square brackets.
+
+
+ Forward Transforms
+ ==================
+
+ T1. Transform to hexadecimal
+ Each character will be converted to 2 hex digits if its value is less than 256 or
& 4 hex digits otherwise.   These groups of digits are separated by a space. As an
& example, "aá" will be transformed to "61 E1"
+
+ T2. Transform to decimal
+ Each character will be converted to decimal separated by a space.  As an example,
& "aá" will be transformed to "097 225"
+
+ T3. Transform to octal
+ Each character will be converted to octal separated by a space.  As an example, "aá"
& will be transformed to "141 341"
+
+ T4. Transform to binary
+ Each character will be converted to binary separated by a space.  As an example,
& "aá" will be transformed to "01100001 11100001"
+
+ T5. UTF-8
+ Each character value, regardless of character set, is treated as if it were a Unicode
& value and were subject to a UTF-8 transformation.  This transformation is basically a
& redistribution of significant bits of the original code value into one or more bytes.
+
+ As an example, consider the single Unicode letter á.  Applying the UTF-8 transformation
& to this letter results in two bytes 0xC3 and 0xA1.  These two bytes are displayed
& in character format ("%c%c" in C programming language).  Consequently, the
& bytes will appear differently depending on the font chosen for the output box.  If
& you choose Microsoft Unicode fonts such as Courier New, Arial, Times New Roman, you
& will see "Ã¡".  If you choose VISCII fonts such as AnhMinh, you will see "Ãắ" instead
& because VISCII places Ã in slot 0xC3 and ẳ in slot 0xA1 of the font table.
+
+
+ T6. UTF-8 bytes in hexadecimal
+ The transformation means first performing a UTF-8 transformation, then hex transformation.
& This means displaying the UTF-8 transformation byte output in hex format.  As example,
& this transformation when applied to á will display "C3 A1" in the output box.
+
+
+ T7. UTF-8 bytes in octal
+ The transformation means first performing a UTF-8 transformation, then octal transformation.
& This means displaying the UTF-8 transformation byte output in octal format.  As
& example, this transformation when applied to á will display "303 241" in the output
& box.
+
+
+ T8. UTF-8 bytes in binary
+ The transformation means first performing a UTF-8 transformation, then binary transformation.
& This means displaying the UTF-8 transformation byte output in binary format.  As
& example, this transformation when applied to á will display "11000011 10100001" in
& the output box.
+
+
+ Inverse Transforms
+ ==================
+
+ For most forward transforms WinVNKey also provides a reverse or inverse transform
& to undo the original transformation.  What you get back is the original data.
+
+ A few notes are in order when you enter source data:
+
+ Hex data can be entered as a sequence of digits without intervening spaces.  If this
& is the case, you have to tell WinVNKey to process 2 or 4 digits at a time.
+
+      - Choose 2 to tell WinVNKey to undo into 8-bit data.
+      - Choose 4 to tell WinVNKey to undo into 16-bit Unicode data.
+
+ Hex data can be entered in groups separated by a space where each group represents
& a character. Thus a group can have up to 5 hex digits, where the 5-digit cases corresponds
& to surrogate data.  Surrogate characters are Unicode characters with code values
& exceeding 4 bytes. 
+
+ The same thing applies to octal data, where you can tell WinVNKey to process 3 or
& 6 octal digits at a time for 8-bit and 16-bit data respectively.  If you use spaces
& to separate groups of octal digits, you can specify upto 9 octal digits to accommodate
& surrogates.
+
+
+ To undo any UTF-8 data, you cannot insert spaces between data that belongs to the
& same character.  For example,
+
+     - You must enter Ã¡ in the source text box when performing U7 transformation
+
+     - You must enter C3A1, not C3 A1 (a space in between), when performing U8 transformation
+
+     - You must enter 303241, not 303 241 (a space in between),  when performing U9 transformation
+





[Page Doc/HTML]
A1=You can convert text and fonts in
+     - Microsoft Word documents (*.DOC files)
+     - Web pages (*.HTM or *.HTML files).
+
+ Because direct conversion is not supported yet, you can work around as follows:
+    1. Open Microsoft Word and read in your .DOC or .HTML files
+    2. Save the files in Rich Text Format (.RTF) filetype
+    3. Use WinVNKey "RTF Files" conversion to convert these RTF files.
+    4. Open Microsoft Word again and read in your new .RTF files
+    5. Save the files immediately in the original .DOC or .HTML filetype.
+

[Page ReplaceFonts]
Table=
List source and destination fonts in the font replacement table=
Add From File=
Add Row=
Delete Row=
Create Table=
Delete Table=
Save Table=
Save As=
Back Up Table=
Restore Table=
Convert to=

A1=Save Table As .INI File

B1=The backup of the current table already exists:
B2=Do you still want to back up and overwrite this file?
B3=Backed up table successfully
B4=Failed to back up table

R1=This table has never been backed up before!
R2=Do you want to overwrite the current table
R3=with the following file
R4=Restored table from backup successfully
R5=Failed to restore table from backup


R6=Rows beginning with "..." are not saved.
R7=Rows ending with "..." have the font unchanged; i.e., the font
+ in column 2 will be made identical to column 1

R8=Table has no entry for "Symbol" font.  Added one.
R9=Table has no entry for "{All other fonts}".  Added one.
R10=You have to specify replacement font for "{All other fonts}".  Reset to "Arial".

Help=You can right click inside the table to see many options. 
& If you see some arrows disappear or too many arrows appear, you can refresh the table  
& by right clicking and choosing the refresh menu or by left clicking anywhere
& inside the table.
+
+ Each table must have at least the two following rows:
+   1. one row that specifies how to convert "Symbol" font.  Normally, you don't want to
& convert it.  So put the same name "Symbol" in column 2.
+   2. one row that specifies how to convert all other fonts not listed in the table.
& This row has "{All other fonts}" in column 1, and by default, "Arial" in column 2.
& You can change column 2 it if you want, but not column 1.
+
+ If a font name is incorrect, you can click on the relevant combobox arrow to display a dropdown list  
& of fonts and choose a correct font.
+
+ There are three types of dropdown lists.  You can choose which list to appear by right-clicking 
& anywhere inside the table and selecting an appropriate menu option:
+
+     1. Display system fonts:  display all fonts currently installed in your system.
+
+     2. Display RTF file fonts: you will be prompted for an RTF file.  WinVNKey will collect 
& all font names in this file and will display this list whenever you left click on a combobox arrow.
+
+     3. Display " My Own List Of Font Names" :  if you want to display fonts that are not installed in your system 
& and are not in any RTF files, you must use a text editor like Notepad to put the font names in 
& the special file named "My Own List Of Font Names.txt".
& Then if you choose this third option, WinVNKey will display the font names listed in this file 
& whenever you left click on a combobox arrow.
+
+
+ NOTE 1:
+ The directory containing the file "My Own List Of Font Names.txt" 
& can be opened via this menu: Table ==> Open Folder
+
+ NOTE 2:
+ If a destination font is from single-byte character sets such as VISCII, VPS, ABC,
& you can optionally specify the capital font in the third column.  For example,
& suppose you want to convert from Unicode Arial font to VISCII font AnhMinh.
& Normally this is fine as long as the text does not contain "bad" capital
& such as characters Ẳ, Ẫ, Ỹ, etc that do not show up in AnhMinh.
+
+ When WinVNKey encounters these bad characters, it automatically switches to
& the appropriate capital font that is associated with the regular font in the
& second column.  But how does it know the name of the capital font?
+
+ WinVNKey knows the capital font names based on its internal database.
& But the database is incomplete and may be incorrect.
& So you can help WinVNKey by specifying exactly what capital font you want
& in the third column.  For example, if the second column is AnhMinh, you
& should specify AnhMinhH in the third column.
+
+ If the third column does not show up in the table, you can force it
& to show up by clicking on the downward arrow on the "Table" button,
& then selecting the menu "Show Capital Font Column".
+

[Page CheckCharsets]
Get font names from=
RTF File(s)=
Font Name=
Font Table=

B1=The table has been changed.
+ Do you want to save to disk?


Help=Each font is used exclusively for a character set.  
& However, not all fonts in the same character set are converted to Unicode in the same way.   
& For example, "VI Times" is a regular VISCII font and "VI Times H" is a capital VISCII font.   
& Because of differences in regular and capital fonts, they are converted to Unicode differently.   
& The conversion for "VI Times" is specified in the conversion file Viscii.txt   
& and for "VI Times H" in Viscii-Capital.txt.
+
+ Therefore WinVNKey associates each font with a unique conversion file.    
+
+ The table below lists font names in column 1 and conversion files in column 2.  
& If a conversion file is wrong, you can do as follows:
+      (a) click on the downward arrow to choose the correct one,
+      (b) or manually edit the file 
+                 $
+ based on the instructions therein.
+
+
+ In general, single-byte Vietnamese character sets like VISCII, VPS, ABC, DHBK1, VietWare_F, etc  
& have at least three different conversion files:
+      (1) regular conversion file, e.g. Viscii.txt, used for regular fonts
+      (2) capital conversion file, e.g. Viscii-Capital.txt, used for fonts  
& in which all lower-case English letters remain lower case and all other letters  
& are upper case (such as "VI Times H").
+      (3) all-capital conversion file, e.g. Viscii-AllCapital.txt, used for  
& fonts in which all letters are upper case (such  
& as "ÁnhMinhH 1.1", "MinhQuânH 1.1").
+
+ If you don't know whether a font is capital or all-capital, click on the "Check Capital" button  
& below to go through a visual test to determine its capital type. 
+
+
+ Double-byte character sets like VNI, DHBK-2, VietWare_X, Unicode, etc do not have capital fonts.  
& However, many VNI fonts contain extra foreign characters that are different  
& depending on the individual fonts.  If you use the conversion file VNI.txt, you will be able to  
& convert all Vietnamese characters correctly.  But if your text also contains foreign characters, they  
& may not get converted correctly.  Therefore, WinVNKey provides a limited number of conversion files for  
& a few VNI fonts to handle the foreign character conversion.  If a foreign character in a particular  
& VNI font is converted wrong, chances are you need a different VNI conversion file for this font.  
& You can define a new conversion file via the "Check Unicode Conversion" page by modifying an existing  
& VNI conversion file and saving under a different name.   
& If a programmer, you can go to the "FontSets" directory, make a copy of an existing  
& VNI conversion text file, then add or change the lines that describe the  
& conversion rule for the foreign characters of interest. 
+





[Page CheckConversion]
Font Name=
Conversion File=
Delete Row=
Add Row=
Delete File=

C1=Do you want to back up the original conversion file first?

C2=Backup file already exists:
+   XX
+ Do you want to overwrite?

C3=File XX saved successfully to disk.

C4=Do you want to associate font XX with conversion file YY?

C5=This conversion file has never been backed up before!
C6=Restored conversion file from backup successfully
C7=Failed to restore conversion file from backup:
C8=Could not delete file
+   XX
C9=because the file is read-only.
C10=because the file was not found.

C11=Backed up successfully:
C12=Failed to back up conversion file:
C13=File "XX" will be deleted.
+ Are you sure?


D1=Invalid expression for character code.
+ If the character is single-byte, the correct value must be a decimal
+ between 0 and 255, or a hexadecimal value between 0x00 and 0xFF.
+ If the character is double-byte, the two byte values are separated by
+ a comma such as "0x41,0xC7"

D2=Invalid expression.
+ The correct number must begin with U+, which is followed by
+ one to six hexadecimal digits.

D3=How to edit a table cell?


Help=Converting formatted documents (e.g. RTF file) from one font to another is more complicated than
& converting plain text files from one character set to another.  In theory all fonts of the same
& character set must define the same character at the same position in the font table of each font.  In practice, 
& fonts may have different characters at the same location in the font table.  An example is VNI fonts for Windows.
& As far as Vietnamese characters are concerned, VNI defines them at fixed locations in the font table.
& However, this is not true of foreign characters. They jump from one slot to another depending on the font.
+
+ Thus to convert formatted documents correctly, WinVNKey has to rely on the exact mapping from individual fonts
& to Unicode.  Therefore, each font must be associated with a conversion file, which specifies the mapping from
& all font characters to Unicode.  In this sense each font behaves like a character set in itself.
& Because it is impossible to know in advance the variation in all fonts, WinVNKey has to make the
& best guess and leave the final decision to users, who must know their fonts better than WinVNKey.
& Therefore, the user interface allows users to specify or define the conversion file and modify it
& to make sure the conversion is correct.
+
+ Interface description:
+
+ Column 1 displays characters in the font and column 3 displays the corresponding hex values.
+
+ Column 2 displays the corresponding Unicode characters and column 4 displays the Unicode values.
+
+ On each row, if the font character is displayed well, the Unicode character should look the
& same as the font character. If it looks different, the conversion is incorrect and needs to be fixed.
+
+ To this end, you must left-click twice on the Unicode character, then right-click to select another
& Unicode character that looks similar to the font character.
& If a char appears blank or as an empty box, it does not mean the conversion is necessarily incorrect.
& Rather, it can be Windows that can't display it for some reason.
& In this case visual inspection is impossible, but the hex
& values listed in columns 3 and 4 can help you verify the conversion.  If a value is wrong,
& double click on it to manually enter the correct value, if you know what it is.
+
+ Changing an entry in column 1 will adjust column 3 automatically and vice versa.
+
+ Changing an entry in column 2 will adjust column 4 automatically and vice versa.
+
+ NOTES:
+
+ 1. You can change font or font size in column 1 or 2 by right-clicking on the column header.
& Normally, column 1 should be in the font listed in the combobox at the top of the dialog.
+ 2. Entries in columns 1 and 2 can be edited with the help of a pop-up font table.
& To do this, first left-click twice on the cell, then right-click to choose the appropriate
& menu: "Select a Unicode character".
+ 3. Columns 3 and 4 are intended for advanced users or programmers.
& They offer manual edit capability only.
+ 4. You can add missing font characters by clicking on the "Add Row" button.
+ 5. If you make any changes to the conversion table, you must save them using the dropdown
& menu from the downward arrow on the "Conversion File" button.  Otherwise, they will be lost.
+

Help-EditCell=You can change text in any row and any column
& in the table as follows: 
+    1. Left click twice on the cell to change it to an edit box
+    2. Type text directly into the edit box and then press Return when done
+
+ For the first two columns you can replace step (2) with the following:
+    3. Right click to select an appropriate menu
+       For column 1:  "Choose a font character"
+       For column 2:  "Choose a Unicode character"
+
+ Note you can right click inside the table at any time to display a menu
& for more options.
+




[Page Remap]
Help=Some Vietnamese charsets have characters, usually upper case, that are not
& displayable or even forbidden in certain applications.  You can remap them
& to displayable characters such as lower case.

B1=When in charset
C1=remap the following bad characters:
D1=Edit File



[Charmap Help]
A1=Typing Tips
Help=1. Choose a font (e.g. Arial, Arial Unicode MS) and appropriate character set
+ 2. Double click on a desired char on the charmap
+ 3. Repeat step 2 for all characters you want to have
+ 4. Click the Copy button to copy to clipboad
+ 5. Go back to wherever you want to put the text
+ 6. Type CTRL-V or right-hand click and choose Paste
+

[Unicode Typepad]
A1=Script
A2=Page
A3=Characters to copy
A4=Characters to send
A5=Characters selected
A6=Copy
A7=Send to
A8=Hexadecimal
A9=Decimal
A10=decimal

;;[Script Menu]
M0=Change Font
M1=Expand
M2=Reduce
M3=Goto

[XMessageBox]

X0=OK
X1=Cancel
X2=Ignore
X3=Retry
X4=Abort
X5=Help
X6=Yes
X7=No
X8=Continue

X9=Don't ask me again
X10=Don't tell me again
X11=Yes to All
X12=No to All

[Page DeadKeys]
; No longer used in WinVNKey 4.0.350

B1=Turn dead keys into normal to allow typing marks after letters:

N0=1.  Dead key behavior is not changed: dead key is typed before base letters
+         e.g.   ^o ==> ô
+ 2. To type accent marks after letters, type extra space after a dead key.
+          e.g.  type  o, type ^, type space ==> ô

N1=1.  All dead keys become normal
+          e.g.   - type  dead key ^  ==> get  ^  immediately
+                   - type o, type dead key ^  ==>  get ô
+ 2. To get back dead key behavior, type an escape char (backslash) before it
+          e.g.   - type  a,   ==> get  ^  immediately
+                   - type o, type \, type dead key ^, type u  ==>  get aû

C0=0. Don't change dead keys
C1=1. Make ALL dead keys behave like normal keys
C2=2. Make SOME dead keys behave like normal keys


D1=The following dead keys will become normal:
D2=Change

E1=This is to train WinVNKey to recognize deakeys and convert them into normal keys.
E2=Enter only those dead keys that you want to convert to normal keys.
E3=Enter a space after each dead key.
E4=Don't copy and paste!

E5=Convert these dead keys to normal:


[Page Hotkeys]

Select Keyboard Mode=
Select Charset=
Select Output Method=
Select Typing Method=
Select Viet Option Page=
Enable Macro=
Disable Macro=
Enable Language=
Disable Language=
Run Hannom Dialog=
Stop Hannom Dialog=

A1=Don't beep on hotkey success in carrying out the action

Help=Note: You can right click inside the list box to display additional capabilities.
+
+ WinVNKey defines a hot key to be the following three-key sequence:
+        the first key is Ctrl or left Shift.
+        the second key is Ctrl or left Shift.
+        the third key is a letter or a digit.
+
+ You must press and release the first key, then press and release the second key, then press and release the third key.
& Never press the first and second keys at the same time.
& Never press the second and third keys at the same time.
& WinVNKey chooses this behavior to avoid conflict with hotkeys from other applications.
+
+ When you press the third key, WinVNKey will not display it on screen regardless of what it is.
& If the third key forms a sequence defined in the hotkey table, WinVNKey will take appropriate action.
& Otherwise, WinVNKey will do nothing and display nothing; i.e., the third key is
& completely ignored.
+
+ Examples:
+       1) Ctrl-Ctrl-A: press and release CTRL twice, then press key labeled 'A'
+       2) Ctrl-LShift-2: press and release CTRL, press and release left SHIFT, then press key labeled '2'
+
+ Note that if the third key is A, it does not mean you have to press a SHIFT key to get a capital letter A.
& It simply means you need to press and release the key that has the 'A' label.
& Similarly for B, C, ..., Z, 0, 1, 2, 3, .., 9.
+
+ WinVNKey can support as many as 144 hot key sequences.  
& It also allows users to define different hot key sequences for the same action.
+
+ Note that the right Shift key is never used in a hot key definition.  The right Shift
& key is reserved to "Undo" combination/uncombination/macro.  That is, if a mark is combined
& or a macro is expanded, pressing and releasing the right Shift key will undo it.  Then
& pressing and releasing the right Shift key again will undo the last action. 
+

[Page AddHotKey]

Purpose=
Use hot key sequence=
To choose=
To toggle=To toggle (turn on/off)
And choose keyboard mode=
Note=Choose mode 3 if you want to turn off Vietnamese and want to type other languages instead.
& If you want BOTH Vietnamese and other languages as well, choose mode 1.

Select Keyboard Mode=
Select Charset=
Select Output Method=
Select Typing Method=
Select Viet Option Page=

Macro: Start/Stop macro dialog=
Macro: Enable one or more macros=
Macro: Disable all macros=
Turn off all macros in Main Page=

Language: Choose languages and keyboard mode=
Language: Toggle a language, keep others unchanged=
Language: Disable all languages=
Turn off all languages in Language Page=

Hannom: Run dialog=
Hannom: Stop dialog=
HanNom: Select databases=HanNom: Enable one or more databases
HanNom: Toggle database=HanNom: Toggle a single database
HanNom: Toggle displaying code next to char=



Convert: Run dialog=
Convert: Stop dialog=
WinVNKey: Maximize main dialog=
WinVNKey: Minimize main dialog=
WinVNKey: Exit=

@Macro1=If the macro dialog is not running,
& pressing the hot key sequence will run it. If it is running, pressing the hot key
& sequence will stop and close the macro dialog.

@Lang2=When pressing the hot key listed above, disable the 
& said language if it is currently enabled, and enable it if it is currently disabled.

@HN3=When pressing the hot key listed above, disable the 
& said typing method if it is currently enabled, and enable it if it is currently disabled.


[Page CheckCapFonts]
A1=This page is to determine if a Vietnamese font associated
& with a single-byte character set (VISCII, VPS, ABC, VietWare_F,
& DHBK-1, ISC, etc) is a regular, capital, or all-capital font.
& You simply select the font and answer two questions.

A2=Look at Vietnamese letters only.  Do you see upper or lower case? 
A3=All upper case
A4=All lower case
A5=Not all upper case



B1=Conclusion: This is an All-Capital font (all letters are capital)
B2=However, the conversion file is currently $.
& The correct name must contain "-AllCapital."
&  Please choose the correct file for this font in the Check Charsets page.

C1=Conclusion: This is a Capital font (only Viet-specific letters are capital).
C2=However, the conversion file is currently $.
& The correct name must contain "-Capital."
& Please choose the correct file for this font in the Check Charsets page.

D1=Conclusion: This is a regular font.
D2=However, the conversion file is currently $.
& The correct name must NOT contain "Capital."
& Please choose the correct file for this font in the Check Charsets page.

E1=Conclusion: This font type is unknown.
E2=It appears all English letters are upper case
& but Vietnamese-specific letters are not.
& Please check again.

[ComboHelp-About]
T1=DEVELOPMENT HISTORY
T2=COMPOSITION ALGORITHM
T3=TECHNICAL DISCUSSION WITH
T4=VIETNAMESE FONTS


A5=This version is dedicated to NT-based platforms such as NT 3.x/4, 2000, XP, 2003, and Vista, 2008, etc.
& The focus of version 5.x is to support smart Vietnamese typing features:
+
+    * Supports Vietnamese typing in almost all Windows applications: MS Office, Internet Explorer, Wordpad, Notepad, pidgin, gaim, firefox, thunderbird, etc.
+    * Supports smart placement of Vietnamese diacritics on mono-syllable words (e.g. Hùng Vương) or multi-syllable words (e.g. Inđônêxia), 
& allowing users to type the diacritics anywhere in the syllable, correcting spelling for single words or compound words.
+    * Supports many types of macros, especially lazy syllables and lazy words.  These two smart macros will expand if and only if the resulting
& word is a legal Vietnamese word (e.g. Hùng) or an intermediate form of a legal 
& Vietnamese word (e.g. Vưong is the intermediate form of Vương).
+    * Supports entry of Hán or Nôm characters by typing their pronunciations in Vietnamese or Pinyin.
& Users can type multi Vietnamese or Pinyin words without spaces in between (e.g. anhhùng) to reduce the number of characters to choose.
+    * Supports entry of Hán or Nôm characters by the four corner index method or Canjie.
+    * Has large databases of Hán/Nôm characters (in plain text), including Hán characters used in Bhuddist literature.
+    * Allows users to update Hán/Nôm databases with new characters.
+    * Supports Hán Nôm surrogate characters, providing GUI to allow users to configure Unicode surrogates in registry easily.
+    * Supports entry of Katakana and Hiragana, etc.
+    * Supports autoguessing the character set of plain text, hence, can convert plain text where the source character set is unknown.
+    * Supports converting plain text to RTF, which is useful for converting plain text in legacy 
& Vietnamese character sets to RTF to preserve data integrity.
+    * Supports smart conversion of RTF files based on font names.  Users do not have to specify the 
& character set of the source file; all they need to do is specify
& which source font name will be changed to which destination font name.
& WinVNKey will determine the character sets based on the font names imbedded in the file.
& This method allows the source file to contain multiple character sets.  
+    * Supports conversion of character case or character set for selected text in an application.
& All users need to do is use the mouse to select the text, then press and release
& a CTRL key, and finally right click the mouse to choose an appropriate conversion menu 
& to perform the conversion.  The output text will replace the selected text in the application.
+    * Supports hot keys, dead keys, invisible spaces, special key sequences, etc.
+    * Supports customization of WinVNKey settings for individual applications:  keyboard mode, output method, fixing macro bugs.
+

A4=First version to provide multilingual support, including full Unicode and all
& Vietnamese character sets known so far, for all versions of Windows
& NT 3.x, 4, 2000, XP, 9X/ME.
+    Contributors to version 4.x:
A4.1=lead developer
A4.2=installation packaging
A4.3=German localization and active beta testing
A4.4=Pali-Sankscrit macros and active beta testing

A3=supports Win9X/ME, NT3.51/4 with some Unicode in certain applications.

A2=supports Win9X, NT3.51/4 (no Unicode).
A1=supports Windows 3.x

C1=Coordinator
C2=Joint effort by many people -- too numerous to acknowledge properly.  Thank you all.

;-------------------------------------------------------------------------------
title=About WinVNKey

topic1=About WinVNKey
topic2=Copyright Information
topic3=About the TriChlor Group
topic4=About the VietStd Group
topic5=About VISCII Charset
topic6=About VIQR
topic7=Contact Information
topic8=Contribution Requested

topic1.link1.label=Visit WinVNKey website
topic1.link1.url=http://winvnkey.sf.net

topic3.link1.label=Visit TriChlor website
topic3.link1.url=http://trichlor.sf.net

topic4.link1.label=Visit Vietstd website
topic4.link1.url=http://vietstd.sf.net

topic5.link1.label=Read VISCII document at Vietstd website
topic5.link1.url=http://vietstd.sf.net

topic6.link1.label=Read VIQR document at Vietstd website
topic6.link1.url=http://vietstd.sf.net

topic7.link1.label=Contact trichlor.org by email
topic7.link1.url=mailto:Winvnkey-users@lists.sf.net  

topic7.link2.label=Check WinVNKey forum at www.vn.net
topic7.link2.url=http://www.vn.net/viewforum.php?forum=3

VietStd=The Vietnamese Standardization Group  was formed in the Fall of 1989
& to promote the standardization of Vietnamese character encoding and to
& monitor ongoing work of international bodies in this regard. The group
& is not for profit and consists of oversea Vietnamese professionals and
& friends of other nationals. Members cooperate their work electronically
& and some members meet occasionally in the Silicon valley, California,
& and elsewhere.
+
+ After a long struggle spanning 1989-1991 the group
& finally succeeded in requesting the two committees on multilingual character
& encoding---the Unicode Consortium and the International Standardizations
& Organization (ISO)---to encode Vietnamese characters in precomposed form
& in the same manner as other Latin-based European languages.
+
+ By the end of 1992 the group completed the design and testing of the 8-bit
& Vietnamese Standard Code for Information Interchange (VISCII) and the 7-bit
& Vietnamese Quoted Readable Specifications (VIQR). See more info at
& the web site below.
+
+ Contact:
+
+     The Vietnamese Standardization Working Group
+     Address:   2821 Toledo Ave, Santa Clara, CA 95051, USA
+     Email:        vietstd@vietstd.org
+     Web site:  http://vietstd.sf.net
+     Fax:          1-443-581-0581
+

;======================================
Contact=You can browse the Internet for WinVNKey related information simply 
& by navigating from the main WinVNKey control panel: Run -> Browse -> ... 
& The following info may be helpful:
+
+ 1. The TriChlor Software Group:
+       Address:   3225 Delta Road, San Jose, CA 95135, USA
+       Email:     Winvnkey-users@lists.sf.net  
+       Web site:  http://trichlor.sf.net
+       Fax:       1-443-581-0581
+
+ 2. WinVNKey Public Forum on Internet:
+           http://www.vn.net/forum.php
+     Open to everyone. You can participate in technical discussion or post your own questions.
+
+ 3. WinVNKey-specific Public Mailing Lists:
+       Winvnkey-users@lists.sf.net 
+       WinVNKey-developers@lists.sf.net
+ If you are not a member of sf.net, you can sign up for free 
& at http://sf.net.  You are encouraged to subscribe to these lists 
& via the WinVNKey Main control pane: Run -> Browse -> WinVNKey Mailing Lists
+
+ 4. WinVNKey Bug Reports:
+ Please give us feedbacks so that the next release of WinVNKey will be better. 
& You can post your feebacks in the forum, or in the public mailing lists, or mail to 
& Winvnkey-users@lists.sf.net  .  Currently, we need volunteers for beta testing, documenting 
& WinVNKey features, defining macros for typing foreign characters, 
& translating the user interface to Vietnamese and 
& other languages, etc.
+
+ 5. The Vietnamese Standardization Working Group (Viet-Std):
+       Address:   2821 Toledo Ave, Santa Clara, CA 95051, USA
+       Email:     vietstd@vietstd.org
+       Web site:  http://vietstd.sf.net
+       Fax:       1-443-581-0581
+

;==============================
Contributions=TriChlor is an absolutely non-profit software group. 
& We copyright all of our work but make it available for free to the public 
& in the hope of promoting standardization of Vietnamese computing. 
& We are happy to do this, though we do incur out-of-pocket expenses to buy 
& compilers, books, tools, etc.
+
+ If you like what we are doing and would like to contribute either your expertise, 
& time, or money to help cover expenses, please contact us at Winvnkey-users@lists.sf.net  
& (trichlor.sf.net, http://winvnkey.sf.net).
+
+ We don't as yet have a checking account.  So for now please make your check payable to:

;===================
TriChlor=The TriChlor Software Group was formed in 1992 by volunteers who were devoted
& to integrating Vietnamese to existing computing environments.
+
+ The group has developed and distributed for free quality utilities, codes, libraries to support the
& VISCII character set (VIetnamese Standard Code for Information Interchange), which was
& designed by the Vietnamese StandardizationWorking Group (vietstd.sf.net) in 1992. 
& TriChlor members are spread world wide and communicate via TriChlor's private mailing
& list (see address below). This is where we can be contacted if you would like to pitch in
& and help.
+
+ TriChlor membership is normally extended by invitation to those who support the VISCII standard
& and have demonstrated significant contributions to TriChlor cause.
+
+ Contact:
+              The TriChlor Software Group:
+              Address: 3225 Delta Road, San Jose, CA 95135, USA
+              Email: Winvnkey-users@lists.sf.net  
+              Web site: trichlor.sf.net
+

;=============
VISCII=VISCII stands for VIetnamese Standard Code for Information Interchange, an 8-bit
& code standard for encoding Vietnamese characters proposed by the Viet-Std group
& (Vietnamese Standardization Working Group) in 1992. It has been implemented in
& many computing platforms, such as DOS, Windows, Unix, Linux, X-Windows, Mac, ....
+
+ See formal document at vietstd.sf.net.
+

;====================
VIQR=VIQR stands for VIetnamese Quoted-Readable, which is a convention to
& write Vietnamese letters using 7-bit ASCII. This convention arises from the need
& to exchange Vietnamese messages in 7-bit environments such as email or the
& soc.culture.vietnamese newsgroup in the Internet. For this reason VIQR is also
& known as Vietnet convention.
+
+ The Viet-Std Group formally finalized the VIQR convention in 1992 (see vietstd.sf.net).
& As an introduction, consider this message written in the VIQR convention:
+
+             To^i ye^u tie^'ng nu+o+'c to^i tu+` khi mo+'i ra ddo+`i\.
+
+ It can be seen that the intent is to represent Vietnamese diacritical marks (da^'u phu.) 
& as ASCII characters that suggest the shape of the original accents or tonemarks.
+

;==================
Copyright=Permission granted to use, copy, and distribute for free without disassembly
& or changes.
+
+ WinVNKey is provided without express or implied warranty.
+
+ VISCII and VIQR are Vietnamese character sets proposed by the Vietnamese
&  Standardization (Viet-Std) Working Group (vietstd.sf.net).
+
+ VPS is a Vietnamese character set proposed by the Vietnamese Professional
& Society (www.vps.org).
+
+ VNU is a Vietnamese character set proposed by VNU.
+
+ VNI is a Vietnamese character set proposed by VNI (www.vnisoft.com)
+


[Page Surrogates]

A1=Requirements to display surrogate characters (U+10000 or greater):



B1=Enable Windows to process surrogate characters

B2=This means setting SURROGATE registry value to 2.

C1=Fonts for Internet Explorer to use when characters are surrogates

C2=Fixed font
C3=Proportional font

D1=Optional fallback fonts for Windows XP or later

D2=When a surrogate character is not found in the Unicode font you are using,
& Windows will use the following fallback font if specified:

D3=For characters in
D4=Use fallback font

Help-ProportionalFont=Select a proportional font that
& has Unicode surrogate characters such as "SimSun (Founder Extended)" or "HAN NOM B".
+
+

Help-FixedFont=Select a fixed font that
& has Unicode surrogate characters such as "SimSun (Founder Extended)" or "HAN NOM B".
+
+



Help-Plane=Plane 2 contains about 42 thousand Hán Nôm characters that are
& surrogates (double Unicode characters).
+
+

  

Help-PlaneFont=You should choose a font that supports Unicode surrogate characters in this plane.
+
+ For instance, for Hán Nôm characters in Extension B (Plane 2), you can choose 
& "SimSun (Founder Extended)" or "HAN NOM B".
+
+

Help-Default=Your system does not have surrogate font "HAN NOM B."
+ Do you want to get help in downloading it?
+


[ComboHelp-SurrogateFonts]
topic1=Notes on surrogate fonts
topic1.help=Note that font "Arial Unicode MS" contains characters under 64K in values only.
& Hence it cannot be used to display surrogate characters.
& There are currently two sets of fonts that support Hán Nôm surrogate characters that
& the WinVNKey author is aware of:
+
+ 1) Commercial Font "SimSun (Founder Extended)" [filename: SURSONG.TTF, 41 MB compressed]
+     This commercial font has about 65,000 Chinese characters in Unicode 3.1.
& It covers Hán characters in Unicode Extension B but lacks significant number of Nôm characters.
& It is included with the Microsoft Office XP Proofing Tools CD (version 2002). 
& It also comes with Chinese editions of Office XP.   Although the font is commercial,
& you can search for "sursong.ttf" on www.google.com and may find a site to download.
+
+ 2) Free Font "HAN NOM B" 
+     This font has a complete list of Nôm characters in Unicode 4.0 in addition to Chinese characters.
& It was designed by a group of Vietnamese in Vietnam and overseas and was released in a zip package
& that consists of two fonts as follows:
+      - HAN NOM A  -- containing Hán Nôm characters in Extension A (single Unicode characters, 
& code value is expressible in U+xxXX format with at most 4 hex digits).
& Thus this font is similar to "Arial Unicode MS" as far as Hán Nôm characters go.
& But it has more Han Nôm characters and less other national characters than  "Arial Unicode MS".
+
+      - HAN NOM B  -- containing Hán Nôm characters in Extension B (surrogate characters,
& i.e., double Unicode characters or characters expressible in U+2XXxx format
& with at least 5 hex digits).
+
+ Actually, the group released two packages, one for high resolution and one for low resolution.
& You should first try the high resolution version.  If the display does not come out well, 
& then try the low resolution version.  
+
+ The zip packages are available at:
+
+     http://sf.net/project/showfiles.php?group_id=41991
+
+ Or you can use these links to download directly:
+
+  a)  hannomH.zip (high resolution, 27 MB)
+       http://prdownloads.sf.net/vietunicode/hannomH.zip?download  
+
+  b) hannom.zip (low resolution, 19 MB)
+        http://prdownloads.sf.net/vietunicode/hannom.zip?download  
+
+ These fonts are also available in exe format for automatic installation:
+
+     http://sf.net/project/showfiles.php?group_id=39420
+
+ Specifically
+
+     http://prdownloads.sf.net/winvnkey/HiRes-Hannom-A.exe?download
+     http://prdownloads.sf.net/winvnkey/HiRes-Hannom-B.exe?download
+     http://prdownloads.sf.net/winvnkey/LowRes-Hannom-A.exe?download
+     http://prdownloads.sf.net/winvnkey/LowRes-Hannom-B.exe?download
+

topic1.link3.label=Visit Han Nom font site at vietunicode.sf.net
topic1.link3.url=http://sf.net/project/showfiles.php?group_id=41991

topic1.link2.label=Download font Arial Unicode MS (14 MB)
topic1.link2.url=http://www.star-italia.net/home/download/aruniupd.exe 

topic1.link1.label=Download fonts Han Nom A, B at winvnkey.sf.net
topic1.link1.url=http://sf.net/project/showfiles.php?group_id=39420 


[Tool Tips]
A1=Click to see explanation
A2=Click here to change font
A3=Click here to change font for input box
A4=Click here to change font for output box
A5=Click here to change font for list box
A6=Click here for more information




[Change Warning]

A1=Any change you make to this page will become effective immediately.
& You may want to save this page under a different name before
& making a change.  This can be done as follows:
+     - click on the downward arrow at the top button
+     - select the "Save As" menu.
+

A2=Any change you make to this table will NOT
& become effective until you click the Save button.
& Clicking the Save button will force changes to take effect
& and also save changes to disk as well.
+
+

[File Warning]
A1=File Not Saved Yet!
A2=File has not been saved!
A3=Do you want to save it now?

A4=Replacement table "XX" will be deleted.
+ Are you sure?

A5=Could not delete table "XX"
A6=because the file is read-only.
A7=because the file was not found.

A8=File was deleted successfully.
A9=File XX already exists.
+ Do you want to overwrite it?

B1=Create New Table
B2=Enter new table name (replace the three dots):
B3=Table name is empty.
+ Please enter again.



[Help Titles]
Charset Help=
Keyboard Mode Help=
Hot Key Help=
Help=
Info=

Vietnamese Currency Symbol=
Common Mark Help=
Erase Accent Mark=
Bind Accent Mark=
Retrieve Accent Mark=
Escape Character=
Delayed Echo Mode=
How to change font?=

Help on accent mark toggling=
Help on reset a Viet word=

Conversion Status=
Update Progress=
Detailed Conversion Status=

[Dialog New Name]
Naming Typing Method=
Naming Viet Option Page=
Set File Info=Set File Information

[ComboHelp-HanNom]
title=Help on Han Nom
topic1=1. Where to download Han Nom fonts?

topic1.help=There are a few free Han Nam fonts that are downloadable from the Internet.
+
+        1. Microsoft font "Arial Unicode MS" (Aruniupd.exe, 14 MB).
+            Download:  http://www.star-italia.net/home/download/aruniupd.exe
+
+        2. Fonts "HAN NOM A" and "HAN NOM B", which are packaged together in HannomH.zip
& (27 MB, high resolution) or Hannom.zip (19 MB, low resolution). 
+            Download:  
+                - http://prdownloads.sf.net/vietunicode/hannomH.zip?download  
+                - http://prdownloads.sf.net/vietunicode/hannom.zip?download  
+
+        
+ Font "Arial Unicode MS" contains Han/Nom and Latin-based characters
& less than 64K in values, i.e.,  Unicode
& characters expressible as U+xxxx where there are at most 4 hex digits following the plus sign.
+
+ Font "HAN NOM A" contains the following Han/Nom characters (less than 64K in values):
+       Radicals Supplements [u+2F00 – u+2FD5 (214 glyphs)] 
+       CJK Unified Ideographs Extension A [u+3400 – u+4DB5 (6572 glyphs)] 
+       CJK Unified Ideographs [u+4E00 – u+9FA5 (20,832 glyphs)] 
+       Private Use Area [u+E000 ... (glyphs temporarily used by the Dictionary compilers team)] 
+
+ Font "HAN NOM B" contains Han/Nom surrogate characters in Unicode Extension B
+       CJK Unified Ideographs Extension B [u+20000 – u+2A6D6 (42,702 glyphs)] 
+       Fillers used by font designers on purpose [u+2A6D0 ...] 
+
+ These characters are greater than 64K in values, i.e., 
& they are expressible as U+xx..xx with 5 or
& 6 hex digits following the plus sign.
+
+ It is generally good to install 3 fonts: Arial Unicode MS, HAN NOM A, and HAN NOM B.
& Font "Arial Unicode MS" has lots of characters from many languages but lacks
& all Han/Nom characters in Extension A and B.  Therefore you need to
& download HAN NOM A and HAN NOM B.   
& Always try the high resolution version first.  If the installation
& fails because your Windows does not recognize the high resolution font, you
& then try the low resolution version.  If you install both the low and high resolution versions together,
& the latter version will replace the first.
+
+ Because the fonts HANNOM A/B are large, if you can afford downloading one package, you
& should choose the high resolution version. 
+
+ You can click on the hyperlinks below to download the fonts.
+



topic1.link3.label=Download Arial Unicode MS (aruniupd.exe)
topic1.link3.url=http://orwell.ru/download/aruniupd.exe

topic1.link2.label=Download Hannom.zip (low resolution)
topic1.link2.url=http://prdownloads.sf.net/vietunicode/hannom.zip?download

topic1.link1.label=Download HannomH.zip (high resolution)
topic1.link1.url=http://prdownloads.sf.net/vietunicode/hannomH.zip?download

topic2=2. How to type a Han Nom character using Vietnamese pronunciation?
topic3=3. How to type a Han Nom character using a Unicode value?
topic4=4. How to type a Han Nom character using Pinyin pronunciation?
topic5=5. How to type a Han Nom character using the four corner index method?
topic6=6. How to type a Han Nom character using the Cangjie method?

topic7=7. How to choose a Han Nom font?
topic8=8. How to set up surrogate fonts?
topic9=9. Why do I see two empty boxes instead of a single Han/Nom character?
topic10=10. Why does the Han Nom character go to a wrong Window when I click on it?
topic11=11. What do the different character colors mean?
topic12=12. Can I right click on each character?
topic13=13. What about Chinese font "SimSun (Founder Extended)"?

topic2.help=You need to know how to type Latin-based Vietnamese (chữ Quốc Ngữ) 
& in order to produce Hán Nôm characters.  
+
+ Note that unlike standard Hán Nôm IME's, WinVNKey requires you type DIRECTLY
& in your applications, such as MS Word, Wordpad, Notepad, etc.  There is a combobox
& entitled "Recall typed word" on the Han Nom Manager dialog. But it is not for typing.  It is
& for saving Vietnamese words that you already typed in your applications. 
+
+ In the following we will present two methods for Hán Nôm entry:  single character entry
& and compound character entry.  
+
+ A.  SINGLE HÁN NÔM CHARACTER ENTRY
+ ---------------------------------------------------------------
+                
+ 1. Look at the combobox just below the "Options" button.
+     Click on the arrow to the left of the combobox to display a dropdown menu with checkboxes such as
+                  [ ] 1. Type Chinese by Vietnamese ...
+                  [ ] 2. Type Nôm by Vietnamese ...
+                  [ ] 3.  etc
+                  
+ 2. Check one of more checkbox(es) depending on what you want to type (Chinese, Nôm, etc).
& The following examples assume you enable the first checkbox (i.e., typing Chinese).
+
+ 3. Open Microsoft Word (or any word processor, e.g., Notepad or Wordpad).  All the examples
& below assume you use MS Word.
+
+ 4. Type a Latin-based Vietnamese pronunciation, say, tam
+
+ 5. Then type XXX  immediately after tam, i.e., tamXXX.  This prompts the
& Han Nom Manager to display all Hán Nôm characters that are pronounced as "tam" in
& Vietnamese.  All these characters are labeled with 1, 2, 3, ..., 9, a, b, c, ..., A, ..., Z as follows:
+
+           1. 三
+           2. 仨
+           3. 叁
+           4. 参
+           5. 參
+           6. 叄
+           7. 弎
+           8. 毵
+           9. 毿
+           a. 犙
+           b. 蔘
+           c. 鬖
+           d. 〣
+
+     Note: If you cannot see the Chinese characters listed above, please right click on this page to display
& a menu to change font.  You can select font Arial Unicode MS or HANNOM A.
++ 6. Suppose you want the first character, which is labeled with "1".  To select this character,
& you can click on it or just type the single character label, 1,  immediately after XXX, i.e. "tamXXX1".
& The first character 三 will replace the sequence "tamXXX1" in MS Word.  If you see
& a square appear, it is likely because the font selected in MS Word is incorrect.
& You should try one of these fonts:
+             - Arial Unicode MS
+             - HANNOM A
+             - HANNOM B
+ or any other Han Nom font you may have.
+
+ The character XXX behaves like a command and is called a Han Nom selector 
& because it helps users select a Han Nom
& character.  You can change this character from the "Setup Hán-Nôm" menu.
+
+ If you want "XXX" to appear as is, just precede it with an escape character.
& For instance, if you type "tam\XXX1", you will get "tamXXX1" as is, not
& the first Han Nom character in the list.
+
+ NOTE
+
+ If you want to select all Han Nom characters at once, you can type = or | immediately after
& XXX.  
+    - type = if you want all characters to appear horizontally in your application (e.g. tamXXX=)
+    - type | if you want all characters to appear vertically in your application (e.g. tamXXX|)
+    - or you can right click on the Vietnamese word, which is always labeled as "0", and
& then choose the menu "Select All".  This will paste all the characters horizontally in your application.
+
+
+ B.  COMPOUND HÁN NÔM CHARACTER ENTRY
+ --------------------------------------------------------------------
+
+ The single Hán Nôm character entry is inconvenient in that the resulting list may be very long and
& users have to scroll the list several times to find the correct character.  For example,
& there are 40 Hán characters that read "anh" in Vietnamese, 110 that read "tư".
& But if limited in the context of "anh hùng" or "tư nhân", the number of Hán characters
& that read "anh" or "tư" must be sharply reduced.
+
+ To this end WinVNKey supports compound Hán Nôm character entry method.
& Before delving into this, you have to adjust WinVNKey as follows:
+
+      a) From the Hán Nôm "Options" button, choose the following menu:
+                "Display characters and pronunciation"
+          Note that you can resize the Han Nom Manager dialog to accommodate the display of
& both Hán Nôm characters and their pronunciations.
+
+      b) From the Main page, choose the following Viet Option page:
+                "7. Multi-Syllable with free marking (Type mark anywhere & Combine with last syllable)"
+          This choice allows you to type multisyllable words such as Inđônêxia or coalesced
& Vietnamese words such as anhhùng, danhnhân, etc.
+
+ The compound Hán Nôm character entry method can be broken down in two cases as follows:
+
+ B1. Complete compound entry
+ ---------------------------------------
+ All Vietnamese pronunciations must be coalesced into a single token as if it were a multi-syllable word,
& such as anhhùng, danhnhân, tưnhân.  You then treat it as a single word and type XXX at the end
& as usual.  For instance,
+           - type anhhùng/
+           - type tưnhân/
+
+ Note that WinVNKey has an internal dictionary that has a limited number of Hán Nôm compound characters
& (see more info from this menu: Options | About | Han-Viet.dat).  Thus if you do not see the correct
& characters listed, you have to fall back to the single Hán Nôm character entry.
+
+ B2. Partial compound entry
+ -----------------------------------
+ This method allows you to type just the beginning part of the coalesced Vietnamese pronunciation words
& and use the symbol = or * to represent the rest.  For example,
+       (a) Type tưnh=/
+             You will see the following Hán Nôm character compounds appear together with their pronunciations:
+                    私人    tư nhân
+                    滋潤    tư nhuận
+
+      (b) Type tưnh*/
+             You will see the following Hán Nôm character compounds appear together with their pronunciations:
+                    私人    tư nhân
+                    滋潤    tư nhuận
+                    四眼    tứ nhãn
+                    四一    tứ nhất
+                    .....................
+                    慈忍    từ nhẫn
+                    .....................
+                    自然    tự nhiên
+
+
+ 1)  When to use the equal sign?
+ ------------------------------------------
+
+      The equal sign means exact matching.  You should use the equal sign when you want to list all
& compounds whose coalesced pronunciation writings have their first part match exactly with the specified string.
+
+ In example (a) above, all listed pronunciations(e.g., tư nhân, tư nhuận), when writing without spaces, have their beginning
& part match exactly with "tưnh".  You do not see "tứ nhãn" because the starting part, tứnh, does not match
& exactly with tưnh.
+
+ 2) When to use the asterisk?
+ --------------------------------------
+
+  The asterisk represents all the remaining accent marks and letters that you do not want to type.
& Thus you should use the asterisk if you do not want to type all the marks of the first part and/or
& the letters of the trailing part.
+
+ In example (b) above where you typed "tưnh*", the asterisk represents all the marks that can go
& with "tư" as well as all the characters that can follow "nh".   Thus you see all Hán Nôm compounds
& with pronunciations starting with "tư nh", "tứ nh", "từ nh", "tự nh".
+
+ Another way to understanding "tưnh" is to read as follows: "tưnh*" means all strings
& that contain "tưnh".
+ 
+ To this end the multi-syllable word is converted to the VIQR writing style,
& then all diacritical marks in the order from left to right are moved to the end of the word.
& For example,
+
+      (a)  tưnhân  =>  tu+nha^n  =>  tunhan  and   ^^
+      (b)  tứnhãn  =>  tu+nha~n  =>  tunhan  and  +~
+      (c)  tựnhiên =>  tu+.nhie^n =>  tunhien  and  +.^
+      (d)  tưnh     =>  tu+nh        =>  tunh  and  +
+
+ Let's look at the last sequences on lines (a), (b), (c) and compare them with (d).  It can be seen that
+       - the alphabetical parts of (a), (b), (c) contain the alphabetical part of (d), i.e., tunh
+       - the diacritical parts of (a), (b), (c) contain the diacritical  part of (d), i.e., +
+
+ Thus, "tưnh*" can be understood as all strings that contain "tưnh".  This VIQR interpretation
& is also the algorithm used in WinVNKey to handle the asterisk.
+
+
+  


topic3.font=Arial Unicode MS
topic3.help=If you know the Unicode value of a Han/Nom character, you can type it directly
& and WinVNKey will convert it into character for you.
+
+ Let's look at the Hán character U+4E09 (pronounced tam in Vietnamese).
+ When the Han Nom Manager is running, if you type in Notepad, Wordpad, Word, etc
+              0h4E09XXX
+ you will see the Hán character  三  (displayable in font "Arial Unicode MS" or "HAN NOM A".
& If you don't see this character, right click inside this dialog and change font).
+
+ So the rule is to type three parts:
+         - a prefix 0h
+         - Unicode value
+         - a Han Nom selector character XXX
+ This method works as long as the Han Nom Manager is running.
+
+ Note there are many ways to type a code value and have WinVNKey convert to
& a character:
+       - go to the "Advanced" control panel
+       - enable the checkbox for "Change certain numbers to characters"
+       - click on the corresponding ">>" button to set up your prefix and suffix for different type of Unicode values.
+

topic4.font=Arial Unicode MS
topic4.help=You need to know how to type Latin-based Pinyin  
& in order to produce Hán characters.  
+
+ Note that unlike standard Hán IME's, WinVNKey requires you type DIRECTLY
& in your applications, such as MS Word, Wordpad, Notepad, etc.  There is a combobox
& entitled "Recall typed word" on the Han Nom Manager dialog. But it is not for typing.  It is
& for saving Pinyin words that you already typed in your applications. 
+
+ If you have not read help topic #2 entitled:
+
+       "2. How to type a Han Nom character using Vietnamese pronunciation?"
+
+ you should read it now because the procedure and usage is almost identical.
+
+ Sample Usage:
+ --------------------
+
+ a) Suppose you have chosen the following typing method (click the combobox just below the Options button):
+
+                 6. Type Traditional/Simplified Chinese by Pinyin followed by /
+
+ b) Open MS Word (or Wordpad, Notepad, etc) and type the following Pinyin pronunciation followed by XXX
& (type directly in MS Word):
+         fang4XXX
+
+     This will list the following Hán characters in the Hán Nôm Manager dialog:
+         1. 放
+         2. 
紡
+         3. 
趽
+         4. 
邡+         5. 䢍
+         6. 
𨾔+ 
+ If you want to choose any character, just type its label immediately after XXX.  In other words,
& you should type fang4/1 to obtain 放, fang4/2 to obtain 紡.  Alternatively, you can simply use the mouse
& to click on the character you want.
+
+ c) You can also type Pinyin words together (without spacing) as if it were a multisyllable word.
& For example, type
+        fan3she4/ 
+ to list 反射.  You may want to display the Pinyin pronunciation next to the Hán characters
& by enabling the menu:
+                     Options | Display characters and pronunciation
+
+ Note that the dialog can be resized to accommodate the display of characters and pronunciation.
+
+ d) At the present time (WinVNKey version 5.4.445) WinVNKey has not offered pattern matching
& for Pinyin yet.  Thus you cannot use symbols = and * as defined for typing Hán Nôm
& characters by Vietnamese pronunciation.
+
+

topic5.link2.label=Four corner method as explained in Wikipedia.
topic5.link2.url=http://en.wikipedia.org/wiki/Four_corner_method
topic5.link1.label=Listing of four corner indices and Hán characters
topic5.link1.url=http://en.wiktionary.org/wiki/Wiktionary:Chinese_four_corner_index
topic5.font=Arial Unicode MS
topic5.help=The four corner index method is described here:
+          http://en.wikipedia.org/wiki/Four_corner_method
+
+ 1.  Background information
+ ------------------------------------
+
+ This method attempts to characterize each Chinese character by a 4-digit number where
& each digit represents the shape of a corner.  A variant of this method adds a fifth digit, which
& describes an additional corner.
+
+ The following website
+          http://en.wiktionary.org/wiki/Wiktionary:Chinese_four_corner_index
+
+ provides a list of 5-digit indices and the corresponding Han characters.  Below is an excerpt:
+
+           00104: 主, 壅, 童 
+           00106: 亶 
+           00107: 亹, 斖, 衁 
+           00108: 立 
+           00109: 鏖 
+           00111: 庛, 疕, 疘, 疪, 疵, 痄, 症, 痙, 痱 
+           00112: 痝, 瘥 
+           00113: 瘣 
+           00114: 疣, 疰, 痊, 痤, 痲, 痽, 瘞, 瘧, 瘽, 癃, 癰, 癱 
+           00116: 疸 
+           00117: 疙, 疤, 疶, 疽, 瘋, 瘟, 癙 
+           ......................
+           40104: 圭, 坴, 奎, 桽, 臺 
+           40107: 壺, 壼, 查, 盍, 盔 
+           ......................
+           99901: 禜 
+           99903: 縈 
+           99904: 榮 
+
+ 2. How to type Hán characters using the four-corner index method?
+ --------------------------------------------------------------------------------------
+
+ You must type directly in your application such as MS Word, Wordpad, Notepad, etc.
& You can simply type the leading 4 digits or a complete 5-digit string followed by XXX.
& For example, you can type
+          00107XXX
+ which will display the following list of Hán characters:
+          1. 亹
+          2. 斖
+          3. 衁
+
+ To select a character, you can simply type its label immediately after XXX.
& For example, type 00107XXX2 to get 斖.
+ Or you can use the mouse to click directly on the character.
+
+ 3. How to update the database?
+ -----------------------------------------
+
+ Please click on the following menu:
+              Options | About | Han-4corner.4ci
+
+ to see how to update the source files from the web and rebuild the database.
+
+

topic6.link2.label=Cangjie input method as explained in Wikipedia.
topic6.link2.url=http://en.wikipedia.org/wiki/Cangjie_method
topic6.link1.label=Open source file Cangjie.txt
topic6.link1.file=HanNom\Han-Cangjie\Cangjie.txt
topic6.font=Arial Unicode MS
topic6.help=The Cangjie input method is described here:
+          http://en.wikipedia.org/wiki/Cangjie_method
+
+ 1.  Background information
+ ------------------------------------
+
+ This method attempts to characterize each Chinese characters by its radicals, each of which
& is represented by an English letter.  As a result, each Chinese character can be represented
& by a sequence of one to five English letter.
+
+ The Cangjie representations of Chinese characters are provided in the Unihan database
& published by the Unicode Consortium.  WinVNKey has extracted all the Cangjie representations
& from this database and placed them in a plain text file
+            HanNom\Han-Cangjie\Cangjie.txt
+
+ Below is an excerpt from this file:
+           U+3400	TM
+           U+3401	MOW
+           U+3402	PPP
+           U+3403	OML
+           U+3404	JV
+           U+3405	K
+           U+3406	HSMS
+  
+ The first column is the Unicode values, the second column is the Cangjie representations.
+
+
+ 2. How to type Hán characters using the Cangjie input method?
+ --------------------------------------------------------------------------------------
+
+ You must type directly in your applications such as MS Word, Wordpad, Notepad, etc.
+ You simply type the Cangjie strings followed by XXX.  The string is case insensitive.
& For example, you can type
+          tlbkXXX
+ which will display the following list of Hán characters:
+          1. 英
+
+ To select a character, you can simply type its label immediately after XXX, i.e. type tlbkXXX1 to get 英. 
+ Or you can use the mouse to click directly on the character.
+
+ 3. How to update the database?
+ -----------------------------------------
+
+ Please click on the following menu:
+              Options | About | Han-Cangjie.dat
+
+ to see how to update the text source file with data from the Unihan database
& and rebuild the database.
+
+


topic7.help=a) For Han/Nom characters whose code values are under 64K (except U+Exxx)
+        1. Arial Unicode MS
+        2. HAN NOM A
+
+ b) For Han/Nom characters whose code values are U+Exxx (Private Use Area)
+        1. HAN NOM A
+
+ c) For Han/Nom characters whose code values are U+2xxXX:
+        1. HAN NOM B
+
+ d) For Han/Nom characters whose code values are U+FxxXX (Private Use)
+        1. HAN NOM A
+
+
+ The Han Nom Manager offers a menu to change these two types of fonts.
+
+ Note: There are many ways to find out the Unicode value of each character
& in the Han Nom Manager:
+
+      - Right click on the Han/Nom character see its U+ value.
+      - Select the menu "Display Unicode value next to character"
+


topic8=8. How to set up surrogate fonts?
topic8.help=Surrogate characters are double Unicode characters.  
& You can recognize them easily if you don't have surrogate fonts installed because each surrogate character
& appears as two empty square boxes.  If you right click on the surrogate character in the Han Nom Manager,
& you will see its value listed as U+2xxXX with 5 hex digits following the plus sign.
+
+ After you downloaded and installed surrogate fonts successfully, you need to set up your
& Windows registry so that the fonts can be used.  WinVNKey offers a dialog to help you:
+      - Click on "Run" button from the main control panel
+      - Select "Preferences"
+      - Click on the "Surrogate Fonts" tab.
+      - Click on the "Default" button
+
+ When you click on the "Default" button, WinVNKey will change the registry so that
+      - all characters in Plane 2 (U+2xxxx) will use font "HAN NOM B"
+      - all characters in Plane F (U+Fxxxx) will use font "HAN NOM A"
+
+ Please click on hyperlink for detailed explanation.
+
topic8.link1.label=Set up surrogate fonts in Windows registry
topic8.link1.html=SetupSurrogateFonts.html

topic9.help=This happens because
+   1. the Han/Nom character is a surrogate character (double Unicode), and
+   2. your Windows registry was not set up to handle surrogate characters.
+
+ Surrogate characters are supported in surrogate fonts such as "HAN NOM B".
& See topic 1 for more information.
+
+ You can set up your Windows registry to tell Windows to use a fallback font
& for surrogates if the current font does not have these characters.  This works
& for Windows XP.
+


topic9.link1.label=Set up surrogate fonts in Windows registry
topic9.link1.html=SetupSurrogateFonts.html

topic10.help=This happens when you switch from one application to another and you have
& not typed any key in the new Window.
+
+ Normally the Han Nom Manager sends characters to the Window where you last
& typed in keystrokes.  While the Manager is displaying a list of Han Nom characters,
& if you switch to another Window, you should type some key in that Window before
& clicking on a Han Nom character.   
+
+ The simplest way is to press and release a CTRL key because it does not
& leave any character in the new Window.
+

topic11.help=The color is meant to tell about the type of a Han Nom character.  It depends on
& the list of characters in the Han Nom Manager.
+
+         - black: for character codes less than 64K (U+xxXX format except U+Exxx)
+         - pink: for characters in Private Use Area (U+Exxx format)
+         - blue: for surrogate characters U+2xxXX (Extension B)
+         - red: for surrogate characters U+FxxXX (Private Use Plane)
+         - If you select or click on a character, that character will turn into green
+
+


topic12.help=You can right click on each character in the Han Nom Manager to see its property.
& You can even right click on the Vietnamese word label "0" to see  a summary.
+

topic13.help=Font "SimSun (Founder Extended)" [filename: SURSONG.TTF, 41 MB compressed]
+
+ This is a commercial, not free, Hán font, which has 
& about 65,000 Chinese characters in Unicode 3.1.
& It covers Hán characters in Unicode Extension B but lacks significant number of Nôm characters.
& It is included with the Microsoft Office XP Proofing Tools CD (version 2002). 
& It also comes with Chinese editions of Office XP.   Although the font is commercial,
& you can search for "sursong.ttf" on www.google.com and may find a site to download.

topic13.link1.label=Search for "sursong.ttf" on www.google.com
topic13.link1.url=http://www.google.com/search?hl=en&q=sursong.ttf&btnG=Google+Search


[Convert VIQR Source]

A1=When converting a VIQR text file, WinVNKey will do as follows:
A2=A. Use accent mark convention in typing method #5 (VietNet)
A3=B. Use options 3, 4, 5, 6 of the following Viet Options Page:
A4=C. For periods following a vowel at end of sentence
A5=D. For question marks following a vowel  at end of sentence
A6=E. Always combine for sequences of upper case letters
A7=F. Join words that are split at ends of lines

Help-Surrounding=Sometimes a word itself cannot provide enough information to
& determine if an ending dot or question mark is a punctuation mark or an accent mark.
& In this case it may be necessary to check the surrounding words.
& Consider these examples:
+
+      a) Anh ddi dda^u?
+                - the question mark is a true punctuation because đâủ is illegal
+      b) Con nho+' me.
+                - the dot is ambiguous because both mẹ and me make sense
+      c) Con nho+' me.  Con xa nha` dda~ la^u ro^`i
+                - the dot after me is a true punctuation because "me" is lowercase
& and the next word Con is capitalized at the first letter.
+      d) Chuye^.n Mu`a Thu.   Tha^.t hay qua'
+               - the dot after Thu is ambiguous because both Thu and Tha^.t are
& capitalized at the first letter only.  Of course our brain can identify it as a punctuation
& but it is very hard to put this intelligence into WinVNKey.
+      e) Tu+. DDie^?n Vie^.t Nam
+               - the dot after Tu+ is ambiguous because both Tu+ and DDie^?n are
& capitalized at the first letter only.  Of course our brain can identify it as an accent mark
& but it is very hard to put this intelligence into WinVNKey.
+
+
+ Case (c) usually happens in normal text when the last word of a sentence
& has a single vowel and that vowel is also the ending letter of the word.
& For example, me., chi., la., le., ha., ho., co?, ddo?, to?, etc.
+
+ Cases (d) and (e) usually happen
+       - in proper names like DDoa`n Thi. DDie^?m (the dot is ambiguous)
+       - in titles and subtitles, chapters, sections, etc like "Li.ch Su+? Vie^.t Nam" (the
& question mark is ambiguous), "Mu`a Ha. No'ng Bo?ng" (the dot is ambiguous).
+
+ You can ask WinVNKey to check surrounding words when a mark is ambiguous
& by checking the box for
+
+            Check surrounding words (lower/upper, ending paragraph, ...)
+
& If checked, WinVNKey can resolve ambiguity in examples (c), (d), and (e)
+ with a high rate of success.  If the output text does not look correct, you
& can always uncheck the box and reconvert the text.
+

Help-UpperCaseSequence=Many sequences of upper case Vietnamese letters are not pronounceable
& because they are abbreviations such as ÐH (Ðại Học), which appears as DDH in VietNet convention.
& When you convert from VietNet to true Vietnamese, 
+     (1) DDH gets converted to ÐH if you choose Viet Option 0 (No Smart)
+     (2) DDH is left unchanged if you choose other smart Viet Option pages because DDH is not
& a pronounceable Vietnamese word.  However, if you turn on the checkbox
+
+      Always combine for sequences of upper case letters
+
+ then DDH will get converted to ÐH.
+
+

Help-JoinSplitWords=Many VIQR words can be inadvertently split at the ends
& of lines.  This can happen if the VIQR text is formatted to limit to 70 to
& 80 characters per line.  For example, this problem can be seen in
& VIQR text sent through email or posted in news groups such as
& http://groups.google.com/group/soc.culture.vietnamese.
+
+ Occasionally you may see lines split as follows:
+
+ To^i ye^u tie^'ng nu+o+'c to^i tu+ khi mo
+ +'i ra ddo+`i.
+
+ When you see these word breaks happen to your text, you can 
& turn on option F to rejoin the split words for you.
+
+

[Dialog Retyping]

Help-Retyping=You are using a special feature of WinVNKey to convert text written in Telex, VIQR,
& VNI, VPS, or Microsoft, etc to any character set.  
+
+ Suppose you want to convert text written in "XXX" to "YYY".  There are two ways to accomplish this.
+
+ 1) Retype source text by yourself:  You should set up the keyboard on the Main Page as follows:
+         - Typing Method:       "TTT"
+         - Viet Option Page:    "0.  No smart"
+     Then retype the entire source text, character by character.
+
+ 2) Have WinVNKey automatically retype source text for you.
+     To this end, you should set up as follows:
+        -  Choose source charset:   "SSS"
+        -  On this dialog, choose Viet Option Page:        "0. No smart".
+     This will force WinVNKey to perform conversion by retyping each and every character in the source text
& and saving the output in the destination file (or clipboard, depending on what you chose).
+
+ Notes on automatic retype method:
+     a) You can choose another smart Viet Option page to correct spelling in the source text.
+     b) The retyping does not use macros.  If the source text contains macros and you
& want to expand them, you need to choose source option: 
+          "200. Use typing method, Viet option page, and macros on Main page"
+
+ Then WinVNKey will use the settings in the bottom three comboboxes for automatic retyping:
+               - Typing Method
+               - Viet Option page
+               - Macros
+


[ComboHelp-ConvertToVIQR]

title=VIQR Output Methods
topic1=VIQR Output Methods
topic1.help=How to choose a VIQR output method?
+ =============================
+
+ The VIQR output method is specified on the Main control panel.
& Open the Main control panel and remember the current character set.
& Now temporarily switch the "Charset" combobox to "3. VIQR (VietNet)",
& then select your desired method in the "Output Method" combobox.
& That's all.  But you have to restore the "Charset" combobox to its original character set.
+
+
+ About three VIQR output methods
+ =========================
+
+ There are three ways to convert a text file in true Vietnamese 
& to VIQR (or VietNet) format.
+
+   1. Friendly VIQR - Don't add \ to output
+       e.g.   Chuye^.n Mu`a Thu.   Con nho+' ba me.  Con xa nha` dda~ la^u ro^`i.   
+
+ This method can lead to ambiguity in the output text.  It is up to the reader
& to decide the meaning from the context.  But clearly the output text is easy
& to read.
+
+   2. Standard VIQR - Add \ between vowel and punctuation mark
+       e.g.   Chuye^.n Mu`a Thu\.   Con nho+' ba me\.  Con xa nha` dda~ la^u ro^`i\.   
+
+ In this method WinVNKey ALWAYS adds a backslash between a vowel
& and a punctuation mark even if the mark clearly cannot combine with
& the vowel as in the case of "rồi."   The additional backslashes make the output
& text difficult to read but the meaning is always clear.
+
+   3. Smart VIQR - Add \ if really needed
+       e.g.   Chuye^.n Mu`a Thu\.   Con nho+' ba me.  Con xa nha` dda~ la^u ro^`i.
+
+ In the smart VIQR output method, WinVNKey recognizes
& that there is no such word as "rồị".   
& Hence it will leave the dot alone without adding a backslash.   It also recognizes
& the dot ater "me" is really a punctuation mark because
+       - the word "me" is lower case
+       - the next word, "Con", is capitalized at the first letter only.
+ In general, it will not output
& an additional backslash between a vowel and a mark if it can
& identify that the mark is really a punctuation mark, not a tonemark.
& Thus this method combines the advantages of both methods 1 and 2.
+

topic1.link1.label=Read more about VIQR convention at Vietstd.org
topic1.link1.url=http://vietstd.sf.net

[GetChar Dialog]
A1=Enter character code (in hex)
A2=Example
A3=XXX is invalid.  You must enter hex digits 0...9 and A...F only.

[ComboHelp-NewRelease]

A1=New WinVNKey version XXX is available
A2=New Service Patch XXX is available

A3=Although your current WinVNKey has the same version XXX, it was released earlier (yyyymmdd) and
& contains a few bugs.  You should download the newer version, which was rebuilt on YYYYMMDD.

title=New software release
topic1=New Release
topic1.help=New WinVNKey version XXX was released on YYYYMMDD.
+
+ NOTE.
+
+ This dialog will show up each time WinVNKey is started until
& you update WinVNKey or click on the first link below.  If you don't want WinVNkey
& to check the Internet, click on the Run button => Preferences => Miscellaneous
& and then uncheck the first box.

topic1.link2.label=What's new?
topic1.link2.url=http://winvnkey.sf.net/whatsnew.html

topic1.link1.label=Goto WinVNKey homepage
topic1.link1.url=http://winvnkey.sf.net

[Page Miscellaneous]
A1=Choose a language:
+ Chọn một ngôn ngữ cho giao diện:
+

C1=Automatic Notification of New Version
C2=1. Enable automatic notification of new WinVNKey releases
C3=2. Run WinVNKey on Windows restart
C4=3. Hide WinVNKey dialog on startup
C5=4. Show Han Nom dialog on startup
C6=5. Clicking on WinVNKey icon on tray will toggle Viet/Literal modes
C7=6. Use Wordpad to display conversion result of plain text.
C8=7. Don't show WinVNKey tray icon (near the clock)


Help=WinVNKey can check the Internet for new releases on startup.
+ You can turn on/off this feature by clicking on 
+ the Run button => Preferences => Miscellaneous
+ and then check the first box.
+
+ You can turn on/off this feature by answering the question below.
+
+ Do you want WinVNKey to check the Internet on startup?
+

Help-ClickTrayIcon=CHANGE KEYBOARD STATE BY CLICKING TRAY ICON
+
+ When WinVNKey is running, you will see an icon appear on the tray in the status bar
& near the clock (at the bottom right corner of the screen).  This icon usually
& displays the letters "VN" in red color over a yellow background.
+
+ Normally, each left click on this icon will toggle the keyboard state of WinVNKey
& between 
+               0.  OFF  (icon displays a red STOP sign over a yellow background)
+               1.  Auto combine (icon displays "VN" in red over a yellow background).
+ This means as follows. If WinVNKey is in state (1), left clicking on the icon will
& switch WinVNKey to state 0 (OFF).  If WinVNKey is in state (1),  
& left clicking on the icon will
& switch WinVNKey to state 1 (auto-combine).
+
+ But if you want WinVNKey to switch to "Literal state" instead of "OFF",
& you can enable checkbox 5 on the Miscellaneous page.  Then,
& each left click on this icon will toggle the keyboard state of WinVNKey
& between 
+               1.  Auto combine (icon displays "VN" in red over a yellow background).
+               3.  Literal  (icon displays a red arrow penetrating a blue wall over a yellow background)
+
+ By the way, in the Literal state what you type is what you get except for a few special key sequences.
& Every keystroke is passed through unchanged, just like 
& an arrow that penetrates a wall and still emerges intact.
+

Help-UseWordpad=USE WORDPAD TO VIEW FILES AFTER CONVERSION
+
+ There are two methods that you can convert plain text from one character set to another:
+      (a) Use Plain Text Converter
+      (b) Use Mouse Converter
+
+ If you use method (a), click on the Run button | Converter | Plain Text.  In this convert dialog there
& are two "File" hyperlinks.  If you click on them, WinVNKey will 
& use, by default, Notepad to display the relevant files.
+
+ If you use method (b), you have to first select text, then type CTRL-C to copy,
& then press and release a CTRL key, then right click on the mouse to display a conversion
& menu.  If you choose menu E1 -- E4, the conversion result
& will be stored in a temporary file and WinVNKey will display it, by default, with Notepad.
+
+ If you turn on checkbox 6 on the Miscellaneous page, WinVNKey will use Wordpad instead
& of Notepad to display conversion result of plain text.
& The main advantage of using Wordpad is that it
& can wrap long lines to help you view the text easily.
+
+




[Dialog OverBackpacing]
A1=FIXING OVERBACKSPACING BUG
+
+ Typical bug:  type chà, but get cà, the letter h was erased.
+ This bug is called overbackspacing because WinVNKey 
+ overbackspaced and erased 'h'.   
+
+
+ You are currently running the following program:
+      Filename:  XXX
+      Location: YYY
+      Size:  ZZZ bytes
+
+ Do you have overbackspacing problem when typing accent marks
+ with this program?
+

A2=Do you want to fix the overbackspacing problems?
+


B1=FIXING OVERBACKSPACING
+
+ You are currently running the following program:
+      Filename:  XXX
+      Location: YYY
+      Size:  ZZZ bytes
+
+ When you type chà, do you see cà ?
+
+ If you answer yes, WinVNKey will fix this overbackspacing
+ problem for XXX. 
+

C1=FIXING UNDERBACKSPACING
+
+ You are currently running the following program:
+      Filename:  XXX
+      Location: YYY
+      Size:  ZZZ bytes
+
+ WinVNKey has been reducing backspacing for XXX.
+ This may have cause problem in typing accent marks.
+
+ When you type chà, do you see chaà ?
+
+ If you answer yes, WinVNKey will return to normal backspacing
+ for XXX. 
+

[Dialog Customization]
A1=You can customize or fix bugs for program XXX in folder:

B1=A. When typing characters in this program
B2=I want to use this specific keyboard mode:

C1=B. When typing Unicode using automatic output method
C2=I want to use this specific output method:

D1=C. Fix bugs specific to XXX
D2=1. Fix overbackspacing (type chà, but get cà)
D3=2. Fix multilined macros that appear on the same line

@H1=Overbackspacing bug when typing a Vietnamese diacritical mark
+
+ Symptom:  type chà, but get cà (letter h is missing)
+
+ Reason: XXX overbackspaced and erased letter h.
+
+ How to fix: enable the first checkbox and test again
+
+ After checking the checkbox, retype chà.  If you get chaà,
& it is a different bug. In this case,
& you should uncheck the box and report the bug to the author
& (hoc96@yahoo.com).
+

@H2=Multilined Macro Bug
+
+ Symptom:  You type a multilined macro but the macro expands into a single line.  You expect
& the text to appear in several lines instead.
+
+ Reason: XXX treats the carriage return differently.
+
+ How to fix: enable the second checkbox and test again
+
+
+ After checking the checkbox, retype the macro.  If the macro does not expand into
& several lines, try a different output method on Page Main.
& If it does not work at all for every outpu\t method, it is a different bug. In this case,
& you should uncheck the box and report the bug to the author
& (hoc96@yahoo.com).
+


B3=B. Fix overbackspacing problem

[Button ToolTip]
Click to reset Expand Type and Properties to default=

@B1=Click to append font names used in an RTF file, which you will specify, to column 1 of the table above
@B2=Click to insert a new row to the table above
@B3=Click to delete the row selected in the table above
@B4=Click to save the table to disk

[Context Converter]

Help-CharCase=There are two methods of converting character case of selected text in any applications as follows.
+
+ A) Mouse method: <CTRL> <Right Mouse>
+ ----------------------------------------------------------
+    1. Use mouse to select (highlight) text of interest
+    2. Press and release a CTRL key
+    3. Immediately after this CTRL key, click the right mouse to display the context conversion menu
+    4. Click on a conversion menu  (e.g. menu A1 to convert to upper case, A2 to lower case, etc).
+
+ As soon as you release the mouse, WinVNKey will convert the selected text and put the result in clipboard
& as well as replace the selected text on screen.
+
+ B) Keyboard method: <CTR-C> <CTRL> <Letter>
+ -------------------------------------------------------------------
+ Use the shortcut key sequences listed in the context menu (obtained by typing <CTRL><Right MOUSE>) 
& or click on item 4 of the tabbed page "Special Keys".
+
+ For example, the shortcut key sequence for converting to upper case is <CTRL-C><CTRL><U>,
& which stands for: type CTRL-C, press and release CTRL key, and type the U key.
+
+ The process of converting to upper case is as follows.
+    1. Use mouse to select text of interest
+    2. Type CTRL-C to copy into clipboard
+    3. Immediately after this CTRL-C, press and release <CTRL>, then type <U>.
+
+ As soon as you release the U key, WinVNKey will convert the selected text and put the result in clipboard
& as well as replace the selected text on screen.
+
+ Notes:
+ If you select a lot of text, the mouse method may not work.  If this is the case, you
& should try the keyboard method and have a long pause between steps 2 and 3 to
& allow CTRL-C to complete the copy process.
+

// save
+ If you are curious to know how WinVNKey accomplishes this task, here is the explanation.
& As soon as you click on a conversion menu, the following events occur:
+    a) WinVNKey asks the application to copy the selected text to clipboard (similar to CTRL-C)
+    b) WinVNKey will wait 100 milliseconds for the application to complete the task.
+    c) After 100 milliseconds, it does not matter if the application completes the copy,
& WinVNKey will proceed to do the requested conversion and put the result into clipboard
+    d) Then it asks the application to do a paste (similar to CTRL-V)
+
+

Help-Convert=There are three methods of converting selected text from one character set to another as follows.
+
+ A) Mouse method: <CTRL> <Right Mouse>
+ ---------------------------------------------------------
+    1. Use mouse to select text of interest
+    2. Press and release a CTRL key
+    3. Immediately after this CTRL key, hold down the right mouse to display the context conversion menu
+    4. Click on a conversion menu  (e.g. menu D1 to convert from VIQR to Unicode, D2 to convert
& to Unicode without knowing the source charset, etc).
+
+ As soon as you release the mouse, WinVNKey will convert the selected text and put the result in clipboard
& as well as a temporary file. Then it displays the file appropriately with Notepad or a browser.
+
+ B) Full Converter method
+ ---------------------------------
+ You can run the full converter to do the conversion.  This method  is very rich and can handle
& source text in file or clipboard.  You can run the converter
+       - Click "Run" | "Convert..."
+       - Or type the shortcut key sequence: <CTRL><ALT><ALT><C>, i.e., press and
& release a CTRL key, press and release an ALT key twice, and type C key.
+       - Or type <CTRL><Right Mouse>, i.e. press and release a CTRL key, click the right mouse, then click
& menu C.
+
+ C) Keyboard method: <CTR-C> <CTRL> <Letter>
+ -------------------------------------------------------------------
+ Use the shortcut key sequences listed in the context menu (obtained by typing <CTRL><RMOUSE>).
& For example, the shortcut key sequence for converting to from VIQR to Unicode is <CTRL-C><CTRL><V>,
& which stands for: type CTRL-C, press and release CTRL key, and type the V key.
+
+ Let us illustrate the case of converting from VIQR to Unicode as follows.
+    1. Use mouse to select text of interest
+    2. Type CTRL-C to copy into clipboard
+    3. Immediately after this CTRL-C, press and release <CTRL>, then type <V>.
+
+ As soon as you release the V key, WinVNKey will convert the selected text and put the result in clipboard
& as well as a temporary file. Then it displays the file appropriately with Notepad or a browser.
+
+
+ Notes:
+ If you select a lot of text, the mouse method may not work.  If this is the case, you
& should try the keyboard method and have a long pause between steps 2 and 3 to
& allow CTRL-C to complete the copy process.
+
+


Help-PresetCharsets=You can quickly convert selected text by the one of the following methods:
+      (a) or type <CTRL-C> <CTRL> <B>
+      (b) type <CTRL> <CTRL> <Right Mouse> <menu item B>    (You may need one <CTRL> depending on your setup of option 4 on page "Special Keys")
+ 
+ If you choose to do so, WinVNKey will use the following character sets:
+


[Dlg GetString]

; Combo-item
@A1=All font names containing the following pattern (e.g., Arial, Times, etc):

@M1=The pattern is empty.   Please try again.  
+ If you click Cancel, WinVNKey will default to "Time".

@A2=Enter font name (type exactly the character case):
@M2=The name is empty.   Please try again.  
+ If you click Cancel, WinVNKey will default to "Times New Roman".

[Combo Item]
(Blank)=
(Unchanged)=
(Let me type)=
{All other fonts}=
{All fontnames containing=

[Page Unihan]
A1=Click here to find out if you should download the latest Unihan.zip
A2=You currently do not have the master database Unihan.txt in folder:
A3=You currently have the master database XXX in folder:

B1=Extract data from the master database
B2=Extract data associated with the following keyword
B3=And save the output to the following text file:
B4=Extract

B5=Do you want to insert true Hán/Nôm characters 
+ into the first column of the output file?

B6=Extraction succeeded.
+ You can click on the hyperlink "Filename" to open the output file.
+

B7=Failed: Cannot open input file Unihan.txt
B8=Failed: Cannot create new file XXX
B9=Cannot find any data matching the specified keyword!

C1=Click to check the latest Unihan version (revision number) and date at www.unicode.org
C2=Click to know where to save the output file correctly

Help-Download=This Unihan DB dialog provides you with the tool to extract Unihan characters
& with a certain property from the Unihan database.  You can add these extracted characters
& into an existing Han Nom database of WinVNKey so that you can later use WinVNKey to type them.
+
+ A. Do you need Unihan database?
+ ----------------------------------------------
+    To support entry of Han Nom characters by typing pronunciation or certain special strings,
& WinVNKey normally uses Han Nom databases from many sources, such as
+      1) the master Unihan database Unihan.zip, which can be downloaded from
+                ftp://www.unicode.org/Public/UNIDATA/Unihan.zip
+      2) the Cedict dictionary: 
+                http://us.mdbg.net/chindict/chindict.php?page=cedict
+      3) Han Nom databases provided by Thanh Son Le and Kiet The Dang.
+      4) and many other online sources
+
+ In general, these databases are fairly up to date.  Thus you should not have 
& to download the latest Unihan database unless you are a researcher in Han Nom and want
& to use the latest Unihan characters
& that are standardized in the Unicode Standards.  
+
+ For your information the Unicode Standards are updated frequently with newly found
& Unihan characters.  These characters are usually used in very old books
& and are no longer used today.  Thus if you are interested in these characters, then
& this tool is for you.
+
+ B. What is the Unihan database?
+ -------------------------------------------
+     The Unicode Standard refers to all the Chinese/Japanese/Korean/Vietnamese ideographs as Unihan characters.
& All the Unihan characters are collected in a file named Unihan.txt, which is fairly large (6MB compressed, 28 MB uncompressed).
& This file is commonly known as the Unihan database.  It is a plain text file in UTF-8 and basically contains 3 columns such as
+           ............	...................	.........
+           U+346B	kCangjie		OOIP
+           U+346B	kVietnamese	nộm
+           ............	...................	.........
+     Column 1:  Unicode value of the Unihan character in hexadecimal digits (e.g., U+346B)
+     Column 3:  pronunciation in a language, or a certain encoding standing for the character, or the method to look up in dictionaries.
+     Column 2:  keyword or tag (e.g. kCangjie or kVietnamese).  It means the name or the property of column 3.
+                      - If column 3 the Cangjie code (i.e. OOIP), then column 2 lists the name kCangjie.
+                      - If column 3 the Vietnamese pronunciation (i.e. nộm), then column 2 lists the name kVietnamese.
+
+ Thus a single Unihan character may be listed repeatedly on several lines, each line corresponding to a different keyword.
& By extracting all lines associated with kVietnamese, for instance, you will get a text file that contains all the Unihan
& characters that have a Vietnamese pronunciation.  You can name the file Unihan-Vietnamese and place it in
& folder Han-Viet.
+
+ C. Procedure to extract
+ -----------------------------------
+     1. You can click the hyperlink at the bottom of this dialog to download the latest Unihan.zip from the official Unicode website.
& Or you can type this address directly in the browser:
+
+                ftp://www.unicode.org/Public/UNIDATA/Unihan.zip
+         
+         Notes:
+         -  For more info about this latest database (such as version number and a summary of changes since the last release), see
+                http://www.unicode.org/Public/UNIDATA/Unihan.html    
+         - To download old versions of the database, see
+                http://www.unicode.org/ucd/
+
+     2. Save Unihan.zip to your disk, unzip it to get Unihan.txt, and move it to this folder:
+                HanNom\InternetSources
+     3. Go back to the Unihan.txt dialog.  
+         If you put Unihan.txt in the correct folder, the second line in this dialog will tell you the version number of Unihan.txt.
+     4. Select the keyword that you want to extract its data, say kVietnamese.
+     5. Click the Openfile folder and browse to the folder where you want to save the output and type the name of the file.
+         For kVietnamese you should choose "Han-Viet" folder and filename "Unihan-Vietnamese.txt".
+         Click OK button
+     6. Click Extract button.
+     7. Go to tabbed page "Update Database" and update the database that has the new data file.
+         For the example of kVietnamese, you should:
+              - select "Han-Viet" in combobox
+              - click "Rebuild"
+     8. Restart WinVNKey so that the newly rebuilt database will take effect.
+
+ D.  Notes
+ --------------
+     1.  Unihan database does not distinguish Hán-Việt or Nôm-Việt data.  Therefore, 
& it is up to you to decide where to put the extracted text file: either in 
& Han-Viet or Nom-Viet directory.
+
+    2. When you rebuild a binary database, WinVNKey open the folder named after the database
& and read all files therein in their alphabetical order and will ignore
& all repeated Unihan characters.  
+
+ For example, suppose your new data file "Unihan-Vietnamese.txt"
& is processed last in the Han-Viet directory.  If WinVNKey reads an entry in Unihan-Vietnamese.txt
& and finds that it is already present in the files that are already read, say, Data-HanViet-LST.txt, 
& then WinVNKey will discard this entry.  At the end of the file,
& WinVNKey will give a summary of how many characters the file Unihan-Vietnamese.txt
& has and how many of them are discarded.  If all of them are discarded,
& you know exactly that the Han-Viet database released by WinVNKey is complete
& and you do not need Unihan.txt at all.
+
+ Thus you should name your extracted file in such a way that it will be sorted last.
& To this end, the name should begin with an initial letter x, y, z, etc.
& The name Unihan-Vietnamese.txt may be a good choice because 
& the file is sorted last in the Han-Viet folder.
+
+

Help-ExtractKeyword=Choose keyword to extract
+ --------------------------------------
+
+ Examples:
+
+ - Choose "kVietnamese" to extract from file Unihan.txt all lines that contain the word "kVietnamese" in the second column.  The result 
& is a Unicode text file that has two columns:  the first is the hex codes of the ideographic characters, the second is the Vietnamese pronunciation written in Quốc ngữ.
+
+ - Choose "kCantonese" to extract from file Unihan.txt all lines that contain the word "kCantonese" in the second column.  The result 
& is a Unicode text file that has two columns:  the first is the hex codes of the ideographic characters, the second is the Cantonese pronunciation written in 
& Latin-based characters with 1, 2, 3, ... as tone marks similar to Pinyin.
+
+ - Choose "kFourCornerCode" to extract from file Unihan.txt all lines that contain the word "kFourCornerCode" in the second column.  The result 
& is a Unicode text file that has two columns:  the first is the hex codes of the ideographic characters, the second is the four corner index codes.
+
+ The best way to understanding the keywords is to open the file Unihan.txt and read the data lines that do not not start with the # character.
& These lines have 3 columns.   For example,
+           ............	...................	.........
+           U+346B	kCangjie		OOIP
+           U+346B	kVietnamese	nộm
+           ............	...................	.........
+     Column 1:  Unicode value of the Unihan character in hexadecimal digits (e.g., U+346B)
+     Column 2:  keyword or tag (e.g. kCangjie or kVietnamese)
+     Column 3:  value or property associated with keyword:
+                      - If keyword is kCangjie, the 3rd column says the Cangjie code of this character is OOIP
+                      - If keyword is kVietnamese, the 3rd column says the character is pronounced "nộm" in Vietnamese
+
+ Thus a single Unihan character may be listed repeatedly on several lines, each line corresponding to a different keyword.
& By extracting all lines associated with kVietnamese, for instance, you will get a text file that contains all the Unihan
& characters that have a Vietnamese pronunciation.
+

Help-SaveOutput=
& Save output file
+ ----------------------
+
+ You should click the open folder icon to specify the output file to save.  The first thing to decide is to choose the correct folder.
+
+ 1. How to choose the folder?
+ ---------------------------------------
+ 
+ The folder name is also used as the database name.  All text files *.txt will be combined into a single binary database, which is named after the folder name.
+
+ For this reason, you should choose the "Han-Viet" directory for all Unihan characters extracted by the keyword "kVietnamese".  In general,
& you should choose as follows:
+         - keyword kCangjie ==> save in Han-Cangjie 
+         - keyword kFourCornerCode ==> save in Han-4Corner
+         - etc
+
+ 2. How to choose the filename?
+ -------------------------------------------
+
+ You should name the file starting with one of the last letters of the English alphabet like u, v, x, y, z.  The reason is as follows.
+
+ When you rebuild a binary database, say, Han-Viet, WinVNKey will read all text files in folder
& Han-Viet in their alphabetical order and will ignore
& all repeated Unihan characters.  By having your new data file processed last, you can determine how many characters
& in your files are redundant and should be deleted.
+
+ For example, suppose your extracted file is named "Unihan-Vietnamese.txt" and it
& is processed last in the Han-Viet directory.  If all Unihan characters in this file are also
& present in other files in the Han-Viet directory (say, Data-HanViet-LST.txt), 
& then WinVNKey will discard all characters in "Unihan-Vietnamese.txt".
& WinVNKey will give you a summary of how many characters the file Unihan-Vietnamese.txt
& has and how many of them are discarded.  If all of them are discarded,
& you know exactly that the Han-Viet database released by WinVNKey is complete
& and you do not need Unihan.txt at all.
+
+ Thus you should name your extracted file in such a way that it will be sorted last.
& To this end, the name should begin with an initial letter x, y, z, etc.
& The name Unihan-Vietnamese.txt may be a good choice because the
& initial letter U is likely to cause it to be sorted last.  To be sure, you can name your file as zUnihan-Vietnamese.txt.
+
+

[Page HannomDB Setup]

Help-Note=Need to limit the number of active databases
+
+ A number of Han Nom databases are very large in size, notably those that contain Pinyin pronunciation:
+         - HanPhonThe-Pinyin:  about 3 MB
+         - HanGianThe-Pinyin:  about 3 MB
+
+ All databases listed in the Han Nom dropdown checklist are loaded into memory whether used or not.  
& If a database is large, it takes a lot of memory and a longer time to load.
+
+ Thus if you don't need any database, you should put it away by moving it to the left list box.
& For instance, if you are typing Han/Nom by Vietnamese pronunciation, you absolutely do not need 
& Pinyin databases, four-corner method database, and Cangjie database.  You can move all of them to
& the left box.
+
+ When you are done, restart WinVNKey so that your changes will take effect.
+

