# x x x x x   D O N ' T   D E L E T E   T H E   F I R S T   L I N E   O F   T H E   F I L E ! 
 
 # x x x x x   T h e   f i r s t   c h a r a c t e r   o f   t h e   f i r s t   l i n e   o f   t h i s   f i l e   i s   a   s p e c i a l   U n i c o d e 
 
 # x x x x x   c h a r a c t e r   c a l l e d   t h e   B O M   c h a r a c t e r   ( 0 x F E F F ) ,   w h i c h   i s   i n v i s i b l e   t o   y o u . 
 
 # x x x x x   I t s   p r e s e n c e   t e l l s   o t h e r   a p p l i c a t i o n s   t h a t   t h e   e n t i r e   f i l e   i s   i n   U n i c o d e . 
 
 # 
 
 # = = = = = = = = = =   H a n - V i e t   T e x t   D a t a b a s e   = = = = = = = = = = = = = = = = = = = = = = = = = = = = 
 
 # 
 
 #   @ V e r s i o n :   1 
 
 #   @ D a t e :         J a n u a r y   1 7 ,   2 0 0 3 
 
 #   @ C o n t r i b u t o r s : 
 V u o n g   D o a n   N g u y e n   - -   l e v a n @ h o t m a i l . c o m 
 
 #   @ C r e a t e d   b y   H o c   D .   N g o   - -   h o c n g o @ g m a i l . c o m 
 
 #             H o c   f i x e d   n o n   V i e t n a m e s e   l e t t e r s   i n   t h e   p r o n u n c i a t i o n   c o l u m n   a n d   
 
 #             c o n v e r t e d   t o   t h i s   p l a i n   t e x t   f o r m a t . 
 
 #   @ D e f a u l t F o r m a t O f V a l u e s : 
 
 #             ( V a l i d   v a l u e   a f t e r   c o l o n   i s   h e x   o r   j u s t   l e a v e   i t   e m p t y ) 
 
 # 
 
 #   W i n V N K e y   r e a d s   t h i s   t e x t   f i l e   w h e n   y o u   a s k   i t   t o   r e b u i l d   t h e   H a n n o m   d a t a b a s e : 
 
 #         S t a r t   W i n V N K e y   = >   c l i c k   R u n   b u t t o n   = >   S e l e c t   T y p e   H  n   N  m 
 
 #         = >   H a n   N o m   d i a l o g   a p p e a r s 
 
 #         = >   C l i c k   t h e   t o p   d o w n w a r d   a r r o w   t o   d i s p l a y   a   d r o p d o w n   m e n u 
 
 #         = >   s e l e c t   m e n u   " U p d a t e   H a n   N o m   d a t a b a s e " 
 
 #   T h e   r e b u i l d   p r o c e s s   r e a d s   a l l   . t x t   f i l e s   i n   t h e   s u b d i r e c t o r i e s   H a n V i e t   a n d   N o m V i e t 
 
 #   a n d   c o m b i n e s   t h e m   i n t o   a   s i n g l e   b i n a r y   f i l e   H a n n o m . d a t 
 
 #   W i n V N K e y   r e a d s   H a n n o m . d a t   o n   s t a r t u p   t o   s u p p o r t   H  n   N  m   t y p i n g . 
 
 # 
 
 #   I f   y o u   k n o w   t h e   s y n t a x   o f   t h i s   f i l e ,   y o u   c a n   a d d   n e w   H  n   c h a r a c t e r s   a n d   t h e n 
 
 #   r e b u i l d   t h e   d a t a b a s e .     T h e n   r e s t a r t   W i n V N K e y   t o   u s e   t h e   n e w   d a t a b a s e . 
 
 # = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = 
 
 # 
 
 #   S y n t a x : 
 
 # 
 
 #   T h e   s y n t a x   i s   v e r y   s i m p l e : 
 
 #             T h e   f i r s t   c o l u m n   i s   U n i c o d e   v a l u e s   o f   H  n   c h a r a c t e r s . 
 
 #             T h e   s e c o n d   c o l u m n   i s   t h e   c o r r e s p o n d i n g   p r o n u n c i a t i o n   i n   L a t i n - b a s e d   V i e t n a m e s e . 
 
 #             E a c h   l i n e   c a n   h a v e   c o m m e n t   t h a t   a p p e a r s   a f t e r   a   #   s i g n . 
 
 # 
 
 # = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = 
 
 #     H o w   t o   c r e a t e   a n   a d d i t i o n a l   H  n - V i e t   t e x t   f i l e ? 
 
 # 
 
 #     S u p p o s e   y o u   h a v e   f o u n d   t h r e e   n e w   H  n   c h a r a c t e r s   t h a t   a r e   m i s s i n g   f r o m 
 
 #     t h e   d i s t r i b u t i o n : 
 
 # 
 
 #     U + 9 D 1 B 	 u y  n 
 
 #     U + 9 D 1 5 	  
 
 #     U + 9 D 1 2 	 l i n h 
 
 # 
 
 #   Y o u   w a n t   t o   p u t   t h e m   i n   a   s e p a r a t e   f i l e   t o   a v o i d   m e s s i n g   u p   w i t h   t h e 
 
 #   m a s t e r   d a t a b a s e .     
 
 # 
 
 #   W e l l ,   i t   i s   b e t t e r   t o   u s e   N o t e p a d   b e c a u s e   i t   w i l l   n o t   a d d   i n v i s i b l e   c h a r a c t e r s 
 
 #   t o   t h e   f i l e .     O p e n   N o t e p a d ,   t y p e   t h e   t h r e e   l i n e s   a s   l i s t e d   a b o v e ,   s t a r t i n g 
 
 #   w i t h   U + .     I n   o t h e r   w o r d s ,   y o u   h a v e   t o   o m i t   t h e   l e a d i n g   c h a r a c t e r   #   o n   e a c h   l i n e 
 
 #   a n d   b e g i n   w i t h   U +   i n s t e a d .     T h e n   c l i c k   m e n u 
 
 #                 F i l e   |   S a v e   A s 
 
 #     C h o o s e : 
 
 #                 F i l e n a m e :                 H a n - V i e t - n e w 1     ( o r   a n y   n a m e   y o u   w a n t ) 
 
 #                 S a v e   a s   t y p e :     T e x t   D o c u m e n t s   ( * . t x t )               
 
 #                 E n c o d i n g :                 U n i c o d e 
 
 #   T h e n   c l i c k   O K . 
 
 # = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = 
 
 # 
 
 #     S y n t a x   D e t a i l s 
 
 # 
 
 #     F o l l o w i n g   a r e   t h e   s y n t a x   d e t a i l s   i f   y o u   w a n t   t o   u n d e r t a n d   m o r e : 
 
 # 
 
 #   ( 1 )   F o r m a t   o f   f i r s t   c o l u m n : 
 
 #                   a .   U n i c o d e   v a l u e   i n   h e x ,   s a y   U + 9 9 A C ,   o r   0 x 9 9 A C   ( i . e . ,   n u m b e r   w i t h   p r e f i x   U +   o r   0 x ) 
 
 #                   b .   O r   U n i c o d e   v a l u e   i n   d e c i m a l ,   s a y   1 9 9 7 7   ( i . e . ,   n u m b e r   w i t h o u t   p r e f i x ) 
 
 #                   c .   O r   T r u e   U n i c o d e   c h a r a c t e r   l i k e   	N  ( t a m ) ,   ʎ  ( x a ) ,     ( m  ) 
 
 # 
 
 #           N o t e   w h e n   a d d i n g   n e w   H  n   c h a r a c t e r s   t o   t h i s   f i l e : 
 
 #                 -   Y o u   c a n   m i x   t h e s e   f o r m a t s ,   i . e . ,   s o m e   r o w s   c a n   b e   i n   f o r m a t   ( a ) , 
 
 #                     s o m e   i n   ( b ) ,   a n d   o t h e r s   i n   ( c ) . 
 
 #                 -   A   N  m   v a l u e   o f   8 3 0 0   c a n   b e   h e x   o r   d e c i m a l .     I f   h e x ,   u s e   U + 8 3 0 0 . 
 
 #                     I f   d e c i m a l ,   u s e   8 3 0 0 . 
 
 #                 -   I f   y o u   s p e c i f y   " #   @ D e f a u l t F o r m a t O f V a l u e s :   h e x " 
 
 #                     t h e n   a l l   n u m b e r s   w i t h o u t   a   p r e f i x   " U + "   o r   " 0 x "   a r e   h e x a d e c i m a l . 
 
 #                 -   I f   y o u   s p e c i f y   " #   @ D e f a u l t F o r m a t O f V a l u e s : "   a l o n e , 
 
 #                     t h e n   a l l   n u m b e r s   w i t h o u t   a   p r e f i x   " U + "   o r   " 0 x "   a r e   d e c i m a l . 
 
 #                 -   A l l   n u m b e r s   w i t h   a   p r e f i x   " U + "   o r   " 0 x "   a r e   A L W A Y S   h e x a d e c i m a l , 
 
 #                     r e g a r d l e s s   o f   w h a t   y o u   s p e c i f y   f o r   @ D e f a u l t F o r m a t O f V a l u e s . 
 
 #                 -   F o r   N  m   c h a r a c t e r s   t h a t   a r e   d o u b l e   U n i c o d e   ( s u r r o g a t e   p a i r ) ,   y o u   c a n   l i s t   t h e 
 
 #                     4   h e x   d i g i t s   o f   t h e   h i g h   s u r r o g a t e   f o l l o w e d   b y   t h e   4   h e x   d i g i t s   o f   t h e   l o w 
 
 #                     s u r r o g a t e .     O r   y o u   c a n   l i s t   i t s   N C R   v a l u e .     F o r   e x a m p l e ,   t h e   N  m   c h a r a c t e r 
 
 #                     f o r   " h a i "   i s   a   s u r r o g a t e   p a i r : 
 
 #                                       l o w   s u r r o g a t e   =   U + D D 2 9 ,     h i g h   s u r r o g a t e   =   U + D 8 4 0 
 
 #                     I t s   H T M L   ( N C R )   r e p r e s e n t a t i o n   i s   & # 1 3 1 3 6 9 ;   o r   & # x 2 0 1 2 9 ; . 
 
 #                     T h u s   y o u   c a n   e n t e r   a n y   o f   t h e   f o l l o w i n g   i n   t h e   f i r s t   c o l u m n   f o r   " h a i " : 
 
 #                                 U + D 8 4 0 D D 2 9   o r   0 x D 8 4 0 D D 2 9   o r   1 3 1 3 6 9   o r   U + 2 0 1 2 9   o r   0 x 2 0 1 2 9 
 
 # 
 
 #   ( 2 )   F o r m a t   o f   s e c o n d   c o l u m n : 
 
 #           T h i s   c o l u m n   i s   r e s e r v e d   f o r   p r o n u n c i a t i o n   o n l y .   I t   i s   s e p a r a t e d   f r o m   t h e   f i r s t 
 
 #           c o l u m n   b y   o n e   o r   m o r e   c o m m a ,   s p a c e s   o r   t a b s . 
 
 #           I f   a   N  m   c h a r a c t e r   h a s   s e v e r a l   p r o n u n c i a t i o n s ,   y o u   c a n   e i t h e r   l i s t   t h e m   i n   t h e 
 
 #           s a m e   r o w   s e p a r a t e d   b y   c o m m a s   o r   p u t   t h e m   i n   s e p a r a t e   r o w s . 
 
 #           I f   y o u   p u t   t h e m   i n   s e p a r a t e   r o w s ,   m a k e   s u r e   t h e   N  m   c h a r a c t e r   i n   t h e 
 
 #           f i r s t   c o l u m n   i s   t h e   s a m e .     N E V E R   p u t   c o m m e n t   i n   t h e   s e c o n d   c o l u m n . 
 
 # 
 
 #   ( 3 )   F o r m a t   o f   t h i r d   c o l u m n : 
 
 #           T h e   t h i r d   c o l u m n   i s   o p t i o n a l   a n d   i s   u s e d   f o r   c o m m e n t . 
 
 #           I f   y o u   p u t   a n y t h i n g   i n   t h e   t h i r d   c o l u m n ,   p u t   i t   a f t e r   a   #   s i g n . 
 
 # 
 
 #           N o t e   t h a t   i f   t h e   s e c o n d   c o l u m n   c o n t a i n s   a n y   m i s s p e l l e d   V i e t n a m e s e   w o r d 
 
 #           o r   a   f o r e i g n   w o r d   t h a t   W i n V N K e y   c a n n o t   r e c o g n i z e   i t   a s   a   s i n g l e   V i e t n a m e s e 
 
 #           w o r d ,   i t   w i l l   r e j e c t   t h i s   w o r d   u n l e s s   y o u   p u t   " @ O K "   i n   t h e   t h i r d   c o l u m n .     T h e 
 
 #           p r e s e n c e   o f   " @ O K "   t e l l s   W i n V N K e y   t o   b y p a s s   s p e l l i n g   c h e c k . 
 
 # 
 
 # x x x x x x x x x x x x x x x x x   E n d   o f   h e a d e r   ( d o n ' t   d e l e t e ! )   x x x x x x x x x x x x x x x x x x x x x x 
 
 