source: general/genlib/icu.xml@ 4afbfbd

11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/xf86-video-removal
Last change on this file since 4afbfbd was 4afbfbd, checked in by Xi Ruoyao <xry111@…>, 19 months ago

icu: add a note about extracted directory name

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