<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.12 $ -->
<!-- Purpose: international -->
<!-- Membership: bundled, external -->

 <reference id="ref.recode">
  <title>GNU Recode Functions</title>
  <titleabbrev>Recode</titleabbrev>

  <partintro>
   <section id="recode.intro">
    &reftitle.intro;
    <para>
     This module contains an interface to the GNU Recode library. The GNU
     Recode library converts files between various coded character sets and
     surface encodings. When this cannot be achieved exactly, it may get rid
     of the offending characters or fall back on approximations. The library
     recognises or produces nearly 150 different character sets and is able to
     convert files between almost any pair. Most
     <ulink url="&url.rfc;1345">RFC 1345</ulink> character sets are
     supported.
    </para>
    &note.no-windows.extension;
   </section>

   <section id="recode.requirements">
    &reftitle.required;
    <para>
     You must have GNU Recode 3.5 or higher installed on your system.
     You can download the package from <ulink url="&url.recode;">&url.recode;</ulink>.
    </para>
    <warning>
     <para>
      The Recode library version 3.6 adds weird characters behind converted
      strings under certain circumstances. Thus it's safer to use Recode v3.5
      or one of the available alternatives like the
      <link linkend="ref.iconv">iconv</link> or
      <link linkend="ref.mbstring">mbstring</link> extension.
     </para>
    </warning>
   </section>

   &reference.recode.configure;

   <section id="recode.configuration">
    &reftitle.runtime;
    &no.config;
   </section>

   <section id="recode.resources">
    &reftitle.resources;
    &no.resource;
   </section>

   <section id="recode.constants">
    &reftitle.constants;
    &no.constants;
   </section>
  </partintro>

&reference.recode.functions;

 </reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->