New documentation layout.

ChangeLog

@@ -5,6 +5,10 @@ phpMyAdmin - Changelog
 $Id$
 $Source$
 
+2003-02-01 Michal Cihar  <nijel@users.sourceforge.net>
+    * Documentation.*, translators.html, docs.css: New documentation layout.
+    * scripts/create-release.sh: Added --dont_wrap_pre to lynx parameters.
+
 2003-02-01 Marc Delisle  <lem9@users.sourceforge.net>
     * tbl_change.php3, tbl_replace.php3, (new)tbl_replace_fields.php3,
       db_details.php3, tbl_query_box.php3, libraries/common.lib.php3:

Documentation.txt

@@ -1,4 +1,10 @@
 
+   ______________________________________________________________________
+
+   Top  -  Requirements  -  Introduction  -  Installation  -
+   Configuration  -  FAQ  -  Developers  -  Credits  -  Translators
+   ______________________________________________________________________
+
                       phpMyAdmin 2.4.0-dev Documentation
 
      * Sourceforge phpMyAdmin project page   [ http://www.phpmyadmin.net/
@@ -7,13 +13,8 @@
           + Version history: ChangeLog
           + General notes: README
           + License: LICENSE
-     * Documentation version: $Id: Documentation.html,v 1.379 2003/01/24
+     * Documentation version: $Id: Documentation.html,v 1.381 2003/01/30
-       02:45:18 lem9 Exp $
+       13:55:58 nijel Exp $
-   ______________________________________________________________________
-
-   Top  -  Requirements  -  Introduction  -  Installation  -
-   Configuration  -  FAQ  -  Developers  -  Credits
-   ______________________________________________________________________
 
 Requirements
 
@@ -26,11 +27,6 @@ Requirements
        field types, this version of phpMyAdmin probably won't work
        correctly with MySQL >= 4.1.0!
      * a web-browser (doh!).
-   ______________________________________________________________________
-
-   Top  -  Requirements  -  Introduction  -  Installation  -
-   Configuration  -  FAQ  -  Developers  -  Credits
-   ______________________________________________________________________
 
 Introduction
 
@@ -59,11 +55,6 @@ Introduction
    (*)  phpMyAdmin can compress (Zip, GZip -RFC 1952- or Bzip2 formats)
    dumps and CSV exports if you use PHP4 >= 4.0.4 with Zlib support
    (--with-zlib) and/or Bzip2 support (--with-bz2).
-   ______________________________________________________________________
-
-   Top  -  Requirements  -  Introduction  -  Installation  -
-   Configuration  -  FAQ  -  Developers  -  Credits
-   ______________________________________________________________________
 
 Installation
 
@@ -126,7 +117,7 @@ Installation
      * Http and cookie authentication modes are more secure: the MySQL
        password does not need to be set in the phpMyAdmin configuration
        file (except for the "controluser" -see the Configuration
-       section-).
+       section).
        However, keep in mind that the password travels in plain text,
        unless you are using the https protocol.
        In cookie mode, we send the password in a temporary cookie, so
@@ -142,20 +133,22 @@ Installation
        pmapass as the controlpass, but this is only an example: use
        something else in your file:
 
-       GRANT USAGE ON mysql.* TO 'pma'@'localhost' IDENTIFIED BY
+GRANT USAGE ON mysql.* TO 'pma'@'localhost' IDENTIFIED BY 'pmapass';
-   'pmapass';
+GRANT SELECT (Host, User, Select_priv, Insert_priv, Update_priv, Delete_priv, Create_priv,
-   GRANT SELECT (Host, User, Select_priv, Insert_priv, Update_priv,
+    Drop_priv, Reload_priv, Shutdown_priv, Process_priv, File_priv,
-   Delete_priv, Create_priv, Drop_priv, Reload_priv, Shutdown_priv,
+    Grant_priv, References_priv, Index_priv, Alter_priv)
-   Process_priv, File_priv, Grant_priv, References_priv, Index_priv,
+    ON mysql.user TO 'pma'@'localhost';
-   Alter_priv) ON mysql.user TO 'pma'@'localhost';
+GRANT SELECT ON mysql.db TO 'pma'@'localhost';
-   GRANT SELECT ON mysql.db TO 'pma'@'localhost';
+GRANT SELECT (Host, Db, User, Table_name, Table_priv, Column_priv)
-   GRANT SELECT (Host, Db, User, Table_name, Table_priv, Column_priv) ON
+    ON mysql.tables_priv TO 'pma'@'localhost';
-   mysql.tables_priv TO 'pma'@'localhost';
+
        ... and if you want to use the many new relation and bookmark
        features:
-       GRANT SELECT, INSERT, UPDATE, DELETE ON <pma_db> TO
+
-   'pma'@'localhost'; (this of course requires you to have a special DB
+GRANT SELECT, INSERT, UPDATE, DELETE ON <pma_db> TO 'pma'@'localhost';
-   for phpMyAdmin, the contents will be explained later)
+
+       (this of course requires you to have a special DB for phpMyAdmin,
+       the contents will be explained later)
      * Then each of the true users should be granted a set of privileges
        on a set of particular databases. Normally you shouldn't give
        global privileges to an ordinary user, unless you understand the
@@ -196,11 +189,6 @@ Installation
        Host authentication $cfg['Servers'][$i]['AllowDeny']['order'] and
        $cfg['Servers'][$i]['AllowDeny']['rules'] configuration
        directives.
-   ______________________________________________________________________
-
-   Top  -  Requirements  -  Introduction  -  Installation  -
-   Configuration  -  FAQ  -  Developers  -  Credits
-   ______________________________________________________________________
 
 Configuration
 
@@ -228,19 +216,15 @@ Configuration
 
 $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://'
                        . $_SERVER['HTTP_HOST']
