Updated manual timestamps and the added stuffing filters to mime.html.

14 files changed, 61 insertions, 39 deletions

diff --git a/doc/dns.html b/doc/dns.html
index fa4c230..67b24ca 100644
--- a/doc/dns.html
+++ b/doc/dns.html
@@ -118,7 +118,7 @@ message.
 <p>
 <small>
 Last modified by Diego Nehab on <br>
-Sat Aug 9 01:00:41 PDT 2003
+Thu Jun 17 02:46:57 EDT 2004
 </small>
 </p>
 </center>
diff --git a/doc/ftp.html b/doc/ftp.html
index 7ad5e4d..14a3601 100644
--- a/doc/ftp.html
+++ b/doc/ftp.html
@@ -267,7 +267,7 @@ f, e = ftp.put{
 <p>
 <small>
 Last modified by Diego Nehab on <br>
-Sat Aug 9 01:00:41 PDT 2003
+Thu Jun 17 02:47:04 EDT 2004
 </small>
 </p>
 </center>
diff --git a/doc/http.html b/doc/http.html
index 9125df7..a98915c 100644
--- a/doc/http.html
+++ b/doc/http.html
@@ -303,7 +303,7 @@ r, c = http.request {
 <p>
 <small>
 Last modified by Diego Nehab on <br>
-Sat Aug 9 01:00:41 PDT 2003
+Thu Jun 17 02:47:21 EDT 2004
 </small>
 </p>
 </center>
diff --git a/doc/index.html b/doc/index.html
index f6d37ac..b96385e 100644
--- a/doc/index.html
+++ b/doc/index.html
@@ -284,7 +284,7 @@ those that have compatibility issues.
 <p>
 <small>
 Last modified by Diego Nehab on <br>
-Sun Aug 10 01:36:26 PDT 2003
+Thu Jun 17 02:47:14 EDT 2004
 </small>
 </p>
 </center>
diff --git a/doc/introduction.html b/doc/introduction.html
index 63a7d84..8706c83 100644
--- a/doc/introduction.html
+++ b/doc/introduction.html
@@ -330,7 +330,7 @@ io.write(socket.try((udp:receive())))
 <p>
 <small>
 Last modified by Diego Nehab on <br>
-Sat Aug 9 01:00:41 PDT 2003
+Thu Jun 17 02:47:21 EDT 2004
 </small>
 </p>
 </center>
diff --git a/doc/ltn12.html b/doc/ltn12.html
index 9029b9c..23b9ff8 100644
--- a/doc/ltn12.html
+++ b/doc/ltn12.html
@@ -415,7 +415,7 @@ Creates and returns a source that produces the contents of a
 <p>
 <small>
 Last modified by Diego Nehab on <br>
-Sat Aug 9 01:00:41 PDT 2003
+Thu Jun 17 02:47:21 EDT 2004
 </small>
 </p>
 </center>
diff --git a/doc/mime.html b/doc/mime.html
index fe15df3..520c8ff 100644
--- a/doc/mime.html
+++ b/doc/mime.html
@@ -156,6 +156,22 @@ base64 = ltn12.filter.chain(
 )
 </pre>
 
+<!-- stuff +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
+
+<p class=name id="stuff">
+mime.<b>stuff()</b><br>
+</p>
+
+<p class=description>
+Creates and returns a filter that performs stuffing of SMTP messages.
+</p>
+
+<p class=note>
+Note: The <a href=smtp.html#send><tt>smtp.send</tt></a> function 
+uses this filter automatically. You don't need to chain it with your
+source, or apply it to your message body.  
+</p>
+
 <!-- wrap +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
 
 <p class=name id="wrap">
@@ -232,33 +248,36 @@ print((mime.b64("diego:password")))
 
 <!-- dot +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
 <p class=name id="dot">
-A, B = mime.<b>dot(</b>C [, D]<b>)</b>
+A, n = mime.<b>dot(</b>m [, B]<b>)</b>
 </p>
 
 <p class=description>
-Low-level filter to perform Base64 encoding. 
+Low-level filter to perform SMTP stuffing and enable transmission of
+messages containing the sequence "CRLF.CRLF". 
 </p>
 
-<p class=description>
-<tt>A</tt> is the encoded version of the largest prefix of 
-<tt>C..D</tt> 
-that can be encoded unambiguously. <tt>B</tt> has the remaining bytes of 
-<tt>C..D</tt>, <em>before</em> encoding. 
-If <tt>D</tt> is <tt><b>nil</b></tt>, <tt>A</tt> is padded with 
-the encoding of the remaining bytes of <tt>C</tt>. 
+<p class=parameters>
+<tt>A</tt> is the stuffed version of <tt>B</tt>. '<tt>n</tt>' gives the
+number of characters from the sequence CRLF seen in the end of <tt>B</tt>.
+'<tt>m</tt>' should tell the same, but for the previous chunk.
 </p>
 
-<p class=note>
-Note: The simplest use of this function is to encode a string into it's
-Base64 transfer content encoding. Notice the extra parenthesis around the
-call to <tt>mime.b64</tt>, to discard the second return value.
+<p class=note>Note: The message body is defined to begin with 
+an implicit CRLF. Therefore, to stuff a message correctly, the
+first <tt>m</tt> should have the value 2. 
 </p>
 
 <pre class=example>
-print((mime.b64("diego:password")))
---&gt; ZGllZ286cGFzc3dvcmQ=
+print((string.gsub(mime.dot(2, ".\r\nStuffing the message.\r\n.\r\n."), "\r\n", "\\n")))
+--&gt; ..\nStuffing the message.\n..\n..
 </pre>
 
+<p class=note>
+Note: The <a href=smtp.html#send><tt>smtp.send</tt></a> function 
+uses this filter automatically. You don't need to 
+apply it again. 
+</p>
+
 <!-- eol ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
 
 <p class=name id="eol">
@@ -273,7 +292,7 @@ context the function receives besides the chunk.  An updated version of
 the context is returned after each new chunk. 
 </p>
 
-<p class=description>
+<p class=parameters>
 <tt>A</tt> is the translated version of <tt>D</tt>. <tt>C</tt> is the
 ASCII value of the last character of the previous chunk, if it was a
 candidate for line break, or 0 otherwise. 
@@ -296,7 +315,7 @@ A, B = mime.<b>qp(</b>C [, D, marker]<b>)</b>
 Low-level filter to perform Quoted-Printable encoding. 
 </p>
 
-<p class=description>
+<p class=parameters>
 <tt>A</tt> is the encoded version of the largest prefix of 
 <tt>C..D</tt> 
 that can be encoded unambiguously. <tt>B</tt> has the remaining bytes of 
@@ -328,7 +347,7 @@ A, m = mime.<b>qpwrp(</b>n [, B, length]<b>)</b>
 Low-level filter to break Quoted-Printable text into lines. 
 </p>
 
-<p class=description>
+<p class=parameters>
 <tt>A</tt> is a copy of <tt>B</tt>, broken into lines of at most 
 <tt>length</tt> bytes (defaults to 76). 
 '<tt>n</tt>' should tell how many bytes are left for the first 
@@ -352,7 +371,7 @@ A, B = mime.<b>unb64(</b>C [, D]<b>)</b>
 Low-level filter to perform Base64 decoding. 
 </p>
 
-<p class=description>
+<p class=parameters>
 <tt>A</tt> is the decoded version of the largest prefix of 
 <tt>C..D</tt> 
 that can be decoded unambiguously. <tt>B</tt> has the remaining bytes of 
@@ -383,7 +402,7 @@ Low-level filter to remove the Quoted-Printable transfer content encoding
 from data. 
 </p>
 
-<p class=description>
+<p class=parameters>
 <tt>A</tt> is the decoded version of the largest prefix of 
 <tt>C..D</tt> 
 that can be decoded unambiguously. <tt>B</tt> has the remaining bytes of 
@@ -414,7 +433,7 @@ Low-level filter to break text into lines with CRLF marker.
 Text is assumed to be in the <a href=#normalize><tt>normalize</tt></a> form.
 </p>
 
-<p class=description>
+<p class=parameters>
 <tt>A</tt> is a copy of <tt>B</tt>, broken into lines of at most 
 <tt>length</tt> bytes (defaults to 76). 
 '<tt>n</tt>' should tell how many bytes are left for the first 
@@ -443,7 +462,7 @@ marker.
 <p>
 <small>
 Last modified by Diego Nehab on <br>
-Sat Aug 9 01:00:41 PDT 2003
+Thu Jun 17 02:47:21 EDT 2004
 </small>
 </p>
 </center>
diff --git a/doc/reference.html b/doc/reference.html
index 9ff6004..607958b 100644
--- a/doc/reference.html
+++ b/doc/reference.html
@@ -107,17 +107,19 @@
 <a href="mime.html#normalize">normalize</a>,
 <a href="mime.html#decode">decode</a>,
 <a href="mime.html#encode">encode</a>,
+<a href="mime.html#stuff">stuff</a>,
 <a href="mime.html#wrap">wrap</a>.
 </blockquote>
 <blockquote>
 <a href="mime.html#low">low-level</a>:
 <a href="mime.html#b64">b64</a>,
-<a href="mime.html#unb64">unb64</a>,
+<a href="mime.html#dot">dot</a>,
 <a href="mime.html#eol">eol</a>,
 <a href="mime.html#qp">qp</a>,
-<a href="mime.html#unqp">unqp</a>,
 <a href="mime.html#wrp">wrp</a>,
 <a href="mime.html#qpwrp">qpwrp</a>.
+<a href="mime.html#unb64">unb64</a>,
+<a href="mime.html#unqp">unqp</a>,
 </blockquote>
 </blockquote>
 
@@ -218,7 +220,7 @@
 <p>
 <small>
 Last modified by Diego Nehab on <br>
-Thu Sep 27 16:18:27 EST 2001
+Thu Jun 17 02:47:21 EDT 2004
 </small>
 </p>
 </center>
diff --git a/doc/smtp.html b/doc/smtp.html
index 6b348e0..89f4757 100644
--- a/doc/smtp.html
+++ b/doc/smtp.html
@@ -347,8 +347,9 @@ source = smtp.message{
     [1] = { 
       body = mime.eol(0, [[
         Lines in a message body should always end with CRLF. 
-        The smtp module will *NOT* perform translation. It will
-        perform necessary stuffing or '.' characters, though.
+        The smtp module will *NOT* perform translation. However, the 
+        send function *DOES* perform SMTP stuffing, whereas the message
+        function does *NOT*.
       ]])
     },
     -- second part: headers describe content to be a png image, 
@@ -397,7 +398,7 @@ r, e = smtp.send{
 <p>
 <small>
 Last modified by Diego Nehab on <br>
-Sat Aug 9 01:00:41 PDT 2003
+Thu Jun 17 02:47:21 EDT 2004
 </small>
 </p>
 </center>
diff --git a/doc/socket.html b/doc/socket.html
index cf65704..d7739f8 100644
--- a/doc/socket.html
+++ b/doc/socket.html
@@ -251,7 +251,7 @@ This constant has a string describing the current LuaSocket version.
 <p>
 <small>
 Last modified by Diego Nehab on <br>
-Sat Aug 9 01:00:41 PDT 2003
+Thu Jun 17 02:47:21 EDT 2004
 </small>
 </p>
 </center>
diff --git a/doc/tcp.html b/doc/tcp.html
index 7a49660..781ec6f 100644
--- a/doc/tcp.html
+++ b/doc/tcp.html
@@ -462,7 +462,7 @@ This function returns 1.
 <p>
 <small>
 Last modified by Diego Nehab on <br>
-Sat Aug 9 01:00:41 PDT 2003
+Thu Jun 17 02:47:21 EDT 2004
 </small>
 </p>
 </center>
diff --git a/doc/udp.html b/doc/udp.html
index 5ae0a89..6f2e607 100644
--- a/doc/udp.html
+++ b/doc/udp.html
@@ -395,7 +395,7 @@ imperative nature obvious.
 <p>
 <small>
 Last modified by Diego Nehab on <br>
-Sat Aug 9 01:00:41 PDT 2003
+Thu Jun 17 02:48:14 EDT 2004
 </small>
 </p>
 </center>
diff --git a/doc/url.html b/doc/url.html
index 1dbee52..46e6e09 100644
--- a/doc/url.html
+++ b/doc/url.html
@@ -315,7 +315,7 @@ The function returns the decoded string.
 <p>
 <small>
 Last modified by Diego Nehab on <br>
-Sat Aug 9 01:00:41 PDT 2003
+Thu Jun 17 02:48:14 EDT 2004
 </small>
 </p>
 </center>
diff --git a/test/testmesg.lua b/test/testmesg.lua
index 3e4c28f..d43c189 100644
--- a/test/testmesg.lua
+++ b/test/testmesg.lua
@@ -23,7 +23,7 @@ source = smtp.message{
         Lines in a message body should always end with CRLF. 
         The smtp module will *NOT* perform translation. It will
         perform necessary stuffing, though.
-     ]])
+      ]])
     },
     -- second part: Headers describe content the to be an image, 
     -- sent under the base64 transfer content encoding.