0
@@ -3,17 +3,31 @@ require 'merb-core/dispatch/router/behavior'
0
 require 'merb-core/dispatch/router/route'
0
 require 'merb-core/controller/mixins/responder'
0
 module Merb
0
+  # Router stores route definitions and finds first
0
+  # that matches incoming request URL.
0
+  #
0
+  # Then information from route is used by dispatcher to
0
+  # call action on the controller.
0
+  #
0
+  # ==== Routes compilation.
0
+  #
0
+  # Most interesting method of Router (and heart of
0
+  # route matching machinery) is match method generated
0
+  # on fly from routes definitions. It is called routes
0
+  # compilation. Generated match method body contains
0
+  # one if/elsif statement that picks first matching route
0
+  # definition and sets values to named parameters of the route.
0
   class Router
0
     SEGMENT_REGEXP = /(:([a-z_][a-z0-9_]*|:))/
0
     SEGMENT_REGEXP_WITH_BRACKETS = /(:[a-z_]+)(\[(\d+)\])?/
0
     JUST_BRACKETS = /\[(\d+)\]/
0
     PARENTHETICAL_SEGMENT_STRING = "([^\/.,;?]+)".freeze
0
-    
0
+
0
     @@named_routes = {}
0
     @@routes = []
0
     @@compiler_mutex = Mutex.new
0
     cattr_accessor :routes, :named_routes
0
-    
0
+
0
     class << self
0
 
0
       # Appends the generated routes to the current routes.
0
@@ -141,6 +155,6 @@ module Merb
0
         url
0
       end
0
     end # self
0
-    
0
+
0
   end
0
 end