source: general/genlib/icu.xml@ b01309e7

11.0 ken/refactor-virt lazarus qt5new trunk
Last change on this file since b01309e7 was b01309e7, checked in by Douglas R. Reno <renodr@…>, 6 months ago

Update to ICU-69.1
Fix building WebKitGTK+ with ICU-69.1 (patch from Xi Ruoyao)
Fix building Node.JS with ICU-69.1 (patch from Ken Moffat)

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