File: mytool.html

package info (click to toggle)
yudit 2.5.4-2
  • links: PTS
  • area: main
  • in suites: woody
  • size: 8,528 kB
  • ctags: 8,403
  • sloc: cpp: 59,394; ansic: 2,585; perl: 2,398; makefile: 864; sh: 321
file content (230 lines) | stat: -rw-r--r-- 7,305 bytes parent folder | download | duplicates (9)
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 -&gt; '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>