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 |