From 0daf6e4dba9016345059d2496df3b518341a0c13 Mon Sep 17 00:00:00 2001
From: Mark Story <mark@mark-story.com>
Date: Thu, 29 Apr 2010 00:33:41 -0400
Subject: [PATCH] Adding skeleton for addDetector.

---
 cake/libs/cake_request.php | 39 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/cake/libs/cake_request.php b/cake/libs/cake_request.php
index 2322a1d52..c569ab789 100644
--- a/cake/libs/cake_request.php
+++ b/cake/libs/cake_request.php
@@ -272,6 +272,45 @@ class CakeRequest implements ArrayAccess {
 		return false;
 	}
 
+/**
+ * Add a new detector to the list of detectors that a request can use.
+ * There are several different formats and types of detectors that can be set.
+ *
+ * ### Environment value comparison
+ *
+ * An environment value comparison, compares a value fetched from `env()` to a known value
+ * the environment value is equality checked against the provided value.
+ *
+ * e.g `addDetector('post', array('env' => 'REQUEST_METHOD', 'value' => 'POST'))`
+ *
+ * ### Pattern value comparison
+ *
+ * Pattern value comparison allows you to compare a value fetched from `env()` to a regular expression.
+ * 
+ * e.g `addDetector('iphone', array('env' => 'HTTP_USER_AGENT', 'pattern' => '/iPhone/i'));
+ *
+ * ### Option based comparison
+ *
+ * Option based comparisons use a list of options to create a regular expression.  Subsequent calls
+ * to add an already defined options detector will merge the options.
+ *
+ * e.g `addDetector('mobile', array('env' => 'HTTP_USER_AGENT', 'options' => array('Fennec')));`
+ *
+ * ### Callback detectors
+ *
+ * Callback detectors allow you to provide a 'callback' type to handle the check.  The callback will
+ * recieve the request object as its only parameter.
+ *
+ * e.g `addDetector('custom', array('callback' => array('SomeClass', 'somemethod')));`
+ *
+ * @param string $name The name of the detector.
+ * @param array $options  The options for the detector definition.  See above.
+ * @return void
+ */
+	public function addDetector($name, $options) {
+		
+	}
+
 /**
  * Array access read implementation
  *