source: general/genlib/icu.xml@ 0456d3b

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 0456d3b was 0456d3b, checked in by Bruce Dubbs <bdubbs@…>, 7 years ago

Update to libevdev-1.5.5.
Update to icu4c-58.2.
Update to iso-codes-3.72.
Update to libinput-1.5.3.
Update to sysstat-11.5.3.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@18052 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 13.5 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY icu-download-http
8 "http://download.icu-project.org/files/icu4c/&icu-version;/icu4c-&icu-dl-version;-src.tgz">
9 <!ENTITY icu-download-ftp " ">
10 <!ENTITY icu-md5sum "fac212b32b7ec7ab007a12dff1f3aea1">
11 <!ENTITY icu-size "22 MB">
12 <!ENTITY icu-buildsize "292 MB (add 32 MB for tests)">
13 <!ENTITY icu-time "2.1 SBU (add 1.8 SBU for tests)">
14]>
15
16<sect1 id="icu" xreflabel="ICU-&icu-version;">
17 <?dbhtml filename="icu.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>ICU-&icu-version;</title>
25
26 <indexterm zone="icu">
27 <primary sortas="a-ICU">ICU</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to ICU</title>
32
33 <para>
34 The <application>International Components for Unicode</application> (ICU)
35 package is a mature, widely used set of C/C++ libraries providing Unicode
36 and Globalization support for software applications.
37 <application>ICU</application> is widely portable and gives applications
38 the same results on all platforms.
39 </para>
40
41 &lfs7a_checked;
42
43 <bridgehead renderas="sect3">Package Information</bridgehead>
44 <itemizedlist spacing="compact">
45 <listitem>
46 <para>
47 Download (HTTP): <ulink url="&icu-download-http;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download (FTP): <ulink url="&icu-download-ftp;"/>
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download MD5 sum: &icu-md5sum;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download size: &icu-size;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated disk space required: &icu-buildsize;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Estimated build time: &icu-time;
73 </para>
74 </listitem>
75 </itemizedlist>
76
77 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
78 <itemizedlist spacing="compact">
79 <listitem>
80 <para>
81 Required patch:
82 <ulink url="&patch-root;/icu4c-&icu-version;-fix_enumeration-1.patch"/>
83 </para>
84 </listitem>
85 </itemizedlist>
86
87 <bridgehead renderas="sect3">ICU Dependencies</bridgehead>
88
89 <bridgehead renderas="sect4">Optional</bridgehead>
90 <para role="optional">
91 <xref linkend="llvm"/> (with Clang), and
92 <xref linkend="doxygen"/> (for documentation)
93 </para>
94
95 <para condition="html" role="usernotes">
96 User Notes: <ulink url="&blfs-wiki;/icu"/>
97 </para>
98 </sect2>
99
100 <sect2 role="installation">
101 <title>Installation of ICU</title>
102
103 <para>
104 First, fix a regression in version 58.1:
105 </para>
106
107<screen><userinput>patch -p1 -i ../icu4c-&icu-version;-fix_enumeration-1.patch</userinput></screen>
108
109 <para>
110 Install <application>ICU</application> by running the following commands:
111 </para>
112
113<screen><userinput>cd source &amp;&amp;
114./configure --prefix=/usr &amp;&amp;
115make</userinput></screen>
116
117 <para>
118 To test the results, issue: <command>make check</command>.
119 </para>
120
121 <para>
122 Now, as the <systemitem class="username">root</systemitem> user:
123 </para>
124
125<screen role="root"><userinput>make install</userinput></screen>
126 </sect2>
127
128 <sect2 role="commands">
129 <title>Command Explanations</title>
130
131 <para>
132 <envar>CC=gcc CXX=g++</envar>: If you prefer to use
133 <command>gcc</command> and/or <command>g++</command> instead of
134 <command>clang</command> and/or <command>clang++</command>, if they are
135 installed, use one or both variables in the configure line.
136 </para>
137
138 </sect2>
139
140 <sect2 role="content">
141 <title>Contents</title>
142
143 <segmentedlist>
144 <segtitle>Installed Programs</segtitle>
145 <segtitle>Installed Libraries</segtitle>
146 <segtitle>Installed Directories</segtitle>
147
148 <seglistitem>
149 <seg>
150 derb, genbrk, genccode, gencfu, gencmn, gencnval, gendict, gennorm2,
151 genrb, gensprep, icu-config, icuinfo, icupkg, makeconv, pkgdata, and
152 uconv
153 </seg>
154 <seg>
155 libicudata.so, libicui18n.so, libicuio.so, libicule.so, libiculx.so,
156 libicutest.so, libicutu.so, and libicuuc.so
157 </seg>
158 <seg>
159 /usr/include/layout,
160 /usr/include/unicode,
161 /usr/lib/icu, and
162 /usr/share/icu
163 </seg>
164 </seglistitem>
165 </segmentedlist>
166
167 <variablelist>
168 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
169 <?dbfo list-presentation="list"?>
170 <?dbhtml list-presentation="table"?>
171
172 <varlistentry id="derb">
173 <term><command>derb</command></term>
174 <listitem>
175 <para>
176 disassembles a resource bundle.
177 </para>
178 <indexterm zone="icu derb">
179 <primary sortas="b-derb">derb</primary>
180 </indexterm>
181 </listitem>
182 </varlistentry>
183
184 <varlistentry id="genbrk">
185 <term><command>genbrk</command></term>
186 <listitem>
187 <para>
188 compiles ICU break iteration rules source files into binary data
189 files.
190 </para>
191 <indexterm zone="icu genbrk">
192 <primary sortas="b-genbrk">genbrk</primary>
193 </indexterm>
194 </listitem>
195 </varlistentry>
196
197 <varlistentry id="genccode">
198 <term><command>genccode</command></term>
199 <listitem>
200 <para>
201 generates C or platform specific assembly code from an ICU data
202 file.
203 </para>
204 <indexterm zone="icu genccode">
205 <primary sortas="b-genccode">genccode</primary>
206 </indexterm>
207 </listitem>
208 </varlistentry>
209
210 <varlistentry id="gencfu">
211 <term><command>gencfu</command></term>
212 <listitem>
213 <para>
214 reads in Unicode confusable character definitions and writes out the
215 binary data.
216 </para>
217 <indexterm zone="icu gencfu">
218 <primary sortas="b-gencfu">gencfu</primary>
219 </indexterm>
220 </listitem>
221 </varlistentry>
222
223 <varlistentry id="gencmn">
224 <term><command>gencmn</command></term>
225 <listitem>
226 <para>
227 generates an ICU memory-mappable data file.
228 </para>
229 <indexterm zone="icu gencmn">
230 <primary sortas="b-gencmn">gencmn</primary>
231 </indexterm>
232 </listitem>
233 </varlistentry>
234
235 <varlistentry id="gencnval">
236 <term><command>gencnval</command></term>
237 <listitem>
238 <para>
239 compiles the converter's aliases file.
240 </para>
241 <indexterm zone="icu gencnval">
242 <primary sortas="b-gencnval">gencnval</primary>
243 </indexterm>
244 </listitem>
245 </varlistentry>
246
247 <varlistentry id="gendict">
248 <term><command>gendict</command></term>
249 <listitem>
250 <para>
251 compiles word lists into ICU string trie dictionaries.
252 </para>
253 <indexterm zone="icu gendict">
254 <primary sortas="b-gendict">gendict</primary>
255 </indexterm>
256 </listitem>
257 </varlistentry>
258
259 <varlistentry id="gennorm2">
260 <term><command>gennorm2</command></term>
261 <listitem>
262 <para>
263 builds binary data files with Unicode normalization data.
264 </para>
265 <indexterm zone="icu gennorm2">
266 <primary sortas="b-gennorm2">gennorm2</primary>
267 </indexterm>
268 </listitem>
269 </varlistentry>
270
271 <varlistentry id="genrb">
272 <term><command>genrb</command></term>
273 <listitem>
274 <para>
275 compiles a resource bundle.
276 </para>
277 <indexterm zone="icu genrb">
278 <primary sortas="b-genrb">genrb</primary>
279 </indexterm>
280 </listitem>
281 </varlistentry>
282
283 <varlistentry id="gensprep">
284 <term><command>gensprep</command></term>
285 <listitem>
286 <para>
287 compiles StringPrep data from filtered RFC 3454 files.
288 </para>
289 <indexterm zone="icu gensprep">
290 <primary sortas="b-gensprep">gensprep</primary>
291 </indexterm>
292 </listitem>
293 </varlistentry>
294
295 <varlistentry id="icu-config">
296 <term><command>icu-config</command></term>
297 <listitem>
298 <para>
299 outputs ICU build options.
300 </para>
301 <indexterm zone="icu icu-config">
302 <primary sortas="b-icu-config">icu-config</primary>
303 </indexterm>
304 </listitem>
305 </varlistentry>
306
307 <varlistentry id="icuinfo">
308 <term><command>icuinfo</command></term>
309 <listitem>
310 <para>
311 outputs configuration information about the current ICU.
312 </para>
313 <indexterm zone="icu icuinfo">
314 <primary sortas="b-icuinfo">icuinfo</primary>
315 </indexterm>
316 </listitem>
317 </varlistentry>
318
319 <varlistentry id="icupkg">
320 <term><command>icupkg</command></term>
321 <listitem>
322 <para>
323 extracts or modifies an ICU .dat archive.
324 </para>
325 <indexterm zone="icu icupkg">
326 <primary sortas="b-icupkg">icupkg</primary>
327 </indexterm>
328 </listitem>
329 </varlistentry>
330
331 <varlistentry id="makeconv">
332 <term><command>makeconv</command></term>
333 <listitem>
334 <para>
335 compiles a converter table.
336 </para>
337 <indexterm zone="icu makeconv">
338 <primary sortas="b-makeconv">makeconv</primary>
339 </indexterm>
340 </listitem>
341 </varlistentry>
342
343 <varlistentry id="pkgdata">
344 <term><command>pkgdata</command></term>
345 <listitem>
346 <para>
347 packages data for use by ICU.
348 </para>
349 <indexterm zone="icu pkgdata">
350 <primary sortas="b-pkgdata">pkgdata</primary>
351 </indexterm>
352 </listitem>
353 </varlistentry>
354
355 <varlistentry id="uconv">
356 <term><command>uconv</command></term>
357 <listitem>
358 <para>
359 converts data from one encoding to another.
360 </para>
361 <indexterm zone="icu uconv">
362 <primary sortas="b-uconv">uconv</primary>
363 </indexterm>
364 </listitem>
365 </varlistentry>
366
367 <varlistentry id="libicudata">
368 <term><filename class="libraryfile">libicudata.so</filename></term>
369 <listitem>
370 <para>
371 is the data library.
372 </para>
373 <indexterm zone="icu libicudata">
374 <primary sortas="c-libicudata">libicudata.so</primary>
375 </indexterm>
376 </listitem>
377 </varlistentry>
378
379 <varlistentry id="libicui18n">
380 <term><filename class="libraryfile">libicui18n.so</filename></term>
381 <listitem>
382 <para>
383 is the internationalization (i18n) library.
384 </para>
385 <indexterm zone="icu libicui18n">
386 <primary sortas="c-libicui18n">libicui18n.so</primary>
387 </indexterm>
388 </listitem>
389 </varlistentry>
390
391 <varlistentry id="libicuio">
392 <term><filename class="libraryfile">libicuio.so</filename></term>
393 <listitem>
394 <para>
395 is the ICU I/O (unicode stdio) library.
396 </para>
397 <indexterm zone="icu libicuio">
398 <primary sortas="c-libicuio">libicuio.so</primary>
399 </indexterm>
400 </listitem>
401 </varlistentry>
402
403 <varlistentry id="libicule">
404 <term><filename class="libraryfile">libicule.so</filename></term>
405 <listitem>
406 <para>
407 is the layout engine.
408 </para>
409 <indexterm zone="icu libicule">
410 <primary sortas="c-libicule">libicule.so</primary>
411 </indexterm>
412 </listitem>
413 </varlistentry>
414
415 <varlistentry id="libiculx">
416 <term><filename class="libraryfile">libiculx.so</filename></term>
417 <listitem>
418 <para>
419 is the layout extensions engine.
420 </para>
421 <indexterm zone="icu libiculx">
422 <primary sortas="c-libiculx">libiculx.so</primary>
423 </indexterm>
424 </listitem>
425 </varlistentry>
426
427 <varlistentry id="libicutest">
428 <term><filename class="libraryfile">libicutest.so</filename></term>
429 <listitem>
430 <para>
431 is the test library.
432 </para>
433 <indexterm zone="icu libicutest">
434 <primary sortas="c-libicutest">libicutest.so</primary>
435 </indexterm>
436 </listitem>
437 </varlistentry>
438
439 <varlistentry id="libicutu">
440 <term><filename class="libraryfile">libicutu.so</filename></term>
441 <listitem>
442 <para>
443 is the tool utility library.
444 </para>
445 <indexterm zone="icu libicutu">
446 <primary sortas="c-libicutu">libicutu.so</primary>
447 </indexterm>
448 </listitem>
449 </varlistentry>
450
451 <varlistentry id="libicuuc">
452 <term><filename class="libraryfile">libicuuc.so</filename></term>
453 <listitem>
454 <para>
455 is the common library.
456 </para>
457 <indexterm zone="icu libicuuc">
458 <primary sortas="c-libicuuc">libicuuc.so</primary>
459 </indexterm>
460 </listitem>
461 </varlistentry>
462
463 </variablelist>
464
465 </sect2>
466
467</sect1>
Note: See TracBrowser for help on using the repository browser.