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

mongrel 0.2.1 → 0.2.2

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>