diff --git a/reference/yaf/yaf_route_interface/route.xml b/reference/yaf/yaf_route_interface/route.xml
index b40ccdb33e..08bf3cfc64 100644
--- a/reference/yaf/yaf_route_interface/route.xml
+++ b/reference/yaf/yaf_route_interface/route.xml
@@ -10,8 +10,8 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <modifier>abstract</modifier> <modifier>public</modifier> <type>void</type><methodname>Yaf_Route_Interface::route</methodname>
-   <methodparam><type>string</type><parameter>request</parameter></methodparam>
+   <modifier>abstract</modifier> <modifier>public</modifier> <type>bool</type><methodname>Yaf_Route_Interface::route</methodname>
+   <methodparam><type>Yaf_Request_Abstract</type><parameter>request</parameter></methodparam>
   </methodsynopsis>
   <para>
     <methodname>Yaf_Route_Interface::route</methodname> is the only method
diff --git a/reference/yaf/yaf_route_map/construct.xml b/reference/yaf/yaf_route_map/construct.xml
index f6b7c5394f..d5fc26b9a8 100644
--- a/reference/yaf/yaf_route_map/construct.xml
+++ b/reference/yaf/yaf_route_map/construct.xml
@@ -11,8 +11,8 @@
   &reftitle.description;
   <methodsynopsis>
    <methodname>Yaf_Route_Map::__construct</methodname>
-   <methodparam choice="opt"><type>string</type><parameter>controller_prefer</parameter></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>delimiter</parameter></methodparam>
+   <methodparam choice="opt"><type>string</type><parameter>controller_prefer</parameter><initializer>false</initializer></methodparam>
+   <methodparam choice="opt"><type>string</type><parameter>delimiter</parameter><initializer>''</initializer></methodparam>
   </methodsynopsis>
   <para>
 
@@ -29,7 +29,7 @@
     <term><parameter>controller_prefer</parameter></term>
     <listitem>
      <para>
-      
+      Whether the result should considering as controller or action
      </para>
     </listitem>
    </varlistentry>
@@ -51,6 +51,76 @@
   </para>
  </refsect1>
 
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title><function>Yaf_Route_Map</function>example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+   /**
+    * Add a map route to Yaf_Router route stack
+    */
+    Yaf_Dispatcher::getInstance()->getRouter()->addRoute("name",
+        new Yaf_Route_Map());
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+/* for http://yourdomain.com/product/foo/bar
+ * route will result in following values:
+ */
+array(
+  "controller" => "product_foo_bar",
+)
+]]>
+   </screen>
+  </example>
+  <example>
+   <title><function>Yaf_Route_Map</function>example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+   /**
+    * Add a map route to Yaf_Router route stack
+    */
+    Yaf_Dispatcher::getInstance()->getRouter()->addRoute("name",
+        new Yaf_Route_Map(true, "_"));
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+/* for http://yourdomain.com/user/list/_/foo/22
+ * route will result in following values:
+ */
+array(
+    "action" => "user_list",
+)
+
+/**
+ * and request parameters:
+ */
+array(
+  "foo"   => 22,
+)
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member><methodname>Yaf_Router::addRoute</methodname></member>
+   <member><classname>Yaf_Route_Static</classname></member>
+   <member><classname>Yaf_Route_Supervar</classname></member>
+   <member><classname>Yaf_Route_Simple</classname></member>
+   <member><classname>Yaf_Route_Regex</classname></member>
+   <member><classname>Yaf_Route_Rewrite</classname></member>
+  </simplelist>                       
+ </refsect1>  
 
 </refentry>
 
diff --git a/reference/yaf/yaf_route_map/route.xml b/reference/yaf/yaf_route_map/route.xml
index 4f0f7cbd5e..0f0bd75528 100644
--- a/reference/yaf/yaf_route_map/route.xml
+++ b/reference/yaf/yaf_route_map/route.xml
@@ -10,8 +10,8 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <modifier>public</modifier> <type>void</type><methodname>Yaf_Route_Map::route</methodname>
-   <methodparam><type>string</type><parameter>request</parameter></methodparam>
+   <modifier>public</modifier> <type>bool</type><methodname>Yaf_Route_Map::route</methodname>
+   <methodparam><type>Yaf_Request_Abstract</type><parameter>request</parameter></methodparam>
   </methodsynopsis>
   <para>
 
