Reverts b30bf89

Removed Request::check_cache(). The replacement method doesn't work, so it's better to change the api and remove the method instead of confusing people by leaving in a method that is broken. Refs #3743

classes/kohana/request.php

@@ -661,7 +661,7 @@ protected static function _parse_accept( & $header, array $accepts = NULL)
 	 * created using the [Request::instance] or [Request::factory] methods.
 	 *
 	 *     $request = new Request($uri);
-	 * 
+	 *
 	 * If $cache parameter is set, the response for the request will attempt to
 	 * be retrieved from the cache.
 	 *
@@ -1084,27 +1084,6 @@ public function create_response($bind = TRUE)
 			return $this->_response = $response;
 	}
 
-	/**
-	 * Checks the browser cache to see the response needs to be returned.
-	 *
-	 *     $request->check_cache($etag);
-	 *
-	 * [!!] If the cache check succeeds, no further processing can be done!
-	 *
-	 * @param   string  $etag  Etag to check
-	 * @return  Request
-	 * @throws  Kohana_Request_Exception
-	 * @uses    Request::generate_etag
-	 * @deprecated
-	 */
-	public function check_cache($etag = null)
-	{
-		$this->create_response()
-			->check_cache($etag, $this);
-
-		return $this;
-	}
-
 	/**
 	 * Gets or sets the Http method. Usually GET, POST, PUT or DELETE in
 	 * traditional CRUD applications.