Index: settings.php
===================================================================
RCS file: /cvs/drupal/drupal/sites/default/settings.php,v
retrieving revision 1.11
diff -u -r1.11 settings.php
--- settings.php	15 Mar 2005 21:07:49 -0000	1.11
+++ settings.php	26 Mar 2005 01:17:54 -0000
@@ -37,21 +37,42 @@
  *
  * Note that the $db_url variable gets parsed using PHP's built-in
  * URL parser (i.e. using the "parse_url()" function) so make sure
- * not to confuse the parser. In practice, you should avoid using
- * special characters that are not used in "normal" URLs either.
- * That is, the use of ':', '/', '@', '?', '=' and '#', ''', '"',
- * and so on is likely to confuse the parser; use alpha-numerical
- * characters instead.
+ * not to confuse the parser. If your db_user, db_password,
+ * db_hostname, or db_name contain characters used to delineate
+ * $db_url parts, you can escape them via URI hex encodings:
+ *
+ *   : = %3a   / = %2f   @ = %40
+ *   + = %2b   ( = %28   ) = %29
+ *   ? = %3f   = = %3d   & = %26
  *
  * To specify multiple connections to be used in your site (i.e. for
  * complex custom modules) you can also specify an associative array
  * of $db_url variables with the 'default' element used until otherwise
  * requested.
  *
- * If an optional $db_prefix is specified, all database table names
- * will be prepended with this string. Be sure to use valid database
- * characters only, usually alphanumeric and underscore. If no
- * prefixes are desired, set to empty string ''.
+ * You can set prefixes for some or all database table names by using
+ * the $db_prefix setting. If a prefix is specified, its value will be
+ * prepended with this string. Be sure to use valid database characters
+ * only, usually alphanumeric and underscore. If no prefixes are desired,
+ * leave it as an empty string ''.
+ *
+ * To have all database names prefixed, set $db_prefix as a string:
+ *
+ *   $db_prefix = 'd1_';
+ *
+ * To provide prefixes for specific tables, set $db_prefix as an array.
+ * The array's keys are the table names and the values are the prefixes.
+ * The 'default' element holds the prefix for any tables not specified
+ * elsewhere in the array. Example:
+ *
+ *   $db_prefix = array(
+ *     'default'   => 'd1_',
+ *     'users'     => 'd_share_',
+ *     'sessions'  => 'd_share_',
+ *     'role'      => 'd_share_',
+ *     'authmap'   => 'd_share_',
+ *     'sequences' => 'd_share_',
+ *   );
  *
  * Database URL format:
  * $db_url = 'mysql://db_user:db_password@db_hostname/db_name';