diff --git a/reference/yaf/yaf_route_regex/route.xml b/reference/yaf/yaf_route_regex/route.xml
index 1797cd04ee..13c350a1d6 100644
--- a/reference/yaf/yaf_route_regex/route.xml
+++ b/reference/yaf/yaf_route_regex/route.xml
@@ -10,8 +10,8 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <modifier>public</modifier> <type>void</type><methodname>Yaf_Route_Regex::route</methodname>
-   <methodparam><type>string</type><parameter>request</parameter></methodparam>
+   <modifier>public</modifier> <type>bool</type><methodname>Yaf_Route_Regex::route</methodname>
+   <methodparam><type>Yaf_Request_Abstract</type><parameter>request</parameter></methodparam>
   </methodsynopsis>
   <para>
 
diff --git a/reference/yaf/yaf_route_rewrite/route.xml b/reference/yaf/yaf_route_rewrite/route.xml
index afe8640abb..57c4517edf 100644
--- a/reference/yaf/yaf_route_rewrite/route.xml
+++ b/reference/yaf/yaf_route_rewrite/route.xml
@@ -10,8 +10,8 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <modifier>public</modifier> <type>void</type><methodname>Yaf_Route_Rewrite::route</methodname>
-   <methodparam><type>string</type><parameter>request</parameter></methodparam>
+   <modifier>public</modifier> <type>bool</type><methodname>Yaf_Route_Rewrite::route</methodname>
+   <methodparam><type>Yaf_Request_Abstract</type><parameter>request</parameter></methodparam>
   </methodsynopsis>
   <para>
 
diff --git a/reference/yaf/yaf_route_simple/route.xml b/reference/yaf/yaf_route_simple/route.xml
index 94c7851d5e..62219278bb 100644
--- a/reference/yaf/yaf_route_simple/route.xml
+++ b/reference/yaf/yaf_route_simple/route.xml
@@ -10,8 +10,8 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <modifier>public</modifier> <type>void</type><methodname>Yaf_Route_Simple::route</methodname>
-   <methodparam><type>string</type><parameter>request</parameter></methodparam>
+   <modifier>public</modifier> <type>bool</type><methodname>Yaf_Route_Simple::route</methodname>
+   <methodparam><type>Yaf_Request_Abstract</type><parameter>request</parameter></methodparam>
   </methodsynopsis>
   <para>
    see <methodname>Yaf_Route_Simple::__construct</methodname>
diff --git a/reference/yaf/yaf_route_static/route.xml b/reference/yaf/yaf_route_static/route.xml
index 066207ac66..7d752cdd40 100644
--- a/reference/yaf/yaf_route_static/route.xml
+++ b/reference/yaf/yaf_route_static/route.xml
@@ -10,8 +10,8 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <modifier>public</modifier> <type>void</type><methodname>Yaf_Route_Static::route</methodname>
-   <methodparam><type>string</type><parameter>request</parameter></methodparam>
+   <modifier>public</modifier> <type>bool</type><methodname>Yaf_Route_Static::route</methodname>
+   <methodparam><type>Yaf_Request_Abstract</type><parameter>request</parameter></methodparam>
   </methodsynopsis>
   <para>
 
diff --git a/reference/yaf/yaf_route_supervar/route.xml b/reference/yaf/yaf_route_supervar/route.xml
index 85bea55ac1..343574af6f 100644
--- a/reference/yaf/yaf_route_supervar/route.xml
+++ b/reference/yaf/yaf_route_supervar/route.xml
@@ -10,8 +10,8 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <modifier>public</modifier> <type>void</type><methodname>Yaf_Route_Supervar::route</methodname>
-   <methodparam><type>string</type><parameter>request</parameter></methodparam>
+   <modifier>public</modifier> <type>bool</type><methodname>Yaf_Route_Supervar::route</methodname>
+   <methodparam><type>Yaf_Request_Abstract</type><parameter>request</parameter></methodparam>
   </methodsynopsis>
   <para>