1 files changed, 12 insertions, 2 deletions

diff --git a/doc/url.html b/doc/url.html
index cd699a2..1dbee52 100644
--- a/doc/url.html
+++ b/doc/url.html
@@ -36,13 +36,22 @@
 <h2 id=url>URL</h2> 
 
 <p>
-The  module  <tt>url.lua</tt>  provides  functions  to  parse,  protect,
+The  <tt>url</tt>  namespace provides  functions  to  parse,  protect,
 and build URLs, as well  as functions to compose  absolute URLs
 from base and relative URLs, according to 
 <a href="http://www.cs.princeton.edu/~diego/rfc/rfc2396.txt">RFC
 2396</a>.
 </p>
 
+<p> 
+To obtain the <tt>url</tt> namespace, run:
+</p>
+
+<pre class=example>
+-- loads the URL module 
+local url = require("url")
+</pre>
+
 <p>
 An URL is defined by the following grammar:
 </p>
@@ -67,7 +76,8 @@ Builds an absolute URL from a base URL and a relative URL.
 </p>
 
 <p class=parameters>
-<tt>Base</tt> is a string with the base URL and <tt>relative</tt> is a
+<tt>Base</tt> is a string with the base URL or
+a parsed URL table.  <tt>Relative</tt> is a
 string with the relative URL.
 </p>