diff --git a/core/includes/bootstrap.inc b/core/includes/bootstrap.inc
index 027e070..ec83fbc 100644
--- a/core/includes/bootstrap.inc
+++ b/core/includes/bootstrap.inc
@@ -547,17 +547,24 @@ function timer_stop($name) {
  * For example:
  * @code
  * $sites = array(
- *   'devexample.com' => 'example.com',
+ *   'devexample.com'    => 'example.com',
  *   'localhost.example' => 'example.com',
+ *   '8080.localhost'    => 'example.com',
+ *   '8080.example.com.mysite.test' => 'example.com',
  * );
  * @endcode
- * The above array will cause Drupal to look for a directory named
- * "example.com" in the sites directory whenever a request comes from
- * "example.com", "devexample.com", or "localhost/example". That is useful
- * on development servers, where the domain name may not be the same as the
- * domain of the live server. Since Drupal stores file paths into the database
- * (files, system table, etc.) this will ensure the paths are correct while
- * accessed on development servers.
+ * The above array will cause Drupal to look for a directory named "example.com"
+ * in the sites directory whenever a request comes from:
+ * - example.com (default behavior)
+ * - devexample.com
+ * - localhost/example
+ * - localhost:8080
+ * - example.com:8080/mysite/test
+ *
+ * This is useful on development servers, where the domain name may not be
+ * the same as the domain of the live server. Since Drupal stores file paths
+ * into the database (files, system table, etc.) this will ensure the paths
+ * are correct while accessed on development servers.
  *
  * @param bool $require_settings
  *   Only configuration directories with an existing settings.php file
diff --git a/sites/default/default.settings.php b/sites/default/default.settings.php
index f434ac5..d6a6eac 100755
--- a/sites/default/default.settings.php
+++ b/sites/default/default.settings.php
@@ -40,6 +40,10 @@
  * hostname with that number. For example,
  * http://www.drupal.org:8080/mysite/test/ could be loaded from
  * sites/8080.www.drupal.org.mysite.test/.
+ *
+ * @see conf_path()
+ * @see find_conf_path()
+ * @see examples.sites.php
  */
 
 /**
diff --git a/sites/example.sites.php b/sites/example.sites.php
index 08c1020..d0f3637 100644
--- a/sites/example.sites.php
+++ b/sites/example.sites.php
@@ -4,40 +4,90 @@
  * @file
  * Configuration file for Drupal's multi-site directory aliasing feature.
  *
- * Drupal searches for an appropriate configuration directory based on the
- * website's hostname and pathname. A detailed description of the rules for
- * discovering the configuration directory can be found in the comment
- * documentation in 'sites/default/default.settings.php'.
+ * When index.php is called, Drupal tries to discover an appropriate
+ * configuration directory based on the website's hostname, port, and pathname.
+ * This file allows you to define a set of aliases that map hostnames, ports and
+ * pathnames to configuration directories in the sites directory. These aliases
+ * are loaded prior to scanning for directories, and they are exempt from the
+ * normal discovery rules.
  *
- * This file allows you to define a set of aliases that map hostnames and
- * pathnames to configuration directories. These aliases are loaded prior to
- * scanning for directories, and they are exempt from the normal discovery
- * rules. The aliases are defined in an associative array named $sites, which
- * should look similar to the following:
+ * To use this file, copy and rename it such that its path plus filename is
+ * 'sites/sites.php'. If you don't need to use multi-site directory aliasing,
+ * then you can safely ignore this file, and Drupal will ignore it too.
  *
+ * Aliases are defined in an associative array named $sites, which should look
+ * similar to the following:
+ * @code
  * $sites = array(
- *   'devexample.com' => 'example.com',
+ * //'The url to alias'  => 'A directory within the sites directory',
+ *   'devexample.com'    => 'example.com',
  *   'localhost.example' => 'example.com',
+ *   '8080.localhost'    => 'example.com',
+ *   '8080.example.com.mysite.test' => 'example.com',
  * );
+ * @endcode
+ * The above array will cause Drupal to look for a directory named "example.com"
+ * in the sites directory whenever a request comes from:
+ * - example.com (default behavior)
+ * - devexample.com
+ * - localhost/example
+ * - localhost:8080
+ * - example.com:8080/mysite/test
  *
- * The above array will cause Drupal to look for a directory named
- * "example.com" in the sites directory whenever a request comes from
- * "example.com", "devexample.com", or "localhost/example". That is useful
- * on development servers, where the domain name may not be the same as the
- * domain of the live server. Since Drupal stores file paths into the database
- * (files, system table, etc.) this will ensure the paths are correct while
- * accessed on development servers.
+ * This is useful on development servers, where the domain name may not be
+ * the same as the domain of the live server. Since Drupal stores file paths
+ * into the database (files, system table, etc.) this will ensure the paths
+ * are correct while accessed on development servers.
  *
- * To use this file, copy and rename it such that its path plus filename is
- * 'sites/sites.php'. If you don't need to use multi-site directory aliasing,
- * then you can safely ignore this file, and Drupal will ignore it too.
+ * The URLs listed point to root/index.php, and Drupal determines which site
+ * settings.php to load based upon the discovery rules and the aliases in
+ * sites.php. See the online Drupal installation guide for more information on
+ * setting up domains and subdomains. For subdirectories see below. A more
+ * detailed description of the rules for discovering the configuration directory
+ * can be found in sites/default/default.settings.php and
+ * core/includes/bootstrap.inc above conf_path().
+ *
+ * Example: Aliasing a subdirectory of your site (localhost/example)
+ * - Use the appropriate alias example at the end of this file to use
+ *   in sites/sites.php.
+ * - Create a symbolic link in the drupal root folder that points to the drupal
+ *   root.
+ * In the Drupal root where index.php is located, type:
+ * @code
+ * ln -s . example
+ * @endcode
+ * Your site should now have Drupal websites installed at http://localhost, and
+ * another at http://localhost/example sharing the same Drupal code.
+ *
+ * @see default.settings.php
+ * @see conf_path()
+ * @see find_conf_path()
  */
 
 /**
- * Multi-site directory aliasing:
+ * Example multi-site directory aliases.
  *
- * Edit the lines below to define directory aliases. Remove the leading hash
- * signs to enable.
- */
-# $sites['devexample.com'] = 'example.com';
-# $sites['localhost.example'] = 'example.com';
+ * $sites should define an associative array which maps domains to directories.
+ * It should be in the form of:
+ * @code
+ * $sites = array(
+ *   'The url to alias' => 'A directory within the sites directory'
+ * );
+ * @endcode
+ *
+ * The following examples look for a site configuration in sites/example.com
+ * @code
+ * URL: http://devexample.com
+ * $sites['devexample.com'] = 'example.com';
+ *
+ * URL: http://localhost/example
+ * $sites['localhost.example'] = 'example.com';
+ *
+ * URL: http://localhost:8080/example
+ * $sites['8080.localhost.example'] = 'example.com';
+ *
+ * URL: http://www.example.com:8080/mysite/test/
+ * $sites['8080.example.com.mysite.test'] = 'example.com';
+ * @endcode
+ *
+ */
\ No newline at end of file