diff options
| author | Diego Nehab <diego@tecgraf.puc-rio.br> | 2006-04-03 04:45:42 +0000 |
|---|---|---|
| committer | Diego Nehab <diego@tecgraf.puc-rio.br> | 2006-04-03 04:45:42 +0000 |
| commit | 11282d17c8ecb6aa6fa31a3de742eae0215f4cc0 (patch) | |
| tree | aeb65849f145f06f6fb0ddd6a54f79d30912be1f /doc | |
| parent | e9d477aba3bbc084c0a7872e4eaf725e2689e4a6 (diff) | |
| download | luasocket-11282d17c8ecb6aa6fa31a3de742eae0215f4cc0.tar.gz luasocket-11282d17c8ecb6aa6fa31a3de742eae0215f4cc0.tar.bz2 luasocket-11282d17c8ecb6aa6fa31a3de742eae0215f4cc0.zip | |
Almost done 2.0.1.
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/http.html | 10 | ||||
| -rw-r--r-- | doc/index.html | 77 | ||||
| -rw-r--r-- | doc/installation.html | 4 |
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; | |||
| 188 | In case of failure, the function returns <tt><b>nil</b></tt> followed by an | 188 | In case of failure, the function returns <tt><b>nil</b></tt> followed by an |
| 189 | error message. If successful, the simple form returns the response | 189 | error message. If successful, the simple form returns the response |
| 190 | body as a string, followed by the response status code, the response | 190 | body as a string, followed by the response status code, the response |
| 191 | headers and the response status line. The complex function returns the same | 191 | headers and the response status line. The generic function returns the same |
| 192 | information, except the first return value is just the number 1 (the body | 192 | information, except the first return value is just the number 1 (the body |
| 193 | goes to the <tt>sink</tt>). | 193 | goes 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> | ||
| 263 | Note: When sending a POST request, simple interface adds a | ||
| 264 | "<tt>Content-type: application/x-www-form-urlencoded</tt>" | ||
| 265 | header to the request. This is the type used by | ||
| 266 | HTML forms. If you need another type, use the generic | ||
| 267 | interface. | ||
| 268 | </p> | ||
| 269 | |||
| 262 | <p class=note id=authentication> | 270 | <p class=note id=authentication> |
| 263 | Note: Some URLs are protected by their | 271 | Note: Some URLs are protected by their |
| 264 | servers from anonymous download. For those URLs, the server must receive | 272 | servers 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> |
| 81 | Copyright © 2004-2005 Diego Nehab. All rights reserved. <br> | 81 | Copyright © 2004-2006 Diego Nehab. All rights reserved. <br> |
| 82 | Author: <A href="http://www.cs.princeton.edu/~diego">Diego Nehab</a> | 82 | Author: <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> |
| 90 | LuaSocket version 2.0 (final) is now available for download! It is | 90 | LuaSocket version 2.0.1 is now available for download! It is |
| 91 | compatible with Lua 5.0 and has been tested on | 91 | compatible with Lua 5.0 and has been tested on |
| 92 | Windows XP, Linux, and Mac OS X. | 92 | Windows 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> |
| 162 | There is no big change for the 2.0 (final) release. It is basically a | 162 | This is just a bug-fix/update release. |
| 163 | bug fix release. The only improvement is in the non-blocking | ||
| 164 | support. | ||
| 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>; |
| 169 | coroutine based dispatcher; | 167 | <li> Improved: <tt>http.request</tt> is more robust to |
| 170 | <li> New: sample <tt>check-links.lua</tt> works | 168 | malformed URLs (Adrian Sietsma); |
| 171 | both 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 | 171 | header (William Trenker); |
| 174 | based 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; | 173 | servers 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 | 176 | cracks 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; | 178 | ftp.lua (David Burgess). |
| 181 | <li> Fixed: <tt>url.absolute()</tt> to work when <tt>base_url</tt> is in | 179 | <li> |
| 182 | parsed form; | ||
| 183 | <li> Fixed: <tt>http.request()</tt> not to redirect when the location | ||
| 184 | header is empty (naughty servers...); | ||
| 185 | <li> Fixed: <tt>tcp{client}:shutdown()</tt> to check for class instead of | ||
| 186 | group; | ||
| 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 | ||
| 193 | directory (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 | ||
| 199 | fail (Florian Berger); | ||
| 200 | <li> Fixed: Bug in <tt>socket.select()</tt> that caused sockets | ||
| 201 | with 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 | ||
| 217 | use the extra parameters to select only part of the string to be sent, your | ||
| 218 | code 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>, | ||
| 220 | change 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. |
| 43 | All Lua library developers are encouraged to update their libraries so that | 43 | All Lua library developers are encouraged to update their libraries so that |
| 44 | all libraries can coexist peacefully and users can benefit from the | 44 | all libraries can coexist peacefully and users can benefit from the |
| 45 | standardization and flexibility of the standard. | 45 | standardization and flexibility of the standard. |
| @@ -123,7 +123,7 @@ it should be easy to use LuaSocket. Just fire the interpreter and use the | |||
| 123 | Lua 5.0.2 Copyright (C) 1994-2004 Tecgraf, PUC-Rio | 123 | Lua 5.0.2 Copyright (C) 1994-2004 Tecgraf, PUC-Rio |
| 124 | > socket = require("socket") | 124 | > socket = require("socket") |
| 125 | > print(socket._VERSION) | 125 | > print(socket._VERSION) |
| 126 | --> LuaSocket 2.0 | 126 | --> 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 |
