Added FAQ 1.17a about error message, "Client does not support authentication protocol".

ChangeLog

@@ -5,6 +5,10 @@ phpMyAdmin - Changelog
 $Id$
 $Source$
 
+2004-02-05 Alexander M. Turek  <chaos@derrabus.de>
+    * Documentation.html: Added FAQ 1.17a about error message, "Client does not
+      support authentication protocol".
+
 2004-02-04 Marc Delisle  <lem9@users.sourceforge.net>
     * libraries/sqlparser.lib.php: bug 890573 (was a typo)
 

Documentation.html

@@ -2420,9 +2420,9 @@ To create a new, empty mimetype please see libraries/transformations/template_ge
     Instead, it will still use the character set you specified for the MySQL
     onnection.<br />
     When compiling php, we strongly recommend that you manually link the MySQL
-    extension to a MySQL client library of at least the same version since the
+    extension to a MySQL client library of at least the same minor version
-    one that is bundled with current php distributions is rather old and might
+    since the one that is bundled with current php distributions is rather old
-    cause problems.
+    and might cause problems (see also FAQ 1.17a).
     <br />
     Also, we do not yet support the improved MySQL extension (mysqli) that
     comes with php&nbsp;5. For the moment, the old MySQL extension should also
@@ -2431,6 +2431,25 @@ To create a new, empty mimetype please see libraries/transformations/template_ge
     MySQL&nbsp;5.1 is not yet supported.
 </p>
 
+<h4>
+    [1.17a] I cannot connect to the MySQL server. It alawys returns the error
+    message, &quot;Client does not support authentication protocol requested
+    by server; consider upgrading MySQL client&quot;
+</h4>
+<p>
+    You tried to access MySQL with an old MySQL client library. The version of
+    your MySQL client library can be checked in your phpinfo() output.
+    <br />
+    In general, it should have at least the same minor version as your server
+    - as mentioned in FAQ 1.17.
+    <br />
+    The only way to fix this problem is manually compiling php and its MySQL
+    extension against a current MySQL client library.
+    <br />
+    If you still face this problem, please compile your MySQL client library
+    against the same or a newer MySQL release.
+</p>
+
 <h4>
     [1.18] I'm running MySQL&nbsp;&lt;=&nbsp;4.0.1 having
     <tt>lower_case_table_names</tt> set to 1. If I create a new table with a