Docs update for SQL validator

Documentation.html

@@ -2322,7 +2322,7 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://'
     <b>[6.14] How do I set up the SQL validator?</b>
     <br />
     To use it, you need a very recent version of PHP, built with
-    XML and PEAR support.  On your system command line, run
+    Overload, XML and PEAR support.  On your system command line, run
     <tt>"pear install Mail_Mime Net_DIME SOAP"</tt> to get the nessecary
     PEAR modules for usage.
     <br />
@@ -2331,6 +2331,9 @@ $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://'
     strings, numbers replaced with generic values). The Mimer SQL
     Validator itself, is &copy; 2001 Upright Database Technology.
     We utilize it as free XML-SOAP service.
+    <br />
+    The overload module is crucial to the functionality of the validator 
+    service.
 </p>
 
 <p>

Documentation.txt

@@ -7,8 +7,8 @@
           + Version history: ChangeLog
           + General notes: README
           + License: LICENSE
-     * Documentation version: $Id: Documentation.html,v 1.317 2002/08/12
+     * Documentation  version: $Id: Documentation.html,v 1.337 2002/09/05
-       07:28:11 rabus Exp $
+       12:58:16 lem9 Exp $
    ______________________________________________________________________
 
    Top    -    Requirements    -    Introduction    -    Installation   -
@@ -676,9 +676,21 @@ CRIPT_NAME'], '/')+1);
           values: "tbl_properties_structure.php3", "tbl_properties.php3",
           "tbl_select.php3" or "tbl_change.php3".
 
-   $cfg['ManualBaseShort'] string
+   $cfg['MySQLManualBase'] string
-          If set to an URL which points to the MySQL documentation (on
+          If  set to an URL which points to the MySQL documentation (type
-          short pages), appropriate help links are generated.
+          depends on $cfg['MySQLManualType']), appropriate help links are
+          generated.
+          See  MySQL  Documentation page for more information about MySQL
+          manuals and their types.
+
+   $cfg['MySQLManualType'] string
+          Type of MySQL documentation:
+
+          + old - old style used in phpMyAdmin 2.3.0 and sooner
+          + searchable - "Searchable, with user comments"
+          + chapters - "HTML, one page per chapter"
+          + big - "HTML, all on one page"
+          + none - do not show documentation links
 
    $cfg['DefaultLang'] string
           Defines  the default language to use, if not browser-defined or
@@ -705,6 +717,17 @@ CRIPT_NAME'], '/')+1);
           (by  default  only  these  which  are in unicode, just to avoid
           losing some characters).
 
+   $cfg['RecodingEngine'] string
+          You  can  select  here which functions will be used for charset
+          conversion. Possible values are:
+
+          + auto  -  automatically  use  available  one  (first is tested
+            iconv, then recode)
+          + iconv - use iconv or libiconv functions
+          + recode - use recode_string function
+
+          Default is auto.
+
    $cfg['AvailableCharsets'] array
           Available  charsets  for MySQL conversion. You can add your own
           (any  of  supported  by recode/iconv) or remove these which you
@@ -754,6 +777,10 @@ CRIPT_NAME'], '/')+1);
           Number of columns and rows for the textareas.
           This value will be emphasized (*2) for sql query textareas.
 
+   $cfg['TextareaAutoSelect'] boolean
+          Defines if the whole textarea of the query box will be selected
+          on click.
+
    $cfg['LimitChars'] integer
           Maximal  number  of  Chars  showed in a TEXT OR a BLOB field on
           browse view. Can be turned off by a toggle button on the browse
@@ -770,6 +797,18 @@ CRIPT_NAME'], '/')+1);
           There  are  2  display  modes:  horizontal and vertical. Define
           which one is displayed by default.
 
+   $cfg['UploadDir'] string
+          The name of the directory, ending with a slash, where SQL files
+          have been uploaded by other means than phpMyAdmin (for example,
+          ftp).  Those files are available under a drop-down box when you
+          click the database name, then the SQL tab.
+          Please note that the file names must have the suffix ".sql".
+          This feature is useful when your file is too big to be uploaded
+          via HTTP, or when file uploads are disabled in PHP.
+          Please note that if PHP is running in safe mode, this directory
+          must  be  owned by the same user as the owner of the phpMyAdmin
+          scripts.
+
    $cfg['RepeatCells'] integer
           Repeat the headers every X cells, or 0 to deactivate.
 
