glfs/general/genlib/icu.xml
Ken Moffat bd32b6fda1 Note that a few packages are ok with LFS-6.7
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@8619 af4574ff-66df-0310-9fd7-8a98e5e911e0
2010-09-29 22:29:18 +00:00

346 lines
11 KiB
XML

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY icu-download-http "http://download.icu-project.org/files/icu4c/&icu-version;/icu4c-4_2_1-src.tgz">
<!ENTITY icu-download-ftp " ">
<!ENTITY icu-md5sum "e3738abd0d3ce1870dc1fd1f22bba5b1">
<!ENTITY icu-size "12.6 MB">
<!ENTITY icu-buildsize "227 MB">
<!ENTITY icu-time "3.6 SBU">
]>
<sect1 id="icu" xreflabel="ICU-&icu-version;">
<?dbhtml filename="icu.html"?>
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<title>ICU-&icu-version;</title>
<indexterm zone="icu">
<primary sortas="a-ICU">ICU</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to ICU</title>
<para>The <application>ICU</application> package is a mature, widely used
set of C/C++ libraries providing Unicode and Globalization support for
software applications. <application>ICU</application> is widely portable and
gives applications the same results on all platforms.</para>
&lfs67_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&icu-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&icu-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &icu-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &icu-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &icu-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &icu-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">ICU Dependencies</bridgehead>
<bridgehead renderas="sect4">Optional (To build the sample code)</bridgehead>
<para role="optional"><xref linkend="cairo"/>,
<xref linkend="freetype2"/>, and
<xref linkend="libgnomeui"/></para>
<para>See readme.txt under the source/samples directory for further
details.</para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/icu"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of ICU</title>
<para>Install <application>ICU</application> by running the following
commands:</para>
<screen><userinput>cd source &amp;&amp;
chmod +x runConfigureICU configure install-sh &amp;&amp;
./runConfigureICU Linux --prefix=/usr &amp;&amp;
make</userinput></screen>
<para>To test the results, issue: <command>make check</command>.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>derb, genbrk, gencfu, gencnval, genctd, genrb, icu-config,
makeconv, pkgdata, uconv, genccode, gencmn, gensprep, genuca, and
icupkg</seg>
<seg>libicudata.so, libicui18n.so, libicuio.so, libicule.so,
libiculx.so, libicutu.so, and libicuuc.so</seg>
<seg>/usr/{include/{layout,unicode},lib/icu/&icu-version;,
share/icu/&icu-version;/config}</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="derb">
<term><command>derb</command></term>
<listitem>
<para>disassembles a resource bundle.</para>
<indexterm zone="icu derb">
<primary sortas="b-derb">derb</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="genbrk">
<term><command>genbrk</command></term>
<listitem>
<para>compiles ICU break iteration rules source files into binary data
files.</para>
<indexterm zone="icu genbrk">
<primary sortas="b-genbrk">genbrk</primary>
</indexterm>
</listitem>
</varlistentry>
<!--<varlistentry id="gencfu">
<term><command>gencfu</command></term>
<listitem>
<para>does this .....</para>
<indexterm zone="icu gencfu">
<primary sortas="b-gencfu">gencfu</primary>
</indexterm>
</listitem>
</varlistentry>-->
<varlistentry id="gencnval">
<term><command>gencnval</command></term>
<listitem>
<para>compiles the converters aliases file.</para>
<indexterm zone="icu gencnval">
<primary sortas="b-gencnval">gencnval</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="genctd">
<term><command>genctd</command></term>
<listitem>
<para>compiles word list into ICU compact trie dictionary.</para>
<indexterm zone="icu genctd">
<primary sortas="b-genctd">genctd</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="genrb">
<term><command>genrb</command></term>
<listitem>
<para>compile a resource bundle.</para>
<indexterm zone="icu genrb">
<primary sortas="b-genrb">genrb</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="icu-config">
<term><command>icu-config</command></term>
<listitem>
<para>outputs ICU build options.</para>
<indexterm zone="icu icu-config">
<primary sortas="b-icu-config">icu-config</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="makeconv">
<term><command>makeconv</command></term>
<listitem>
<para>compiles a converter table.</para>
<indexterm zone="icu makeconv">
<primary sortas="b-makeconv">makeconv</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="pkgdata">
<term><command>pkgdata</command></term>
<listitem>
<para>packages data for use by ICU.</para>
<indexterm zone="icu pkgdata">
<primary sortas="b-pkgdata">pkgdata</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="uconv">
<term><command>uconv</command></term>
<listitem>
<para>converts data from one encoding to another.</para>
<indexterm zone="icu uconv">
<primary sortas="b-uconv">uconv</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="genccode">
<term><command>genccode</command></term>
<listitem>
<para>generates C or platform specific assembly code from an ICU data
file.</para>
<indexterm zone="icu genccode">
<primary sortas="b-genccode">genccode</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="gencmn">
<term><command>gencmn</command></term>
<listitem>
<para>generates an ICU memory-mappable data file.</para>
<indexterm zone="icu gencmn">
<primary sortas="b-gencmn">gencmn</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="gensprep">
<term><command>gensprep</command></term>
<listitem>
<para>compiles StringPrep data from files filtered by
filterRFC3454.pl.</para>
<indexterm zone="icu gensprep">
<primary sortas="b-gensprep">gensprep</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="genuca">
<term><command>genuca</command></term>
<listitem>
<para>creates the UCA data table.</para>
<indexterm zone="icu genuca">
<primary sortas="b-genuca">genuca</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="icupkg">
<term><command>icupkg</command></term>
<listitem>
<para>extracts or modifies an ICU .dat archive.</para>
<indexterm zone="icu icupkg">
<primary sortas="b-icupkg">icupkg</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libicudata">
<term><filename class='libraryfile'>libicudata.so</filename></term>
<listitem>
<para>is the data library.</para>
<indexterm zone="icu libicudata">
<primary sortas="c-libicudata">libicudata.so</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libicui18n">
<term><filename class='libraryfile'>libicui18n.so</filename></term>
<listitem>
<para>is the internationalization (i18n) library.</para>
<indexterm zone="icu libicui18n">
<primary sortas="c-libicui18n">libicui18n.so</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libicuio">
<term><filename class='libraryfile'>libicuio.so</filename></term>
<listitem>
<para>is the ICU I/O (unicode stdio) library.</para>
<indexterm zone="icu libicuio">
<primary sortas="c-libicuio">libicuio.so</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libicule">
<term><filename class='libraryfile'>libicule.so</filename></term>
<listitem>
<para>is the layout engine.</para>
<indexterm zone="icu libicule">
<primary sortas="c-libicule">libicule.so</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libiculx">
<term><filename class='libraryfile'>libiculx.so</filename></term>
<listitem>
<para>is the layout extensions engine.</para>
<indexterm zone="icu libiculx">
<primary sortas="c-libiculx">libiculx.so</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libicutu">
<term><filename class='libraryfile'>libicutu.so</filename></term>
<listitem>
<para>is the tool utility library.</para>
<indexterm zone="icu libicutu">
<primary sortas="c-libicutu">libicutu.so</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libicuuc">
<term><filename class='libraryfile'>libicuuc.so</filename></term>
<listitem>
<para>is the common library.</para>
<indexterm zone="icu libicuuc">
<primary sortas="c-libicuuc">libicuuc.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>