aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorDiego Nehab <diego@tecgraf.puc-rio.br>2006-04-03 04:45:42 +0000
committerDiego Nehab <diego@tecgraf.puc-rio.br>2006-04-03 04:45:42 +0000
commit11282d17c8ecb6aa6fa31a3de742eae0215f4cc0 (patch)
treeaeb65849f145f06f6fb0ddd6a54f79d30912be1f /doc
parente9d477aba3bbc084c0a7872e4eaf725e2689e4a6 (diff)
downloadluasocket-11282d17c8ecb6aa6fa31a3de742eae0215f4cc0.tar.gz
luasocket-11282d17c8ecb6aa6fa31a3de742eae0215f4cc0.tar.bz2
luasocket-11282d17c8ecb6aa6fa31a3de742eae0215f4cc0.zip
Almost done 2.0.1.
Diffstat (limited to 'doc')
-rw-r--r--doc/http.html10
-rw-r--r--doc/index.html77
-rw-r--r--doc/installation.html4
3 files changed, 29 insertions, 62 deletions
diff --git a/doc/http.html b/doc/http.html
index a60ed25..992ac7a 100644
--- a/doc/http.html
+++ b/doc/http.html
@@ -188,7 +188,7 @@ function from automatically following 301 or 302 server redirect messages;
188In case of failure, the function returns <tt><b>nil</b></tt> followed by an 188In case of failure, the function returns <tt><b>nil</b></tt> followed by an
189error message. If successful, the simple form returns the response 189error message. If successful, the simple form returns the response
190body as a string, followed by the response status code, the response 190body as a string, followed by the response status code, the response
191headers and the response status line. The complex function returns the same 191headers and the response status line. The generic function returns the same
192information, except the first return value is just the number 1 (the body 192information, except the first return value is just the number 1 (the body
193goes to the <tt>sink</tt>). 193goes to the <tt>sink</tt>).
194</p> 194</p>
@@ -259,6 +259,14 @@ r, c, h = http.request {
259-- } 259-- }
260</pre> 260</pre>
261 261
262<p class=note id=post>
263Note: When sending a POST request, simple interface adds a
264"<tt>Content-type: application/x-www-form-urlencoded</tt>"
265header to the request. This is the type used by
266HTML forms. If you need another type, use the generic
267interface.
268</p>
269
262<p class=note id=authentication> 270<p class=note id=authentication>
263Note: Some URLs are protected by their 271Note: Some URLs are protected by their
264servers from anonymous download. For those URLs, the server must receive 272servers from anonymous download. For those URLs, the server must receive
diff --git a/doc/index.html b/doc/index.html
index f740d91..d5a1f30 100644
--- a/doc/index.html
+++ b/doc/index.html
@@ -78,7 +78,7 @@ LuaSocket.
78</p> 78</p>
79 79
80<p> 80<p>
81Copyright &copy; 2004-2005 Diego Nehab. All rights reserved. <br> 81Copyright &copy; 2004-2006 Diego Nehab. All rights reserved. <br>
82Author: <A href="http://www.cs.princeton.edu/~diego">Diego Nehab</a> 82Author: <A href="http://www.cs.princeton.edu/~diego">Diego Nehab</a>
83</p> 83</p>
84 84
@@ -87,8 +87,8 @@ Author: <A href="http://www.cs.princeton.edu/~diego">Diego Nehab</a>
87<h2 id=download>Download</h2> 87<h2 id=download>Download</h2>
88 88
89<p> 89<p>
90LuaSocket version 2.0 (final) is now available for download! It is 90LuaSocket version 2.0.1 is now available for download! It is
91compatible with Lua&nbsp;5.0 and has been tested on 91compatible with Lua&nbsp;5.0 and has been tested on
92Windows&nbsp;XP, Linux, and Mac OS X. 92Windows&nbsp;XP, Linux, and Mac OS X.
93</p> 93</p>
94 94
@@ -159,65 +159,24 @@ has been helping a lot too! Thanks to you all!
159<h2 id=new>What's New</h2> 159<h2 id=new>What's New</h2>
160 160
161<p> 161<p>
162There is no big change for the 2.0 (final) release. It is basically a 162This is just a bug-fix/update release.
163bug fix release. The only improvement is in the non-blocking
164support.
165</p> 163</p>
166 164
167<ul> 165<ul>
168<li> New: sample module <tt>dispatch.lua</tt> implements a 166<li> Updated: now using <tt>compat-5.1r5</tt>;
169coroutine based dispatcher; 167<li> Improved: <tt>http.request</tt> is more robust to
170<li> New: sample <tt>check-links.lua</tt> works 168malformed URLs (Adrian Sietsma);
171both in blocking and non-blocking mode using coroutines 169<li> Improved: the simple <tt>http.request</tt> interface sends a
172(using the new dispatcher); 170"<tt>Content-type: application/x-www-form-urlencoded</tt>"
173<li> New: sample <tt>forward.lua</tt> implements a coroutine 171header (William Trenker);
174based forward server (using the new dispatcher); 172<li> Improved: <tt>http.request</tt> is robust to evil
175<li> Improved: <tt>tcp:send(data, i, j)</tt> to return <tt>(i+sent-1)</tt>. This is great for non-blocking I/O, but might break some code; 173servers that send inappropriate 100-continue messages
176<li> Improved: HTTP, SMTP, and FTP functions to accept a new field 174(David Burgess);
177<tt>create</tt> that overrides the function used to create socket objects; 175<li> Fixed: sample <tt>unix.c</tt> had fallen through the
178<li> Improved: <tt>smtp.message</tt> now supports multipart/alternative 176cracks during development (Matthew Percival);
179(for the HTML messages we all love so much); 177<li> Fixed: error code was not being propagated correctly in
180<li> Fixed: <tt>smtp.send</tt> was hanging on errors returned by LTN12 sources; 178ftp.lua (David Burgess).
181<li> Fixed: <tt>url.absolute()</tt> to work when <tt>base_url</tt> is in 179<li>
182parsed form;
183<li> Fixed: <tt>http.request()</tt> not to redirect when the location
184header is empty (naughty servers...);
185<li> Fixed: <tt>tcp{client}:shutdown()</tt> to check for class instead of
186group;
187<li> Fixed: The manual to stop using <tt>socket.try()</tt> in place of
188<tt>assert()</tt>, since it can't;
189<li> Improved: Got rid of <tt>package.loaded.base = _G</tt> kludge;
190<li> Fixed: Parts of the manual referred to <tt>require("http")</tt> instead of
191<tt>require("socket.http")</tt>;
192<li> Improved: Socket and MIME binaries are called 'core' each inside their
193directory (ex. "socket/core.dll"). The 'l' prefix was just a bad idea;
194<li> Improved: Using bundles in Mac OS X, instead of dylibs;
195<li> Fixed: <tt>luasocket.h</tt> to export <tt>luaopen_socket_core</tt>;
196<li> Fixed: <tt>udp:setpeername()</tt> so you can "disconnect" an
197<tt>UDP</tt> socket;
198<li> Fixed: A weird bug in HTTP support that caused some requests to
199fail (Florian Berger);
200<li> Fixed: Bug in <tt>socket.select()</tt> that caused sockets
201with descriptor 0 to be ignored (Renato Maia);
202<li> Fixed: "Bug" that caused <tt>dns.toip()</tt> to crash under uLinux
203(William Trenker);
204<li> Fixed: "Bug" that caused <tt>gethostbyname</tt> to crash under VMS
205(Renato Maia);
206<li> Fixed: <tt>tcp:send("")</tt> to return 0 bytes sent (Alexander Marinov);
207<li> Improved: <tt>socket.DEBUG</tt> and <tt>socket.VERSION</tt> became <tt>socket._DEBUGs</tt> and <tt>socket._VERSION</tt> for uniformity with other libraries;
208<li> Improved: <tt>socket.select</tt> now works on empty sets on Windows.
209</ul>
210
211<!-- incompatible +++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
212
213<h3 id=incompatible>Incompatibilities with previous versions</h3>
214
215<ul>
216<li> If you use the return value of <tt>tcp:send()</tt> <em>and</em> you
217use the extra parameters to select only part of the string to be sent, your
218code is now broken, but when you fix it, it will be much simpler;
219<li> If you check <tt>socket.DEBUG</tt> or <tt>socket.VERSION</tt>,
220change it to <tt>socket._DEBUG</tt> or <tt>socket._VERSION</tt>.
221</ul> 180</ul>
222 181
223<!-- old ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ --> 182<!-- old ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
diff --git a/doc/installation.html b/doc/installation.html
index fa1d96f..725db42 100644
--- a/doc/installation.html
+++ b/doc/installation.html
@@ -39,7 +39,7 @@ Installation">
39 39
40<h2>Installation</h2> 40<h2>Installation</h2>
41 41
42<p> LuaSocket 2.0 uses the new package proposal for Lua 5.1. 42<p> LuaSocket 2.0.1 uses the new package proposal for Lua 5.1.
43All Lua library developers are encouraged to update their libraries so that 43All Lua library developers are encouraged to update their libraries so that
44all libraries can coexist peacefully and users can benefit from the 44all libraries can coexist peacefully and users can benefit from the
45standardization and flexibility of the standard. 45standardization and flexibility of the standard.
@@ -123,7 +123,7 @@ it should be easy to use LuaSocket. Just fire the interpreter and use the
123Lua 5.0.2 Copyright (C) 1994-2004 Tecgraf, PUC-Rio 123Lua 5.0.2 Copyright (C) 1994-2004 Tecgraf, PUC-Rio
124&gt; socket = require("socket") 124&gt; socket = require("socket")
125&gt; print(socket._VERSION) 125&gt; print(socket._VERSION)
126--&gt; LuaSocket 2.0 126--&gt; LuaSocket 2.0.1
127</pre> 127</pre>
128 128
129<p> Each module loads their dependencies automatically, so you only need to 129<p> Each module loads their dependencies automatically, so you only need to