Re: [PHP-DOC] cvs: phpdoc /en/reference/recode reference.xml

[Friedhelm Betz]

On Wednesday 17 December 2003 19:10, Derick Rethans wrote:
> On Wed, 17 Dec 2003, Jakub Vrana wrote:
> > vrana               Wed Dec 17 11:35:45 2003 EDT
> >
> >   Modified files:
> >     /phpdoc/en/reference/recode     reference.xml
> >   Log:
> >   Version 3.6, warning with reference to bugs 17154 and 19776
>
> From what I know is that 3.5 works just fine, bug 3.6 is buggy (trailing
> garbage for example). So please add *that* to the manual instead of this
> bogus requirement.
>
> Derick

If the following patch suit our needs, I will commit.

Friedhelm

===================================================================
RCS file: /repository/phpdoc/en/reference/recode/reference.xml,v
retrieving revision 1.8
diff -u -r1.8 reference.xml
--- reference.xml       17 Dec 2003 16:35:45 -0000      1.8
+++ reference.xml       18 Dec 2003 23:17:46 -0000
@@ -8,33 +8,33 @@
    <section id="recode.intro">
     &reftitle.intro;
     <para>
-     This module contains an interface to the GNU Recode library,
-     version 3.6. 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.
+     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;
-    <warning>
-     <para>
-      Recode library adds weird characters behind converted strings under
-      certain circumstances. Thus it's safer to use
-      <link linkend="ref.iconv">iconv</link> or
-      <link linkend="ref.mbstring">mbstring</link> extension.
-     </para>
-    </warning>
    </section>
 
    <section id="recode.requirements">
     &reftitle.required;
     <para>
-     You must have GNU Recode 3.6 or higher installed on your system.
+     You must have GNU Recode 3.5 or higher installed on your system.
      You can download the package from <ulink 
url="&url.recode;">here</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>