From f0ff9a514d30ecd5fe6fecec395e618c7526e66d Mon Sep 17 00:00:00 2001
From: Derick Rethans <derick@php.net>
Date: Fri, 6 Jun 2003 21:20:40 +0000
Subject: [PATCH] - Document implode() properly

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@130483 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/strings/functions/implode.xml | 23 ++++++-----------------
 1 file changed, 6 insertions(+), 17 deletions(-)

diff --git a/reference/strings/functions/implode.xml b/reference/strings/functions/implode.xml
index fd3e73c757..0c30c936fe 100644
--- a/reference/strings/functions/implode.xml
+++ b/reference/strings/functions/implode.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
+<!-- $Revision: 1.9 $ -->
 <!-- splitted from ./en/functions/strings.xml, last change in rev 1.2 -->
   <refentry id="function.implode">
    <refnamediv>
@@ -10,21 +10,8 @@
     <title>Description</title>
      <methodsynopsis>
       <type>string</type><methodname>implode</methodname>
-      <methodparam>
-       <type>string</type><parameter>glue</parameter>
-      </methodparam>
-      <methodparam>
-       <type>array</type><parameter>pieces</parameter>
-      </methodparam>
-     </methodsynopsis>
-     <methodsynopsis>
-      <type>string</type><methodname>implode</methodname>
-      <methodparam>
-       <type>array</type><parameter>pieces</parameter>
-      </methodparam>
-      <methodparam choice="opt">
-       <type>string</type><parameter>glue</parameter>
-      </methodparam>
+      <methodparam><type>string</type><parameter>glue</parameter></methodparam>
+      <methodparam><type>array</type><parameter>pieces</parameter></methodparam>
      </methodsynopsis>
     <para>
      Returns a string containing a string representation of all the
@@ -57,7 +44,9 @@ print $comma_separated; // lastname,email,phone
     <note>
      <para>
       As of PHP 4.3.0, the glue parameter of <function>implode</function> is
-      optional and defaults to the empty string('').
+      optional and defaults to the empty string(''). This is not the preferred
+      usage of <function>implode</function>. We recommend to always use two
+      parameters for compatibility with older versions.
      </para>
     </note>
     <simpara>