diff --git a/sites/example.sites.php b/sites/example.sites.php
index 830dcde..f512f76 100644
--- a/sites/example.sites.php
+++ b/sites/example.sites.php
@@ -4,7 +4,7 @@
  * @file
  * Configuration file for Drupal's multi-site directory aliasing feature.
  *
- * This file allows you to define a set of aliases that map hostnames, ports and
+ * 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. See default.settings.php to view how Drupal discovers
@@ -19,20 +19,21 @@
  * '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. To create a
- * directory alias for http://www.drupal.org:8080/mysite/test whose
- * configuration file is in sites/example.com the array should look like:
+ * Aliases are defined in an associative array named $sites. The array is 
+ * written in the format: '<port>.<domain>.<path>' => 'directory'.
+ * As an example, to create a directory alias for:
+ * http://www.drupal.org:8080/mysite/test whose configuration file is in 
+ * sites/example.com, the array should be written as such:
  * @code
  * $sites = array(
- * //'The URL to alias(formatted like example)' => 'A directory within the sites directory',
  *   '8080.www.drupal.org.mysite.test' => 'example.com',
  * );
  * @endcode
  * The URL, http://www.drupal.org:8080/mysite/test/, could be a symbolic link or
  * an Apache Alias directive that points to the Drupal root containing
- * index.php. An alias could also be created for a subdomain. See the online
- * Drupal installation guide for more information on setting up domains,
- * subdomains, and subdirectories.
+ * index.php. An alias could also be created for a subdomain. See the
+ * @link http://drupal.org/documentation/install online Drupal installation guide @endlink
+ * for more information on setting up domains, subdomains, and subdirectories.
  *
  * @see default.settings.php
  * @see conf_path()
@@ -46,7 +47,7 @@
  * It should be in the form of:
  * @code
  * $sites = array(
- *   'The URL to alias(formatted like examples)' => 'A directory within the sites directory'
+ *    '<port>.<domain>.<path>' => 'directory',
  * );
  * @endcode
  *
@@ -64,5 +65,4 @@
  * URL: http://www.drupal.org:8080/mysite/test/
  * $sites['8080.www.drupal.org.mysite.test'] = 'example.com';
  * @endcode
- *
- */
\ No newline at end of file
+ */