aboutsummaryrefslogtreecommitdiff
path: root/doc/index.html
diff options
context:
space:
mode:
authorDiego Nehab <diego@tecgraf.puc-rio.br>2004-11-28 08:17:16 +0000
committerDiego Nehab <diego@tecgraf.puc-rio.br>2004-11-28 08:17:16 +0000
commit534b0cedf714d4de0a6cf67570e11f232cdccf84 (patch)
tree14b26a6a8460e57c9739025eb0e661f64bb78b4f /doc/index.html
parent297b32e828b76ee544c9d4f89f996eda78830cc0 (diff)
downloadluasocket-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.html84
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> &middot; 27<a href="home.html">home</a> &middot;
28<a href="home.html#download">download</a> &middot; 28<a href="home.html#download">download</a> &middot;
29<a href="instalation.html">instalation</a> &middot;
29<a href="introduction.html">introduction</a> &middot; 30<a href="introduction.html">introduction</a> &middot;
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>
82Copyright &copy; 1999-2004 Tecgraf/PUC-Rio. All rights reserved. <br> 83Copyright &copy; 2004 Diego Nehab. All rights reserved. <br>
83Author: <A href="http://www.cs.princeton.edu/~diego">Diego Nehab</a> 84Author: <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>
91LuaSocket version 2.0 beta2 is now available for download! It is 92LuaSocket version 2.0 (beta3) is now available for download! It is
92compatible with Lua&nbsp;5.0 and has been tested on 93compatible with Lua&nbsp;5.0 and has been tested on
93Windows&nbsp;XP, Linux, and Mac OS X. 94Windows&nbsp;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:
124The quick and dirty way to use these binaries is to unpack everything into a 125The quick and dirty way to use these binaries is to unpack everything into a
125directory, say <tt>c:\luasocket</tt> (include all Lua files from the 126directory, say <tt>c:\luasocket</tt> (include all Lua files from the
126LuaSocket distrbitution in the same directory too!). 127LuaSocket distrbitution in the same directory too!).
127Then set <tt>LUA_INIT</tt> to load the <tt>lua.lua</tt> helper file: 128Then 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
130directory:
128</p> 131</p>
129 132
130<pre class=example> 133<pre class=example>
131c:\luasocket\&gt; set LUA_INIT=@lua.lua 134c:\luasocket\&gt; set LUA_INIT=@compat-5.1.lua
135c:\luasocket\&gt; set LUA_CPATH=?.dll
136c:\luasocket\&gt; set LUA_PATH=?.lua
132</pre> 137</pre>
133 138
134<p> 139<p>
@@ -142,9 +147,13 @@ c:\luasocket\&gt; lua
142Lua 5.0.2 Copyright (C) 1994-2004 Tecgraf, PUC-Rio 147Lua 5.0.2 Copyright (C) 1994-2004 Tecgraf, PUC-Rio
143&gt; http = require"http" 148&gt; http = require"http"
144&gt; print(http.request"http://www.tecgraf.puc-rio.br/luasocket/") 149&gt; print(http.request"http://www.tecgraf.puc-rio.br/luasocket/")
145--&gt; this file 150--&gt; 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
154the manual to find out how to properly install the library after you are
155done 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>
168Changes in the 2.0-beta2 were mostly bug-fixes. 177The big change for the 2.0 (beta3) release was the adoption of the Lua 5.1
178package proposal. There were several bug fixes too (a beta is a
179beta, 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;
175simple 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;
178non-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);
181to 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;
183on 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
194higher 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> &middot; 231<a href="home.html#down">download</a> &middot;
232<a href="home.html#download">download</a> &middot;
233<a href="instalation.html">instalation</a> &middot;
228<a href="introduction.html">introduction</a> &middot; 234<a href="introduction.html">introduction</a> &middot;
229<a href="reference.html">reference</a> 235<a href="reference.html">reference</a>
230</p> 236</p>
generated by cgit v1.2.3-55-g6feb (git 2.39.1) at 2025-08-15 18:13:58 +0000