cleaning up more code.

laravel/database/connection.php

@@ -57,12 +57,20 @@ class Connection {
 	/**
 	 * Create a new query grammar for the connection.
 	 *
+	 * Query grammars allow support for new database systems to be added quickly
+	 * and easily. Since the responsibility of the query generation is delegated
+	 * to the grammar classes, it is simple to override only the methods with
+	 * SQL syntax that differs from the default implementation.
+	 *
 	 * @return Grammars\Grammar
 	 */
 	protected function grammar()
 	{
 		if (isset($this->grammar)) return $this->grammar;
 
+		// We allow the developer to hard-code a grammar for the connection. This really
+		// has no use yet; however, if database systems that can use multiple grammars
+		// like ODBC are added in the future, this will be needed.
 		switch (isset($this->config['grammar']) ? $this->config['grammar'] : $this->driver())
 		{
 			case 'mysql':

laravel/database/manager.php

@@ -71,6 +71,10 @@ class Manager {
 	/**
 	 * Create a new database connector instance.
 	 *
+	 * The database connectors are responsible for simply establishing a PDO
+	 * database connection given a configuration. This allows us to easily
+	 * drop in support for new database systems by writing a connector.
+	 *
 	 * @param  string     $driver
 	 * @return Connector
 	 */

laravel/routing/filter.php

@@ -122,6 +122,10 @@ class Filter_Collection {
 	/**
 	 * Determine if this collection's filters apply to a given method.
 	 *
+	 * Methods may be included / excluded using the "only" and "except" methods on the
+	 * filter collection. Also, the "on" method may be used to set certain filters to
+	 * only run when the request uses a given HTTP verb.
+	 *
 	 * @param  string  $method
 	 * @return bool
 	 */

laravel/routing/route.php

@@ -140,6 +140,9 @@ class Route {
 	 */
 	protected function response()
 	{
+		// If the route callback is an instance of a Closure, we can call the
+		// route function directly. There are no before or after filters to
+		// parse out of the route.
 		if ($this->callback instanceof Closure)
 		{
 			return call_user_func_array($this->callback, $this->parameters);