-                       . (!empty($_SERVER['SERVER_PORT']) ? ':' . $_SERVER['SER
+                       . (!empty($_SERVER['SERVER_PORT']) ? ':' . $_SERVER['SERVER_PORT'] : '')
-VER_PORT'] : '')
+                       . substr($_SERVER['PHP_SELF'], 0, strrpos($_SERVER['PHP_SELF'], '/')+1);
-                       . substr($_SERVER['PHP_SELF'], 0, strrpos($_SERVER['PHP_
-SELF'], '/')+1);
 
     or
 
 $cfg['PmaAbsoluteUri'] = (!empty($_SERVER['HTTPS']) ? 'https' : 'http') . '://'
                        . $_SERVER['SERVER_NAME']
-                       . (!empty($_SERVER['SERVER_PORT']) ? ':' . $_SERVER['SER
+                       . (!empty($_SERVER['SERVER_PORT']) ? ':' . $_SERVER['SERVER_PORT'] : '')
-VER_PORT'] : '')
+                       . substr($_SERVER['SCRIPT_NAME'], 0, strrpos($_SERVER['SCRIPT_NAME'], '/')+1);
-                       . substr($_SERVER['SCRIPT_NAME'], 0, strrpos($_SERVER['S
-CRIPT_NAME'], '/')+1);
 
 
           Please note that the $_SERVER array doesn't exist in
@@ -294,6 +278,11 @@ CRIPT_NAME'], '/')+1);
           To use the socket mode, your MySQL server must be on the same
           machine as the Web server.
 
+   $cfg['Servers'][$i]['compress'] boolean
+          Wheather to use a compressed protocol for the MySQL server
+          connection or not (experimental).
+          This feature requires PHP >= 4.3.0.
+
    $cfg['Servers'][$i]['controluser'] string
           $cfg['Servers'][$i]['controlpass'] string
           When using http or cookie authentication modes (or 'config'
@@ -935,11 +924,6 @@ CRIPT_NAME'], '/')+1);
    $cfg['Functions'] array
           A list of functions MySQL supports. In most cases you don't
           need to edit this.
-   ______________________________________________________________________
-
-   Top  -  Requirements  -  Introduction  -  Installation  -
-   Configuration  -  FAQ  -  Developers  -  Credits
-   ______________________________________________________________________
 
 FAQ - Frequently Asked Questions
 
@@ -948,9 +932,10 @@ FAQ - Frequently Asked Questions
 
   [1. Server]
 
-   [1.1] I'm running php 4+ and my server is crashing each time a
+    [1.1] I'm running php 4+ and my server is crashing each time a specific
-   specific action is required or phpMyAdmin sends a blank page or a page
+    action is required or phpMyAdmin sends a blank page or a page full of
-   full of cryptic characters to my browser, what can I do?
+    cryptic characters to my browser, what can I do
+
    There are some known php bugs with output buffering and compression.
    Try to set the $cfg['OBGzip'] directive to FALSE in your
    config.inc.php or .php3 file and the zlib.output_compression directive
@@ -960,29 +945,33 @@ FAQ - Frequently Asked Questions
    with MS Internet Explorer. Please upgrade to the release version php
    4.2.0.
 
-   [1.2] My Apache server crashes when using phpMyAdmin.
+    [1.2] My Apache server crashes when using phpMyAdmin
+
    You should first try the latest versions of Apache (and possibly
    MySQL).
    See also the other FAQ entry about php bugs with output buffering.
    If your server keeps crashing, please ask for help in the various
    Apache support groups.
 
-   [1.3] I'm running phpMyAdmin with "cookie" authentication mode under
+    [1.3] I'm running phpMyAdmin with "cookie" authentication mode under PHP
-   PHP 4.2.0 or 4.2.1 loaded as an Apache 2+ module but can't enter the
+    4.2.0 or 4.2.1 loaded as an Apache 2+ module but can't enter the script:
-   script: I'm always displayed the login screen.
+    I'm always displayed the login screen
+
    This is a known PHP bug (see this bug report) from the official php
    bug database. It means there is and won't be any phpMyAdmin fix
    against it because there is no way to code a fix.
 
     [1.4] Using phpMyAdmin on IIS, I'm displayed the error message: "The
-   specified CGI application misbehaved by not returning a complete set
+    specified CGI application misbehaved by not returning a complete set of
-   of HTTP headers...."
+    HTTP headers...."
+
    You just forgot to read the install.txt file from the php
    distribution. Have a look at the last message in this bug report from
    the official php bug database.
 
     [1.5] Using phpMyAdmin on IIS, I'm facing crashes and/or many error
-   messages with the http or advanced authentication mode.
+    messages with the http or advanced authentication mode
+
    This is a known problem with the php ISAPI filter: it's not so stable.
    For some more information and complete testings see the messages
    posted by Andr<64> B. aka "djdeluxe76" in this thread from the phpWizard
@@ -990,14 +979,15 @@ FAQ - Frequently Asked Questions
    Please use instead the cookie authentication mode.
 
     [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 (2 lines) from the scripts header.inc.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
+    [1.7] How can I GZip or Bzip a dump or a CSV export. It seems to not work
-   work?
+
    These features are based on the gzencode() and bzcompress() php
    functions to be more independent of the platform (Unix/Windows, Safe
    Mode or not, and so on). So, you must have PHP4 >= 4.0.4 and
@@ -1006,8 +996,9 @@ FAQ - Frequently Asked Questions
    Explorer when phpMyAdmin is run with a release candidate of php 4.2.0.
    In this case you should switch to the release version of php 4.2.0.
 
-   [1.8] I cannot insert a text file in a table, and I get an error about
+    [1.8] I cannot insert a text file in a table, and I get an error about safe
-   safe mode being in effect.
+    mode being in effect
+
    Your uploaded file is saved by PHP in the "upload dir", as defined in
    php.ini by the variable upload_tmp_dir (usually the system default is
    /tmp).
@@ -1020,9 +1011,10 @@ FAQ - Frequently Asked Questions
      * put upload_tmp_dir = /tmp/php in php.ini
      * restart Apache
 
-   [1.9] I'm having troubles when uploading files. In general file
+    [1.9] I'm having troubles when uploading files. In general file uploads
-   uploads don't work on my system and uploaded files have a
+    don't work on my system and uploaded files have a Content-Type: header in
-   Content-Type: header in the first line.
+    the first line
+
    It's not really phpMyAdmin related but RedHat 7.0. You have a RedHat
    7.0 and you updated your php rpm to php-4.0.4pl1-3.i386.rpm, didn't
    you?
@@ -1035,16 +1027,18 @@ FAQ - Frequently Asked Questions
    should go away.
    And that fixes the \r\n problem with file uploads!
 
-   [1.10] I'm having troubles when uploading files with phpMyAdmin
+    [1.10] I'm having troubles when uploading files with phpMyAdmin running on
-   running on a secure server. My browser is Internet Explorer and I'm
+    a secure server. My browser is Internet Explorer and I'm using the Apache
-   using the Apache server.
+    server
+
    As suggested by "Rob M" in the phpWizard forum, add this line to your
    httpd.conf:
        SetEnvIf User-Agent ".*MSIE.*" nokeepalive ssl-unclean-shutdown
    It seems to clear up many problems between IE and SSL.
 
-   [1.11] I get an 'open_basedir restriction' while uploading a file from
+    [1.11] I get an 'open_basedir restriction' while uploading a file from the
-   the query box.
+    query box
+
    Since version 2.2.4, phpMyAdmin supports servers with open_basedir
    restrictions. Assuming that the restriction allows you to open files
    in the current directory ('.'), all you have to do is create a 'tmp'
@@ -1053,25 +1047,29 @@ FAQ - Frequently Asked Questions
    uploaded files will be moved there, and after execution of your SQL
    commands, removed.
 
-   [1.12] I have lost my MySQL root password, what can I do?
+    [1.12] I have lost my MySQL root password, what can I do
+
    The MySql manual explains how to reset the permissions.
 
-   [1.13] I get an error 'No SQL query' when trying to execute a
+    [1.13] I get an error 'No SQL query' when trying to execute a bookmark
-   bookmark.
+
    If PHP does not have read/write access to its upload_tmp_dir, it
    cannot access the uploaded query.
 
-   [1.14] I get an error 'No SQL query' when trying to submit a query
+    [1.14] I get an error 'No SQL query' when trying to submit a query from the
-   from the convenient text area.
+    convenient text area
+
    Check the post_max_size directive from your php configuration file and
    try to increase it.
 
-   [1.15] I have problems with mysql.user field names.
+    [1.15] I have problems with mysql.user field names
+
    In older MySQL versions, the User and Password fields were named user
    and password. Please modify your field names to align with current
    standards.
 
-   [1.16] I cannot upload big dump files.
+    [1.16] I cannot upload big dump files
+
    The first things to check (or ask your host provider to check) are the
    values of upload_max_filesize, memory_limit and post_max_size in the
    php.ini configuration file.
@@ -1079,7 +1077,8 @@ FAQ - Frequently Asked Questions
    submitted and handled by php. One user also said that post_max_size
    and memory_limit need to be larger than upload_max_filesize.
 
-   [1.17] Does phpMyAdmin support MySQL 4?
+    [1.17] Does phpMyAdmin support MySQL 4
+
    MySQL 4 is not yet fully supported by phpMyAdmin.
    Because of MySQL 4's backwards compatibility you can use phpMyAdmin
    for administering MySQL 4 servers, but phpMyAdmin does not yet support
@@ -1093,21 +1092,24 @@ FAQ - Frequently Asked Questions
    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.18] I'm running MySQL <= 4.0.1 having lower_case_table_names set to 1.
-   1. If I create a new table with a capital letter in its name it is
+    If I create a new table with a capital letter in its name it is changed to
-   changed to lowercase as it should. But if I try to DROP this table
+    lowercase as it should. But if I try to DROP this table MySQL is unable to
-   MySQL is unable to find the corresponding file.
+    find the corresponding file
+
    This is a bug of MySQL <= 4.0.1. Please upgrade to at least
    MySQL 4.0.2 or turn off your lower_case_table_names directive.
 
-   [1.19] I can't run the "display relations" feature because the script
+    [1.19] I can't run the "display relations" feature because the script seems
-   seems not to know the font face I'm using!
+    not to know the font face I'm using!
+
    The "FPDF" library we're using for this feature requires some special
    files to use font faces.
    Please refers to the FPDF manual to build these files.
 
-   [1.20] I receive the error "cannot load MySQL extension, please check
+    [1.20] I receive the error "cannot load MySQL extension, please check PHP
-   PHP Configuration".
+    Configuration"
+
    To connect to a MySQL server, PHP needs a set of MySQL functions
    called "MySQL extension". This extension may be part of the PHP server
    (compiled-in), otherwise it needs to be loaded dynamically. Its name
@@ -1116,17 +1118,19 @@ FAQ - Frequently Asked Questions
    Usually, the problem is solved by installing a software package called
    "PHP-MySQL" or something similar.
 
-   [1.21] I am running the CGI version of PHP under Unix, and I cannot
+    [1.21] I am running the CGI version of PHP under Unix, and I cannot login
-   login using cookie auth.
+    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
+    [1.22] I don't see the "Location of text file" field, so I cannot upload
-   upload.
+
    This is most likely because in php.ini, your file_uploads parameter is
    not set to "on".
 
-   [1.23] I'm running MySQL on a Win32 machine. Each time I create a new
+    [1.23] I'm running MySQL on a Win32 machine. Each time I create a new table
-   table the table and field names are changed to lowercase!
+    the table and field names are changed to lowercase!
+
    This happens because the MySQL directive lower_case_table_names
    defaults to 1 (ON) in the Win32 version of MySQL. You can change this
    behavior by simply changing the directive to 0 (OFF):
@@ -1138,11 +1142,13 @@ FAQ - Frequently Asked Questions
    SHOW VARIABLES LIKE 'lower_case_table_names';
 
     [1.24] Some characters are being truncated in my queries, or I get
-   characters randomly added. I am running PHP 4.2.3.
+    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
+    [1.25] I am running Apache with mod_gzip-1.3.26.1a on Windows XP, and I get
-   I get problems, such as undefined variables when I run a SQL query.
+    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$
@@ -1150,36 +1156,41 @@ FAQ - Frequently Asked Questions
    as this version of mod_gzip on Apache (Windows) has problems handling
    php scripts. Of course you have to restart Apache.
 
-   [1.26] I just installed phpMyAdmin in my document root of IIS but I
+    [1.26] I just installed phpMyAdmin in my document root of IIS but I get the
-   get the error "No input file specified" when trying to run phpMyAdmin.
+    error "No input file specified" when trying to run phpMyAdmin.
+
    This is a permission problem. Right-click on the phpmyadmin folder and
    choose properties. Under the tab Security, click on "Add" and select
    the user "IUSER_machine" from the list. Now set his permissions and it
    should work.
 
     [1.27] I get empty page when I want to view huge page (eg.
-   db_details_structure.php3 with plenty of dabases).
+    db_details_structure.php3 with plenty of dabases)
+
    This is a PHP bug that occur when GZIP output buffering enabled. If
-   you turn off it (by $cfg['OBGzip'] = FALSE in config.inc.php3, it
+   you turn off it (by $cfg['OBGzip'] = FALSE in config.inc.php3), it
-   should work. This bug will be fixed least in PHP >= 4.5.0.
+   should work. This bug will be fixed in PHP 5.0.0.
 
   [2. Configuration]
 
-   [2.1] The error message "Warning: Cannot add header information -
+    [2.1] The error message "Warning: Cannot add header information - headers
-   headers already sent by ..." is displayed, what's the problem?
+    already sent by ..." is displayed, what's the problem
+
    Edit your config.inc.php or .php3 file and ensure there is nothing (ie
    no blank lines, no spaces, no characters...) neither before the <?php
    tag at the beginning, neither after the ?> tag at the end.
 
-   [2.2] phpMyAdmin can't connect to MySQL. What's wrong?
+    [2.2] phpMyAdmin can't connect to MySQL. What's wrong
+
    Either there is an error with your PHP setup or your username/password
    is wrong. Try to make a small script which uses mysql_connect and see
    if it works. If it doesn't, it may be you haven't even compiled MySQL
    support into PHP.
 
-   [2.3] The error message "Warning: MySQL Connection Failed: Can't
+    [2.3] The error message "Warning: MySQL Connection Failed: Can't connect to
-   connect to local MySQL server through socket '/tmp/mysql.sock'
+    local MySQL server through socket '/tmp/mysql.sock' (111)..." is displayed.
-   (111)..." is displayed. What can I do?
+    What can I do
+
    For RedHat users, Harald Legner suggests this on the mailing list:
    On my RedHat-Box the socket of mysql is /var/lib/mysql/mysql.sock. In
    your php.ini you will find a line
@@ -1204,52 +1215,57 @@ FAQ - Frequently Asked Questions
    Have also a look at the corresponding section of the MySQL
    documentation.
 
-   [2.4] Nothing is displayed by my browser when I try to run phpMyAdmin,
+    [2.4] Nothing is displayed by my browser when I try to run phpMyAdmin, what
-   what can I do?
+    can I do
+
    Try to set the $cfg['OBGZip'] directive to FALSE in the phpMyAdmin
    configuration file. It helps sometime.
    Also have a look at your php version number: if it contains "4.0b..."
    it means you're running a beta version of PHP. That's not a so good
    idea, please upgrade to a plain revision.
 
-   [2.5] Each time I want to insert or change a record or drop a database
+    [2.5] Each time I want to insert or change a record or drop a database or a
-   or a table, an error 404 (page not found) is displayed or, with http
+    table, an error 404 (page not found) is displayed or, with http or cookie
-   or cookie authentication, I'm asked to login again. What's wrong?
+    authentication, I'm asked to login again. What's wrong
+
    Check the value you set for the $cfg['PmaAbsoluteUri'] directive in
    the phpMyAdmin configuration file.
 
   [3. Known limitations]
 
-   [3.1] When using http authentication, an user who logged out can not
+    [3.1] When using http authentication, an user who logged out can not relog
-   relog in with the same nick.
+    in with the same nick
+
    This is related to the authentication mechanism (protocol) used by
    phpMyAdmin. We plan to change it as soon as we may find enough free
    time to do it, but you can bypass this problem: just close all the
    opened browser windows and then go back to phpMyAdmin. You should be
    able to logs in again.
 
-   [3.2] When dumping a large table in compressed mode, I get a memory
+    [3.2] When dumping a large table in compressed mode, I get a memory limit
-   limit error or a time limit error.
+    error or a time limit error
+
    As of version 2.2.4, we build the compressed dump in memory, so large
    tables dumps may hang. The only alternative we can think about (using
    system calls to mysqldump then gzip or bzip2) would not be applicable
    in environments where PHP is in safe mode: access to system programs
    is is limited by the system administrator, and time limit is enforced.
 
-   [3.3] With InnoDB tables, I lose foreign key relationships when I
+    [3.3] With InnoDB tables, I lose foreign key relationships when I rename or
-   rename or alter a table.
+    alter a table
+
    This seems to be a InnoDB bug (fixed in MySQL 3.23.50?). However, keep
    in mind that phpMyAdmin as of version 2.3.0 does not support InnoDB.
 
-   [3.4] I am unable to import dumps I created with the mysqldump tool
+    [3.4] I am unable to import dumps I created with the mysqldump tool bundled
-   bundled with the MySQL server distribution.
+    with the MySQL server distribution
-   The problem is that mysqldump creates invalid comments like this:
 
-     -- MySQL dump 8.22
+   The problem is that mysqldump creates invalid comments like this:
-     --
+-- MySQL dump 8.22
-     -- Host: localhost Database: database
+--
-     ---------------------------------------------------------
+-- Host: localhost Database: database
-     -- Server version 3.23.54
+---------------------------------------------------------
+-- Server version 3.23.54
 
    The invalid part of the code is the horizontal line made of dashes
    that appears once in every dump created with mysqldump. If you want to
@@ -1262,16 +1278,18 @@ FAQ - Frequently Asked Questions
 
   [4. ISPs, multi-user installations ]
 
-   [4.1] I'm an ISP. Can I setup one central copy of phpMyAdmin or do I
+    [4.1] I'm an ISP. Can I setup one central copy of phpMyAdmin or do I need
-   need to install it for each customer?
+    to install it for each customer
+
    Since version 2.0.3, you can setup a central copy of phpMyAdmin for
    all your users. The development of this feature was kindly sponsored
    by NetCologne GmbH. This requires a properly setup MySQL user
    management and phpMyAdmin http or cookie authentication. See the
    install section on "Using http authentication".
 
-   [4.2] What's the preferred way of making phpMyAdmin secure against
+    [4.2] What's the preferred way of making phpMyAdmin secure against evil
-   evil access?
+    access
+
    This depends on your system.
    If you're running a server which cannot be accessed by other people,
    it's sufficient to use the directory protection bundled with your
@@ -1286,14 +1304,16 @@ FAQ - Frequently Asked Questions
      * You should use PHP safe mode, to protect from other users that try
        to include your config.inc.php3 in their scripts.
 
-   [4.3] I get errors about not being able to include a file in /lang or
+    [4.3] I get errors about not being able to include a file in /lang or in
-   in /libraries.
+    /libraries
+
    Check php.ini, or ask your sysadmin to check it. The include_path must
    contain "." somewhere in it, and open_basedir, if used, must contain
    "." and "./lang" to allow normal operation of phpMyAdmin.
 
     [4.4] phpMyAdmin always gives "Access denied" when using http
-   authentication.
+    authentication
+
    This could happen for several reasons:
      * $cfg['Servers'][$i]['controluser'] and/or
        $cfg['Servers'][$i]['controlpass'] are wrong.
@@ -1302,13 +1322,15 @@ FAQ - Frequently Asked Questions
        phpMyAdmin-directory, eg. a .htaccess file. This would interfere
        with phpMyAdmin's authentication, so remove it.
 
-   [4.5] Is it possible to let users create their own databases?
+    [4.5] Is it possible to let users create their own databases
+
    Starting with 2.2.5, in the user management page, you can enter a
    wildcard database name for a user, and put the privileges you want.
    For example, adding SELECT, INSERT, UPDATE, DELETE, CREATE, DROP,
    INDEX, ALTER would let a user create/manage his/her database(s).
 
-   [4.6] How can I use the Host-based authentication additions?
+    [4.6] How can I use the Host-based authentication additions
+
    If you have existing rules from an old .htaccess file, you can take
    them and add a username between the 'deny'/'allow' and 'from' strings.
    Using the username wildcard of '%' would be a major benefit here if
@@ -1330,20 +1352,22 @@ FAQ - Frequently Asked Questions
 
   [5. Browsers or client OS]
 
-   [5.1] I get an out of memory error, and my controls are
+    [5.1] I get an out of memory error, and my controls are non-functional,
-   non-functional, when trying to create a table with more than 14
+    when trying to create a table with more than 14 fields
-   fields.
+
    We could reproduce this problem only under Win98/98SE. Testing under
    WinNT4 or Win2K, we could easily create more than 60 fields.
    A workaround is to create a smaller number of fields, then come back
    to your table properties and add the other fields.
 
-   [5.2] With Xitami 2.5b4, phpMyAdmin won't process form fields.
+    [5.2] With Xitami 2.5b4, phpMyAdmin won't process form fields
+
    This is not a phpMyAdmin problem but a Xitami known bug: you'll face
    it with each script/website that use forms.
    Upgrade or downgrade your Xitami server.
 
     [5.3] I have problems dumping tables with Konqueror (phpMyAdmin 2.2.2)
+
    With Konqueror 2.1.1: plain dumps, zip and gzip dumps work ok, except
    that the proposed file name for the dump is always 'tbl_dump.php'.
    Bzip2 dumps don't seem to work.
@@ -1352,61 +1376,69 @@ FAQ - Frequently Asked Questions
    Konqueror, or else they disappear. Gzip dumps give an error message.
    Testing needs to be done for Konqueror 2.2.2.
 
-   [5.4] I can't use the cookie authentication mode because Internet
+    [5.4] I can't use the cookie authentication mode because Internet Explorer
-   Explorer never stores the cookies.
+    never stores the cookies
+
    MS Internet Explorer seems to be really buggy about cookies, at least
    till version 6. And thanks to Andrew Zivolup we've traced also a php
    4.1.1 bug in this area!
    Then, if you're running php 4.1.1, try to upgrade or downgrade... it
    may work!
 
-   [5.5] In Internet Explorer 5.0, I get Javascript errors when browsing
+    [5.5] In Internet Explorer 5.0, I get Javascript errors when browsing my
-   my rows.
+    rows
+
    Upgrade to at least Internet Explorer 5.5SP2.
 
-   [5.6] In Internet Explorer 5.0, 5.5 or 6.0, I get an error when trying
+    [5.6] In Internet Explorer 5.0, 5.5 or 6.0, I get an error when trying to
-   to modify a row in a table with many fields, or with a text field.
+    modify a row in a table with many fields, or with a text field
+
    Your table neither have a primary key nor an unique one, so we must
    use a long URL to identify this row. There is a limit on the lenght of
    the URL in those browsers, and this not happen in Netscape, for
    example. The workaround is to create a primary or unique key, or use
    another browser.
 
-   [5.7] I refresh (reload) my browser, and come back to the welcome
+    [5.7] I refresh (reload) my browser, and come back to the welcome page
-   page.
+
    Some browsers support right-clicking into the frame you want to
    refresh, just do this in the right frame.
 
-   [5.8] With Mozilla 0.9.7 I have problems sending a query modified in
+    [5.8] With Mozilla 0.9.7 I have problems sending a query modified in the
-   the query box.
+    query box
+
    Looks like a Mozilla bug: 0.9.6 was ok. We will keep an eye on future
    Mozilla versions.
 
     [5.9] With Mozilla 0.9.? to 1.0 and Netscape 7.0-PR1 I can't type a
-   whitespace in the SQL-Query edit area: the page scrolls down.
+    whitespace in the SQL-Query edit area: the page scrolls down
+
    This is a Mozilla bug (see bug #26882 at Bugzilla).
 
-   [5.10] With Netscape 4.75 I get empty rows between each row of data in
+    [5.10] With Netscape 4.75 I get empty rows between each row of data in a
-   a CSV exported file.
+    CSV exported file
+
    This is a known Netscape 4.75 bug: it adds some line feeds when
    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
+    [5.11] Extended-ASCII characters like German umlauts are displayed wrong
-   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.
 
-   [5.12] Apple OS X: Safari browser changes special characters to "?".
+    [5.12] Apple OS X: Safari browser changes special characters to "?"
+
    This issue has been reported by a OS X user, who adds that Chimera,
    Netscape and Mozilla do not have this problem.
 
   [6. Using phpMyAdmin]
 
-   [6.1] I can't insert new rows into a table / I can't create a table -
+    [6.1] I can't insert new rows into a table / I can't create a table - MySQL
-   MySQL brings up a SQL-error.
+    brings up a SQL-error
+
    Examine the SQL error with care. Often the problem is caused by
    specifying a wrong field-type.
    Common errors include:
@@ -1416,19 +1448,22 @@ FAQ - Frequently Asked Questions
    Also, look at the syntax chapter in the MySQL manual to confirm that
    your syntax is correct.
 
-   [6.2] When I create a table, I click the Index checkbox for 2 fields
+    [6.2] When I create a table, I click the Index checkbox for 2 fields and
-   and phpMyAdmin generates only one index with those 2 fields.
+    phpMyAdmin generates only one index with those 2 fields
+
    In phpMyAdmin 2.2.0 and 2.2.1, this is the way to create a
    multi-fields index. If you want two indexes, create the first one when
    creating the table, save, then display the table properties and click
    the Index link to create the other index.
 
-   [6.3] How can I insert a null value into my table?
+    [6.3] How can I insert a null value into my table
+
    Since version 2.2.3, you have a checkbox for each field that can be
    null. Before 2.2.3, you had to enter "null", without the quotes, as
    the field's value.
 
-   [6.4] How can I backup my database or table?
+    [6.4] How can I backup my database or table
+
    Click on a database or table name in the left frame, the properties
    will be displayed. Then on the menu, click "Export", you can dump the
    structure, the data, or both. This will generate standard SQL
@@ -1440,15 +1475,17 @@ FAQ - Frequently Asked Questions
    For additional help on this subject, look for the word "dump" in this
    document.
 
-   [6.5] How can I restore (upload) my database or table using a dump?
+    [6.5] How can I restore (upload) my database or table using a dump? How can
-   How can I run a ".sql" file?
+    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.
    For additional help on this subject, look for the word "upload" in
    this document.
 
-   [6.6] How can I use the relation table in Query-by-example?
+    [6.6] How can I use the relation table in Query-by-example
+
    Here is an example with the tables persons, towns and countries, all
    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
@@ -1496,12 +1533,14 @@ FAQ - Frequently Asked Questions
        correct joins have been generated
      * Click "Submit query"
 
-   [6.7] How can I use the "display field" feature?
+    [6.7] How can I use the "display field" feature
+
    Starting from the previous example, create the PMA_table_info as
    explained in the configuration section, then browse your persons
    table, and move the mouse over a town code or country code.
 
-   [6.8] How can I produce a PDF schema of my database?
+    [6.8] How can I produce a PDF schema of my database
+
    First you have to fill the "relation", "table_coords" and "pdf_pages"
    configuration variables.
    Then, think about your schema layout: which tables will go on which
@@ -1539,11 +1578,13 @@ FAQ - Frequently Asked Questions
        the file under the name it offers).
 
     [6.9] phpMyAdmin is changing the type of one of my columns!
+
    No, it's MySQL that is doing silent column type changing.
 
     [6.10] My database has an underscore in it's name, and when I grant
-   privileges to a user for this database, a backslash is added before
+    privileges to a user for this database, a backslash is added before the
-   the underscore.
+    underscore
+
    This is normal and means that the grant is done only for this
    database. If there was no backslash, this would be a wildcard grant,
    and the underscore would mean "any character". So, if the database
@@ -1552,10 +1593,12 @@ FAQ - Frequently Asked Questions
    If you really want to grant using a wildcard, there is a dialog box "
    Database (wildcards allowed)" for this.
 
-   [6.11] What is the curious symbol <20> in the table statistics?
+    [6.11] What is the curious symbol <20> in the table statistics
+
    It means "average".
 
-   [6.12] I want to understand some Export options.
+    [6.12] I want to understand some Export options
+
    "Complete inserts" adds the column names on every INSERT command, for
    better documentation (but resulting file is bigger).
    "Extended inserts" provides a shorter dump file by using only once the
@@ -1563,13 +1606,15 @@ FAQ - Frequently Asked Questions
    "Enclose table and field names with backquotes" ensures that field and
    table names formed with special characters are protected.
 
-   [6.13] I would like to create a database with a dot in its name.
+    [6.13] I would like to create a database with a dot in its name
+
    This is a bad idea, because in MySQL the syntax "database.table" is
    the normal way to reference a database and table name. Worse, MySQL
    will usually let you create a database with a dot, but then you cannot
    work with it, nor delete it.
 
-   [6.14] How do I set up the SQL validator?
+    [6.14] How do I set up the SQL validator
+
    To use it, you need a very recent version of PHP, 4.3.0 recommended,
    with XML, PCRE and PEAR support. On your system command line, run
    "pear install Net_Socket Net_URL HTTP_Request Mail_Mime Net_DIME SOAP"
@@ -1580,29 +1625,32 @@ FAQ - Frequently Asked Questions
    is <20> 2001 Upright Database Technology. We utilize it as free SOAP
    service.
 
-   [6.15] I want to add a BLOB field and put an index on it, but MySQL
+    [6.15] I want to add a BLOB field and put an index on it, but MySQL says
-   says "BLOB column '...' used in key specification without a key
+    "BLOB column '...' used in key specification without a key length"
-   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.
 
-   [6.16] How can I simply move in page with plenty editing fields?
+    [6.16] How can I simply move in page with plenty editing fields
+
    You can use Ctrl+arrows for moving on most pages with plenty editing
    fields (table structure changes, row editing, etc.).
 
   [7. phpMyAdmin project]
 
-   [7.1] I have found a bug. How do I inform developers?
+    [7.1] I have found a bug. How do I inform developers
+
    Our Bug Tracker is located at
    http://sourceforge.net/projects/phpmyadmin/ under the Bugs section.
    But please first discuss your bug with other users:
    http://sourceforge.net/projects/phpmyadmin/ (and choose Forums)
 
     [7.2] I want to translate the messages to a new language or upgrade an
-   existing language, where do I start?
+    existing language, where do I start
+
    Always use the current cvs version of your language file. For a new
    language, start from english-iso-8859-1.inc.php3. If you don't know
    how to get the cvs version, please ask one of the developers.
@@ -1616,7 +1664,8 @@ FAQ - Frequently Asked Questions
    messages.
 
     [7.3] I would like to help out with the development of phpMyAdmin. How
-   should I proceed?
+    should I proceed
+
    The following method is preferred for new developers:
      * fetch the current CVS tree over anonymous CVS:
        cvs
@@ -1634,11 +1683,6 @@ FAQ - Frequently Asked Questions
    Write access to the CVS tree is granted only to experienced developers
    who have already contributed something useful to phpMyAdmin.
    Also, have a look at the Developers section.
-   ______________________________________________________________________
-
-   Top  -  Requirements  -  Introduction  -  Installation  -
-   Configuration  -  FAQ  -  Developers  -  Credits
-   ______________________________________________________________________
 
 Developers Information
 
@@ -1690,11 +1734,6 @@ Developers Information
    already contributed something useful to phpMyAdmin. If you're
    interested in that, please contact us using the phpmyadmin-devel
    mailing list.
-   ______________________________________________________________________
-
-   Top  -  Requirements  -  Introduction  -  Installation  -
-   Configuration  -  FAQ  -  Developers  -  Credits
-   ______________________________________________________________________
 
 Credits
 
@@ -1811,8 +1850,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,
 Mats Engstrom, Ian Davidson, Laurent Dhima, Kristof Hamann, Thomas Kl<4B>ger,
-Lubos Klokner, Martin Marconcini, Girish Nair, David Nordenberg, Andreas Pauley
+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,
 Rachim Tamsjadi, Kositer Uros, Lu<4C>s V., Martijn W. van der Lee,
@@ -1859,10 +1897,5 @@ Original Credits of Version 2.1.0
 
     And thanks to everyone else who sent me email with suggestions, bug-reports
     and or just some feedback.
-   ______________________________________________________________________
-
-   Top  -  Requirements  -  Introduction  -  Installation  -
-   Configuration  -  FAQ  -  Developers  -  Credits
-   ______________________________________________________________________
 
                                         Valid XHTML 1.0!      Valid CSS! 

docs.css

@@ -0,0 +1,163 @@
+/* $Id$ */
+/* Stylesheet for phpMyAdmin documentation */
+/* vim: expandtab ts=4 sw=4 sts=4 tw=78 
+*/
+
+body {
+    background-color: #ffffff;
+    font-family: sans-serif;
+    color: #000;
+    margin: 0px;
+    padding: 2em 0px 2em 0px;
+}
+
+a {
+    text-decoration: none;
+    color: #000099;
+    background-color: #ffffff;
+    font-weight: normal;
+}
+a:hover {
+    background-color: #99CCFF;
+    background-color: #ffffff;
+    font-weight: bolder
+}
+
+
+div.header {
+    width: 100%;
+    background-color: #ddeeff;
+    color: #000000;
+    text-align: center;
+    padding-bottom: 2px;
+    border-bottom: 1px solid #000000;
+    font-weight: bold;
+    left: 0px;
+    top: 0px;
+    position: fixed;*/
+    /* following MSIE hack was originally written by Riki Fridrich
+     * <http://www.fckbkk.sk> */
+    position: expression("absolute");
+    width: expression(document.body.clientWidth);
+    top: expression(document.body.scrollTop + this.offsetHeight - this.offsetHeight);
+}
+
+div.header hr {
+    display: none;
+}
+div.header a {
+    text-decoration: none;
+    font-size: medium;
+    color: #000099;
+    background-color: #ddeeff;
+    font-weight: normal;
+}
+div.header a:hover {
+    background-color: #99CCFF;
+    font-weight: bolder
+}
+
+h1 {
+    text-align: center;
+    padding-left: 8%;
+    margin-top: 1em;
+    background-color: #ddeeff;
+    font-size: x-large;
+    border-top: 1px solid #000000;
+    border-bottom: 1px solid #000000;
+    clear: both;
+}
+
+h2 {
+    padding-left: 8%;
+    margin-top: 1em;
+    background-color: #ddeeff;
+    font-size: large;
+    border-top: 1px solid #000000;
+    border-bottom: 1px solid #000000;
+    clear: both;
+}
+h3 {
+    padding-left: 10%;
+    margin-top: 1em;
+    background-color: #ddeeff;
+    font-size: medium;
+    border-top: 1px solid #000000;
+    border-bottom: 1px solid #000000;
+    clear: both;
+}
+
+h4 {
+    padding: 0px;
+    margin: 10px 5% 2px 5%;
+    font-weight: bold;
+}
+
+p {
+    margin: 2px 5% 2px 5%;
+}
+
+table {
+    margin: 2px 5% 2px 5%;
+    border: none;
+}
+
+table tr,table td,table th {
+    border: none;
+}
+
+table.translators {
+    text-align: center;
+    display: table; margin-left: auto; margin-right: auto;
+    border-collapse: collapse;
+}
+
+table.translators th {
+    background-color: #d3dce3;
+}
+
+table.translators td, table.translators th {
+    border: 1px solid #000000;
+    padding: 5px;
+}
+
+ul {
+    margin: 2px 5% 2px 5%;
+}
+
+pre {
+    margin: 2px 5% 2px 5%;
+    
+}
+pre.wrap {
+    white-space: normal;
+}
+
+dl {
+    margin: 1em 6% 1em 6%;
+}
+dt {
+    font-weight: bold;
+    margin-left: 2em;
+    padding-top: 6px;
+}
+dd {
+    margin-left: 4em;
+}
+
+ol {
+    margin: 1em 6% 1em 6%;
+}
+
+.important {
+    color: #bb0000;
+}
+
+p.footnote {
+    margin: 2px 5% 2px 7%;
+}
+
+p.footnote:first-line {
+    margin-left: -2%;
+}
+

scripts/create-release.sh

@@ -59,7 +59,7 @@ Please ensure you have:
           " <h1>phpMyAdmin $1 Documentation</h1> "
      - in translators.html
   2. built the new "Documentation.txt" version using:
-       lynx --nolist --dump Documentation.html > Documentation.txt
+       lynx --dont_wrap_pre --nolist --dump Documentation.html > Documentation.txt
   3. synchronized the language files:
        cd lang
        ./sync_lang.sh

translators.html

@@ -6,48 +6,7 @@
 <head>
     <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
     <title>phpMyAdmin 2.4.0-dev - Official translators</title>
-    <style type="text/css">
+    <link rel="stylesheet" type="text/css" href="docs.css" />
-    <!--
-    body {
-        font-family: Arial, Helvetica, sans-serif;
-        font-size: normal;
-    }
-    p {
-        font-family: Arial, Helvetica, sans-serif;
-        font-size: normal;
-    }
-    h1 {
-        font-family: Verdana, Arial, Helvetica, sans-serif;
-        font-size: x-latge;
-        font-weight: bold;
-        color: #000066;
-    }
-    th {
-        font-family: Arial, Helvetica, sans-serif;
-        font-size: normal;
-        color: #000000;
-        background-color: #d3dce3;
-    }
-    td {
-        font-family: Arial, Helvetica, sans-serif;
-        font-size: normal;
-    }
-    .redtext {
-        color: #bb0000;
-    }
-    .navigation {
-        font-family: Verdana, Arial, Helvetica, sans-serif;
-        text-decoration: none;
-        font-size: normal;
-        color: #000099;
-        font-weight: normal;
-    }
-    .navigation:hover {
-        background-color: #99ccff;
-        font-weight: bolder;
-    }
-    //-->
-    </style>
     <script lanuage="javascript" type="text/javascript">
     <!--
     function PMA_notice(language) {
@@ -67,33 +26,46 @@
 </head>
 
 
-<body bgcolor="#FFFFFF">
+<body>
 
-<h1 align="center">phpMyAdmin 2.4.0-dev official translators list</h1>
+<div class="header">
-<br />
+<hr noshade="noshade" width="100%" />
+    <a href="Documentation.html#top">Documentation</a> &nbsp;-&nbsp;
+    <a href="Documentation.html#require">Requirements</a> &nbsp;-&nbsp;
+    <a href="Documentation.html#intro">Introduction</a> &nbsp;-&nbsp;
+    <a href="Documentation.html#setup">Installation</a> &nbsp;-&nbsp;
+    <a href="Documentation.html#config">Configuration</a> &nbsp;-&nbsp;
+    <a href="Documentation.html#faq">FAQ</a> &nbsp;-&nbsp;
+    <a href="Documentation.html#developers">Developers</a> &nbsp;-&nbsp;
+    <a href="Documentation.html#credits">Credits</a> &nbsp;-&nbsp;
+    <a href="Translators.html">translators</a>
+<hr noshade="noshade" width="100%" />
+</div>
+
+<h1>phpMyAdmin 2.4.0-dev official translators list</h1>
 
 <p>
     Here is the list of the so called &quot;official translators&quot; of
     phpMyAdmin.
 </p>
 <p>
-    <span class="redtext">If you want to suggest some improvements on a
+    <span class="important">If you want to suggest some improvements on a
     translation please ask them</span>: we (the phpMyAdmin developement team)
     don't know anything about most of these languages and then we can't have
     any opinion on grammar issues or bad translations!
 </p>
 <p>
     All translations listed here are included in this distribution.
-    <span class="redtext">Please don't ask the translators to send you a
+    <span class="important">Please don't ask the translators to send you a
     localized phpMyAdmin version!</span>
 </p>
 <p>
-    <span class="redtext">Please do not expect the translators to provide
+    <span class="important">Please do not expect the translators to provide
     e-mail support.</span>
 </p>
 <br />
 
-<table border="1" cellpadding="5" cellspacing="5" align="center">
+<table class="translators">
 <tr>
     <th>Language</th>
     <th>Official translator(s)</th>