Update

ChangeLog

@@ -17,6 +17,7 @@ $Source$
     * lang/italian-*.inc.php3: Updates, thanks again to Pietro Danesi (danone).
     * libraries/grab_globals.lib.php3: Fixed bug #638548 (table name with a
       quote).
+    * Documentation.txt: Update.
 
 2002-11-16 Marc Delisle  <lem9@users.sourceforge.net>
     * libraries/build_dump.lib.php3: fix for old MySQL, thanks to

Documentation.txt

@@ -1,5 +1,5 @@
 
-                        phpMyAdmin 2.3.2 Documentation
+                      phpMyAdmin 2.3.3-rc1 Documentation
 
      * Sourceforge phpMyAdmin project page   [ http://www.phpmyadmin.net/
        ]
@@ -7,8 +7,8 @@
           + Version history: ChangeLog
           + General notes: README
           + License: LICENSE
-     * Documentation version: $Id: Documentation.html,v 1.351 2002/10/08
+     * Documentation  version: $Id: Documentation.html,v 1.360 2002/11/18
-       19:07:27 lem9 Exp $
+       17:59:20 lem9 Exp $
    ______________________________________________________________________
 
    Top    -    Requirements    -    Introduction    -    Installation   -
@@ -22,6 +22,9 @@ Requirements
        PHP 3.0.8. Then you should not run this script with PHP3 < 3.0.8.
        PHP also needs to be compiled with MySQL support;
      * MySQL (tested with 3.21.x, 3.22.x, 3.23.x and 4.0.x);
+       Note: Because of a major change in the definition syntax of string
+       field  types,  this  version  of  phpMyAdmin  probably  won't work
+       correctly with MySQL >= 4.1.0!
      * a web-browser (doh!).
    ______________________________________________________________________
 
@@ -244,12 +247,10 @@ CRIPT_NAME'], '/')+1);
 
    $cfg['PmaNoRelation_DisableWarning'] boolean
           Starting with version 2.3.0 phpMyAdmin offers a lot of features
-          to work with master / foreign - tables. These features require
+          to    work    with    master    /   foreign   -   tables   (see
-          the PMA administrator to set up a special database for PMA (see
+          $cfg['Servers'][$i]['pmadb']).
-          $cfg['Servers'][$i]['pmadb']). Its contents and use will be
+          If  you tried to set this up and it does not work for you, have
-          explained further down.
+          a  look on the "Structure" page of one database where you would
-          If you tried to set this up and it does not work for you have a
-          look on the "Structure" page of one database where you would
           like  to  use  it.  You  will find a link that will analyze why
           those features have been disabled.
           If  you  do not want to use those features set this variable to
@@ -347,8 +348,15 @@ CRIPT_NAME'], '/')+1);
    $cfg['Servers'][$i]['pmadb'] string
           Starting with version 2.3.0 phpMyAdmin offers a lot of features
           to work with master / foreign - tables. To use those as well as
-          the bookmark feature you will need to create a new db.
+          the  bookmark feature you need special tables with a predefined
-          To use this functionality as superuser create a new database:
+          structure, which we explain below.
+          If  you  are the only user of this phpMyAdmin installation, you
+          can use your current database to store those special tables; in
+          this   case,   just   put   your   current   database  name  in
+          $cfg['Servers'][$i]['pmadb'].
+          If you are setting up a multi-user phpMyAdmin installation, you
+          will  need to create a new db and setup special privileges, so,
+          as superuser:
 
           + create a new database for phpmyadmin:
               CREATE DATABASE phpmyadmin;
@@ -364,9 +372,9 @@ CRIPT_NAME'], '/')+1);
    $cfg['Servers'][$i]['bookmarktable'] string
           Since release 2.2.0 phpMyAdmin allows to bookmark queries. This
           can be useful for queries you often run.
-          To allow the usage of this functionality the superuser has to:
+          To allow the usage of this functionality you have to:
 
