glfs/general/genlib/icu.xml
Ken Moffat 236b13f347 Fix to previous commit: comment the icu dependencies heading now all the dependencies are now commented.
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@9157 af4574ff-66df-0310-9fd7-8a98e5e911e0
2011-12-30 16:50:10 +00:00

350 lines
12 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_8_1_1-src.tgz">
<!ENTITY icu-download-ftp " ">
<!ENTITY icu-md5sum "ea93970a0275be6b42f56953cd332c17">
<!ENTITY icu-size "18 MB">
<!ENTITY icu-buildsize "245 MB (+ 20MB if running the testsuite)">
<!ENTITY icu-time "2.2 SBU (+ 2.6 SBU if running the testsuite)">
]>
<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>
&lfs70_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>
Commenting this because the layout sample (only thing using these) isn't
built by default, the instructions in the readme.html are not correct (make
all doesn't build it), and running it requires non-standard fonts
<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>On at least x86_64, the testsuite ends with a segmentation fault, and
therefore reports an error in cintltest and ends in error. If you nevertheless
wish 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, and uconv</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>