summaryrefslogtreecommitdiff
path: root/doc/libunistring_16.html
diff options
context:
space:
mode:
authorStephen Kitt <skitt@debian.org>2016-05-27 10:11:04 +0200
committerManuel A. Fernandez Montecelo <manuel.montezelo@gmail.com>2016-05-27 14:28:33 +0100
commit752fd7247bc223bcea35bd89cf56d1c08ead9ba6 (patch)
treeb4a428f847a963738faaf24c8eff070fdb03a3a5 /doc/libunistring_16.html
parent9f7d4fa477ff2a51d7c932b13d57ac22dc033105 (diff)
parenta9a31b1de5776a3b08a82101a4fa711294f0dd1d (diff)
Imported Debian patch 0.9.6+really0.9.3-0.1debian/0.9.6+really0.9.3-0.1
Diffstat (limited to 'doc/libunistring_16.html')
-rw-r--r--doc/libunistring_16.html177
1 files changed, 19 insertions, 158 deletions
diff --git a/doc/libunistring_16.html b/doc/libunistring_16.html
index cb3496a6..5e9abeb5 100644
--- a/doc/libunistring_16.html
+++ b/doc/libunistring_16.html
@@ -1,6 +1,6 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html401/loose.dtd">
<html>
-<!-- Created on July, 8 2015 by texi2html 1.78a -->
+<!-- Created on March, 30 2010 by texi2html 1.78a -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -11,10 +11,10 @@ Send bugs and suggestions to <texi2html-bug@nongnu.org>
-->
<head>
-<title>GNU libunistring: 16. Using the library</title>
+<title>GNU libunistring: 16. More advanced functionality</title>
-<meta name="description" content="GNU libunistring: 16. Using the library">
-<meta name="keywords" content="GNU libunistring: 16. Using the library">
+<meta name="description" content="GNU libunistring: 16. More advanced functionality">
+<meta name="keywords" content="GNU libunistring: 16. More advanced functionality">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="texi2html 1.78a">
@@ -42,8 +42,8 @@ ul.toc {list-style: none}
<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<table cellpadding="1" cellspacing="1" border="0">
-<tr><td valign="middle" align="left">[<a href="libunistring_15.html#SEC60" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
-<td valign="middle" align="left">[<a href="libunistring_17.html#SEC67" title="Next chapter"> &gt;&gt; </a>]</td>
+<tr><td valign="middle" align="left">[<a href="libunistring_15.html#SEC55" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="libunistring_17.html#SEC62" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
@@ -51,166 +51,27 @@ ul.toc {list-style: none}
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left">[<a href="libunistring.html#SEC_Top" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[<a href="libunistring.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
-<td valign="middle" align="left">[<a href="libunistring_19.html#SEC77" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="libunistring_18.html#SEC71" title="Index">Index</a>]</td>
<td valign="middle" align="left">[<a href="libunistring_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
<hr size="2">
-<a name="Using-the-library"></a>
+<a name="More-functionality"></a>
<a name="SEC61"></a>
-<h1 class="chapter"> <a href="libunistring.html#TOC61">16. Using the library</a> </h1>
+<h1 class="chapter"> <a href="libunistring.html#TOC61">16. More advanced functionality</a> </h1>
-<p>This chapter explains some practical considerations, regarding the
-installation and compiler options that are needed in order to use this
-library.
+<p>For bidirectional reordering of strings, we recommend the GNU FriBidi library:
+<a href="http://www.fribidi.org/">http://www.fribidi.org/</a>.
</p>
-
-<hr size="6">
-<a name="Installation"></a>
-<a name="SEC62"></a>
-<h2 class="section"> <a href="libunistring.html#TOC62">16.1 Installation</a> </h2>
-
-<p>Before you can use the library, it must be installed. First, you have to
-make sure all dependencies are installed. They are listed in the file
-&lsquo;<tt>DEPENDENCIES</tt>&rsquo;.
-</p>
-<a name="IDX891"></a>
-<p>Then you can proceed to build and install the library, as described in the
-file &lsquo;<tt>INSTALL</tt>&rsquo;. For installation on Windows systems, please refer to
-the file &lsquo;<tt>README.woe32</tt>&rsquo;.
-</p>
-<hr size="6">
-<a name="Compiler-options"></a>
-<a name="SEC63"></a>
-<h2 class="section"> <a href="libunistring.html#TOC63">16.2 Compiler options</a> </h2>
-
-<p>Let's denote as <code>LIBUNISTRING_PREFIX</code> the value of the &lsquo;<samp>--prefix</samp>&rsquo;
-option that you passed to <code>configure</code> while installing this package.
-If you didn't pass any &lsquo;<samp>--prefix</samp>&rsquo; option, then the package is installed
-in &lsquo;<tt>/usr/local</tt>&rsquo;.
-</p>
-<p>Let's denote as <code>LIBUNISTRING_INCLUDEDIR</code> the directory where the
-include files were installed. This is usually the same as
-<code>${LIBUNISTRING_PREFIX}/include</code>. Except that if you passed an
-&lsquo;<samp>--includedir</samp>&rsquo; option to <code>configure</code>, it is the value of that
-option.
-</p>
-<p>Let's further denote as <code>LIBUNISTRING_LIBDIR</code> the directory where
-the library itself was installed. This is the value that you passed
-with the &lsquo;<samp>--libdir</samp>&rsquo; option to <code>configure</code>, or otherwise the
-same as <code>${LIBUNISTRING_PREFIX}/lib</code>. Recall that when building
-in 64-bit mode on a 64-bit GNU/Linux system that supports executables
-in either 64-bit mode or 32-bit mode, you should have used the option
-<code>--libdir=${LIBUNISTRING_PREFIX}/lib64</code>.
-</p>
-<a name="IDX892"></a>
-<p>So that the compiler finds the include files, you have to pass it the
-option <code>-I${LIBUNISTRING_INCLUDEDIR}</code>.
-</p>
-<p>So that the compiler finds the library during its linking pass, you have
-to pass it the options <code>-L${LIBUNISTRING_LIBDIR} -lunistring</code>.
-On some systems, in some configurations, you also have to pass options
-needed for linking with <code>libiconv</code>. The autoconf macro
-<code>gl_LIBUNISTRING</code> (see <a href="#SEC65">Autoconf macro</a>) deals with this
-particularity.
-</p>
-<hr size="6">
-<a name="Include-files"></a>
-<a name="SEC64"></a>
-<h2 class="section"> <a href="libunistring.html#TOC64">16.3 Include files</a> </h2>
-
-<p>Most of the include files have been presented in the introduction, see
-<a href="libunistring_1.html#SEC1">Introduction</a>, and subsequent detailed chapters.
-</p>
-<p>Another include file is <code>&lt;unistring/version.h&gt;</code>. It contains the
-version number of the libunistring library.
-</p>
-<dl>
-<dt><u>Macro:</u> int <b>_LIBUNISTRING_VERSION</b>
-<a name="IDX893"></a>
-</dt>
-<dd><p>This constant contains the version of libunistring that is being used
-at compile time. It encodes the major and minor parts of the version
-number only. These parts are encoded in the form <code>(major&lt;&lt;8) + minor</code>.
-</p></dd></dl>
-
-<dl>
-<dt><u>Constant:</u> int <b>_libunistring_version</b>
-<a name="IDX894"></a>
-</dt>
-<dd><p>This constant contains the version of libunistring that is being used
-at run time. It encodes the major and minor parts of the version
-number only. These parts are encoded in the form <code>(major&lt;&lt;8) + minor</code>.
-</p></dd></dl>
-
-<p>It is possible that <code>_libunistring_version</code> is greater than
-<code>_LIBUNISTRING_VERSION</code>. This can happen when you use
-<code>libunistring</code> as a shared library, and a newer, binary
-backward-compatible version has been installed after your program
-that uses <code>libunistring</code> was installed.
-</p>
-<hr size="6">
-<a name="Autoconf-macro"></a>
-<a name="SEC65"></a>
-<h2 class="section"> <a href="libunistring.html#TOC65">16.4 Autoconf macro</a> </h2>
-
-<p>GNU Gnulib provides an autoconf macro that tests for the availability
-of <code>libunistring</code>. It is contained in the Gnulib module
-&lsquo;<samp>libunistring</samp>&rsquo;, see
-<a href="http://www.gnu.org/software/gnulib/MODULES.html#module=libunistring">http://www.gnu.org/software/gnulib/MODULES.html#module=libunistring</a>.
-</p>
-<a name="IDX895"></a>
-<p>The macro is called <code>gl_LIBUNISTRING</code>. It searches for an installed
-libunistring. If found, it sets and AC_SUBSTs <code>HAVE_LIBUNISTRING=yes</code>
-and the <code>LIBUNISTRING</code> and <code>LTLIBUNISTRING</code> variables and augments
-the <code>CPPFLAGS</code> variable, and defines the C macro
-<code>HAVE_LIBUNISTRING</code> to 1. Otherwise, it sets and AC_SUBSTs
-<code>HAVE_LIBUNISTRING=no</code> and <code>LIBUNISTRING</code> and <code>LTLIBUNISTRING</code>
-to empty.
-</p>
-<p>The complexities that <code>gl_LIBUNISTRING</code> deals with are the following:
-</p>
-<ul>
-<li>
-On some operating systems, in some configurations, libunistring depends
-on <code>libiconv</code>, and the options for linking with libiconv must be
-mentioned explicitly on the link command line.
-
-</li><li>
-GNU <code>libunistring</code>, if installed, is not necessarily already in the
-search path (<code>CPPFLAGS</code> for the include file search path,
-<code>LDFLAGS</code> for the library search path).
-
-</li><li>
-GNU <code>libunistring</code>, if installed, is not necessarily already in the
-run time library search path. To avoid the need for setting an environment
-variable like <code>LD_LIBRARY_PATH</code>, the macro adds the appropriate
-run time search path options to the <code>LIBUNISTRING</code> variable. This works
-on most systems.
-</li></ul>
-
-<hr size="6">
-<a name="Reporting-problems"></a>
-<a name="SEC66"></a>
-<h2 class="section"> <a href="libunistring.html#TOC66">16.5 Reporting problems</a> </h2>
-
-<p>If you encounter any problem, please don't hesitate to send a detailed
-bug report to the <code>bug-libunistring@gnu.org</code> mailing list. You can
-alternatively also use the bug tracker at the project page
-<a href="https://savannah.gnu.org/projects/libunistring">https://savannah.gnu.org/projects/libunistring</a>.
-</p>
-<p>Please always include the version number of this library, and a short
-description of your operating system and compilation environment with
-corresponding version numbers.
-</p>
-<p>For problems that appear while building and installing <code>libunistring</code>,
-for which you don't find the remedy in the &lsquo;<tt>INSTALL</tt>&rsquo; file, please include
-a description of the options that you passed to the &lsquo;<samp>configure</samp>&rsquo; script.
+<a name="IDX775"></a>
+<p>For the rendering of Unicode strings outside of the context of a given toolkit
+(KDE/Qt or GNOME/Gtk), we recommend the Pango library:
+<a href="http://www.pango.org/">http://www.pango.org/</a>.
</p>
<hr size="6">
<table cellpadding="1" cellspacing="1" border="0">
-<tr><td valign="middle" align="left">[<a href="#SEC61" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
-<td valign="middle" align="left">[<a href="libunistring_17.html#SEC67" title="Next chapter"> &gt;&gt; </a>]</td>
+<tr><td valign="middle" align="left">[<a href="libunistring_15.html#SEC55" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="libunistring_17.html#SEC62" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
@@ -218,12 +79,12 @@ a description of the options that you passed to the &lsquo;<samp>configure</samp
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left">[<a href="libunistring.html#SEC_Top" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[<a href="libunistring.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
-<td valign="middle" align="left">[<a href="libunistring_19.html#SEC77" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="libunistring_18.html#SEC71" title="Index">Index</a>]</td>
<td valign="middle" align="left">[<a href="libunistring_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
<p>
<font size="-1">
- This document was generated by <em>Daiki Ueno</em> on <em>July, 8 2015</em> using <a href="http://www.nongnu.org/texi2html/"><em>texi2html 1.78a</em></a>.
+ This document was generated by <em>Bruno Haible</em> on <em>March, 30 2010</em> using <a href="http://www.nongnu.org/texi2html/"><em>texi2html 1.78a</em></a>.
</font>
<br>