diff options
author | Diego Nehab <diego@tecgraf.puc-rio.br> | 2004-11-28 08:17:16 +0000 |
---|---|---|
committer | Diego Nehab <diego@tecgraf.puc-rio.br> | 2004-11-28 08:17:16 +0000 |
commit | 534b0cedf714d4de0a6cf67570e11f232cdccf84 (patch) | |
tree | 14b26a6a8460e57c9739025eb0e661f64bb78b4f /doc/index.html | |
parent | 297b32e828b76ee544c9d4f89f996eda78830cc0 (diff) | |
download | luasocket-534b0cedf714d4de0a6cf67570e11f232cdccf84.tar.gz luasocket-534b0cedf714d4de0a6cf67570e11f232cdccf84.tar.bz2 luasocket-534b0cedf714d4de0a6cf67570e11f232cdccf84.zip |
Added new instalation section to the manual.
Diffstat (limited to 'doc/index.html')
-rw-r--r-- | doc/index.html | 84 |
1 files changed, 45 insertions, 39 deletions
diff --git a/doc/index.html b/doc/index.html index c0a46ea..c3c391f 100644 --- a/doc/index.html +++ b/doc/index.html | |||
@@ -4,7 +4,7 @@ | |||
4 | 4 | ||
5 | <head> | 5 | <head> |
6 | <meta name="description" content="The LuaSocket Homepage"> | 6 | <meta name="description" content="The LuaSocket Homepage"> |
7 | <meta name="keywords" content="Lua, Library, Network, Support, Internet"> | 7 | <meta name="keywords" content="Lua, LuaSocket, Network, Library, Support, Internet"> |
8 | <title>LuaSocket: Network support for the Lua language </title> | 8 | <title>LuaSocket: Network support for the Lua language </title> |
9 | <link rel="stylesheet" href="reference.css" type="text/css"> | 9 | <link rel="stylesheet" href="reference.css" type="text/css"> |
10 | </head> | 10 | </head> |
@@ -26,6 +26,7 @@ | |||
26 | <p class=bar> | 26 | <p class=bar> |
27 | <a href="home.html">home</a> · | 27 | <a href="home.html">home</a> · |
28 | <a href="home.html#download">download</a> · | 28 | <a href="home.html#download">download</a> · |
29 | <a href="instalation.html">instalation</a> · | ||
29 | <a href="introduction.html">introduction</a> · | 30 | <a href="introduction.html">introduction</a> · |
30 | <a href="reference.html">reference</a> | 31 | <a href="reference.html">reference</a> |
31 | </p> | 32 | </p> |
@@ -79,7 +80,7 @@ LuaSocket. | |||
79 | </p> | 80 | </p> |
80 | 81 | ||
81 | <p> | 82 | <p> |
82 | Copyright © 1999-2004 Tecgraf/PUC-Rio. All rights reserved. <br> | 83 | Copyright © 2004 Diego Nehab. All rights reserved. <br> |
83 | Author: <A href="http://www.cs.princeton.edu/~diego">Diego Nehab</a> | 84 | Author: <A href="http://www.cs.princeton.edu/~diego">Diego Nehab</a> |
84 | </p> | 85 | </p> |
85 | 86 | ||
@@ -88,7 +89,7 @@ Author: <A href="http://www.cs.princeton.edu/~diego">Diego Nehab</a> | |||
88 | <h2 id=download>Download</h2> | 89 | <h2 id=download>Download</h2> |
89 | 90 | ||
90 | <p> | 91 | <p> |
91 | LuaSocket version 2.0 beta2 is now available for download! It is | 92 | LuaSocket version 2.0 (beta3) is now available for download! It is |
92 | compatible with Lua 5.0 and has been tested on | 93 | compatible with Lua 5.0 and has been tested on |
93 | Windows XP, Linux, and Mac OS X. | 94 | Windows XP, Linux, and Mac OS X. |
94 | </p> | 95 | </p> |
@@ -99,8 +100,8 @@ The library can be downloaded in source code from the following links: | |||
99 | 100 | ||
100 | <blockquote> | 101 | <blockquote> |
101 | <p> | 102 | <p> |
102 | <a href="luasocket-2.0-beta2.tar.gz">luasocket-2.0-beta2.tar.gz</a> <br> | 103 | <a href="luasocket-2.0-beta3.tar.gz">luasocket-2.0-beta3.tar.gz</a> <br> |
103 | <a href="luasocket-2.0-beta2.zip">luasocket-2.0-beta2.zip</a> | 104 | <a href="luasocket-2.0-beta3.zip">luasocket-2.0-beta3.zip</a> |
104 | </p> | 105 | </p> |
105 | </blockquote> | 106 | </blockquote> |
106 | 107 | ||
@@ -116,7 +117,7 @@ LuaSocket a quick try: | |||
116 | 117 | ||
117 | <blockquote> | 118 | <blockquote> |
118 | <p> | 119 | <p> |
119 | <a href="luasocket-2.0-beta2-win32.zip">luasocket-2.0-beta2-win32.zip</a> | 120 | <a href="luasocket-2.0-beta3-win32.zip">luasocket-2.0-beta3-win32.zip</a> |
120 | </p> | 121 | </p> |
121 | </blockquote> | 122 | </blockquote> |
122 | 123 | ||
@@ -124,11 +125,15 @@ LuaSocket a quick try: | |||
124 | The quick and dirty way to use these binaries is to unpack everything into a | 125 | The quick and dirty way to use these binaries is to unpack everything into a |
125 | directory, say <tt>c:\luasocket</tt> (include all Lua files from the | 126 | directory, say <tt>c:\luasocket</tt> (include all Lua files from the |
126 | LuaSocket distrbitution in the same directory too!). | 127 | LuaSocket distrbitution in the same directory too!). |
127 | Then set <tt>LUA_INIT</tt> to load the <tt>lua.lua</tt> helper file: | 128 | Then set <tt>LUA_INIT</tt> to load the <tt>compat-5.1.lua</tt> and set |
129 | <tt>LUA_PATH</tt> and <tt>LUA_CPATH</tt> to look for files in that | ||
130 | directory: | ||
128 | </p> | 131 | </p> |
129 | 132 | ||
130 | <pre class=example> | 133 | <pre class=example> |
131 | c:\luasocket\> set LUA_INIT=@lua.lua | 134 | c:\luasocket\> set LUA_INIT=@compat-5.1.lua |
135 | c:\luasocket\> set LUA_CPATH=?.dll | ||
136 | c:\luasocket\> set LUA_PATH=?.lua | ||
132 | </pre> | 137 | </pre> |
133 | 138 | ||
134 | <p> | 139 | <p> |
@@ -142,9 +147,13 @@ c:\luasocket\> lua | |||
142 | Lua 5.0.2 Copyright (C) 1994-2004 Tecgraf, PUC-Rio | 147 | Lua 5.0.2 Copyright (C) 1994-2004 Tecgraf, PUC-Rio |
143 | > http = require"http" | 148 | > http = require"http" |
144 | > print(http.request"http://www.tecgraf.puc-rio.br/luasocket/") | 149 | > print(http.request"http://www.tecgraf.puc-rio.br/luasocket/") |
145 | --> this file | 150 | --> this gets dumped to terminal |
146 | </pre> | 151 | </pre> |
147 | 152 | ||
153 | <p> Take a look at the <a href=instalation.html>installation</a> section of | ||
154 | the manual to find out how to properly install the library after you are | ||
155 | done playing with it. </p> | ||
156 | |||
148 | <!-- thanks +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ --> | 157 | <!-- thanks +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ --> |
149 | 158 | ||
150 | <h2 id=thanks>Special thanks</h2> | 159 | <h2 id=thanks>Special thanks</h2> |
@@ -165,35 +174,31 @@ has been helping a lot too! Thanks to you all! | |||
165 | <h2 id=new>What's New</h2> | 174 | <h2 id=new>What's New</h2> |
166 | 175 | ||
167 | <p> | 176 | <p> |
168 | Changes in the 2.0-beta2 were mostly bug-fixes. | 177 | The big change for the 2.0 (beta3) release was the adoption of the Lua 5.1 |
178 | package proposal. There were several bug fixes too (a beta is a | ||
179 | beta, is a beta). | ||
169 | </p> | 180 | </p> |
170 | 181 | ||
171 | <ul> | 182 | <ul> |
172 | <li> Fixed silly last-minute-change bug in HTTP/SMTP; | 183 | <li> New compat-5.1 distribution: |
173 | <li> <tt>usocket.c</tt>/<tt>wsocket.c</tt> look nicer thanks to Mike; | 184 | <ul> |
174 | <li> Finally total timeout is reliable on Windows! (found a pretty | 185 | <li> Instalation uses new directory structure; |
175 | simple work around); | 186 | <li> Namespace hierarchy is in now back in use (ex. <tt>socket.url</tt> |
176 | <li> UDP has a reasonable maximum datagram size (8k); | 187 | instead of <tt>url</tt>); |
177 | <li> <tt>Receive</tt> accepts the prefix optional argument (good for | 188 | <li> Globals not visible from inside namespaces; |
178 | non-blocking); | 189 | <li> All modules call <tt>require</tt> even for standard libraries; |
179 | <li> <b><tt>Send</tt> doesn't support multiple arguments anymore</b>; | 190 | </ul> |
180 | <li> Instead, <tt>send</tt> allows the selection of the substring | 191 | <li> LTN12 avoids coroutines (so you can go wild on the C side); |
181 | to be sent (good for non-blocking); | 192 | <li> Kludge on wsocket.c:sock_send for windows timeout issue |
182 | <li> Fixed bug that caused select return tables not to be associative | 193 | moved to buffer.c:sendraw; |
183 | on windows; | 194 | <li> <tt>socket.protect </tt>only catches errors thrown by <tt>socket.try</tt>; |
184 | <li> Should compile with g++; | 195 | <li> Fixed <tt>udp:sendto</tt> to call <tt>sock_sendto</tt> instead of |
185 | <li> New sample unix domain support; | 196 | <tt>sock_send</tt>; |
186 | <li> New sample LPD support; | 197 | <li> <tt>close</tt> wasn't returning 1! |
187 | <li> Comprehensive error messages; | 198 | <li> <tt>socket.gettime</tt> returns time since Unix Epoch 1/1/1970 (UTC) |
188 | <li> New <tt>getstats</tt> and <tt>setstats</tt> methods to help throttling; | 199 | <li> <tt>socket.sleep</tt> is robust to interrupts; |
189 | <li> <tt>Listen</tt> defaults to 32 backlog; | 200 | <li> <tt>socket.select</tt> wasn't calling <tt>tm_markstart</tt>; |
190 | <li> SMTP/FTP/HTTP fail gracefully; | 201 | <li> <tt>http.PROXY</tt> etc wasn't working. |
191 | <li> <tt>accept</tt>/<tt>connect</tt>/<tt>select</tt> interrupt safe | ||
192 | <li> Fixed bug that didn't set accepted sockets as non-blocking | ||
193 | <li> <b>New timming functions <tt>sleep</tt> and <tt>gettime</tt> have | ||
194 | higher resolution and no wrap around problems</b>; | ||
195 | <li> Bug fixes in the manual; | ||
196 | <li> Fixed bug of missing cast in <tt>getfd</tt>. | ||
197 | </ul> | 202 | </ul> |
198 | 203 | ||
199 | <!-- incompatible +++++++++++++++++++++++++++++++++++++++++++++++++++++++ --> | 204 | <!-- incompatible +++++++++++++++++++++++++++++++++++++++++++++++++++++++ --> |
@@ -201,10 +206,9 @@ higher resolution and no wrap around problems</b>; | |||
201 | <h3 id=incompatible>Incompatibilities with previous versions</h3> | 206 | <h3 id=incompatible>Incompatibilities with previous versions</h3> |
202 | 207 | ||
203 | <ul> | 208 | <ul> |
204 | 209 | <li> Namespaces are hierarchical again. This means that whoever called | |
205 | <li> New <tt>send</tt> inteface doesn't send multiple arguments anymore; | 210 | <tt>require("url")</tt> should update their code to |
206 | <li> <tt>Time</tt> is replaced by <tt>gettime</tt> with advantage. | 211 | <tt>require("socket.url")</tt>. |
207 | |||
208 | </ul> | 212 | </ul> |
209 | 213 | ||
210 | <!-- old ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ --> | 214 | <!-- old ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ --> |
@@ -225,6 +229,8 @@ those that have compatibility issues. | |||
225 | <center> | 229 | <center> |
226 | <p class=bar> | 230 | <p class=bar> |
227 | <a href="home.html#down">download</a> · | 231 | <a href="home.html#down">download</a> · |
232 | <a href="home.html#download">download</a> · | ||
233 | <a href="instalation.html">instalation</a> · | ||
228 | <a href="introduction.html">introduction</a> · | 234 | <a href="introduction.html">introduction</a> · |
229 | <a href="reference.html">reference</a> | 235 | <a href="reference.html">reference</a> |
230 | </p> | 236 | </p> |