zyppe/luasocket
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Added new instalation section to the manual.

Browse source
This commit is contained in:
Diego Nehab 2004-11-28 08:17:16 +00:00
parent 297b32e828
commit 534b0cedf7
17 changed files with 264 additions and 89 deletions
Download patch file Download diff file Expand all files Collapse all files

84
doc/index.html
View file

@ -4,7 +4,7 @@
<head>
<meta name="description" content="The LuaSocket Homepage">
<meta name="keywords" content="Lua, Library, Network, Support, Internet">
<meta name="keywords" content="Lua, LuaSocket, Network, Library, Support, Internet">
<title>LuaSocket: Network support for the Lua language </title>
<link rel="stylesheet" href="reference.css" type="text/css">
</head>
@ -26,6 +26,7 @@
<p class=bar>
<a href="home.html">home</a> &middot;
<a href="home.html#download">download</a> &middot;
<a href="instalation.html">instalation</a> &middot;
<a href="introduction.html">introduction</a> &middot;
<a href="reference.html">reference</a>
</p>
@ -79,7 +80,7 @@ LuaSocket.
</p>
<p>
Copyright &copy; 1999-2004 Tecgraf/PUC-Rio. All rights reserved. <br>
Copyright &copy; 2004 Diego Nehab. All rights reserved. <br>
Author: <A href="http://www.cs.princeton.edu/~diego">Diego Nehab</a>
</p>
@ -88,7 +89,7 @@ Author: <A href="http://www.cs.princeton.edu/~diego">Diego Nehab</a>
<h2 id=download>Download</h2>
<p>
LuaSocket version 2.0 beta2 is now available for download! It is
LuaSocket version 2.0 (beta3) is now available for download! It is
compatible with Lua&nbsp;5.0 and has been tested on
Windows&nbsp;XP, Linux, and Mac OS X.
</p>
@ -99,8 +100,8 @@ The library can be downloaded in source code from the following links:
<blockquote>
<p>
<a href="luasocket-2.0-beta2.tar.gz">luasocket-2.0-beta2.tar.gz</a> <br>
<a href="luasocket-2.0-beta2.zip">luasocket-2.0-beta2.zip</a>
<a href="luasocket-2.0-beta3.tar.gz">luasocket-2.0-beta3.tar.gz</a> <br>
<a href="luasocket-2.0-beta3.zip">luasocket-2.0-beta3.zip</a>
</p>
</blockquote>
@ -116,7 +117,7 @@ LuaSocket a quick try:
<blockquote>
<p>
<a href="luasocket-2.0-beta2-win32.zip">luasocket-2.0-beta2-win32.zip</a>
<a href="luasocket-2.0-beta3-win32.zip">luasocket-2.0-beta3-win32.zip</a>
</p>
</blockquote>
@ -124,11 +125,15 @@ LuaSocket a quick try:
The quick and dirty way to use these binaries is to unpack everything into a
directory, say <tt>c:\luasocket</tt> (include all Lua files from the
LuaSocket distrbitution in the same directory too!).
Then set <tt>LUA_INIT</tt> to load the <tt>lua.lua</tt> helper file:
Then set <tt>LUA_INIT</tt> to load the <tt>compat-5.1.lua</tt> and set
<tt>LUA_PATH</tt> and <tt>LUA_CPATH</tt> to look for files in that
directory:
</p>
<pre class=example>
c:\luasocket\&gt; set LUA_INIT=@lua.lua
c:\luasocket\&gt; set LUA_INIT=@compat-5.1.lua
c:\luasocket\&gt; set LUA_CPATH=?.dll
c:\luasocket\&gt; set LUA_PATH=?.lua
</pre>
<p>
@ -142,9 +147,13 @@ c:\luasocket\&gt; lua
Lua 5.0.2 Copyright (C) 1994-2004 Tecgraf, PUC-Rio
&gt; http = require"http"
&gt; print(http.request"http://www.tecgraf.puc-rio.br/luasocket/")
--&gt; this file
--&gt; this gets dumped to terminal
</pre>
<p> Take a look at the <a href=instalation.html>installation</a> section of
the manual to find out how to properly install the library after you are
done playing with it. </p>
<!-- thanks +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
<h2 id=thanks>Special thanks</h2>
@ -165,35 +174,31 @@ has been helping a lot too! Thanks to you all!
<h2 id=new>What's New</h2>
<p>
Changes in the 2.0-beta2 were mostly bug-fixes.
The big change for the 2.0 (beta3) release was the adoption of the Lua 5.1
package proposal. There were several bug fixes too (a beta is a
beta, is a beta).
</p>
<ul>
<li> Fixed silly last-minute-change bug in HTTP/SMTP;
<li> <tt>usocket.c</tt>/<tt>wsocket.c</tt> look nicer thanks to Mike;
<li> Finally total timeout is reliable on Windows! (found a pretty
simple work around);
<li> UDP has a reasonable maximum datagram size (8k);
<li> <tt>Receive</tt> accepts the prefix optional argument (good for
non-blocking);
<li> <b><tt>Send</tt> doesn't support multiple arguments anymore</b>;
<li> Instead, <tt>send</tt> allows the selection of the substring
to be sent (good for non-blocking);
<li> Fixed bug that caused select return tables not to be associative
on windows;
<li> Should compile with g++;
<li> New sample unix domain support;
<li> New sample LPD support;
<li> Comprehensive error messages;
<li> New <tt>getstats</tt> and <tt>setstats</tt> methods to help throttling;
<li> <tt>Listen</tt> defaults to 32 backlog;
<li> SMTP/FTP/HTTP fail gracefully;
<li> <tt>accept</tt>/<tt>connect</tt>/<tt>select</tt> interrupt safe
<li> Fixed bug that didn't set accepted sockets as non-blocking
<li> <b>New timming functions <tt>sleep</tt> and <tt>gettime</tt> have
higher resolution and no wrap around problems</b>;
<li> Bug fixes in the manual;
<li> Fixed bug of missing cast in <tt>getfd</tt>.
<li> New compat-5.1 distribution:
<ul>
<li> Instalation uses new directory structure;
<li> Namespace hierarchy is in now back in use (ex. <tt>socket.url</tt>
instead of <tt>url</tt>);
<li> Globals not visible from inside namespaces;
<li> All modules call <tt>require</tt> even for standard libraries;
</ul>
<li> LTN12 avoids coroutines (so you can go wild on the C side);
<li> Kludge on wsocket.c:sock_send for windows timeout issue
moved to buffer.c:sendraw;
<li> <tt>socket.protect </tt>only catches errors thrown by <tt>socket.try</tt>;
<li> Fixed <tt>udp:sendto</tt> to call <tt>sock_sendto</tt> instead of
<tt>sock_send</tt>;
<li> <tt>close</tt> wasn't returning 1!
<li> <tt>socket.gettime</tt> returns time since Unix Epoch 1/1/1970 (UTC)
<li> <tt>socket.sleep</tt> is robust to interrupts;
<li> <tt>socket.select</tt> wasn't calling <tt>tm_markstart</tt>;
<li> <tt>http.PROXY</tt> etc wasn't working.
</ul>
<!-- incompatible +++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
@ -201,10 +206,9 @@ higher resolution and no wrap around problems</b>;
<h3 id=incompatible>Incompatibilities with previous versions</h3>
<ul>
<li> New <tt>send</tt> inteface doesn't send multiple arguments anymore;
<li> <tt>Time</tt> is replaced by <tt>gettime</tt> with advantage.
<li> Namespaces are hierarchical again. This means that whoever called
<tt>require("url")</tt> should update their code to
<tt>require("socket.url")</tt>.
</ul>
<!-- old ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
@ -225,6 +229,8 @@ those that have compatibility issues.
<center>
<p class=bar>
<a href="home.html#down">download</a> &middot;
<a href="home.html#download">download</a> &middot;
<a href="instalation.html">instalation</a> &middot;
<a href="introduction.html">introduction</a> &middot;
<a href="reference.html">reference</a>
</p>