README
1The two programs "vn7to8" and "vn8to7" convert between the 7-bit
2VIQR format for Vietnamese (Viet-Net like) and the 8-bit VISCII
3data format.
4
5The current supported version is VISCII 1.1.
6
7Usage:
8
9 vn7to8 [-com <c>] [-v|-m|-l] [7-bit input file(s)]
10 -com: <c> specifies the composition character, default is "\"
11 -v: sets the initial state to Vietnamese
12 -m: sets the initial state to English
13 -l: sets the initial state to Literal
14
15
16 vn8to7 [-com <c>] [-m|-v] [8-bit input file(s)]
17 -com: <c> specifies the composition character, default is "\"
18 -m: specifies English mode output
19 -v: specifies Vietnamese mode output (default)
20
21 vn80to81 [input file] [output file]
22 If file names not specified, stdio is used.
23 Purpose: converts files from VISCII 1.0 to VISCII 1.1
24 Version: VISCII 1.1
25
26Two sample files are provided for you to experiment with: VIQR.7,
27which contains VIQR-format data, and VISCII.8, which contains VISCII-format
28data.
29--------
30
31VIQR guide:
32 There are three supported states, Vietnamese, English, and Literal.
33 Each state is entered by the sequence "\x", where "x" is "v" or "V"
34 for Vietnamese, "e" or "E" for English, and "l" or "L" for Literal.
35
36 \v: Start Vietnamese mode, where Viet-Net style input is supported,
37 for example:
38
39 Ca' kho^ng a(n muo^'i ca' u+o+ng
40 Con ca~i cha me. tra(m ddu+o+`ng con hu+\.
41
42 To prevent composition, use "\". The example above shows
43 "hu+\." which tells Vnterm that the ending period is
44 a period and not a Vietnamese dot-below (da^'u na(.ng).
45
46 The diacritics (da^'u) are:
47
48 ( breve da^'u tra(ng, a('
49 ^ circumflex da^'u mu~, a^'
50 + horn da^'u mo'c, o+
51
52 ' acute da^'u sa('c
53 ` grave da^'u huye^`n
54 ? hook above da^'u ho?i
55 ~ tilde da^'u nga~
56 . dot below da^'u na(.ng
57
58 \m: Start English mode, where Viet-Net style input is supported,
59 but must be explicitly announced with a "\", for example:
60
61 C\a' kh\o^ng \a(n mu\o^'i c\a' \u+\o+ng
62 Con c\a~i cha m\e. tr\a(m \dd\u+\o+`ng con h\u+\.
63
64 This mode is useful if you type mostly English and don't
65 want the trouble of having to type "\" to escape composition
66 all the time.
67
68 \l: starts Literal mode, almost all keys are passed literally.
69
70 For complete details, please see the Viet-Std documents
71 published elsewhere. Contact "viet-std@haydn.Stanford.EDU"
72 if you would like a copy.
73
74Cu+o+`ng Nguye^~n
75