0
@@ -2,6 +2,8 @@
0
 
0
 module Thin
0
   # Connection between the server and client.
0
+  # This class is instanciated by EventMachine on each new connection
0
+  # that is opened.
0
   class Connection < EventMachine::Connection
0
     include Logging
0
     
0
0
@@ -11,11 +13,13 @@
0
     # Connector to the server
0
     attr_accessor :connector
0
     
0
+    # Get the connection ready to process a request.
0
     def post_init
0
       @request  = Request.new
0
       @response = Response.new
0
     end
0
     
0
+    # Called when data is received from the client.
0
     def receive_data(data)
0
       trace { data }
0
       process if @request.parse(data)
0
@@ -25,6 +29,8 @@
0
       close_connection
0
     end
0
     
0
+    # Called when all data was received and the request
0
+    # is ready to being processed.
0
     def process
0
       # Add client info to the request env
0
       @request.remote_address = remote_address
0
@@ -32,7 +38,7 @@
0
       # Process the request
0
       @response.status, @response.headers, @response.body = @app.call(@request.env)
0
       
0
-      # Tell the client the connection is persistent if requested
0
+      # Make the response persistent if requested by the client
0
       @response.persistent! if @request.persistent?
0
       
0
       # Send the response
0
0
@@ -57,10 +63,14 @@
0
       post_init if persistent?
0
     end
0
     
0
+    # Called when the connection is unbinded from the socket
0
+    # and can no longer be used to process requests.
0
     def unbind
0
       @connector.connection_finished(self)
0
     end
0
     
0
+    # Return +true+ if the connection must be left open
0
+    # and ready to be reused for another request.
0
     def persistent?
0
       @response.persistent?
0
     end