6 files changed, 36 insertions, 8 deletions

diff --git a/doc/http.html b/doc/http.html
index 9f3f087..cd41c0d 100644
--- a/doc/http.html
+++ b/doc/http.html
@@ -95,8 +95,9 @@ headers = {<br>
 </blockquote>
 
 <p>
-Field names are case insensitive (as  specified by the standard) and all
-functions  work with  lowercase field names.  
+Field names are case insensitive (as specified by the standard) and all
+functions work with lowercase field names (but see
+<a href=socket.html#headers.canonic><tt>socket.headers.canonic</tt></a>).
 Field values are left unmodified.
 </p>
 
@@ -117,6 +118,7 @@ the HTTP module:
 <li> <tt>USERAGENT</tt>: default user agent reported to server.
 </ul>
 
+
 <!-- http.request ++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
 
 <p class=name id="request">
diff --git a/doc/index.html b/doc/index.html
index 9da0f3c..833c9a8 100644
--- a/doc/index.html
+++ b/doc/index.html
@@ -87,7 +87,7 @@ Author: <A href="http://www.impa.br/~diego">Diego Nehab</a>
 <h2 id=download>Download</h2>
 
 <p>
-LuaSocket version 2.1.1-rc1 is now available for download! 
+LuaSocket version 2.1-rc1 is now available for download! 
 It is compatible with  Lua&nbsp;5.1 and 5.2, and has    
 been tested on Windows&nbsp;XP, Linux, and Mac OS X. Chances
 are it works well on most UNIX distributions and Windows flavors.
@@ -125,7 +125,7 @@ has helped bring this library back to life.
 <h2 id=new>What's New</h2>
 
 <p>
-Main changes for LuaSocket&nbsp;2.1.1-rc1 are IPv6 support
+Main changes for LuaSocket&nbsp;2.1-rc1 are IPv6 support
 and Lua&nbsp;5.2 compatibility. 
 </p>
 
@@ -135,6 +135,7 @@ and Lua&nbsp;5.2 compatibility.
 <ul>
 <li> <tt>Socket.connect</tt> and <tt>socket.bind</tt> support IPv6 addresses;
 <li> <tt>Getpeername</tt> and <tt>getsockname</tt> support IPv6 addresses;
+<li> URL module updated to support IPv6 host names;
 <li> New <tt>socket.tcp6</tt> and <tt>socket.udp6</tt> functions;
 <li> New <tt>socket.dns.getaddrinfo</tt> function;
 </ul>
diff --git a/doc/installation.html b/doc/installation.html
index 00b2db0..37c309b 100644
--- a/doc/installation.html
+++ b/doc/installation.html
@@ -39,7 +39,7 @@ Installation">
 
 <h2>Installation</h2>
 
-<p> LuaSocket 2.1.1-rc still uses Lua&nbsp;5.1's package
+<p> LuaSocket 2.1-rc still uses Lua&nbsp;5.1's package
 system. Users that have already made the switch to
 Lua&nbsp;5.2 should leave the default
 <tt>LUA_COMPAT_MODULE</tt> defined when compiling their Lua
@@ -95,7 +95,7 @@ it should be easy to use LuaSocket. Just fire the interpreter and use the
 Lua 5.1.5  Copyright (C) 1994-2012 Lua.org, PUC-Rio
 &gt; socket = require("socket")
 &gt; print(socket._VERSION)
---&gt; LuaSocket 2.1.1-rc1
+--&gt; LuaSocket 2.1-rc1
 </pre>
 
 <p> Each module loads their dependencies automatically, so you only need to
diff --git a/doc/reference.html b/doc/reference.html
index d1043d4..f069d47 100644
--- a/doc/reference.html
+++ b/doc/reference.html
@@ -148,6 +148,7 @@ Support, Manual">
 <a href="socket.html#debug">_DEBUG</a>,
 <a href="dns.html#dns">dns</a>,
 <a href="socket.html#gettime">gettime</a>,
+<a href="socket.html#headers.canonic">headers.canonic</a>,
 <a href="socket.html#newtry">newtry</a>,
 <a href="socket.html#protect">protect</a>,
 <a href="socket.html#select">select</a>,
diff --git a/doc/smtp.html b/doc/smtp.html
index 2ef673a..bbbff80 100644
--- a/doc/smtp.html
+++ b/doc/smtp.html
@@ -90,8 +90,9 @@ headers = {<br>
 </blockquote>
 
 <p>
-Field names are case insensitive (as  specified by the standard) and all
-functions  work with  lowercase field names.  
+Field names are case insensitive (as specified by the standard) and all
+functions work with lowercase field names (but see
+<a href=socket.html#headers.canonic><tt>socket.headers.canonic</tt></a>).
 Field values are left unmodified.
 </p>
 
diff --git a/doc/socket.html b/doc/socket.html
index 2267b4a..dcf8b61 100644
--- a/doc/socket.html
+++ b/doc/socket.html
@@ -112,6 +112,29 @@ t = socket.gettime()
 print(socket.gettime() - t .. " seconds elapsed")
 </pre>
 
+<!-- socket.headers ++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
+
+<p class=name id="headers.canonic">
+socket.headers.<b>canonic</b></p>
+
+<p> The <tt>socket.headers.canonic</tt> table 
+is used by the HTTP and SMTP modules to translate from 
+lowercase field names back into their canonic 
+capitalization. When a lowercase field name exists as a key
+in this table, the associated value is substituted in
+whenever the field name is sent out.
+</p>
+
+<p> 
+You can obtain the <tt>headers</tt> namespace if case run-time
+modifications are required by running:
+</p>
+
+<pre class=example>
+-- loads the headers module 
+local headers = require("headers")
+</pre>
+
 <!-- newtry +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
 
 <p class=name id=newtry>