-          + set up a PMA database as described above
+          + set up "pmadb" as described above
           + within this database create a table following this scheme:
                  CREATE TABLE `PMA_bookmark` (
                    id int(11) DEFAULT '0' NOT NULL auto_increment,
@@ -399,7 +407,7 @@ CRIPT_NAME'], '/')+1);
           The keys can be numeric or character.
           To allow the usage of this functionality the superuser has to:
 
-          + set up a PMA database as described above
+          + set up "pmadb" as described above
           + within this database create a table following this scheme:
                  CREATE TABLE `PMA_relation` (
                    `master_db` varchar(64) NOT NULL default '',
@@ -430,7 +438,7 @@ CRIPT_NAME'], '/')+1);
           table.  To  allow the usage of this functionality the superuser
           has to:
 
-          + set up a PMA database as described above
+          + set up "pmadb" as described above
           + within this database create a table following this scheme:
                  CREATE TABLE `PMA_table_info` (
                    `db_name` varchar(64) NOT NULL default '',
@@ -458,7 +466,7 @@ CRIPT_NAME'], '/')+1);
           output.
           To allow the usage of this functionality the superuser has to:
 
-          + set up a PMA database as described above
+          + set up "pmadb" as described above
           + within this database create a table following this scheme:
                  CREATE TABLE `PMA_table_coords` (
                    `db_name` varchar(64) NOT NULL default '',
@@ -490,7 +498,7 @@ CRIPT_NAME'], '/')+1);
           "printview".
           To allow the usage of this functionality the superuser has to:
 
-          + set up a PMA database as described above
+          + set up "pmadb" as described above
           + within this database create a table following this scheme:
                  CREATE TABLE `PMA_column_comments` (
                    id int(5) unsigned NOT NULL auto_increment,
@@ -1068,8 +1076,11 @@ FAQ - Frequently Asked Questions
    use  php >= 4.1  since  older  versions  of  php are not compatible to
    MySQL 4.
    Furthermore,  several  users reported problems with phpMyAdmin related
-   to bugs in MySQL 4. MySQL 4 is still an alpha release and should be
+   to bugs in MySQL 4. MySQL 4 is still a beta release and should be used
-   used for test purposes only!
+   for  test  purposes  only! Because of a major change in the definition
+   syntax  of  string  field  types,  this version of phpMyAdmin probably
+   won't  work correctly with MySQL >= 4.1.0! We will work on the support
+   as soon as MySQL 4.1.0 is released.
 
    [1.18] I'm running MySQL <= 4.0.1 having lower_case_table_names set to
    1.  If  I  create  a new table with a capital letter in its name it is
@@ -1119,6 +1130,15 @@ FAQ - Frequently Asked Questions
    characters randomly added. I am running PHP 4.2.3.
    This is a PHP 4.2.3 bug.
 
+   [1.25]  I am running Apache with mod_gzip-1.3.26.1a on Windows XP, and
+   I get problems, such as undefined variables when I run a SQL query.
+   A  tip  from  Jose Fandos: put a comment on the following two lines in
+   httpd.conf, like this:
+   # mod_gzip_item_include file \.php$
+   # mod_gzip_item_include mime "application/x-httpd-php.*"
+   as  this version of mod_gzip on Apache (Windows) has problems handling
+   php scripts. Of course you have to restart Apache.
+
   [2. Configuration]
 
    [2.1]  The  error  message  "Warning:  Cannot add header information -
@@ -1329,6 +1349,13 @@ FAQ - Frequently Asked Questions
    exporting  data  in  octet-stream  mode.  Since  we  can't  detect the
    specific Netscape version, we cannot workaround this bug.
 
+   [5.11]  Extended-ASCII  characters  like  German umlauts are displayed
+   wrong.
+   Please  ensure  that you have set your browser's charset to the one of
+   the  language  file  you  have  selected  on  phpMyAdmin's start page.
+   Alternatively,  you  can try the auto detection mode that is supported
+   by the recent versions of the most browsers.
+
   [6. Using phpMyAdmin]
 
    [6.1]  I can't insert new rows into a table / I can't create a table -
@@ -1401,14 +1428,14 @@ FAQ - Frequently Asked Questions
         ) TYPE=MyISAM;
         INSERT INTO REL_towns VALUES ('S', 'Sherbrooke');
         INSERT INTO REL_towns VALUES ('M', 'Montr<74>al');
-        INSERT INTO `PMA_relation` VALUES ('mydb', 'REL_persons',
+   To setup appropriate links and display information:
-   'town_code', 'mydb', 'REL_towns', 'town_code');
+     * on table "persons" click Structure, then Relation view
-        INSERT INTO `PMA_relation` VALUES ('mydb', 'REL_persons',
+     * in Links, for "town_code" choose "towns->code"
-   'country_code', 'mydb', 'REL_countries', 'country_code');
+     * in Links, for "country_code" choose "countries->country_code"
-        INSERT INTO `PMA_table_info` VALUES ('mydb', 'REL_towns',
+     * on table "towns" click Structure, then Relation view
-   'description');
+     * in "Choose field to display", choose "description"
-        INSERT INTO `PMA_table_info` VALUES ('mydb', 'REL_countries',
+     * repeat the two previous steps for table "countries"
-   'description');
+
    Then test like this:
      * Click on your db name in the left frame
      * Choose "Query"
@@ -1732,7 +1759,7 @@ enhancements, bugfixes or support for a new language since version 2.1.0:
 
 Bora Alioglu, Ricardo ?, Sven-Erik Andersen, Alessandro Astarita,
 P<EFBFBD>ter Bakondy, Borges Botelho, Olivier Bussier, Neil Darlow,
-Laurent Dhima, Kristof Hamann, Thomas Kl<4B>ger, Lubos Klokner,
+Ian Davidson, Laurent Dhima, Kristof Hamann, Thomas Kl<4B>ger, Lubos Klokner,
 Martin Marconcini, Girish Nair, David Nordenberg, Andreas Pauley,
 Bernard M. Piller, Laurent Haas, "Sakamoto", Yuval Sarna,
 www.securereality.com.au, Alvar Soome, Siu Sun, Peter Svec, Michael Tacelosky,