RubyGems - mongrel - Versions diffs - 0.2.1 → 0.2.2 - Mend

mongrel 0.2.1 → 0.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (52) hide show

data/doc/rdoc/classes/Mongrel/DirHandler.src/M000008.html ADDED

@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+  <title>new (Mongrel::DirHandler)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre>     <span class="ruby-comment cmt"># File lib/mongrel.rb, line 433</span>
+433:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">path</span>, <span class="ruby-identifier">listing_allowed</span>=<span class="ruby-keyword kw">true</span>)
+434:       <span class="ruby-ivar">@path</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">expand_path</span>(<span class="ruby-identifier">path</span>)
+435:       <span class="ruby-ivar">@listing_allowed</span>=<span class="ruby-identifier">listing_allowed</span>
+436:       <span class="ruby-identifier">puts</span> <span class="ruby-value str">&quot;DIR: #@path&quot;</span>
+437:     <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/rdoc/classes/Mongrel/DirHandler.src/M000009.html ADDED

@@ -0,0 +1,31 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+  <title>send_dir_listing (Mongrel::DirHandler)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre>     <span class="ruby-comment cmt"># File lib/mongrel.rb, line 439</span>
+439:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">send_dir_listing</span>(<span class="ruby-identifier">base</span>, <span class="ruby-identifier">dir</span>, <span class="ruby-identifier">response</span>)
+440:       <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@listing_allowed</span>
+441:         <span class="ruby-identifier">response</span>.<span class="ruby-identifier">start</span>(<span class="ruby-value">200</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">head</span>,<span class="ruby-identifier">out</span><span class="ruby-operator">|</span>
+442:           <span class="ruby-identifier">head</span>[<span class="ruby-value str">'Content-Type'</span>] = <span class="ruby-value str">&quot;text/html&quot;</span>
+443:           <span class="ruby-identifier">out</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">&quot;&lt;html&gt;&lt;head&gt;&lt;title&gt;Directory Listing&lt;/title&gt;&lt;/head&gt;&lt;body&gt;&quot;</span>
+444:           <span class="ruby-constant">Dir</span>.<span class="ruby-identifier">entries</span>(<span class="ruby-identifier">dir</span>).<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">child</span><span class="ruby-operator">|</span>
+445:             <span class="ruby-identifier">out</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-node">&quot;&lt;a href=\&quot;#{base}/#{child}\&quot;&gt;#{child}&lt;/a&gt;&lt;br/&gt;&quot;</span>
+446:           <span class="ruby-keyword kw">end</span>
+447:           <span class="ruby-identifier">out</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">&quot;&lt;/body&gt;&lt;/html&gt;&quot;</span>
+448:         <span class="ruby-keyword kw">end</span>
+449:       <span class="ruby-keyword kw">else</span>
+450:         <span class="ruby-identifier">response</span>.<span class="ruby-identifier">start</span>(<span class="ruby-value">403</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">head</span>,<span class="ruby-identifier">out</span><span class="ruby-operator">|</span>
+451:           <span class="ruby-identifier">out</span>.<span class="ruby-identifier">write</span>(<span class="ruby-value str">&quot;Directory listings not allowed&quot;</span>)
+452:         <span class="ruby-keyword kw">end</span>
+453:       <span class="ruby-keyword kw">end</span>
+454:     <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/rdoc/classes/Mongrel/DirHandler.src/M000010.html ADDED

@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+  <title>send_file (Mongrel::DirHandler)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre>     <span class="ruby-comment cmt"># File lib/mongrel.rb, line 457</span>
+457:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">send_file</span>(<span class="ruby-identifier">req</span>, <span class="ruby-identifier">response</span>)
+458:       <span class="ruby-identifier">response</span>.<span class="ruby-identifier">start</span>(<span class="ruby-value">200</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">head</span>,<span class="ruby-identifier">out</span><span class="ruby-operator">|</span>
+459:         <span class="ruby-identifier">open</span>(<span class="ruby-identifier">req</span>, <span class="ruby-value str">&quot;r&quot;</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">f</span><span class="ruby-operator">|</span>
+460:           <span class="ruby-identifier">out</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">f</span>.<span class="ruby-identifier">read</span>)
+461:         <span class="ruby-keyword kw">end</span>
+462:       <span class="ruby-keyword kw">end</span>
+463:     <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/rdoc/classes/Mongrel/DirHandler.src/M000011.html ADDED

@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+  <title>process (Mongrel::DirHandler)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre>     <span class="ruby-comment cmt"># File lib/mongrel.rb, line 466</span>
+466:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">process</span>(<span class="ruby-identifier">request</span>, <span class="ruby-identifier">response</span>)
+467:       <span class="ruby-identifier">req</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">expand_path</span>(<span class="ruby-value str">&quot;.&quot;</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">request</span>.<span class="ruby-identifier">params</span>[<span class="ruby-value str">'PATH_INFO'</span>], <span class="ruby-ivar">@path</span>)
+468:       <span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;FIND: #{req}&quot;</span>
+469:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">req</span>.<span class="ruby-identifier">index</span>(<span class="ruby-ivar">@path</span>) <span class="ruby-operator">!=</span> <span class="ruby-value">0</span> <span class="ruby-keyword kw">or</span> <span class="ruby-operator">!</span><span class="ruby-constant">File</span>.<span class="ruby-identifier">exist?</span> <span class="ruby-identifier">req</span>
+470:         <span class="ruby-comment cmt"># not found, return a 404</span>
+471:         <span class="ruby-identifier">response</span>.<span class="ruby-identifier">start</span>(<span class="ruby-value">404</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">head</span>,<span class="ruby-identifier">out</span><span class="ruby-operator">|</span>
+472:           <span class="ruby-identifier">out</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">&quot;File not found&quot;</span>
+473:         <span class="ruby-keyword kw">end</span>
+474:       <span class="ruby-keyword kw">else</span>
+475:         <span class="ruby-keyword kw">begin</span>
+476:           <span class="ruby-keyword kw">if</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">directory?</span> <span class="ruby-identifier">req</span>
+477:             <span class="ruby-identifier">send_dir_listing</span>(<span class="ruby-identifier">request</span>.<span class="ruby-identifier">params</span>[<span class="ruby-value str">&quot;REQUEST_URI&quot;</span>],<span class="ruby-identifier">req</span>, <span class="ruby-identifier">response</span>)
+478:           <span class="ruby-keyword kw">else</span>
+479:             <span class="ruby-identifier">send_file</span>(<span class="ruby-identifier">req</span>, <span class="ruby-identifier">response</span>)
+480:           <span class="ruby-keyword kw">end</span>
+481:         <span class="ruby-keyword kw">rescue</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">details</span>
+482:           <span class="ruby-identifier">response</span>.<span class="ruby-identifier">reset</span>
+483:           <span class="ruby-identifier">response</span>.<span class="ruby-identifier">start</span>(<span class="ruby-value">403</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">head</span>,<span class="ruby-identifier">out</span><span class="ruby-operator">|</span>
+484:             <span class="ruby-identifier">out</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">&quot;Error accessing file&quot;</span>
+485:           <span class="ruby-keyword kw">end</span>
+486:           <span class="ruby-constant">STDERR</span>.<span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;ERROR: #{details}&quot;</span>
+487:         <span class="ruby-keyword kw">end</span>
+488:       <span class="ruby-keyword kw">end</span>
+489:     <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/rdoc/classes/Mongrel/Error404Handler.html CHANGED

@@ -96,8 +96,8 @@ custom message for special URIs.
       <h3 class="section-bar">Methods</h3>
       <div class="name-list">
-      <a href="#M000023">new</a>&nbsp;&nbsp;
-      <a href="#M000024">process</a>&nbsp;&nbsp;
+      <a href="#M000028">new</a>&nbsp;&nbsp;
+      <a href="#M000029">process</a>&nbsp;&nbsp;
       </div>
     </div>
@@ -119,12 +119,12 @@ custom message for special URIs.
     <div id="methods">
       <h3 class="section-bar">Public Class methods</h3>
-      <div id="method-M000023" class="method-detail">
-        <a name="M000023"></a>
+      <div id="method-M000028" class="method-detail">
+        <a name="M000028"></a>
         <div class="method-heading">
-          <a href="Error404Handler.src/M000023.html" target="Code" class="method-signature"
-            onclick="popupCode('Error404Handler.src/M000023.html');return false;">
+          <a href="Error404Handler.src/M000028.html" target="Code" class="method-signature"
+            onclick="popupCode('Error404Handler.src/M000028.html');return false;">
           <span class="method-name">new</span><span class="method-args">(msg)</span>
           </a>
         </div>
@@ -139,12 +139,12 @@ it&#8217;s pretty efficient.
       <h3 class="section-bar">Public Instance methods</h3>
-      <div id="method-M000024" class="method-detail">
-        <a name="M000024"></a>
+      <div id="method-M000029" class="method-detail">
+        <a name="M000029"></a>
         <div class="method-heading">
-          <a href="Error404Handler.src/M000024.html" target="Code" class="method-signature"
-            onclick="popupCode('Error404Handler.src/M000024.html');return false;">
+          <a href="Error404Handler.src/M000029.html" target="Code" class="method-signature"
+            onclick="popupCode('Error404Handler.src/M000029.html');return false;">
           <span class="method-name">process</span><span class="method-args">(request, response)</span>
           </a>
         </div>

data/doc/rdoc/classes/Mongrel/Error404Handler.src/{M000023.html → M000028.html} RENAMED

@@ -10,9 +10,9 @@
   <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
 </head>
 <body class="standalone-code">
-  <pre>     <span class="ruby-comment cmt"># File lib/mongrel.rb, line 153</span>
-153:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">msg</span>)
-154:       <span class="ruby-ivar">@response</span> = <span class="ruby-constant">HttpServer</span><span class="ruby-operator">::</span><span class="ruby-constant">ERROR_404_RESPONSE</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">msg</span>
-155:     <span class="ruby-keyword kw">end</span></pre>
+  <pre>     <span class="ruby-comment cmt"># File lib/mongrel.rb, line 410</span>
+410:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">msg</span>)
+411:       <span class="ruby-ivar">@response</span> = <span class="ruby-constant">HttpServer</span><span class="ruby-operator">::</span><span class="ruby-constant">ERROR_404_RESPONSE</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">msg</span>
+412:     <span class="ruby-keyword kw">end</span></pre>
 </body>
 </html>

data/doc/rdoc/classes/Mongrel/Error404Handler.src/{M000024.html → M000029.html} RENAMED

@@ -10,9 +10,9 @@
   <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
 </head>
 <body class="standalone-code">
-  <pre>     <span class="ruby-comment cmt"># File lib/mongrel.rb, line 158</span>
-158:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">process</span>(<span class="ruby-identifier">request</span>, <span class="ruby-identifier">response</span>)
-159:       <span class="ruby-identifier">response</span>.<span class="ruby-identifier">socket</span>.<span class="ruby-identifier">write</span>(<span class="ruby-ivar">@response</span>)
-160:     <span class="ruby-keyword kw">end</span></pre>
+  <pre>     <span class="ruby-comment cmt"># File lib/mongrel.rb, line 415</span>
+415:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">process</span>(<span class="ruby-identifier">request</span>, <span class="ruby-identifier">response</span>)
+416:       <span class="ruby-identifier">response</span>.<span class="ruby-identifier">socket</span>.<span class="ruby-identifier">write</span>(<span class="ruby-ivar">@response</span>)
+417:     <span class="ruby-keyword kw">end</span></pre>
 </body>
 </html>

data/doc/rdoc/classes/Mongrel/HeaderOut.html CHANGED

@@ -78,6 +78,21 @@
   <div id="contextContent">
+    <div id="description">
+      <p>
+This class implements a simple way of constructing the HTTP headers
+dynamically via a Hash syntax. Think of it as a write-only Hash. Refer to
+<a href="HttpResponse.html">HttpResponse</a> for information on how this is
+used.
+</p>
+<p>
+One consequence of this write-only nature is that you can write multiple
+headers by just doing them twice (which is sometimes needed in HTTP), but
+that the normal semantics for Hash (where doing an insert replaces) is not
+there.
+</p>
+    </div>
    </div>
@@ -86,8 +101,8 @@
       <h3 class="section-bar">Methods</h3>
       <div class="name-list">
-      <a href="#M000014">[]=</a>&nbsp;&nbsp;
-      <a href="#M000013">new</a>&nbsp;&nbsp;
+      <a href="#M000018">[]=</a>&nbsp;&nbsp;
+      <a href="#M000017">new</a>&nbsp;&nbsp;
       </div>
     </div>
@@ -122,12 +137,12 @@
     <div id="methods">
       <h3 class="section-bar">Public Class methods</h3>
-      <div id="method-M000013" class="method-detail">
-        <a name="M000013"></a>
+      <div id="method-M000017" class="method-detail">
+        <a name="M000017"></a>
         <div class="method-heading">
-          <a href="HeaderOut.src/M000013.html" target="Code" class="method-signature"
-            onclick="popupCode('HeaderOut.src/M000013.html');return false;">
+          <a href="HeaderOut.src/M000017.html" target="Code" class="method-signature"
+            onclick="popupCode('HeaderOut.src/M000017.html');return false;">
           <span class="method-name">new</span><span class="method-args">(out)</span>
           </a>
         </div>
@@ -138,17 +153,20 @@
       <h3 class="section-bar">Public Instance methods</h3>
-      <div id="method-M000014" class="method-detail">
-        <a name="M000014"></a>
+      <div id="method-M000018" class="method-detail">
+        <a name="M000018"></a>
         <div class="method-heading">
-          <a href="HeaderOut.src/M000014.html" target="Code" class="method-signature"
-            onclick="popupCode('HeaderOut.src/M000014.html');return false;">
+          <a href="HeaderOut.src/M000018.html" target="Code" class="method-signature"
+            onclick="popupCode('HeaderOut.src/M000018.html');return false;">
           <span class="method-name">[]=</span><span class="method-args">(key,value)</span>
           </a>
         </div>
         <div class="method-description">
+          <p>
+Simply writes &quot;#{key}: #{value}&quot; to an output buffer.
+</p>
         </div>
       </div>

data/doc/rdoc/classes/Mongrel/HeaderOut.src/{M000013.html → M000017.html} RENAMED

@@ -10,9 +10,9 @@
   <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
 </head>
 <body class="standalone-code">
-  <pre>    <span class="ruby-comment cmt"># File lib/mongrel.rb, line 88</span>
-88:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">out</span>)
-89:       <span class="ruby-ivar">@out</span> = <span class="ruby-identifier">out</span>
-90:     <span class="ruby-keyword kw">end</span></pre>
+  <pre>     <span class="ruby-comment cmt"># File lib/mongrel.rb, line 169</span>
+169:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">out</span>)
+170:       <span class="ruby-ivar">@out</span> = <span class="ruby-identifier">out</span>
+171:     <span class="ruby-keyword kw">end</span></pre>
 </body>
 </html>

data/doc/rdoc/classes/Mongrel/HeaderOut.src/M000018.html ADDED

@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+  <title>[]= (Mongrel::HeaderOut)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre>     <span class="ruby-comment cmt"># File lib/mongrel.rb, line 174</span>
+174:     <span class="ruby-keyword kw">def</span><span class="ruby-operator">[]=</span>(<span class="ruby-identifier">key</span>,<span class="ruby-identifier">value</span>)
+175:       <span class="ruby-ivar">@out</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">key</span>)
+176:       <span class="ruby-ivar">@out</span>.<span class="ruby-identifier">write</span>(<span class="ruby-value str">&quot;: &quot;</span>)
+177:       <span class="ruby-ivar">@out</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">value</span>)
+178:       <span class="ruby-ivar">@out</span>.<span class="ruby-identifier">write</span>(<span class="ruby-value str">&quot;\r\n&quot;</span>)
+179:     <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/rdoc/classes/Mongrel/HttpHandler.html CHANGED

@@ -95,7 +95,7 @@ back a response. Look at the <a href="HttpRequest.html">HttpRequest</a> and
       <h3 class="section-bar">Methods</h3>
       <div class="name-list">
-      <a href="#M000019">process</a>&nbsp;&nbsp;
+      <a href="#M000023">process</a>&nbsp;&nbsp;
       </div>
     </div>
@@ -110,19 +110,6 @@ back a response. Look at the <a href="HttpRequest.html">HttpRequest</a> and
-    <div id="attribute-list">
-      <h3 class="section-bar">Attributes</h3>
-      <div class="name-list">
-        <table>
-        <tr class="top-aligned-row context-row">
-          <td class="context-item-name">script_name</td>
-          <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
-          <td class="context-item-desc"></td>
-        </tr>
-        </table>
-      </div>
-    </div>
@@ -130,12 +117,12 @@ back a response. Look at the <a href="HttpRequest.html">HttpRequest</a> and
     <div id="methods">
       <h3 class="section-bar">Public Instance methods</h3>
-      <div id="method-M000019" class="method-detail">
-        <a name="M000019"></a>
+      <div id="method-M000023" class="method-detail">
+        <a name="M000023"></a>
         <div class="method-heading">
-          <a href="HttpHandler.src/M000019.html" target="Code" class="method-signature"
-            onclick="popupCode('HttpHandler.src/M000019.html');return false;">
+          <a href="HttpHandler.src/M000023.html" target="Code" class="method-signature"
+            onclick="popupCode('HttpHandler.src/M000023.html');return false;">
           <span class="method-name">process</span><span class="method-args">(request, response)</span>
           </a>
         </div>

data/doc/rdoc/classes/Mongrel/HttpHandler.src/{M000019.html → M000023.html} RENAMED

@@ -10,8 +10,8 @@
   <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
 </head>
 <body class="standalone-code">
-  <pre>     <span class="ruby-comment cmt"># File lib/mongrel.rb, line 141</span>
-141:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">process</span>(<span class="ruby-identifier">request</span>, <span class="ruby-identifier">response</span>)
-142:     <span class="ruby-keyword kw">end</span></pre>
+  <pre>     <span class="ruby-comment cmt"># File lib/mongrel.rb, line 262</span>
+262:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">process</span>(<span class="ruby-identifier">request</span>, <span class="ruby-identifier">response</span>)
+263:     <span class="ruby-keyword kw">end</span></pre>
 </body>
 </html>

data/doc/rdoc/classes/Mongrel/HttpRequest.html CHANGED

@@ -88,9 +88,9 @@ HttpRequest.body which is a string containing the request body (raw for
 now).
 </p>
 <p>
-<a href="../Mongrel.html">Mongrel</a> really only support small-ish request
-bodies right now since really huge ones have to be completely read off the
-wire and put into a string. Later there will be several options for
+<a href="../Mongrel.html">Mongrel</a> really only supports small-ish
+request bodies right now since really huge ones have to be completely read
+off the wire and put into a string. Later there will be several options for
 efficiently handling large file uploads.
 </p>
@@ -103,7 +103,7 @@ efficiently handling large file uploads.
       <h3 class="section-bar">Methods</h3>
       <div class="name-list">
-      <a href="#M000025">new</a>&nbsp;&nbsp;
+      <a href="#M000030">new</a>&nbsp;&nbsp;
       </div>
     </div>
@@ -143,12 +143,12 @@ efficiently handling large file uploads.
     <div id="methods">
       <h3 class="section-bar">Public Class methods</h3>
-      <div id="method-M000025" class="method-detail">
-        <a name="M000025"></a>
+      <div id="method-M000030" class="method-detail">
+        <a name="M000030"></a>
         <div class="method-heading">
-          <a href="HttpRequest.src/M000025.html" target="Code" class="method-signature"
-            onclick="popupCode('HttpRequest.src/M000025.html');return false;">
+          <a href="HttpRequest.src/M000030.html" target="Code" class="method-signature"
+            onclick="popupCode('HttpRequest.src/M000030.html');return false;">
           <span class="method-name">new</span><span class="method-args">(params, initial_body, socket)</span>
           </a>
         </div>

data/doc/rdoc/classes/Mongrel/HttpRequest.src/M000030.html ADDED

@@ -0,0 +1,31 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+  <title>new (Mongrel::HttpRequest)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre>     <span class="ruby-comment cmt"># File lib/mongrel.rb, line 140</span>
+140:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">params</span>, <span class="ruby-identifier">initial_body</span>, <span class="ruby-identifier">socket</span>)
+141:       <span class="ruby-ivar">@body</span> = <span class="ruby-identifier">initial_body</span> <span class="ruby-operator">||</span> <span class="ruby-value str">&quot;&quot;</span>
+142:       <span class="ruby-ivar">@params</span> = <span class="ruby-identifier">params</span>
+143:       <span class="ruby-ivar">@socket</span> = <span class="ruby-identifier">socket</span>
+144:
+145:       <span class="ruby-comment cmt"># fix up the CGI requirements</span>
+146:       <span class="ruby-identifier">params</span>[<span class="ruby-constant">Const</span><span class="ruby-operator">::</span><span class="ruby-constant">CONTENT_LENGTH</span>] = <span class="ruby-identifier">params</span>[<span class="ruby-constant">Const</span><span class="ruby-operator">::</span><span class="ruby-constant">HTTP_CONTENT_LENGTH</span>] <span class="ruby-operator">||</span> <span class="ruby-value">0</span>
+147:       <span class="ruby-identifier">params</span>[<span class="ruby-constant">Const</span><span class="ruby-operator">::</span><span class="ruby-constant">CONTENT_TYPE</span>] <span class="ruby-operator">||=</span> <span class="ruby-identifier">params</span>[<span class="ruby-constant">Const</span><span class="ruby-operator">::</span><span class="ruby-constant">HTTP_CONTENT_TYPE</span>]
+148:
+149:       <span class="ruby-comment cmt"># now, if the initial_body isn't long enough for the content length we have to fill it</span>
+150:       <span class="ruby-comment cmt"># TODO: adapt for big ass stuff by writing to a temp file</span>
+151:       <span class="ruby-identifier">clen</span> = <span class="ruby-identifier">params</span>[<span class="ruby-constant">Const</span><span class="ruby-operator">::</span><span class="ruby-constant">HTTP_CONTENT_LENGTH</span>].<span class="ruby-identifier">to_i</span>
+152:       <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@body</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">&lt;</span> <span class="ruby-identifier">clen</span>
+153:         <span class="ruby-ivar">@body</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-ivar">@socket</span>.<span class="ruby-identifier">read</span>(<span class="ruby-identifier">clen</span> <span class="ruby-operator">-</span> <span class="ruby-ivar">@body</span>.<span class="ruby-identifier">length</span>)
+154:       <span class="ruby-keyword kw">end</span>
+155:     <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/rdoc/classes/Mongrel/HttpResponse.html CHANGED

@@ -78,6 +78,51 @@
   <div id="contextContent">
+    <div id="description">
+      <p>
+Writes and controls your response to the client using the HTTP/1.1
+specification. You use it by simply doing:
+</p>
+<pre>
+ response.start(200) do |head,out|
+   head['Content-Type'] = 'text/plain'
+   out.write(&quot;hello\n&quot;)
+ end
+</pre>
+<p>
+The parameter to start is the response code&#8212;which <a
+href="../Mongrel.html">Mongrel</a> will translate for you based on
+HTTP_STATUS_CODES. The head parameter is how you write custom headers. The
+out parameter is where you write your body. The default status code for <a
+href="HttpResponse.html#M000025">HttpResponse.start</a> is 200 so the above
+example is redundant.
+</p>
+<p>
+As you can see, it&#8217;s just like using a Hash and as you do this it
+writes the proper header to the output on the fly. You can even intermix
+specifying headers and writing content. The <a
+href="HttpResponse.html">HttpResponse</a> class with write the things in
+the proper order once the HttpResponse.block is ended.
+</p>
+<p>
+You may also work the <a href="HttpResponse.html">HttpResponse</a> object
+directly using the various attributes available for the raw socket, body,
+header, and status codes. If you do this you&#8217;re on your own. A design
+decision was made to force the client to not pipeline requests. HTTP/1.1
+pipelining really kills the performance due to how it has to be handled and
+how unclear the standard is. To fix this the <a
+href="HttpResponse.html">HttpResponse</a> gives a &quot;Connection:
+close&quot; header which forces the client to close right away. The bonus
+for this is that it gives a pretty nice speed boost to most clients since
+they can close their connection immediately.
+</p>
+<p>
+One additional caveat is that you don&#8217;t have to specify the
+Content-length header as the <a href="HttpResponse.html">HttpResponse</a>
+will write this for you based on the out length.
+</p>
+    </div>
    </div>
@@ -86,9 +131,10 @@
       <h3 class="section-bar">Methods</h3>
       <div class="name-list">
-      <a href="#M000022">finished</a>&nbsp;&nbsp;
-      <a href="#M000020">new</a>&nbsp;&nbsp;
-      <a href="#M000021">start</a>&nbsp;&nbsp;
+      <a href="#M000027">finished</a>&nbsp;&nbsp;
+      <a href="#M000024">new</a>&nbsp;&nbsp;
+      <a href="#M000026">reset</a>&nbsp;&nbsp;
+      <a href="#M000025">start</a>&nbsp;&nbsp;
       </div>
     </div>
@@ -143,12 +189,12 @@
     <div id="methods">
       <h3 class="section-bar">Public Class methods</h3>
-      <div id="method-M000020" class="method-detail">
-        <a name="M000020"></a>
+      <div id="method-M000024" class="method-detail">
+        <a name="M000024"></a>
         <div class="method-heading">
-          <a href="HttpResponse.src/M000020.html" target="Code" class="method-signature"
-            onclick="popupCode('HttpResponse.src/M000020.html');return false;">
+          <a href="HttpResponse.src/M000024.html" target="Code" class="method-signature"
+            onclick="popupCode('HttpResponse.src/M000024.html');return false;">
           <span class="method-name">new</span><span class="method-args">(socket)</span>
           </a>
         </div>
@@ -159,31 +205,59 @@
       <h3 class="section-bar">Public Instance methods</h3>
-      <div id="method-M000022" class="method-detail">
-        <a name="M000022"></a>
+      <div id="method-M000027" class="method-detail">
+        <a name="M000027"></a>
         <div class="method-heading">
-          <a href="HttpResponse.src/M000022.html" target="Code" class="method-signature"
-            onclick="popupCode('HttpResponse.src/M000022.html');return false;">
+          <a href="HttpResponse.src/M000027.html" target="Code" class="method-signature"
+            onclick="popupCode('HttpResponse.src/M000027.html');return false;">
           <span class="method-name">finished</span><span class="method-args">()</span>
           </a>
         </div>
         <div class="method-description">
+          <p>
+This takes whatever has been done to header and body and then writes it in
+the proper format to make an HTTP/1.1 response.
+</p>
+        </div>
+      </div>
+      <div id="method-M000026" class="method-detail">
+        <a name="M000026"></a>
+        <div class="method-heading">
+          <a href="HttpResponse.src/M000026.html" target="Code" class="method-signature"
+            onclick="popupCode('HttpResponse.src/M000026.html');return false;">
+          <span class="method-name">reset</span><span class="method-args">()</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Primarily used in exception handling to reset the response output in order
+to write an alternative response.
+</p>
         </div>
       </div>
-      <div id="method-M000021" class="method-detail">
-        <a name="M000021"></a>
+      <div id="method-M000025" class="method-detail">
+        <a name="M000025"></a>
         <div class="method-heading">
-          <a href="HttpResponse.src/M000021.html" target="Code" class="method-signature"
-            onclick="popupCode('HttpResponse.src/M000021.html');return false;">
+          <a href="HttpResponse.src/M000025.html" target="Code" class="method-signature"
+            onclick="popupCode('HttpResponse.src/M000025.html');return false;">
           <span class="method-name">start</span><span class="method-args">(status=200) {|@header, @body| ...}</span>
           </a>
         </div>
         <div class="method-description">
+          <p>
+Receives a block passing it the header and body for you to work with. When
+the block is finished it writes everything you&#8217;ve done to the socket
+in the proper order. This lets you intermix header and body content as
+needed.
+</p>
         </div>
       </div>