source: general/genlib/libidn.xml@ 4de23175

10.0 10.1 11.0 9.1 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 4de23175 was 4de23175, checked in by Douglas R. Reno <renodr@…>, 20 months ago

A few tags

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@22705 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 6.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 libidn-download-http "&gnu-http;/libidn/libidn-&libidn-version;.tar.gz">
8 <!ENTITY libidn-download-ftp "&gnu-ftp;/libidn/libidn-&libidn-version;.tar.gz">
9 <!ENTITY libidn-md5sum "bef634141fe39326cb354b75e891fead">
10 <!ENTITY libidn-size "4.0 MB">
11 <!ENTITY libidn-buildsize "25 MB">
12 <!ENTITY libidn-time "0.2 SBU (using parallelim=4)">
13]>
14
15<sect1 id="libidn" xreflabel="libidn-&libidn-version;">
16 <?dbhtml filename="libidn.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>libidn-&libidn-version;</title>
24
25 <indexterm zone="libidn">
26 <primary sortas="a-libidn">libidn</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to libidn</title>
31
32 <para>
33 <application>libidn</application> is a package designed for
34 internationalized string handling based on the
35 <ulink url="http://www.ietf.org/rfc/rfc3454.txt">Stringprep</ulink>,
36 <ulink url="http://www.ietf.org/rfc/rfc3492.txt">Punycode</ulink> and
37 <ulink url="http://www.ietf.org/rfc/rfc3490.txt">IDNA</ulink>
38 specifications defined by the Internet Engineering Task Force
39 (IETF) Internationalized Domain Names (IDN) working group, used for
40 internationalized domain names. This is useful for converting data from the
41 system's native representation into UTF-8, transforming Unicode strings
42 into ASCII strings, allowing applications to use certain ASCII name labels
43 (beginning with a special prefix) to represent non-ASCII name labels, and
44 converting entire domain names to and from the ASCII Compatible Encoding
45 (ACE) form.
46 </para>
47
48 &lfs91_checked;
49
50 <bridgehead renderas="sect3">Package Information</bridgehead>
51 <itemizedlist spacing="compact">
52 <listitem>
53 <para>
54 Download (HTTP): <ulink url="&libidn-download-http;"/>
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download (FTP): <ulink url="&libidn-download-ftp;"/>
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Download MD5 sum: &libidn-md5sum;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Download size: &libidn-size;
70 </para>
71 </listitem>
72 <listitem>
73 <para>
74 Estimated disk space required: &libidn-buildsize;
75 </para>
76 </listitem>
77 <listitem>
78 <para>
79 Estimated build time: &libidn-time;
80 </para>
81 </listitem>
82 </itemizedlist>
83
84 <bridgehead renderas="sect3">libidn Dependencies</bridgehead>
85
86 <bridgehead renderas="sect4">Optional</bridgehead>
87 <para role="optional">
88 <xref linkend="pth"/>,
89 <xref linkend="emacs"/>,
90 <xref linkend="gtk-doc"/>,
91 <xref linkend="openjdk"/>,
92 <xref linkend="valgrind"/>, and
93 <ulink url="http://www.mono-project.com/">Mono</ulink>
94 </para>
95
96 <para condition="html" role="usernotes">User Notes:
97 <ulink url="&blfs-wiki;/libidn"/>
98 </para>
99 </sect2>
100
101 <sect2 role="installation">
102 <title>Installation of libidn</title>
103
104 <para>
105 Install <application>libidn</application> by running the following
106 commands:
107 </para>
108
109<screen><userinput>./configure --prefix=/usr --disable-static &amp;&amp;
110make</userinput></screen>
111
112 <para>
113<!-- This package does not come with a functional test suite. -->
114 To test the results, issue: <command>make check</command>.
115 </para>
116
117 <para>
118 Now, as the <systemitem class="username">root</systemitem> user:
119 </para>
120
121<screen role="root"><userinput>make install &amp;&amp;
122
123find doc -name "Makefile*" -delete &amp;&amp;
124rm -rf -v doc/{gdoc,idn.1,stamp-vti,man,texi} &amp;&amp;
125mkdir -v /usr/share/doc/libidn-&libidn-version; &amp;&amp;
126cp -r -v doc/* /usr/share/doc/libidn-&libidn-version;</userinput></screen>
127
128 </sect2>
129
130 <sect2 role="commands">
131 <title>Command Explanations</title>
132
133 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
134 href="../../xincludes/static-libraries.xml"/>
135
136 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
137 href="../../xincludes/gtk-doc-rebuild.xml"/>
138
139 </sect2>
140
141 <sect2 role="content">
142 <title>Contents</title>
143
144 <segmentedlist>
145 <segtitle>Installed Program</segtitle>
146 <segtitle>Installed Library</segtitle>
147 <segtitle>Installed Directories</segtitle>
148
149 <seglistitem>
150 <seg>
151 idn
152 </seg>
153 <seg>
154 libidn.so
155 </seg>
156 <seg>
157 /usr/share/doc/libidn-&libidn-version; and
158 /usr/share/gtk-doc/html/libidn
159 </seg>
160 </seglistitem>
161 </segmentedlist>
162
163 <variablelist>
164 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
165 <?dbfo list-presentation="list"?>
166 <?dbhtml list-presentation="table"?>
167
168 <varlistentry id="idn">
169 <term><command>idn</command></term>
170 <listitem>
171 <para>
172 is a command line interface to the internationalized domain
173 name library.
174 </para>
175 <indexterm zone="libidn idn">
176 <primary sortas="b-idn">idn</primary>
177 </indexterm>
178 </listitem>
179 </varlistentry>
180
181 <varlistentry id="libidn-lib">
182 <term><filename class='libraryfile'>libidn.so</filename></term>
183 <listitem>
184 <para>
185 contains a generic Stringprep implementation that does Unicode
186 3.2 NFKC normalization, mapping and prohibition of characters, and
187 bidirectional character handling. Profiles for Nameprep, iSCSI, SASL
188 and XMPP are included as well as support for Punycode and ASCII
189 Compatible Encoding (ACE) via IDNA. A mechanism to define Top-Level
190 Domain (TLD) specific validation tables, and to compare strings
191 against those tables, as well as default tables for some TLDs are
192 included.
193 </para>
194 <indexterm zone="libidn libidn-lib">
195 <primary sortas="c-libidn">libidn.so</primary>
196 </indexterm>
197 </listitem>
198 </varlistentry>
199
200 </variablelist>
201
202 </sect2>
203
204</sect1>
Note: See TracBrowser for help on using the repository browser.