diff --git a/core/Core.php b/core/Core.php
index 12a7c4c2b..35233545c 100755
--- a/core/Core.php
+++ b/core/Core.php
@@ -290,6 +290,9 @@ function getTempFolder($base = null) {
  * classes.  Classes will be loaded from any PHP file within the application.
  * If your class contains an underscore, for example, Page_Controller, then the filename is
  * expected to be the stuff before the underscore.  In this case, Page.php.
+ * 
+ * Class names are converted to lowercase for lookup to adhere to PHP's case-insensitive
+ * way of dealing with them.
  */
 function __autoload($className) {
 	global $_CLASS_MANIFEST;
@@ -299,7 +302,10 @@ function __autoload($className) {
 }
 
 /**
- * Return the file where that class is stored
+ * Return the file where that class is stored.
+ * 
+ * @param String $className Case-insensitive lookup.
+ * @return String
  */
 function getClassFile($className) {
 	global $_CLASS_MANIFEST;
diff --git a/core/ManifestBuilder.php b/core/ManifestBuilder.php
index 760b41485..806592ec5 100644
--- a/core/ManifestBuilder.php
+++ b/core/ManifestBuilder.php
@@ -380,6 +380,8 @@ class ManifestBuilder {
 
 		foreach(self::$classArray as $class => $info) {
 			$allClasses['exists'][$class] = $class;
+			// Class names are converted to lowercase for lookup to adhere to PHP's case-insensitive
+			// way of dealing with them.
 			$allClasses['file'][strtolower($class)] = $info['file'];
 		}