source: general/genlib/libidn.xml@ 350452c

10.0 10.1 11.0 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 350452c was 350452c, checked in by Randy McMurchy <randy@…>, 13 years ago

Changed hard-coded URLs to use the Anduin entity

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

  • Property mode set to 100644
File size: 7.6 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 "&sources-anduin-http;/l/libidn-&libidn-version;.tar.gz">
8 <!-- <!ENTITY libidn-download-http "http://josefsson.org/libidn/releases/libidn-&libidn-version;.tar.gz"> -->
9 <!ENTITY libidn-download-ftp "ftp://alpha.gnu.org/pub/gnu/libidn/libidn-&libidn-version;.tar.gz">
10 <!ENTITY libidn-md5sum "040f012a45feb56168853998bb87ad4d">
11 <!ENTITY libidn-size "2.3 MB">
12 <!ENTITY libidn-buildsize "19 MB">
13 <!ENTITY libidn-time "0.2 SBU">
14]>
15
16<sect1 id="libidn" xreflabel="libidn-&libidn-version;">
17 <?dbhtml filename="libidn.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>Libidn-&libidn-version;</title>
25
26 <indexterm zone="libidn">
27 <primary sortas="a-Libidn">Libidn</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to Libidn</title>
32
33 <para><application>Libidn</application> is a package designed for
34 internationalized string handling based on the <ulink
35 url="http://josefsson.org/cgi-bin/rfcmarkup?url=http://www.ietf.org/rfc/rfc3454.txt">
36 Stringprep</ulink>, <ulink
37 url="http://josefsson.org/cgi-bin/rfcmarkup?url=http://www.ietf.org/rfc/rfc3492.txt">
38 Punycode</ulink>, <ulink
39 url="http://josefsson.org/cgi-bin/rfcmarkup?url=http://www.ietf.org/rfc/rfc3490.txt">
40 IDNA</ulink> and <ulink
41 url="http://josefsson.org/cgi-bin/rfcmarkup?url=http://josefsson.org/cgi-bin/viewcvs.cgi/*checkout*/libidn/doc/specifications/draft-hoffman-idn-reg-02.txt">
42 TLD</ulink> specifications defined by the Internet Engineering Task Force
43 (IETF) Internationalized Domain Names (IDN) working group, used for
44 internationalized domain names. This is useful for converting data from the
45 system's native representation into UTF-8, transforming Unicode strings
46 into ASCII strings, allowing applications to use certain ASCII name labels
47 (beginning with a special prefix) to represent non-ASCII name labels, and
48 converting entire domain names to and from the ASCII Compatible Encoding
49 (ACE) form.</para>
50
51 <bridgehead renderas="sect3">Package Information</bridgehead>
52 <itemizedlist spacing="compact">
53 <listitem>
54 <para>Download (HTTP): <ulink url="&libidn-download-http;"/></para>
55 </listitem>
56 <listitem>
57 <para>Download (FTP): <ulink url="&libidn-download-ftp;"/></para>
58 </listitem>
59 <listitem>
60 <para>Download MD5 sum: &libidn-md5sum;</para>
61 </listitem>
62 <listitem>
63 <para>Download size: &libidn-size;</para>
64 </listitem>
65 <listitem>
66 <para>Estimated disk space required: &libidn-buildsize;</para>
67 </listitem>
68 <listitem>
69 <para>Estimated build time: &libidn-time;</para>
70 </listitem>
71 </itemizedlist>
72
73 <bridgehead renderas="sect3">Libidn Dependencies</bridgehead>
74
75 <bridgehead renderas="sect4">Optional</bridgehead>
76 <para role="optional"><xref linkend="emacs"/>,
77 <xref linkend="pkgconfig"/>,
78 <xref linkend="gtk-doc"/>,
79 a Java compiler&mdash;one of (looked for in this order)
80 <xref linkend="gcc"/> (for <command>gcj</command> and you must also have
81 the <ulink url="ftp://ftp.gnu.org/gnu/classpath/">gjdoc</ulink> package
82 installed),
83 <ulink url="http://jikes.sourceforge.net/">Jikes</ulink> or
84 <xref linkend="jdk"/>,
85 and a C# compiler&mdash;<ulink
86 url="http://www.mono-project.com/Main_Page">Mono</ulink> or
87 <ulink url="http://www.southern-storm.com.au/portable_net.html">
88 DotGNU Portable.NET</ulink></para>
89
90 <para condition="html" role="usernotes">User Notes:
91 <ulink url="&blfs-wiki;/libidn"/></para>
92
93 </sect2>
94
95 <sect2 role="installation">
96 <title>Installation of Libidn</title>
97
98 <para>Install <application>Libidn</application> by running the following
99 commands:</para>
100
101<screen><userinput>./configure --prefix=/usr &amp;&amp;
102make</userinput></screen>
103
104 <!-- <para>If you have <xref linkend="tetex"/> installed and wish to create a
105 text version of the documentation, issue the following commands:</para>
106
107<screen><userinput>cd doc &amp;&amp;
108makeinfo (double-dash removed intentionally) -plaintext -o libidn.txt libidn.texi &amp;&amp;
109cd ..</userinput></screen> -->
110
111 <para>To test the results, issue: <command>make check</command>.</para>
112
113 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
114
115<screen role="root"><userinput>make install &amp;&amp;
116find doc -name "Makefile*" -exec rm {} \; &amp;&amp;
117
118install -v -m755 -d \
119 /usr/share/doc/libidn-&libidn-version;/{api,java,specifications,tld} &amp;&amp;
120install -v -m644 doc/components* \
121 doc/libidn.{pdf,ps,html} \
122 /usr/share/doc/libidn-&libidn-version; &amp;&amp;
123install -v -m644 doc/reference/html/* \
124 /usr/share/doc/libidn-&libidn-version;/api &amp;&amp;
125install -v -m644 doc/specifications/* \
126 /usr/share/doc/libidn-&libidn-version;/specifications &amp;&amp;
127install -v -m644 doc/tld/* /usr/share/doc/libidn-&libidn-version;/tld &amp;&amp;
128cp -v -R doc/java/* /usr/share/doc/libidn-&libidn-version;/java</userinput></screen>
129
130 <!-- <para>If you created the text documentation, install it using the following
131 command as the <systemitem class="username">root</systemitem> user:</para>
132
133<screen role="root"><userinput>install -v -m644 doc/libidn.txt /usr/share/doc/libidn-&libidn-version;</userinput></screen> -->
134
135 </sect2>
136
137 <sect2 role="commands">
138 <title>Command Explanations</title>
139
140 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
141 href="../../xincludes/gtk-doc-rebuild.xml"/>
142
143 </sect2>
144
145 <sect2 role="content">
146 <title>Contents</title>
147
148 <segmentedlist>
149 <segtitle>Installed Program</segtitle>
150 <segtitle>Installed Libraries</segtitle>
151 <segtitle>Installed Directory</segtitle>
152
153 <seglistitem>
154 <seg>idn</seg>
155 <seg>libidn.{so,a} and optionally, Java and C# modules</seg>
156 <seg>/usr/share/doc/libidn-&libidn-version;</seg>
157 </seglistitem>
158 </segmentedlist>
159
160 <variablelist>
161 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
162 <?dbfo list-presentation="list"?>
163 <?dbhtml list-presentation="table"?>
164
165 <varlistentry id="idn">
166 <term><command>idn</command></term>
167 <listitem>
168 <para>is a command line interface to the internationalized domain
169 name library.</para>
170 <indexterm zone="libidn idn">
171 <primary sortas="b-idn">idn</primary>
172 </indexterm>
173 </listitem>
174 </varlistentry>
175
176 <varlistentry id="libidn-lib">
177 <term><filename class='libraryfile'>libidn.{so,a}</filename></term>
178 <listitem>
179 <para> contains a generic Stringprep implementation that does Unicode
180 3.2 NFKC normalization, mapping and prohibition of characters, and
181 bidirectional character handling. Profiles for Nameprep, iSCSI, SASL
182 and XMPP are included as well as support for Punycode and ASCII
183 Compatible Encoding (ACE) via IDNA. A mechanism to define Top-Level
184 Domain (TLD) specific validation tables, and to compare strings
185 against those tables, as well as default tables for some TLDs are
186 included.</para>
187 <indexterm zone="libidn libidn-lib">
188 <primary sortas="c-libidn">libidn.{so,a}</primary>
189 </indexterm>
190 </listitem>
191 </varlistentry>
192
193 </variablelist>
194
195 </sect2>
196
197</sect1>
Note: See TracBrowser for help on using the repository browser.