1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
|
<HTML>
<BODY>
<PRE>
<!-- Manpage converted by man2html 3.0.1 -->
mytool - manipulate map files for yudit, uniconv and
uniprint
</PRE>
<H2>SYNOPSIS</H2><PRE>
<B>mytool</B> [ <B>-info</B> ] [ <B>-test</B> ] [ <B>-showkeys</B> ] [ <B>-decode</B> ] [
<B>-encode</B> ] [ <B>-strip</B> ] [ <B>-benchmark</B> ] [ <B>-name</B> <I>new-name</I> ] [
<B>-comment</B> <I>new-comment</I> ] [ <B>-type</B> <I>new-type</I> ] [ <B>-write</B> <I>output-</I>
<I>file</I> ] [ <B>-my</B> <I>input-file</I> ] [ <B>-mys</B> <I>input-file</I> ] [ <B>-rmys</B>
<I>input-file</I> ] [ <B>-kmap</B> <I>input-file</I> ] [ <B>-rkmap</B> <I>input-file</I> ] [
<B>-uni:l,u</B> <I>input-file</I> [ <B>-8</B> ] [ <B>-high</B> ] [ <B>-low</B> ] [ <B>-runi:l,u</B>
<I>input-file</I> [ <B>-8</B> ] [ <B>-high</B> ] [ <B>-low</B> ] ] [ <B>-convert</B> <I>out-</I>
<I>file-format</I> ]
</PRE>
<H2>DESCRIPTION</H2><PRE>
<B>mytool</B> is a <B>my</B> map file manipulation program in the yudit
distribution. It can generates so-called binary nbit ( <B>my</B>
) map file that can map any sequences of bytes into any
sequences of bytes. These sequences of bytes can be
grouped into 1,2,4 and 8 bytes long words. The input
sequence length may be different from the matched sequence
length. 'i / 'n -> 'b specifies that the word 'in' pro�
duces 'b' but only the 'i is consumed from the input
buffer.
It can also generate a so-called <B>binary</B> <B>umap</B> file, that
maps 8 or 16 bit single words into 16 bit single words and
it contains the reverse map too.
It can also disassemble the input map and produce a <B>mys</B>
source file.
The input can be a binary umap file, a <B>my</B> file, <B>mys</B> file a
<B>uni</B> and a kmap file for yudit. It is recommended that all
kmap files use the new <B>mys</B> format because it gives more
freedom to define the mapping.
The yudit distribution has a simple document
<B>yudit/doc/my.doc</B> on the binary map formats, and a source
file example file <B>yudit/mytool/my/example.mys</B> please refer
to this for more details.
</PRE>
<H2>OPTIONS</H2><PRE>
<B>-info</B> prints out a small information on the current map.
<B>-test</B> lets you test the map interactively.
<B>-showkeys</B>
show alls the keys in the map file.
<B>-encode</B>
disk with the <B>-write</B> option The resulting <B>my</B> files
can contain state machines to speed-up conversion.
A state machine based <B>my</B> file can manifest 10%-70%
performance improvement, so it may be desirable for
encoding <B>fontmaps.</B> For <B>fontmaps</B> the <B>bumap</B> format
might be better suited where only one character and
not a sequence of characters need to be mapped.
<B>-decode</B>
builds a state machine in the decoding part of the
map file.
<B>-strip</B> strips off the state machines from the map files.
The <B>-write</B> option can be used to save the new map
file.
<B>-benchmark</B>
option performs a simple benchmark test on the map
file, to compare speed of simple, state machine
based and binary map based map files.
<B>-nocomment</B>
option strips all comments from an input source
file of format <B>mys</B> <B>kmap</B> <B>uni.</B> It does not strip
comments from a binary file.
<B>-name</B> <I>new-name</I>
assigns a name to the map file.
<B>-comment</B> <I>new-comment</I>
assigns a comment to the map file.
<B>-type</B> <I>new-type</I>
assigns a map file a distinctive type, that can be
<B>kmap</B> or <B>fontmap</B> but it is only informative. Keymaps
can be used as fontmaps and vice versa.
<B>-write</B> <I>output-file</I>
writes the data into an output file. <B>mytool</B> never
modifies the original file. All modifications
should be explicitly saved with the this option.
Never specify the same file for input and output.
<B>-my</B> <I>input-file</I>
load a binary map file. Only one of this option can
be specified.
<B>-mys</B> <I>input-source-file</I>
load a source file.
<B>-rmys</B> <I>input-source-file</I>
<B>-kmap</B> <I>input-source-file</I>
load a source file in kmap format.
<B>-rkmap</B> <I>input-source-file</I>
load a source file and reverse it - make encoding
from decoding and vice versa.
<B>-uni:l,u</B> <I>input-source-file</I>
load a source file in Unicode Consortium format.
This format has the local code in column l, and
unicode in column u. The numbering of columns start
from 0.
<B>-runi:l,u</B> <I>input-source-file</I>
load a source file in Unicode Consortium format and
reverses it. Make encoding from decoding and vice
versa.
<B>-8</B> option can be used with the <B>-uni</B> or <B>-runi</B> options.
It specifies that the input is 8 bit and not 16
bit.
<B>-high</B> option can be used with the <B>-uni</B> or <B>-runi</B> options.
It specifies that the key should be or'ed with
0x8080.
<B>-low</B> option can be used with the <B>-uni</B> or <B>-runi</B> options.
It specifies that the key should be and'ed with
0x7f7f.
<B>-convert</B> <I>output-file-format</I>
converts the map file to a format. It is useful
only when combined with <B>-write</B> otion. The possible
formats are <B>my</B> <I>-binary,</I> <B>mys</B> <I>-source,</I> <B>myc</B> <I>-my-c-</I>
<I>source,</I> <B>umap</B> <B>-umap-c-source,</B> <I>bumap</I> <B>-binary-umap</B>
formats. For maps where only a single 8 or 16 bit
local code should be converted into 16 bit unicode
and vice versa, the umap file formats are recom�
mended. The c-source files are provided so that
you can inlucde a full map into the c program.
</PRE>
<H2>DIAGNOSTICS</H2><PRE>
<B>mytool</B> prints out an error message and exits with a non-
zero status on error. If there is no error the exit sta�
tus is zero.
</PRE>
<H2>SEE ALSO</H2><PRE>
This program was written by gsinai@iname.com (Gaspar
Sinai).
Tokyo, 03 January, 2000.
</PRE>
<HR>
<ADDRESS>
Man(1) output converted with
<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
</ADDRESS>
</BODY>
</HTML>
|
