source: general/genlib/icu.xml@ cbcf148

11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/xf86-video-removal
Last change on this file since cbcf148 was 3f2db3a6, checked in by Pierre Labastie <pierre.labastie@…>, 18 months ago

Remove sect1info tags

They only contain a date tag that is nowhere used.

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