@@ -914,8 +953,9 @@ FAQ - Frequently Asked Questions
    [1.6] I can't use phpMyAdmin on PWS: nothing is displayed!
    This  seems  to  be a PWS bug. Filippo Simoncini found a workaroud (at
    this  time  there  is  no  better  fix): remove or comment the DOCTYPE
-   declarations (3 lines) from the scripts header.inc.php3, index.php3,
+   declarations    (2    lines)   from   the   scripts   header.inc.php3,
-   left.php3 and libraries/common.lib.php3.
+   header_printview.inc.php3,       index.php3,       left.php3       and
+   libraries/common.lib.php3.
 
    [1.7]  How  can I GZip or Bzip a dump or a CSV export. It seems to not
    work?
@@ -1038,6 +1078,11 @@ FAQ - Frequently Asked Questions
    login using cookie auth.
    In php.ini, set mysql.max_links higher than 1.
 
+   [1.22]  I  don't  see  the  "Location of text file" field, so I cannot
+   upload.
+   This is most likely because in php.ini, your file_uploads parameter is
+   not set to "on".
+
   [2. Configuration]
 
    [2.1]  The  error  message  "Warning:  Cannot add header information -
@@ -1286,6 +1331,7 @@ FAQ - Frequently Asked Questions
    document.
 
    [6.5]  How  can  I restore (upload) my database or table using a dump?
+   How can I run a ".sql" file?
    Click  on  a  database  name in the left frame, the properties will be
    local  displayed.  Then  in  the "Run SQL query" section, type in your
    dump filename, or use the Browse button. Then click Go.
@@ -1297,32 +1343,36 @@ FAQ - Frequently Asked Questions
    located  in the database mydb. If you don't have a PMA_relation table,
    create  it  as explained in the configuration section. Then create the
    example tables:
