diff --git a/core/includes/install.inc b/core/includes/install.inc
index 3f89516..3f1d1ff 100644
--- a/core/includes/install.inc
+++ b/core/includes/install.inc
@@ -209,7 +209,18 @@ function drupal_rewrite_settings($settings = array()) {
         // Write the new value to settings.php in the following format:
         //    $[setting] = '[value]'; // [comment]
         $setting = $settings[$variable_name];
-        $buffer .= '$' . $variable_name . ' = ' . var_export($setting['value'], TRUE) . ';';
+        // Add special handling for the $databases setting to improve readability and to
+        // match the format of the database settings documentation in settings.php.
+        if ($variable_name == 'databases') {
+          foreach($setting['value'] as $db_first_key => $values) {
+            foreach($values as $db_second_key => $values) {
+              $buffer .= '$' . "databases['$db_first_key']['$db_second_key'] = " . var_export($values, TRUE) . ";";
+            }
+          }
+        }
+        else {
+          $buffer .= '$' . $variable_name . " = " . var_export($setting['value'], TRUE) . ";";
+        }
         if (!empty($setting['comment'])) {
           $buffer .= ' // ' . $setting['comment'];
         }
diff --git a/sites/default/default.settings.php b/sites/default/default.settings.php
index ba17413..10af708 100755
--- a/sites/default/default.settings.php
+++ b/sites/default/default.settings.php
@@ -54,12 +54,12 @@
  * similar to the following:
  * @code
  * array(
- *   'driver' => 'mysql',
  *   'database' => 'databasename',
  *   'username' => 'username',
  *   'password' => 'password',
  *   'host' => 'localhost',
  *   'port' => 3306,
+ *   'driver' => 'mysql',
  *   'prefix' => 'myprefix_',
  *   'collation' => 'utf8_general_ci',
  * );
@@ -106,11 +106,11 @@
  * For a single database configuration, the following is sufficient:
  * @code
  * $databases['default']['default'] = array(
- *   'driver' => 'mysql',
  *   'database' => 'databasename',
  *   'username' => 'username',
  *   'password' => 'password',
  *   'host' => 'localhost',
+ *   'driver' => 'mysql',
  *   'prefix' => 'main_',
  *   'collation' => 'utf8_general_ci',
  * );
@@ -181,24 +181,27 @@
  * Database configuration format:
  * @code
  *   $databases['default']['default'] = array(
- *     'driver' => 'mysql',
  *     'database' => 'databasename',
  *     'username' => 'username',
  *     'password' => 'password',
  *     'host' => 'localhost',
+ *     'port' => '',
+ *     'driver' => 'mysql',
  *     'prefix' => '',
  *   );
  *   $databases['default']['default'] = array(
- *     'driver' => 'pgsql',
  *     'database' => 'databasename',
  *     'username' => 'username',
  *     'password' => 'password',
  *     'host' => 'localhost',
+ *     'port' => '',
+ *     'driver' => 'pgsql',
  *     'prefix' => '',
  *   );
  *   $databases['default']['default'] = array(
- *     'driver' => 'sqlite',
  *     'database' => '/path/to/databasefilename',
+ *     'driver' => 'sqlite',
+ *     'prefix' => '',
  *   );
  * @endcode
  */