RubyGems - mongrel - Versions diffs - 0.3.12.4 → 0.3.13 - Mend

mongrel 0.3.12.4 → 0.3.13

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 (264) hide show

data/doc/rdoc/classes/Mongrel/Command/Registry.src/M000039.html CHANGED

@@ -5,16 +5,46 @@
 <html>
 <head>
-  <title>commands (Mongrel::Command::Registry)</title>
+  <title>run (Mongrel::Command::Registry)</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/command.rb, line 116</span>
-116:       <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">commands</span>
-117:         <span class="ruby-identifier">pmgr</span> = <span class="ruby-constant">GemPlugin</span><span class="ruby-operator">::</span><span class="ruby-constant">Manager</span>.<span class="ruby-identifier">instance</span>
-118:         <span class="ruby-identifier">list</span> = <span class="ruby-identifier">pmgr</span>.<span class="ruby-identifier">plugins</span>[<span class="ruby-value str">&quot;/commands&quot;</span>].<span class="ruby-identifier">keys</span>
-119:         <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">list</span>.<span class="ruby-identifier">sort</span>
-120:       <span class="ruby-keyword kw">end</span></pre>
+  <pre>     <span class="ruby-comment cmt"># File lib/mongrel/command.rb, line 182</span>
+182:       <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">run</span>(<span class="ruby-identifier">args</span>)
+183:         <span class="ruby-comment cmt"># find the command</span>
+184:         <span class="ruby-identifier">cmd_name</span> = <span class="ruby-identifier">args</span>.<span class="ruby-identifier">shift</span>
+185:
+186:         <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">cmd_name</span> <span class="ruby-keyword kw">or</span> <span class="ruby-identifier">cmd_name</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;?&quot;</span> <span class="ruby-keyword kw">or</span> <span class="ruby-identifier">cmd_name</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;help&quot;</span>
+187:           <span class="ruby-identifier">print_command_list</span>
+188:           <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">true</span>
+189:         <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">cmd_name</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;--version&quot;</span>
+190:           <span class="ruby-constant">STDERR</span>.<span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;Mongrel Web Server #{Mongrel::Const::MONGREL_VERSION}&quot;</span>
+191:           <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">true</span>
+192:         <span class="ruby-keyword kw">end</span>
+193:
+194:         <span class="ruby-comment cmt"># command exists, set it up and validate it</span>
+195:         <span class="ruby-keyword kw">begin</span>
+196:           <span class="ruby-identifier">command</span> = <span class="ruby-constant">GemPlugin</span><span class="ruby-operator">::</span><span class="ruby-constant">Manager</span>.<span class="ruby-identifier">instance</span>.<span class="ruby-identifier">create</span>(<span class="ruby-node">&quot;/commands/#{cmd_name}&quot;</span>, <span class="ruby-identifier">:argv</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">args</span>)
+197:         <span class="ruby-keyword kw">rescue</span>
+198:           <span class="ruby-constant">STDERR</span>.<span class="ruby-identifier">puts</span> <span class="ruby-value str">&quot;INVALID COMMAND: #$!&quot;</span>
+199:           <span class="ruby-identifier">print_command_list</span>
+200:           <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">false</span>
+201:         <span class="ruby-keyword kw">end</span>
+202:
+203:         <span class="ruby-comment cmt"># Normally the command is NOT valid right after being created</span>
+204:         <span class="ruby-comment cmt"># but sometimes (like with -h or -v) there's no further processing</span>
+205:         <span class="ruby-comment cmt"># needed so the command is already valid so we can skip it.</span>
+206:         <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">not</span> <span class="ruby-identifier">command</span>.<span class="ruby-identifier">done_validating</span>
+207:           <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">not</span> <span class="ruby-identifier">command</span>.<span class="ruby-identifier">validate</span>
+208:             <span class="ruby-constant">STDERR</span>.<span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;#{cmd_name} reported an error. Use mongrel_rails #{cmd_name} -h to get help.&quot;</span>
+209:             <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">false</span>
+210:           <span class="ruby-keyword kw">else</span>
+211:             <span class="ruby-identifier">command</span>.<span class="ruby-identifier">run</span>
+212:           <span class="ruby-keyword kw">end</span>
+213:         <span class="ruby-keyword kw">end</span>
+214:
+215:         <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">true</span>
+216:       <span class="ruby-keyword kw">end</span></pre>
 </body>
 </html>

data/doc/rdoc/classes/Mongrel/Configurator.html ADDED

@@ -0,0 +1,651 @@
+<?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 xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>Class: Mongrel::Configurator</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <meta http-equiv="Content-Script-Type" content="text/javascript" />
+  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
+  <script type="text/javascript">
+  // <![CDATA[
+  function popupCode( url ) {
+    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
+  }
+  function toggleCode( id ) {
+    if ( document.getElementById )
+      elem = document.getElementById( id );
+    else if ( document.all )
+      elem = eval( "document.all." + id );
+    else
+      return false;
+    elemStyle = elem.style;
+    if ( elemStyle.display != "block" ) {
+      elemStyle.display = "block"
+    } else {
+      elemStyle.display = "none"
+    }
+    return true;
+  }
+  // Make codeblocks hidden by default
+  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
+  // ]]>
+  </script>
+</head>
+<body>
+    <div id="classHeader">
+        <table class="header-table">
+        <tr class="top-aligned-row">
+          <td><strong>Class</strong></td>
+          <td class="class-name-in-header">Mongrel::Configurator</td>
+        </tr>
+        <tr class="top-aligned-row">
+            <td><strong>In:</strong></td>
+            <td>
+                <a href="../../files/lib/mongrel_rb.html">
+                lib/mongrel.rb
+                </a>
+        <br />
+            </td>
+        </tr>
+        <tr class="top-aligned-row">
+            <td><strong>Parent:</strong></td>
+            <td>
+                Object
+            </td>
+        </tr>
+        </table>
+    </div>
+  <!-- banner header -->
+  <div id="bodyContent">
+  <div id="contextContent">
+    <div id="description">
+      <p>
+Implements a simple DSL for configuring a <a
+href="../Mongrel.html">Mongrel</a> server for your purposes. More used by
+framework implementers to setup <a href="../Mongrel.html">Mongrel</a> how
+they like, but could be used by regular folks to add more things to an
+existing mongrel configuration.
+</p>
+<p>
+It is used like this:
+</p>
+<pre>
+  require 'mongrel'
+  config = Mongrel::Configurator.new :host =&gt; &quot;127.0.0.1&quot; do
+    listener :port =&gt; 3000 do
+      uri &quot;/app&quot;, :handler =&gt; Mongrel::DirHandler.new(&quot;.&quot;, load_mime_map(&quot;mime.yaml&quot;))
+    end
+    run
+  end
+</pre>
+<p>
+This will setup a simple <a href="DirHandler.html">DirHandler</a> at the
+current directory and load additional mime types from mimy.yaml. The :host
+=&gt; &quot;127.0.0.1&quot; is actually not specific to the servers but
+just a hash of default parameters that all server or uri calls receive.
+</p>
+<p>
+When you are inside the block after <a
+href="Configurator.html#M000105">Mongrel::Configurator.new</a> you can
+simply call functions that are part of <a
+href="Configurator.html">Configurator</a> (like server, uri, daemonize,
+etc) without having to refer to anything else. You can also call these
+functions on the resulting object directly for additional configuration.
+</p>
+<p>
+A major thing about <a href="Configurator.html">Configurator</a> is that it
+actually lets you configure multiple listeners for any hosts and ports you
+want. These are kept in a map config.listeners so you can get to them.
+</p>
+<ul>
+<li>:pid_file =&gt; Where to write the process ID.
+</li>
+</ul>
+    </div>
+   </div>
+    <div id="method-list">
+      <h3 class="section-bar">Methods</h3>
+      <div class="name-list">
+      <a href="#M000106">change_privilege</a>&nbsp;&nbsp;
+      <a href="#M000109">cloaker</a>&nbsp;&nbsp;
+      <a href="#M000108">cloaking_class</a>&nbsp;&nbsp;
+      <a href="#M000113">daemonize</a>&nbsp;&nbsp;
+      <a href="#M000121">debug</a>&nbsp;&nbsp;
+      <a href="#M000120">join</a>&nbsp;&nbsp;
+      <a href="#M000111">listener</a>&nbsp;&nbsp;
+      <a href="#M000116">load_mime_map</a>&nbsp;&nbsp;
+      <a href="#M000114">load_plugins</a>&nbsp;&nbsp;
+      <a href="#M000115">load_yaml</a>&nbsp;&nbsp;
+      <a href="#M000124">log</a>&nbsp;&nbsp;
+      <a href="#M000105">new</a>&nbsp;&nbsp;
+      <a href="#M000117">plugin</a>&nbsp;&nbsp;
+      <a href="#M000110">resolve_defaults</a>&nbsp;&nbsp;
+      <a href="#M000118">run</a>&nbsp;&nbsp;
+      <a href="#M000122">run_config</a>&nbsp;&nbsp;
+      <a href="#M000123">setup_signals</a>&nbsp;&nbsp;
+      <a href="#M000119">stop</a>&nbsp;&nbsp;
+      <a href="#M000112">uri</a>&nbsp;&nbsp;
+      <a href="#M000107">write_pid_file</a>&nbsp;&nbsp;
+      </div>
+    </div>
+  </div>
+    <!-- if includes -->
+    <div id="section">
+    <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">defaults</td>
+          <td class="context-item-value">&nbsp;[R]&nbsp;</td>
+          <td class="context-item-desc"></td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">listeners</td>
+          <td class="context-item-value">&nbsp;[R]&nbsp;</td>
+          <td class="context-item-desc"></td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">needs_restart</td>
+          <td class="context-item-value">&nbsp;[R]&nbsp;</td>
+          <td class="context-item-desc"></td>
+        </tr>
+        </table>
+      </div>
+    </div>
+    <!-- if method_list -->
+    <div id="methods">
+      <h3 class="section-bar">Public Class methods</h3>
+      <div id="method-M000105" class="method-detail">
+        <a name="M000105"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000105.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000105.html');return false;">
+          <span class="method-name">new</span><span class="method-args">(defaults={}, &amp;blk)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+You pass in initial defaults and then a block to continue configuring.
+</p>
+        </div>
+      </div>
+      <h3 class="section-bar">Public Instance methods</h3>
+      <div id="method-M000106" class="method-detail">
+        <a name="M000106"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000106.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000106.html');return false;">
+          <span class="method-name">change_privilege</span><span class="method-args">(user, group)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Change privilege of the process to specified user and group.
+</p>
+        </div>
+      </div>
+      <div id="method-M000109" class="method-detail">
+        <a name="M000109"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000109.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000109.html');return false;">
+          <span class="method-name">cloaker</span><span class="method-args">(&amp;blk)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Do not call this. You were warned.
+</p>
+        </div>
+      </div>
+      <div id="method-M000108" class="method-detail">
+        <a name="M000108"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000108.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000108.html');return false;">
+          <span class="method-name">cloaking_class</span><span class="method-args">()</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+generates a class for cloaking the current self and making the DSL nicer
+</p>
+        </div>
+      </div>
+      <div id="method-M000113" class="method-detail">
+        <a name="M000113"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000113.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000113.html');return false;">
+          <span class="method-name">daemonize</span><span class="method-args">(options={})</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Daemonizes the current Ruby script turning all the listeners into an actual
+&quot;server&quot; or detached process. You must call this <b>before</b>
+frameworks that open files as otherwise the files will be closed by this
+function.
+</p>
+<p>
+Does not work for Win32 systems (the call is silently ignored).
+</p>
+<p>
+Requires the following options or defaults:
+</p>
+<ul>
+<li>:cwd =&gt; Directory to change to.
+</li>
+<li>:log_file =&gt; Where to write STDOUT and STDERR.
+</li>
+</ul>
+<p>
+It is safe to call this on win32 as it will only require the daemons
+gem/library if NOT win32.
+</p>
+        </div>
+      </div>
+      <div id="method-M000121" class="method-detail">
+        <a name="M000121"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000121.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000121.html');return false;">
+          <span class="method-name">debug</span><span class="method-args">(location, what = [:object, :rails, :files, :threads, :params])</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Calling this before you register your URIs to the given location will setup
+a set of handlers that log open files, objects, and the parameters for each
+request. This helps you track common problems found in <a
+href="Rails.html">Rails</a> applications that are either slow or become
+unresponsive after a little while.
+</p>
+<p>
+TODO: Document the optional selections from the what parameter
+</p>
+        </div>
+      </div>
+      <div id="method-M000120" class="method-detail">
+        <a name="M000120"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000120.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000120.html');return false;">
+          <span class="method-name">join</span><span class="method-args">()</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+This method should actually be called <b>outside</b> of the <a
+href="Configurator.html">Configurator</a> block so that you can control it.
+In otherwords do it like: config.join.
+</p>
+        </div>
+      </div>
+      <div id="method-M000111" class="method-detail">
+        <a name="M000111"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000111.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000111.html');return false;">
+          <span class="method-name">listener</span><span class="method-args">(options={},&amp;blk)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Starts a listener block. This is the only one that actually takes a block
+and then you make <a href="Configurator.html#M000112">Configurator.uri</a>
+calls in order to setup your URIs and handlers. If you write your Handlers
+as GemPlugins then you can use <a
+href="Configurator.html#M000114">load_plugins</a> and plugin to load them.
+</p>
+<p>
+It expects the following options (or defaults):
+</p>
+<ul>
+<li>:host =&gt; Host name to bind.
+</li>
+<li>:port =&gt; Port to bind.
+</li>
+<li>:num_processors =&gt; The maximum number of concurrent threads allowed.
+(950 default)
+</li>
+<li>:timeout =&gt; 1/100th of a second timeout between requests. (10 is 1/10th,
+0 is timeout)
+</li>
+</ul>
+        </div>
+      </div>
+      <div id="method-M000116" class="method-detail">
+        <a name="M000116"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000116.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000116.html');return false;">
+          <span class="method-name">load_mime_map</span><span class="method-args">(file, mime={})</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Loads the MIME map file and checks that it is correct on loading. This is
+commonly passed to <a href="DirHandler.html">Mongrel::DirHandler</a> or any
+framework handler that uses <a href="DirHandler.html">DirHandler</a> to
+serve files. You can also include a set of default MIME types as additional
+settings. See <a href="DirHandler.html">Mongrel::DirHandler</a> for how the
+MIME types map is organized.
+</p>
+        </div>
+      </div>
+      <div id="method-M000114" class="method-detail">
+        <a name="M000114"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000114.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000114.html');return false;">
+          <span class="method-name">load_plugins</span><span class="method-args">(options={})</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Uses the GemPlugin system to easily load plugins based on their gem
+dependencies. You pass in either an :includes =&gt; [] or :excludes =&gt;
+[] setting listing the names of plugins to include or exclude from the when
+determining the dependencies.
+</p>
+        </div>
+      </div>
+      <div id="method-M000115" class="method-detail">
+        <a name="M000115"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000115.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000115.html');return false;">
+          <span class="method-name">load_yaml</span><span class="method-args">(file, default={})</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Easy way to load a YAML file and apply default settings.
+</p>
+        </div>
+      </div>
+      <div id="method-M000124" class="method-detail">
+        <a name="M000124"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000124.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000124.html');return false;">
+          <span class="method-name">log</span><span class="method-args">(msg)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Logs a simple message to STDERR (or the mongrel log if in daemon mode).
+</p>
+        </div>
+      </div>
+      <div id="method-M000117" class="method-detail">
+        <a name="M000117"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000117.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000117.html');return false;">
+          <span class="method-name">plugin</span><span class="method-args">(name, options={})</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Loads and creates a plugin for you based on the given name and configured
+with the selected options. The options are merged with the defaults prior
+to passing them in.
+</p>
+        </div>
+      </div>
+      <div id="method-M000110" class="method-detail">
+        <a name="M000110"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000110.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000110.html');return false;">
+          <span class="method-name">resolve_defaults</span><span class="method-args">(options)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+This will resolve the given options against the defaults. Normally just
+used internally.
+</p>
+        </div>
+      </div>
+      <div id="method-M000118" class="method-detail">
+        <a name="M000118"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000118.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000118.html');return false;">
+          <span class="method-name">run</span><span class="method-args">()</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Works like a meta run method which goes through all the configured
+listeners. Use the <a
+href="Configurator.html#M000120">Configurator.join</a> method to prevent
+Ruby from exiting until each one is done.
+</p>
+        </div>
+      </div>
+      <div id="method-M000122" class="method-detail">
+        <a name="M000122"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000122.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000122.html');return false;">
+          <span class="method-name">run_config</span><span class="method-args">(script)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Used to allow you to let users specify their own configurations inside your
+<a href="Configurator.html">Configurator</a> setup. You pass it a script
+name and it reads it in and does an eval on the contents passing in the
+right binding so they can put their own <a
+href="Configurator.html">Configurator</a> statements.
+</p>
+        </div>
+      </div>
+      <div id="method-M000123" class="method-detail">
+        <a name="M000123"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000123.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000123.html');return false;">
+          <span class="method-name">setup_signals</span><span class="method-args">(options={})</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Sets up the standard signal handlers that are used on most Ruby It only
+configures if the platform is not win32 and doesn&#8217;t do a HUP signal
+since this is typically framework specific.
+</p>
+<p>
+Requires a :pid_file option given to <a
+href="Configurator.html#M000105">Configurator.new</a> to indicate a file to
+delete. It sets the MongrelConfig.needs_restart attribute if the start
+command should reload. It&#8217;s up to you to detect this and do whatever
+is needed for a &quot;restart&quot;.
+</p>
+<p>
+This command is safely ignored if the platform is win32 (with a warning)
+</p>
+        </div>
+      </div>
+      <div id="method-M000119" class="method-detail">
+        <a name="M000119"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000119.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000119.html');return false;">
+          <span class="method-name">stop</span><span class="method-args">(needs_restart=false, unlink_pid_file=true)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Calls .stop on all the configured listeners so they stop processing
+requests (gracefully). By default it assumes that you don&#8217;t want to
+restart and that the pid file should be unlinked on exit.
+</p>
+        </div>
+      </div>
+      <div id="method-M000112" class="method-detail">
+        <a name="M000112"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000112.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000112.html');return false;">
+          <span class="method-name">uri</span><span class="method-args">(location, options={})</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Called inside a <a
+href="Configurator.html#M000111">Configurator.listener</a> block in order
+to add URI-&gt;handler mappings for that listener. Use this as many times
+as you like. It expects the following options or defaults:
+</p>
+<ul>
+<li>:handler =&gt; <a href="HttpHandler.html">HttpHandler</a> &#8212; Handler
+to use for this location.
+</li>
+<li>:in_front =&gt; true/false &#8212; Rather than appending, it prepends this
+handler.
+</li>
+</ul>
+        </div>
+      </div>
+      <div id="method-M000107" class="method-detail">
+        <a name="M000107"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000107.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000107.html');return false;">
+          <span class="method-name">write_pid_file</span><span class="method-args">()</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Writes the PID file but only if we&#8217;re on windows.
+</p>
+        </div>
+      </div>
+    </div>
+  </div>
+<div id="validator-badges">
+  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
+</div>
+</body>
+</html>