-        CREATE TABLE countries (
+        CREATE TABLE REL_countries (
           country_code char(1) NOT NULL default '',
           description varchar(10) NOT NULL default '',
           PRIMARY KEY (country_code)
         ) TYPE=MyISAM;
-        INSERT INTO countries VALUES ('C', 'Canada');
+        INSERT INTO REL_countries VALUES ('C', 'Canada');
-        CREATE TABLE persons (
+        CREATE TABLE REL_persons (
           id tinyint(4) NOT NULL auto_increment,
           person_name varchar(32) NOT NULL default '',
           town_code varchar(5) default '0',
           country_code char(1) NOT NULL default '',
           PRIMARY KEY (id)
         ) TYPE=MyISAM;
-        INSERT INTO persons VALUES (11, 'Marc', 'S', '');
+        INSERT INTO REL_persons VALUES (11, 'Marc', 'S', '');
-        INSERT INTO persons VALUES (15, 'Paul', 'S', 'C');
+        INSERT INTO REL_persons VALUES (15, 'Paul', 'S', 'C');
-        CREATE TABLE towns (
+        CREATE TABLE REL_towns (
           town_code varchar(5) NOT NULL default '0',
           description varchar(30) NOT NULL default '',
           PRIMARY KEY (town_code)
         ) TYPE=MyISAM;
-        INSERT INTO towns VALUES ('S', 'Sherbrooke');
+        INSERT INTO REL_towns VALUES ('S', 'Sherbrooke');
-        INSERT INTO towns VALUES ('M', 'Montr<74>al');
+        INSERT INTO REL_towns VALUES ('M', 'Montr<74>al');
-        INSERT INTO `PMA_relation` VALUES ('mydb', 'persons',
+        INSERT   INTO   `PMA_relation`   VALUES  ('mydb',  'REL_persons',
-   'town_code', 'mydb', 'towns', 'town_code');
+   'town_code', 'mydb', 'REL_towns', 'town_code');
-        INSERT INTO `PMA_relation` VALUES ('mydb', 'persons',
+        INSERT   INTO   `PMA_relation`   VALUES  ('mydb',  'REL_persons',
-   'country_code', 'mydb', 'countries', 'country_code');
+   'country_code', 'mydb', 'REL_countries', 'country_code');
+        INSERT   INTO   `PMA_table_info`   VALUES  ('mydb',  'REL_towns',
+   'description');
+        INSERT  INTO  `PMA_table_info`  VALUES  ('mydb', 'REL_countries',
+   'description');
    Then test like this:
      * Click on your db name in the left frame
      * Choose "Query by example"
@@ -1410,14 +1460,25 @@ FAQ - Frequently Asked Questions
    work with it, nor delete it.
 
    [6.14] How do I set up the SQL validator?
-   To use it, you need a very recent version of PHP, built with XML and
+   To use it, you need a very recent version of PHP, built with Overload,
-   PEAR support. On your system command line, run "pear install Mail_Mime
+   XML  and  PEAR support. On your system command line, run "pear install
-   Net_DIME SOAP" to get the nessecary PEAR modules for usage.
+   Mail_Mime Net_DIME SOAP" to get the nessecary PEAR modules for usage.
    If  you  use it, you should be aware that any SQL statement you submit
    will  be  stored  anonymously  (database/table/column  names, strings,
    numbers replaced with generic values). The Mimer SQL Validator itself,
    is  <20> 2001 Upright Database Technology. We utilize it as free XML-SOAP
    service.
+   The  overload  module is crucial to the functionality of the validator
+   service.
+
+   [6.15]  I  want  to add a BLOB field and put an index on it, but MySQL
+   says  "BLOB  column  '...'  used  in  key  specification without a key
+   length".
+   The  right way to do this, is to create the field without any indexes,
+   then display the table structure and use the "Create an index" dialog.
+   On  this  page,  you will be able to choose your BLOB field, and set a
+   size to the index, which is the condition to create an index on a BLOB
+   field.
 
   [7. phpMyAdmin project]
 
@@ -1530,30 +1591,30 @@ phpMyAdmin - Credits
 CREDITS, in chronological order
 -------------------------------
 
-[tr] - Tobias Ratschiller <tobias_at_phpwizard.net>
+- Tobias Ratschiller <tobias.ratschiller_at_maguma.com>
     * creator of the phpmyadmin project
     * maintainer from 1998 to summer 2000
 
-[md] - Marc Delisle <DelislMa_at_CollegeSherbrooke.qc.ca>
+- Marc Delisle <DelislMa_at_CollegeSherbrooke.qc.ca>
     * multi-language version
     * various fixes and improvements
     * project co-administrator
 
-[om] - Olivier M<>ller <om_at_omnis.ch>
+- Olivier M<>ller <om_at_omnis.ch>
     * started SourceForge phpMyAdmin project in March 2001
     * sync'ed different existing CVS trees with new features and bugfixes
     * multi-language improvements, dynamic language selection
     * current project maintainer
     * many bugfixes and improvements
 
-[lc] - Lo<4C>c Chapeaux <lolo_at_phpheaven.net>
+- Lo<4C>c Chapeaux <lolo_at_phpheaven.net>
     * rewrote and optimized javascript, DHTML and DOM stuff
     * rewrote the scripts so they fit the PEAR coding standards and
       generate XHTML1.0 and CSS2 compliant codes
     * improved the language detection system
     * many bugfixes and improvements
 
-[rj] - Robin Johnson <robbat2_at_users.sourceforge.net>
+- Robin Johnson <robbat2_at_users.sourceforge.net>
     * database maintence controls
     * table type code
     * Host authentication IP Allow/Deny
@@ -1562,79 +1623,86 @@ CREDITS, in chronological order
     * SQL validator
     * many bugfixes and improvements
 
-[af] - Armel Fauveau <armel.fauveau_at_globalis-ms.com>
+- Armel Fauveau <armel.fauveau_at_globalis-ms.com>
     * bookmarks feature
     * multiple dump feature
     * gzip dump feature
     * zip dump feature
 
-[gl] - Geert Lund <glund_at_silversoft.dk>
+- Geert Lund <glund_at_silversoft.dk>
     * various fixes
     * moderator of the phpMyAdmin users forum at phpwizard.net
 
-[kc] - Korakot Chaovavanich <korakot_at_iname.com>
+- Korakot Chaovavanich <korakot_at_iname.com>
     * "insert as new row" feature
 
-[pk] - Pete Kelly <webmaster_at_trafficg.com>
+- Pete Kelly <webmaster_at_trafficg.com>
     * rewrote and fix dump code
     * bugfixes
 
-[sa] - Steve Alberty <alberty_at_neptunlabs.de>
+- Steve Alberty <alberty_at_neptunlabs.de>
     * rewrote dump code for PHP4
     * mySQL table statistics
     * bugfixes
 
-[bg] - Benjamin Gandon <gandon_at_isia.cma.fr>
+- Benjamin Gandon <gandon_at_isia.cma.fr>
     * main author of the version 2.1.0.1
     * bugfixes
 
-[at] - Alexander M. Turek <rabus_at_bugfixes.info>
+- Alexander M. Turek <rabus_at_bugfixes.info>
     * XML exports
     * MySQL 4 related features
     * various small features and fixes
     * German language file updates
 
-[mb] - Mike Beck <mike.beck_at_ibmiller.de>
+- Mike Beck <mike.beck_at_ibmiller.de>
     * automatic joins in QBE
     * links column in printview
     * Relation view
 
-[mc] - Michal Cihar <nijel_at_users.sourceforge.net>
+- Michal Cihar <nijel_at_users.sourceforge.net>
     * enhanced index creation/display feature
     * feature to use a different charset for HTML than for MySQL
-
+    * Czech language file updates
-
-Thanks to these guys who have sent us some major improvements to merge into the
-code since version 2.1.0:
 
 - Christophe Gesch<63> from the "MySQL Form Generator for PHPMyAdmin"
-  (http://sourceforge.net/projects/phpmysqlformgen/) who suggested the patch
+  (http://sourceforge.net/projects/phpmysqlformgen/)
-  for multiple table printviews.
+    * suggested the patch for multiple table printviews
-- Garvin Hicking <hicking at faktor-e.de> who built the patch for
+
-  vertical display of table rows.
+- Garvin Hicking <hicking_at_faktor-e.de>
-- Yukihiro Kawada <kawada at den.fujifilm.co.jp> for the japanese kanji
+    * built the patch for vertical display of table rows
-  encoding conversion feature.
+
-- Piotr Roszatycki <d3xter at users.sourceforge.net> and Dan Wilson, for
+- Yukihiro Kawada <kawada_at_den.fujifilm.co.jp>
-  the Cookie authentication mode.
+    * japanese kanji encoding conversion feature
-- Axel Sander <n8falke at users.sourceforge.net> for the table
+
-  relation-links feature.
+- Piotr Roszatycki <d3xter_at_users.sourceforge.net> and Dan Wilson
-- Maxime Delorme <delorme.maxime at free.fr> for the PDF schema output;
+    * the Cookie authentication mode
-  thanks also to Olivier Plathey for the "FPDF" library
+
-  (see http://www.fpdf.org/).
+- Axel Sander <n8falke_at_users.sourceforge.net>
-- Olof Edlund <olof.edlund at upright.se> for the SQL validator server.
+    * table relation-links feature
+
+- Maxime Delorme <delorme.maxime_at_free.fr>
+    * PDF schema output, thanks also to Olivier Plathey for the
+      "FPDF" library (see http://www.fpdf.org/).
+
+- Olof Edlund <olof.edlund_at_upright.se>
+    * SQL validator server
+
+- Ivan R. Lanin <ivanlanin_at_users.sourceforfe.net>
+    * phpMyAdmin logo
 
 And also to the following people who have contributed minor changes,
 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,
+P<EFBFBD>ter Bakondy, Borges Botelho, Olivier Bussier, Neil Darlow,
-Kristof Hamann, Thomas Kl<4B>ger, Lubos Klokner, Martin Marconcini,
+Laurent Dhima, Kristof Hamann, Thomas Kl<4B>ger, Lubos Klokner,
-Girish Nair, David Nordenberg, Andreas Pauley, Bernard M. Piller, Laurent Haas,
+Martin Marconcini, Girish Nair, David Nordenberg, Andreas Pauley,
-"Sakamoto", Yuval Sarna, www.securereality.com.au,
+Bernard M. Piller, Laurent Haas, "Sakamoto", Yuval Sarna,
-Alvar Soome, Siu Sun, Peter Svec, Michael Tacelosky, Rachim Tamsjadi,
+www.securereality.com.au, Alvar Soome, Siu Sun, Peter Svec, Michael Tacelosky,
-Kositer Uros, Lu<4C>s V., Martijn W. van der Lee, Algis Vainauskas,
+Rachim Tamsjadi, Kositer Uros, Lu<4C>s V., Martijn W. van der Lee,
-Daniel Villanueva, Vinay, Ignacio Vazquez-Abrams, Chee Wai, Jakub Wilk,
+Algis Vainauskas, Daniel Villanueva, Vinay, Ignacio Vazquez-Abrams, Chee Wai,
-Thomas Michael Winningham, Vilius Zigmantas.
+Jakub Wilk, Thomas Michael Winningham, Vilius Zigmantas.
 
 
 Original Credits of Version 2.1.0