source: general/genlib/icu.xml@ 22e8a2af

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 12.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gimp3 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/for-12.3 xry111/intltool xry111/llvm18 xry111/soup3 xry111/spidermonkey128 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 22e8a2af was 22e8a2af, checked in by Ken Moffat <ken@…>, 6 years ago

icu4c-62_1

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

  • Property mode set to 100644
File size: 14.3 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 "490ad9d920158e0314e10ba74ae9a150">
11 <!ENTITY icu-size "23 MB">
12 <!ENTITY icu-buildsize "331 MB (add 33 MB for tests)">
13 <!ENTITY icu-time "2.4 SBU (add 1.7 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 &lfs82_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 <note>
104 <para>
105 If <command>clang++</command> is available, it will be used in the
106 mistaken belief that <command>g++</command> might not support C++11,
107 even though <command>configure</command> has tested for that. If
108 using <command>g++</command> there will be an unnecessary warning at
109 the end of <command>configure</command>. Building with
110 <command>g++</command> also takes longer than the estimated SBU shown.
111 </para>
112 </note>
113<!--
114 <para>
115 First, fix a regression in version 58.1:
116 </para>
117
118<screen><userinput>patch -p1 -i ../icu4c-&icu-version;-fix_enumeration-1.patch</userinput></screen>
119-->
120 <para>
121 Install <application>ICU</application> by running the following commands:
122 </para>
123
124<!-- Review comments at:
125https://chromium.googlesource.com/chromium/src/+/e58fa0ba66272c5f28828b15d06c7e42a9882b3b
126To see if the following prebuild command is appropriate for BLFS:
127sed '/fdef U_CHARSET_I/i#define U_CHARSET_IS_UTF8 1' -i common/unicode/platform.h
128-->
129<screen><userinput>cd source &amp;&amp;
130
131./configure --prefix=/usr &amp;&amp;
132make</userinput></screen>
133
134 <para>
135 To test the results, issue: <command>make check</command>.
136 </para>
137
138 <para>
139 Now, as the <systemitem class="username">root</systemitem> user:
140 </para>
141
142<screen role="root"><userinput>make install</userinput></screen>
143 </sect2>
144
145 <sect2 role="content">
146 <title>Contents</title>
147
148 <segmentedlist>
149 <segtitle>Installed Programs</segtitle>
150 <segtitle>Installed Libraries</segtitle>
151 <segtitle>Installed Directories</segtitle>
152
153 <seglistitem>
154 <seg>
155 derb, escapesrc, genbrk, genccode, gencfu, gencmn, gencnval,
156 gendict, gennorm2,
157 genrb, gensprep, icu-config, icuinfo, icupkg, makeconv, pkgdata, and
158 uconv
159 </seg>
160 <seg>
161 libicudata.so, libicui18n.so, libicuio.so,
162 libicutest.so, libicutu.so, and libicuuc.so
163 </seg>
164 <seg>
165 /usr/include/unicode,
166 /usr/lib/icu, and
167 /usr/share/icu
168 </seg>
169 </seglistitem>
170 </segmentedlist>
171
172 <variablelist>
173 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
174 <?dbfo list-presentation="list"?>
175 <?dbhtml list-presentation="table"?>
176
177 <varlistentry id="derb">
178 <term><command>derb</command></term>
179 <listitem>
180 <para>
181 disassembles a resource bundle.
182 </para>
183 <indexterm zone="icu derb">
184 <primary sortas="b-derb">derb</primary>
185 </indexterm>
186 </listitem>
187 </varlistentry>
188
189 <varlistentry id="escapesrc">
190 <term><command>escapesrc</command></term>
191 <listitem>
192 <para>
193 converts <quote>\u</quote> escaped characters into unicode
194 characters.
195 </para>
196 <indexterm zone="icu escapesrc">
197 <primary sortas="b-escapesrc">escapesrc</primary>
198 </indexterm>
199 </listitem>
200 </varlistentry>
201
202 <varlistentry id="genbrk">
203 <term><command>genbrk</command></term>
204 <listitem>
205 <para>
206 compiles ICU break iteration rules source files into binary data
207 files.
208 </para>
209 <indexterm zone="icu genbrk">
210 <primary sortas="b-genbrk">genbrk</primary>
211 </indexterm>
212 </listitem>
213 </varlistentry>
214
215 <varlistentry id="genccode">
216 <term><command>genccode</command></term>
217 <listitem>
218 <para>
219 generates C or platform specific assembly code from an ICU data
220 file.
221 </para>
222 <indexterm zone="icu genccode">
223 <primary sortas="b-genccode">genccode</primary>
224 </indexterm>
225 </listitem>
226 </varlistentry>
227
228 <varlistentry id="gencfu">
229 <term><command>gencfu</command></term>
230 <listitem>
231 <para>
232 reads in Unicode confusable character definitions and writes out the
233 binary data.
234 </para>
235 <indexterm zone="icu gencfu">
236 <primary sortas="b-gencfu">gencfu</primary>
237 </indexterm>
238 </listitem>
239 </varlistentry>
240
241 <varlistentry id="gencmn">
242 <term><command>gencmn</command></term>
243 <listitem>
244 <para>
245 generates an ICU memory-mappable data file.
246 </para>
247 <indexterm zone="icu gencmn">
248 <primary sortas="b-gencmn">gencmn</primary>
249 </indexterm>
250 </listitem>
251 </varlistentry>
252
253 <varlistentry id="gencnval">
254 <term><command>gencnval</command></term>
255 <listitem>
256 <para>
257 compiles the converter's aliases file.
258 </para>
259 <indexterm zone="icu gencnval">
260 <primary sortas="b-gencnval">gencnval</primary>
261 </indexterm>
262 </listitem>
263 </varlistentry>
264
265 <varlistentry id="gendict">
266 <term><command>gendict</command></term>
267 <listitem>
268 <para>
269 compiles word lists into ICU string trie dictionaries.
270 </para>
271 <indexterm zone="icu gendict">
272 <primary sortas="b-gendict">gendict</primary>
273 </indexterm>
274 </listitem>
275 </varlistentry>
276
277 <varlistentry id="gennorm2">
278 <term><command>gennorm2</command></term>
279 <listitem>
280 <para>
281 builds binary data files with Unicode normalization data.
282 </para>
283 <indexterm zone="icu gennorm2">
284 <primary sortas="b-gennorm2">gennorm2</primary>
285 </indexterm>
286 </listitem>
287 </varlistentry>
288
289 <varlistentry id="genrb">
290 <term><command>genrb</command></term>
291 <listitem>
292 <para>
293 compiles a resource bundle.
294 </para>
295 <indexterm zone="icu genrb">
296 <primary sortas="b-genrb">genrb</primary>
297 </indexterm>
298 </listitem>
299 </varlistentry>
300
301 <varlistentry id="gensprep">
302 <term><command>gensprep</command></term>
303 <listitem>
304 <para>
305 compiles StringPrep data from filtered RFC 3454 files.
306 </para>
307 <indexterm zone="icu gensprep">
308 <primary sortas="b-gensprep">gensprep</primary>
309 </indexterm>
310 </listitem>
311 </varlistentry>
312
313 <varlistentry id="icu-config">
314 <term><command>icu-config</command></term>
315 <listitem>
316 <para>
317 outputs ICU build options.
318 </para>
319 <indexterm zone="icu icu-config">
320 <primary sortas="b-icu-config">icu-config</primary>
321 </indexterm>
322 </listitem>
323 </varlistentry>
324
325 <varlistentry id="icuinfo">
326 <term><command>icuinfo</command></term>
327 <listitem>
328 <para>
329 outputs configuration information about the current ICU.
330 </para>
331 <indexterm zone="icu icuinfo">
332 <primary sortas="b-icuinfo">icuinfo</primary>
333 </indexterm>
334 </listitem>
335 </varlistentry>
336
337 <varlistentry id="icupkg">
338 <term><command>icupkg</command></term>
339 <listitem>
340 <para>
341 extracts or modifies an ICU .dat archive.
342 </para>
343 <indexterm zone="icu icupkg">
344 <primary sortas="b-icupkg">icupkg</primary>
345 </indexterm>
346 </listitem>
347 </varlistentry>
348
349 <varlistentry id="makeconv">
350 <term><command>makeconv</command></term>
351 <listitem>
352 <para>
353 compiles a converter table.
354 </para>
355 <indexterm zone="icu makeconv">
356 <primary sortas="b-makeconv">makeconv</primary>
357 </indexterm>
358 </listitem>
359 </varlistentry>
360
361 <varlistentry id="pkgdata">
362 <term><command>pkgdata</command></term>
363 <listitem>
364 <para>
365 packages data for use by ICU.
366 </para>
367 <indexterm zone="icu pkgdata">
368 <primary sortas="b-pkgdata">pkgdata</primary>
369 </indexterm>
370 </listitem>
371 </varlistentry>
372
373 <varlistentry id="uconv">
374 <term><command>uconv</command></term>
375 <listitem>
376 <para>
377 converts data from one encoding to another.
378 </para>
379 <indexterm zone="icu uconv">
380 <primary sortas="b-uconv">uconv</primary>
381 </indexterm>
382 </listitem>
383 </varlistentry>
384
385 <varlistentry id="libicudata">
386 <term><filename class="libraryfile">libicudata.so</filename></term>
387 <listitem>
388 <para>
389 is the data library.
390 </para>
391 <indexterm zone="icu libicudata">
392 <primary sortas="c-libicudata">libicudata.so</primary>
393 </indexterm>
394 </listitem>
395 </varlistentry>
396
397 <varlistentry id="libicui18n">
398 <term><filename class="libraryfile">libicui18n.so</filename></term>
399 <listitem>
400 <para>
401 is the internationalization (i18n) library.
402 </para>
403 <indexterm zone="icu libicui18n">
404 <primary sortas="c-libicui18n">libicui18n.so</primary>
405 </indexterm>
406 </listitem>
407 </varlistentry>
408
409 <varlistentry id="libicuio">
410 <term><filename class="libraryfile">libicuio.so</filename></term>
411 <listitem>
412 <para>
413 is the ICU I/O (unicode stdio) library.
414 </para>
415 <indexterm zone="icu libicuio">
416 <primary sortas="c-libicuio">libicuio.so</primary>
417 </indexterm>
418 </listitem>
419 </varlistentry>
420
421<!-- <varlistentry id="libicule">
422 <term><filename class="libraryfile">libicule.so</filename></term>
423 <listitem>
424 <para>
425 is the layout engine.
426 </para>
427 <indexterm zone="icu libicule">
428 <primary sortas="c-libicule">libicule.so</primary>
429 </indexterm>
430 </listitem>
431 </varlistentry>
432
433 <varlistentry id="libiculx">
434 <term><filename class="libraryfile">libiculx.so</filename></term>
435 <listitem>
436 <para>
437 is the layout extensions engine.
438 </para>
439 <indexterm zone="icu libiculx">
440 <primary sortas="c-libiculx">libiculx.so</primary>
441 </indexterm>
442 </listitem>
443 </varlistentry>-->
444
445 <varlistentry id="libicutest">
446 <term><filename class="libraryfile">libicutest.so</filename></term>
447 <listitem>
448 <para>
449 is the test library.
450 </para>
451 <indexterm zone="icu libicutest">
452 <primary sortas="c-libicutest">libicutest.so</primary>
453 </indexterm>
454 </listitem>
455 </varlistentry>
456
457 <varlistentry id="libicutu">
458 <term><filename class="libraryfile">libicutu.so</filename></term>
459 <listitem>
460 <para>
461 is the tool utility library.
462 </para>
463 <indexterm zone="icu libicutu">
464 <primary sortas="c-libicutu">libicutu.so</primary>
465 </indexterm>
466 </listitem>
467 </varlistentry>
468
469 <varlistentry id="libicuuc">
470 <term><filename class="libraryfile">libicuuc.so</filename></term>
471 <listitem>
472 <para>
473 is the common library.
474 </para>
475 <indexterm zone="icu libicuuc">
476 <primary sortas="c-libicuuc">libicuuc.so</primary>
477 </indexterm>
478 </listitem>
479 </varlistentry>
480
481 </variablelist>
482
483 </sect2>
484
485</sect1>
Note: See TracBrowser for help on using the repository browser.