File: ch-ckbcomp.html

package info (click to toggle)
console-setup 1.240
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 62,452 kB
  • sloc: perl: 11,215; xml: 8,643; sh: 3,886; makefile: 769
file content (208 lines) | stat: -rw-r--r-- 4,599 bytes parent folder | download | duplicates (3)
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
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN">

<html>

<head>

<meta http-equiv="content-type" content="text/html; charset=iso-8859-1">

<title>The Hackers Guide for console-setup - The ckbcomp Utility</title>

<link href="index.html" rel="start">
<link href="ch4.html" rel="prev">
<link href="index.html" rel="next">
<link href="index.html#contents" rel="contents">
<link href="index.html#copyright" rel="copyright">
<link href="ch1.html" rel="chapter" title="1 Basic Structure">
<link href="ch2.html" rel="chapter" title="2 bdf2psf">
<link href="ch3.html" rel="chapter" title="3 The Legacy Fonts">
<link href="ch4.html" rel="chapter" title="4 The New Fonts">
<link href="ch-ckbcomp.html" rel="chapter" title="5 The ckbcomp Utility">
<link href="ch1.html#s1.1" rel="section" title="1.1 Fonts">
<link href="ch1.html#s1.2" rel="section" title="1.2 Keyboard">
<link href="ch1.html#s1.3" rel="section" title="1.3 describe_unicodes">
<link href="ch2.html#s2.1" rel="section" title="2.1 Synopsis">
<link href="ch2.html#s-charsets" rel="section" title="2.2 Character Sets">
<link href="ch2.html#s-equivalence" rel="section" title="2.3 Equivalence files">
<link href="ch3.html#s3.1" rel="section" title="3.1 Conversion from PSF to BDF">
<link href="ch3.html#s3.2" rel="section" title="3.2 Back Conversion&mdash;from BDF to PSF">

</head>

<body>

<p><a name="ch-ckbcomp"></a></p>
<hr>

<p>
[ <a href="ch4.html">previous</a> ]
[ <a href="index.html#contents">Contents</a> ]
[ <a href="ch1.html">1</a> ]
[ <a href="ch2.html">2</a> ]
[ <a href="ch3.html">3</a> ]
[ <a href="ch4.html">4</a> ]
[ 5 ]
[ <a href="index.html">next</a> ]
</p>

<hr>

<h1>
The Hackers Guide for <samp>console-setup</samp>
<br>Chapter 5 - The <code>ckbcomp</code> Utility
</h1>

<hr>

<p>
The <code>ckbcomp</code> accepts more or less the same arguments as the
<code>setxkbmap</code> utility:
</p>

<pre>
     Usage: ckbcomp [args] [&lt;layout&gt; [&lt;variant&gt; [&lt;option&gt; ... ]]]
     Where legal args are:
     -?,-help            Print this message
     -charmap &lt;name&gt;         Specifies the encoding to use
     -I&lt;dir&gt;             Add &lt;dir&gt; to list of directories to be used
     -keycodes &lt;name&gt;    Specifies keycodes component name
     -symbols &lt;name&gt;     Specifies symbols component name
     -rules &lt;name&gt;       Name of rules file to use
     -model &lt;name&gt;       Specifies model used to choose component names
     -layout &lt;name&gt;      Specifies layout used to choose component names
     -variant &lt;name&gt;     Specifies layout variant used to choose component names
     -v[erbose] [&lt;lvl&gt;]  Sets verbosity (1..10).  Higher values yield
                         more messages
     -option &lt;name&gt;      Adds an option used to choose component names
</pre>

<p>
The main difference is the <code>-charmap</code> parameter which specifies the
encoding to use.  If the encoding is <var>ENC</var> then one of the following
files should exist:
</p>
<ul>
<li>
<p>
<code><var>ENC</var></code>
</p>
</li>
</ul>
<ul>
<li>
<p>
<code><var>ENC</var>.gz</code>
</p>
</li>
</ul>
<ul>
<li>
<p>
<code><var>ENC</var>.acm</code>
</p>
</li>
</ul>
<ul>
<li>
<p>
<code><var>ENC</var>.acm.gz</code>
</p>
</li>
</ul>
<ul>
<li>
<p>
<code>/usr/share/consoletrans/<var>ENC</var></code>
</p>
</li>
</ul>
<ul>
<li>
<p>
<code>/usr/share/consoletrans/<var>ENC</var>.gz</code>
</p>
</li>
</ul>
<ul>
<li>
<p>
<code>/usr/share/consoletrans/<var>ENC</var>.acm</code>
</p>
</li>
</ul>
<ul>
<li>
<p>
<code>/usr/share/consoletrans/<var>ENC</var>.acm.gz</code>
</p>
</li>
</ul>
<ul>
<li>
<p>
<code>acm/<var>ENC</var>.acm</code>
</p>
</li>
</ul>

<p>
This file should define the so called Application Character Map for
<var>ENC</var>.
</p>

<p>
The option <code>-I</code> add a directory to the list of directories where the
X keyboard definitions are searched.  By default this directory list contains
the following directories:
</p>
<ul>
<li>
<p>
<code>/etc/console-setup/ckb</code>
</p>
</li>
</ul>
<ul>
<li>
<p>
<code>/etc/X11/xkb</code>
</p>
</li>
</ul>
<ul>
<li>
<p>
<code>/usr/X11R6/lib/X11/xkb</code>
</p>
</li>
</ul>

<hr>

<p>
[ <a href="ch4.html">previous</a> ]
[ <a href="index.html#contents">Contents</a> ]
[ <a href="ch1.html">1</a> ]
[ <a href="ch2.html">2</a> ]
[ <a href="ch3.html">3</a> ]
[ <a href="ch4.html">4</a> ]
[ 5 ]
[ <a href="index.html">next</a> ]
</p>

<hr>

<p>
The Hackers Guide for <samp>console-setup</samp>
</p>

<address>
Anton Zinoviev <code><a href="mailto:anton@lml.bas.bg">mailto:anton@lml.bas.bg</a></code><br>
<br>
</address>
<hr>

</body>

</html>