diff --git a/ChangeLog b/ChangeLog index dda0b9380..f79e58567 100755 --- a/ChangeLog +++ b/ChangeLog @@ -5,6 +5,9 @@ phpMyAdmin - Changelog $Id$ $Source$ +2004-09-20 Michal Čihař + * Documentation.html: Add info about theme generations. + 2004-09-19 Alexander M. Turek * Documentation.html: Clarification. diff --git a/Documentation.html b/Documentation.html index 331c7e9de..75aa7139d 100755 --- a/Documentation.html +++ b/Documentation.html @@ -146,10 +146,10 @@ tar -xzvf phpMyAdmin_x.x.x.tar.gz in your webserver's document root. If you don't have direct access to your document root, put the files in a directory on your local machine, and, after step 3, - transfer the directory on your web server using, for example, ftp.
  • Ensure that all the scripts have the appropriate owner (if PHP is + transfer the directory on your web server using, for example, ftp.
  • Ensure that all the scripts have the appropriate owner (if PHP is running in safe mode, having some scripts with an owner different from the owner of other scripts will be a - problem). See FAQ 4.2 for suggestions.
    • + problem). See FAQ 4.2 for suggestions.
  • Open the file config.inc.php in your favorite editor and change the values for host, user, password and authentication mode to fit your environment. Here, "host" means the MySQL server. @@ -172,18 +172,18 @@

    Linked-tables infrastructure

    - For a whole set of new features (bookmarks, comments, SQL-history, + For a whole set of new features (bookmarks, comments, SQL-history, PDF-generation, field contents transformation, etc.) you need to create a set of special tables. Those tables can be located - in your own database, or in a central database for a multi-user - installation (this database would then be accessed by the controluser, + in your own database, or in a central database for a multi-user + installation (this database would then be accessed by the controluser, so no other user should have rights to it).

    Please look at your scripts/ directory, where you should find a file called create_tables.sql. (If you are using a Windows server, pay special attention to FAQ 1.23).

    - If your MySQL server's version is 4.1.2 or later, please use + If your MySQL server's version is 4.1.2 or later, please use create_tables_mysql_4_1_2+.sql instead, for a new installation.

    If you already had this infrastructure and upgraded to MySQL 4.1.2 @@ -614,7 +614,7 @@ GRANT SELECT, INSERT, UPDATE, DELETE ON <pma_db>.* TO 'pma'@'localhost';

    The name of the database containing the linked-tables infrastructure.

    - See the Linked-tables infrastructure + See the Linked-tables infrastructure section in this document to see the benefits of this infrastructure, and for a quick way of creating this database and the needed tables.

    @@ -1417,7 +1417,7 @@ Defaults to FALSE (drop-down).
    $cfg['LeftPointerEnable'] boolean
    - A value of TRUE activates the left pointer (when LeftFrameLight is FALSE). + A value of TRUE activates the left pointer (when LeftFrameLight is FALSE).

    @@ -1653,12 +1653,12 @@ Defaults to FALSE (drop-down).
    interface to enter SQL queries.

    When $cfg['QueryFrameJS'] is set to true, clicking on that link opens - the query box, a new custom sized browser window - ($cfg['QueryWindowWidth'], $cfg['QueryWindowWidth'] - both integers - for the size in pixels). - Also, a click on [Edit] from the results page (in the "Showing - Rows" section) opens the query box and puts the current query - inside it. If set to false, clicking on the link only opens the SQL + the query box, a new custom sized browser window + ($cfg['QueryWindowWidth'], $cfg['QueryWindowWidth'] - both integers + for the size in pixels). + Also, a click on [Edit] from the results page (in the "Showing + Rows" section) opens the query box and puts the current query + inside it. If set to false, clicking on the link only opens the SQL input in the main frame.

    The usage of the JavaScript query window is recommended if you have a @@ -1752,7 +1752,7 @@ Defaults to FALSE (drop-down).
    $cfg['ShowHttpHostTitle'] boolean
    - Shows the HTTP host name in window's title bar. + Shows the HTTP host name in window's title bar.

    @@ -1974,7 +1974,7 @@ Defaults to FALSE (drop-down).
    $cfg['TextOperators'] array
    Operators available for search operations on character fields. - Note that we put LIKE by default instead of + Note that we put LIKE by default instead of LIKE %...%, to avoid unintended performance problems in case of huge tables.

    @@ -1985,14 +1985,14 @@ Defaults to FALSE (drop-down).
    Operators available for search operations on enum fields.

    - +
    $cfg['NullOperators'] array
    Additionnal operators available for search operations when the field can be null.

    - + @@ -2775,20 +2775,20 @@ To create a new, empty mimetype please see libraries/transformations/template_ge

    - [2.7] Using and creating themes + [2.7] Using and creating themes

    Themes are configured with $cfg['ThemePath'], $cfg['ThemeManager'] and $cfg['ThemeDefault'].

    - Under $cfg['ThemePath'], you should not delete the directory + Under $cfg['ThemePath'], you should not delete the directory "original" or its underlying structure, because this is - the system theme used by phpMyAdmin. "original" contains all + the system theme used by phpMyAdmin. "original" contains all images and styles, for backwards compatibility and for all themes that would not include images or css-files.

    - If $cfg['ThemeManager'] is enabled, you can select your - favorite theme on the main page. Your selected theme will be stored + If $cfg['ThemeManager'] is enabled, you can select your + favorite theme on the main page. Your selected theme will be stored in a cookie.

    @@ -2808,16 +2808,14 @@ To create a new, empty mimetype please see libraries/transformations/template_ge

    In theme directory there is file info.inc.php which contains - theme verbose name and theme version. These versions are enumerated from 1 - and do not have any direct dependance on phpMyAdmin version. Themes with - higher version should work also in older phpMyAdmin versions because we - currently expect these will only grow (new css classes or more images), - but this behaviour will be probably changed in future, in case phpMyAdmin - will start to use some templates and these will require completely - different themes. + theme verbose name, theme generation and theme version. These versions and + generations are enumerated from 1 and do not have any direct dependance on + phpMyAdmin version. Themes within same generation should be bacward + compatible - theme with version 2 should work in phpMyAdmin requiring + version 1. Themes with different generation are incompatible.

    - If you do not want to use your own symbols and buttons, remove the + If you do not want to use your own symbols and buttons, remove the directory "img" in "your_theme_name". phpMyAdmin will use the default icons and buttons (from the system-theme "original").

    @@ -3681,7 +3679,7 @@ To create a new, empty mimetype please see libraries/transformations/template_ge 
         cd phpMyAdmin
     mkdir tmp
-    chmod o+rwx tmp 
+    chmod o+rwx tmp

    [7. phpMyAdmin project]

    @@ -3820,10 +3818,10 @@ To create a new, empty mimetype please see libraries/transformations/template_ge The phpMyAdmin development team received notice of this security alert: http://securityfocus.com/archive/1/367486/2004-06-26/2004-07-02/0

    - We would like to put emphasis on the disappointment we feel when a - bugreporter does not contact the authors of a software first, before - posting any exploits. The common way to report this, is to give the - developers a reasonable amount of time to respond to an exploit before + We would like to put emphasis on the disappointment we feel when a + bugreporter does not contact the authors of a software first, before + posting any exploits. The common way to report this, is to give the + developers a reasonable amount of time to respond to an exploit before it is made public.

    We acknowledge that phpMyAdmin versions 2.5.1 to 2.5.7 are vulnerable